Ubuntu Manpage: pnm2ppa - convert portable anymap (PNM) images to HP's PPA printer format.

Provided by: printer-driver-pnm2ppa_1.13+nondbs-0ubuntu6_amd64

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.

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)