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
       image, 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
              indicate 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
       LICENSE 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
       options:
         [1m-p  --uni  [22m(this may no longer apply since recent code improvements).




                                                          pnm2ppa(23 Jun 2002)
