.TH pnm2ppa "5 Feb 2000"
.SH NAME
pbm2ppa - convert portable bitmap (PBM) to HP's Printing Performance Architecture (PPA) file format
.SH SYNOPSIS
pbm2ppa [options] [ <\fIinfile\fR] > [ <\fIoutfile\fR]> ] ]

.SH DESCRIPTION
Reads portable bitmap (PBM) format as input.  Outputs a stream suitable for 
processing by  Hewlett-Packard's range of Printing Performance Architecture 
(PPA) printers. 
pnm2ppa supports the HP 710c, 712c, 720c, 722c, 820c, and 1000c 
series printers. 
.PP
(Portable bitmap (PBM) format output can be produced from PostScript(tm) input 
by the GhostScript driver "pbmraw".)
.PP


.SH OPTIONS
.\"{{{	infile  
.IP "\fB\\fIinfile\fR \fP"
Input file \fIinfile\fR is either a path to a file or device, or '-' to indicate stdin (defaults to stdin)
.\"}}}


.\"{{{	outfile 
.IP "\fB\\fIoutfile\fR  \fP"
Output file \fIoutfile\fR is either a path to a file or device, or '-' to indicate stdout (defaults to stdout)
.\"}}}


.\"{{{	-b bottommargin
.IP "\fB\-b \fIbottommargin\fR\fP"
Sets the bottom margin \fIbottommargin\fR in units of 1/600 inches (e.g.,  -b 150 = 0.25")
.\"}}}


.\"{{{	-d
.IP "\fB\-d\fP"
Displays the current configuration
.\"}}}


.\"{{{	-f configfile
.IP "\fB\-f \fIconfigfile\fR\fP"
Overrides reading the configuration from /etc/pnm2ppa.conf, and uses 
\fIconfigfile\fR instead.
.\"}}}


.\"{{{	-h
.IP "\fB\-h\fP"
Displays program usage
.\"}}}



.\"{{{	-l leftmargin
.IP "\fB\-l \fIleftmargin\fR\fP"
Sets the left margin \fIleftmargin\fR in units of 1/600 inches (e.g., -l 150 = 0.25")
.\"}}}


.\"{{{	-r rightmargin
.IP "\fB\-r \fIrightmargin\fR\fP"
Sets the right margin \fIrightmargin\fR in units of 1/600 inches (e.g., -r 150 = 0.25")
.\"}}}

.\"{{{	-s  papersize
.IP "\fB\-s \fIpapersize\fR\fP"
Sets the paper size. Possible values for \fIpapersize\fR are \fBa4\fP (A4),
\fBletter\fP or \fBus\fP (US Letter, 8.5"x11"), and \fBlegal\fR (US Legal,
8.5"x14").
The default is US Letter.
.\"}}}

.\"{{{	-t topmargin
.IP "\fB\-t \fItopmargin\fR\fP"
Sets the top margin \fItopmargin\fR in units of 1/600 inches (ie -t 150 = 0.25")
.\"}}}

.\"{{{	-v  printertype
.IP "\fB\-v \fIprintertype\fP"
Selects the printer model.  Possible values of \fIprintertype\fR are:
\fB710\fP, \fB712\fP, \fB720\fP, \fB722\fP, \fB820\fP and \fB1000\fP.
The default is the HP DeskJet 7X0 Series (710, 712, 720, 722).
.\"}}}


.\"{{{	-x xoffset
.IP "\fB\-x \fIxoffset\fR\fP"
Sets the x-offset \fBxoffset\fR from the left of the page. Units are 1/600 inches
.\"}}}

.\"{{{	-y yoffset
.IP "\fB\-y \fIyoffset\fR\fP"
Sets the y-offset \fByoffset\fR from the top of the page. Units are 1/600 inches
.\"}}}

 
.SH NOTES
The configuration file is read in first. Command line arguments then modify the resulting definitions.
.PP
The -x and -y options accumulate. The -v option resets all definitions back to
an inbuilt default for that printer and should be used before subsequent -b -l -r, -t,  -x, and -y arguments.
.SH "SEE ALSO"
pbm(5)

.SH FILES

.\"{{{	/etc/pbm2ppa.conf
.IP "\fB\fI/etc/pbm2ppa.conf\fR\fP"
Default configuration file
.\"}}}


.SH AUTHOR
This code is licensed under the GNU Public License version 2. See
LICENSE for details.
.PP
(c) 1998	Tim Norman
.PP
.SH HISTORY
This program was written by Tim Norman. It originally 
supported black and white output on the 820 series. This program is
almost obsolete; its successor pnm2ppa will support color printing.
.SH BUGS
This is a stable driver, but does not support color printing.