.\" Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH pnm2ppa 8 "November 2000"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh disable hyphenation
.\" .hy enable hyphenation
.\" .ad l left justify
.\" .ad b justify to both left and right margins
.\" .nf disable filling
.\" .fi enable filling
.\" .br insert line break
.\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.\"
.SH NAME
pnm2ppa \- PPM to PPA converter
.SH SYNOPSIS
.B pnm2ppa
.RI [options]
.SH DESCRIPTION
Using pnm2ppa it's possible to run HP-GDI printers on Linux. These printers are normally "Windows-only" and use the PPA protocol which is proprietary. pnm2ppa supports color and is supposed to work faster than pbm2ppa. pnm2ppa supports the following printers: HP Deskjet 7XX Series, HP Deskjet 820 Series and HP Deskjet 1000 Series.
.SH OPTIONS
.TP
.B \-b <margin>
bottom margin in 1"/600 (default: 150 = 0.25")
.TP
.B \-\-bi
forces bidirectional print head sweeps
.TP
.B \-B <n>
density of black ink (n = 0,1,2,3 or 4)
.TP
.B \-\-bw
forces black/white output
.TP
.B \-d
dumps the configuration to stdout
.TP
.B \-\-eco
Econofast mode (uses less ink)
.TP
.B \-f <cfgfile>
read printer settings from configuration file <cfgfile>
.TP
.B \-F <gammaFile>
read color correction table from file <gammaFile>
.TP
.B \-\-fd
use fast dithering mode
.TP
.B \-g
print color calibration page. See CALIBRATION.txt
.TP
.B \-h, \-\-help displays this help text.
.TP
.B \-i <infile>
input from file <infile>, "-i -" means stdin
.TP
.B \-l <margin>
left margin in 1"/600 (default: 150 = 0.25")
.TP
.B \-\-noGamma
suppresses any color correction
.TP
.B \-o <outfile>
output to file <outfile>, "-o -" means stdout
.TP
.B \-p
disable black ink cartridge
.TP
.B \-r <margin>
right margin in 1"/600 (default: 150 = 0.25")
.TP
.B \-s <paper>
default papersize (a4, legal, letter = us (default))
.TP
.B \-t <margin>
top margin in 1"/600 (default: 150 = 0.25")
.TP
.B \-\-uni
forces unidirectional print head sweeps
.TP
.B \-v <model>
set the printer model (710, 712, 720, 722, 820, or 1000)
.TP
.B \-\-verbose
outputs syslog output to stderr as well
.TP
.B \-\-version
Display the version of pnm2ppa to the syslog
.TP
.B \-x <offset>
vertical offset adjustment in 1"/600
.TP
.B \-y <offset>
horizontal offset adjustment in 1"/600
.TP
The \fB\-v\fR option resets the margins and offset adjustments to the default values for that printer model. <infile> and <outfile> default to stdin and stdout. '-' is a synonym for stdin and stdout.
.SH CONFIGURATION FILES
The order in which parameters are specified is important: The file /etc/pnm2ppa.conf, if it exists, is processed as a configuration file before any command-line parameters are processed. If an alternate configuration file is specified on the command line with the '-f' parameter, its contents are processed at that point. If a parameter is specified more than once, only its last value is used. Configuration files specified with the '-f' parameter have the following format:
.IP
# Comment
.IP
<key1> <value1>
.IP
<key2> <value2>
.IP
[etc.]
.TP
Valid keys include:
.IP
version, xoffset, yoffset, topmargin, leftmargin, rightmargin, bottommargin, blackness, papersize
.TP
or any non-null truncated version of these words. Valid values are the same as with the corresponding command-line parameters.
.TP
Other keys that can be set in the configuration file include:
.IP
silent, verbose, unimode, blackshear, colorshear, RedGammaIdx, BlueGammaIdx, GreenGammaIdx, GammaR, GammaG, GammaB, ColOffsX, ColOffsY, black_ink, color_ink, cyan_ink, magenta_ink, yellow_ink
.TP
See documentation in the sample configuration file for their usage.
.SH FILES
.PD 0
.IR /etc/ppa/gamma.ppm
gamma correction file
.TP
\fI/etc/ppa/pnm2ppa.conf.hp1000\fP, \fI /etc/ppa/pnm2ppa.conf.hp820\fP, \fI /etc/ppa/pnm2ppa.conf.hp720\fP
.TP
Configuration files for the HP1000, HP820, and HP720 Series respectively.
.PD
.SH SEE ALSO
.IR calibrate_ppa (8),
.IR magicfilter (8),
.IR apsfilter(8)