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 pre
ferred. 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.)
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.
--eco Econofast mode: lower print quality that is faster
and saves ink.
-f configFile
Re-reads configuration from configFile (after ini
tially reading it from /etc/pnm2ppa.conf).
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 com
parison with gamma.ppm data produced by cali
brate_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 std
out).
-p Disables the black ink cartridge; i.e., print
using only the color ink cartridge, even for print
ing "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
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
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-2000 Various authors for many, many fixes
HISTORY
This program was originally pbm2ppa, written by Tim Nor
man. 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://source
forge.net/projects/pnm2ppa.
BUGS
Faint horizontal lines marking boundaries between print
sweeps may be visible. For best results when printing
images, use the options -p --uni .
Man(1) output converted with
man2html