home | help
pnm2ppa(23 Jun 2002)					    pnm2ppa(23 Jun 2002)

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  Ghost-
     Script  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  re-
     sult  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 /usr/local/etc/pnm2ppa.conf).

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

     --fd   Enable fast ordered dithering instead of using the slower, but beau-
	    tiful, 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 out-
	    put  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 Se-
	    ries (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  /usr/local/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
     /usr/local/etc/pnm2ppa.conf
	    Default configuration file.

     /usr/local/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 visi-
     ble.  You may get better results when printing images, with the options:
       -p --uni  (this may no longer apply since recent code improvements).

							    pnm2ppa(23 Jun 2002)

home | help