pnm2ppa(23 Jun 2002)                                      pnm2ppa(23 Jun 2002)



[1mNAME[0m
       pnm2ppa - convert portable anymap (PNM) images to HP's PPA printer for-
       mat.

[1mSYNOPSIS[0m
       pnm2ppa [options] [ -i [4minfile[24m ] [ -o [4moutfile[24m ]


[1mDESCRIPTION[0m
       Reads portable anymap (PNM) format as input. Binary PNM formats  pnmraw
       = {ppmraw (color pixmap), pgmraw (graymap), and pbmraw (black-and-white
       bitmap)} are strongly preferred.  Output stream  can  be  locally  pro-
       cessed  by  Hewlett-Packard's  Printing  Performance Architecture (PPA)
       printers (HP DeskJet 710C, 712C, 720C, 722C, 820C, and 1000C series).

       (PNM format output can be produced from  PostScript(tm)  input  by  the
       GhostScript output devices "pbmraw", "pgmraw" or "ppmraw",  or by "pnm-
       raw", which will choose one of these  formats as  appropriate  for  the
       document.)   [1mpnm2ppa  [22massumes the input resolution is 600dpi (or 300dpi
       if the command-line option [1m--dpi300 [22mis  used):  input  at  higher/lower
       resolutions will result in a correspondingly larger/smaller printed im-
       age, provided it is within the printer's allowed size range.

[1mOPTIONS[0m
       [1m-b [4m[22mbottommargin[0m
              Sets the bottom margin [4mbottommargin[24m in  units  of  1/600  inches
              (e.g.,  [1m-b 150 [22mcorresponds to 0.25").


       [1m-B [4m[22mblackness[0m
              Sets  the  black  ink  density  [4mblackness[24m  in  drops  per  pixel
              (0,1,2,3,4).


       [1m--bi   [22mForce bidirectional print sweeps.


       [1m--bw   [22mDisables the color cartridge; will print  in  grey  scale  using
              only the black cartridge.


       [1m-d     [22mDisplays the current configuration.


       [1m--dpi300[0m
              Treat input resolution as 300dpi instead of 600dpi.


       [1m--eco  [22mEconofast  mode:  lower  print  quality that is faster and saves
              ink.


       [1m-f [4m[22mconfigFile[0m
              Re-reads configuration from [4mconfigFile[24m (after initially  reading
              it from /etc/pnm2ppa.conf).


       [1m-F [4m[22mGammaFile[0m
              Overrides  reading the color-correction table (Gamma curve) from
              the default file /etc/pnm2ppa.gamma, and uses [4mGammaFile[24m instead.


       [1m--fd   [22mEnable fast ordered dithering instead of using the  slower,  but
              beautiful,  Floyd-Steinberg  dithering.  (Has  no effect in --bw
              mode.)


       [1m-g     [22mPrints a page of color intensity samples  (for  comparison  with
              gamma.ppm  data  produced  by calibrate_ppa).  This is part of a
              [1mcolor-correction [22mprocedure; see COLOR.txt for more details.


       [1m-h, --help[0m
              Displays program usage.


       [1m-i [4m[22minfile[0m
              Input file [4minfile[24m is either a path to a PPM file, or '-' to  in-
              dicate stdin  (defaults to stdin).


       [1m-l [4m[22mleftmargin[0m
              Sets  the left margin [4mleftmargin[24m in units of 1/600 inches (e.g.,
              [1m-l 150 [22mcorresponds to 0.25").


       [1m--noGamma[0m
              Switches off any color-correction.


       [1m-o [4m[22moutfile[24m | -
              Output file [4moutfile[24m is either a path to a file or device, or '-'
              to indicate stdout (defaults to stdout).


       [1m-p     [22mDisables  the  black ink cartridge; i.e.,  print  using only the
              color ink cartridge, even for printing "black".  This  might  be
              useful for printing high-quality color  images.


       [1m-r [4m[22mrightmargin[0m
              Sets  the  right  margin  [4mrightmargin[24m  in  units of 1/600 inches
              (e.g., [1m-r 150 [22mcorresponds to 0.25").


       [1m-s [4m[22mpapersize[0m
              Sets the default paper size (now used only for  color-correction
              output  produced  by the [1m-g [22moption).  In normal use, pnm2ppa now
              instead reads the paper dimensions from pnm input file  headers,
              and  checks  that  it is a valid papersize for the given printer
              model.  Possible values for [4mpapersize[24m are [1ma4 [22m(A4), [1mletter [22mor  [1mus[0m
              (US  Letter, 8.5"x11"), [1mlegal [22m(US Legal, 8.5"x14").  The default
              is US Letter.


       [1m-t [4m[22mtopmargin[0m
              Sets the top margin [4mtopmargin[24m in units of 1/600  inches  (ie  [1m-t[0m
              [1m150 [22mcorresponds to 0.25").


       [1m--uni  [22mForce  unidirectional  (left  to right) print sweeps.  Useful if
              "shearing" is a problem for high quality color images.


       [1m-v [4m[22mprintertype[0m
              Selects the printer model.  Possible values of [4mprintertype[24m  are:
              [1m710[22m, [1m712[22m, [1m720[22m, [1m722[22m, [1m820 [22mand [1m1000[22m.  The default is the HP DeskJet
              7X0 Series (710, 712, 720, 722).


       [1m--verbose[0m
              Displays the program's System Log messages on the standard  out-
              put, as well.


       [1m--version[0m
              Displays the program's version information.


       [1m-x [4m[22mxoffset[0m
              Sets  the  x-offset [4mxoffset[24m from the left of the page. Units are
              1/600 inches.


       [1m-y [4m[22myoffset[0m
              Sets the y-offset [4myoffset[24m from the top of the  page.  Units  are
              1/600 inches.



[1mNOTES[0m
       The  default  configuration  file  [4m/etc/pnm2ppa.conf[24m  is read in first.
       Command line arguments then modify the resulting definitions.

       The [1m-v [22moption resets all definitions (margins, offsets, etc.)  back  to
       the  inbuilt defaults for that printer and should be used before subse-
       quent [1m-b[22m, [1m-l[22m, [1m-r[22m, [1m-t[22m, [1m-x [22mand [1m-y [22marguments.

[1mSEE ALSO[0m
       pnm(5), ppm(5), pbm(5)


[1mFILES[0m
       [4m/etc/pnm2ppa.conf[0m
              Default configuration file.


       [4m/etc/pnm2ppa.gamma[0m
              Default Gamma (color-correction) file.


[1mAUTHOR[0m
       This code is licensed under the GNU Public License version 2.  See  LI-
       CENSE for details.

       (c) 1998-1999  Tim Norman

       (c) 1999  Giorgio Marzano

       (c) 1999  Andrew van der Stock

       (c) 1998-2002  Various authors for many, many fixes

[1mHISTORY[0m
       This  program  was originally pbm2ppa, written by Tim Norman. It origi-
       nally supported black and white output on the 820  series.   Tim  added
       nascent  color  support  in  early  1999.  In May 1999, Giorgio Marzano
       started making real headway in getting color support working  properly.
       Andrew  van der Stock has maintained the code since September 1999, and
       made it available at http://sourceforge.net/projects/pnm2ppa.

[1mBUGS[0m
       Faint horizontal lines marking boundaries between print sweeps  may  be
       visible.  You may get better results when printing images, with the op-
       tions:
         [1m-p --uni  [22m(this may no longer apply since recent code improvements).




                                                          pnm2ppa(23 Jun 2002)
