Man Linux: Main Page and Category List

NAME

       pnm2ppa  -  convert  portable  anymap  (PNM) images to HP’s PPA printer
       format.

SYNOPSIS

       pnm2ppa [options] [ -i infile ] [ -o outfile ]

DESCRIPTION

       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
       processed  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
       "pnmraw", which will choose one of these  formats  as  appropriate  for
       the  document.)   pnm2ppa  assumes  the  input resolution is 600dpi (or
       300dpi  if  the  command-line  option  --dpi300  is  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.

OPTIONS

       -b bottommargin
              Sets  the  bottom  margin  bottommargin in units of 1/600 inches
              (e.g.,  -b 150 corresponds to 0.25").

       -B blackness
              Sets  the  black  ink  density  blackness  in  drops  per  pixel
              (0,1,2,3,4).

       --bi   Force bidirectional print sweeps.

       --bw   Disables  the  color  cartridge;  will print in grey scale using
              only the black cartridge.

       -d     Displays the current configuration.

       --dpi300
              Treat input resolution as 300dpi instead of 600dpi.

       --eco  Econofast mode: lower print quality that  is  faster  and  saves
              ink.

       -f configFile
              Re-reads  configuration from configFile (after initially reading
              it from /etc/pnm2ppa.conf).

       -F GammaFile
              Overrides reading the color-correction table (Gamma curve)  from
              the default file /etc/pnm2ppa.gamma, and uses GammaFile instead.

       --fd   Enable fast ordered dithering instead of using the  slower,  but
              beautiful,  Floyd-Steinberg  dithering.  (Has  no effect in --bw
              mode.)

       -g     Prints a page of color intensity samples  (for  comparison  with
              gamma.ppm  data  produced  by calibrate_ppa).  This is part of a
              color-correction procedure; see COLOR.txt for more details.

       -h, --help
              Displays program usage.

       -i infile
              Input file infile is either a path to a  PPM  file,  or  ’-’  to
              indicate stdin  (defaults to stdin).

       -l leftmargin
              Sets  the left margin leftmargin in units of 1/600 inches (e.g.,
              -l 150 corresponds to 0.25").

       --noGamma
              Switches off any color-correction.

       -o outfile | -
              Output file outfile is either a path to a file or device, or ’-’
              to indicate stdout (defaults to stdout).

       -p     Disables  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.

       -r rightmargin
              Sets  the  right  margin  rightmargin  in  units of 1/600 inches
              (e.g., -r 150 corresponds to 0.25").

       -s papersize
              Sets the default paper size (now used only for  color-correction
              output  produced  by the -g option).  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 papersize are a4 (A4), letter or  us
              (US  Letter, 8.5"x11"), legal (US Legal, 8.5"x14").  The default
              is US Letter.

       -t topmargin
              Sets the top margin topmargin in units of 1/600  inches  (ie  -t
              150 corresponds to 0.25").

       --uni  Force  unidirectional  (left  to right) print sweeps.  Useful if
              "shearing" is a problem for high quality color images.

       -v printertype
              Selects the printer model.  Possible values of printertype  are:
              710, 712, 720, 722, 820 and 1000.  The default is the HP DeskJet
              7X0 Series (710, 712, 720, 722).

       --verbose
              Displays the program’s  System  Log  messages  on  the  standard
              output, as well.

       --version
              Displays the program’s version information.

       -x xoffset
              Sets  the  x-offset xoffset from the left of the page. Units are
              1/600 inches.

       -y yoffset
              Sets the y-offset yoffset from the top of the  page.  Units  are
              1/600 inches.

NOTES

       The  default  configuration  file  /etc/pnm2ppa.conf  is read in first.
       Command line arguments then modify the resulting definitions.

       The -v option resets all definitions (margins, offsets, etc.)  back  to
       the  inbuilt  defaults  for  that  printer  and  should  be used before
       subsequent -b, -l, -r, -t, -x and -y arguments.

SEE ALSO

       pnm(5), ppm(5), pbm(5)

FILES

       /etc/pnm2ppa.conf
              Default configuration file.

       /etc/pnm2ppa.gamma
              Default Gamma (color-correction) file.

AUTHOR

       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

HISTORY

       This  program  was  originally  pbm2ppa,  written  by  Tim  Norman.  It
       originally 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.

BUGS

       Faint horizontal lines marking boundaries between print sweeps  may  be
       visible.   You  may  get  better results when printing images, with the
       options:
         -p --uni  (this may no longer apply since recent code  improvements).

                                  23 Jun 2002                       pnm2ppa(1)