| 1 |
\ |
| 2 |
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source. |
| 3 |
.\" Do not hand-hack it! If you have bug fixes or improvements, please find |
| 4 |
.\" the corresponding HTML page on the Netpbm website, generate a patch |
| 5 |
.\" against that, and send it to the Netpbm maintainer. |
| 6 |
.TH "Pbmtoppa User Manual" 1 "01 May 2005" "netpbm documentation" |
| 7 |
|
| 8 |
.SH NAME |
| 9 |
pbmtoppa - convert PBM image to HP Printer Performance Architecture (PPA) |
| 10 |
|
| 11 |
.UN synopsis |
| 12 |
.SH SYNOPSIS |
| 13 |
|
| 14 |
\fBpbmtoppa\fP |
| 15 |
[\fIpbm_file\fP |
| 16 |
[\fIppa_file\fP]] |
| 17 |
|
| 18 |
.UN description |
| 19 |
.SH DESCRIPTION |
| 20 |
.PP |
| 21 |
This program is part of |
| 22 |
.BR "Netpbm" (1)\c |
| 23 |
\&. |
| 24 |
|
| 25 |
\fBpbmtoppa\fP converts page images in PBM format to Hewlett |
| 26 |
Packard's PPA (Printer Performance Architecture) format, which is the |
| 27 |
data stream format expected by some HP "Windows-only" |
| 28 |
printers including the HP Deskjet 820C series, the HP DeskJet 720 |
| 29 |
series, and the HP DeskJet 1000 series. |
| 30 |
.PP |
| 31 |
\fIpbm_file\fP is the file specification of the input file or |
| 32 |
\fB-\fP for Standard Input. The default is Standard Input. |
| 33 |
.PP |
| 34 |
The input file contains one or more PBM images, with each one |
| 35 |
being a single page. Each image must have the exact dimensions of a |
| 36 |
page (at 600 pixels per inch in both directions). Significantly, this |
| 37 |
is the format that Ghostscript produces. |
| 38 |
.PP |
| 39 |
\fIppa_file\fP is the file specification of the output file or |
| 40 |
\fB-\fP for Standard Output. The default is Standard Output. |
| 41 |
.PP |
| 42 |
To print Postscript on an HP PPA printer, just use Ghostscript with |
| 43 |
the \fBpbmraw\fP (or \fBpbm\fP) device driver. |
| 44 |
.PP |
| 45 |
You can generate a test page for use with this program with |
| 46 |
\fBpbmpage\fP. |
| 47 |
.PP |
| 48 |
You can also set up a printer filter so you can submit PBM input |
| 49 |
directly to your print queue. See the documentation for your print |
| 50 |
spooler for information on how to do that, or look in hp820install.doc |
| 51 |
for an example lpd print filter for Postscript and text files. |
| 52 |
.PP |
| 53 |
Sometimes, \fBpbmtoppa\fP generates a file which the printer will |
| 54 |
not print (because \fBpbmtoppa\fP's input is unprintable). When this |
| 55 |
happens, all three lights blink to signal the error. This is usually |
| 56 |
because there is material outside of the printer's printable area. To |
| 57 |
make the file print, increase the margins via \fBpbmtoppa\fP options |
| 58 |
or a configuration file. See |
| 59 |
.UR #calibration |
| 60 |
the section on calibration |
| 61 |
.UE |
| 62 |
\& below. |
| 63 |
|
| 64 |
.SS About PPA |
| 65 |
.PP |
| 66 |
The PPA printer language is a far lower level language than most. |
| 67 |
When you use a PPA printer, most of the processing that a conventional |
| 68 |
printer does is done instead on the computer end of the wire. In |
| 69 |
particular, \fBpbmtoppa\fP has to do "swath cutting," and |
| 70 |
"sweep formatting," which other printers do themselves. |
| 71 |
There is very little intelligence inside a PPA printer; |
| 72 |
\fBpbmtoppa\fP generates direct controls for the printer's hardware. |
| 73 |
.PP |
| 74 |
The design goal of PPA was to reduce the cost of a printer by exploiting |
| 75 |
computing resources already present in the computer that requests the |
| 76 |
printing. CPU power, ROM, and RAM requirements inside the printer are all |
| 77 |
reduced compared to a conventional printer. |
| 78 |
.PP |
| 79 |
PPA was new in 1997. It was preceded by Hewlett Packard's PCL |
| 80 |
(Printer Control Language) language. HP manufactured PPA printers for only |
| 81 |
a few years, and no one else ever did. |
| 82 |
|
| 83 |
.UN options |
| 84 |
.SH OPTIONS |
| 85 |
.PP |
| 86 |
In addition to the options common to all programs based on libnetpbm |
| 87 |
(most notably \fB-quiet\fP, see |
| 88 |
.UR index.html#commonoptions |
| 89 |
Common Options |
| 90 |
.UE |
| 91 |
\&), \fBpbmtoppa\fP recognizes the following |
| 92 |
command line options: |
| 93 |
|
| 94 |
|
| 95 |
.TP |
| 96 |
\fB-v\fP \fIversion\fP |
| 97 |
printer version (720, 820, or 1000) |
| 98 |
|
| 99 |
.TP |
| 100 |
\fB-x\fP \fIxoff\fP |
| 101 |
horizontal offset adjustment in 1/600 inches. |
| 102 |
|
| 103 |
.TP |
| 104 |
\fB-y\fP \fIyoff\fP |
| 105 |
vertical offset adjustment in 1/600 inches. |
| 106 |
|
| 107 |
.TP |
| 108 |
\fB-t\fP \fItopmarg\fP |
| 109 |
top margin in 1/600 inches (default: 150 = 0.25 inch) |
| 110 |
|
| 111 |
.TP |
| 112 |
\fB-l\fP \fIleftmarg\fP |
| 113 |
left margin in 1/600 inches (default: 150 = 0.25 inch) |
| 114 |
|
| 115 |
.TP |
| 116 |
\fB-r\fP \fIrightmarg\fP |
| 117 |
right margin in 1/600 inches (default: 150 = 0.25 inch) |
| 118 |
|
| 119 |
.TP |
| 120 |
\fB-b\fP \fIbotmarg\fP |
| 121 |
bottom margin in 1/600 inches (default: 150 = 0.25 inch) |
| 122 |
|
| 123 |
.TP |
| 124 |
\fB-s\fP \fIpaper\fP |
| 125 |
paper size: \fBus\fP or \fBa4\fP. Default is \fBus\fP. |
| 126 |
|
| 127 |
.TP |
| 128 |
\fB-d\fP \fIdpi\fP |
| 129 |
Print resolution in dots per inch. |
| 130 |
|
| 131 |
.TP |
| 132 |
\fB-f\fP \fIcfgfile\fP |
| 133 |
Read parameters from the configuration file named \fIcfgfile\fP. |
| 134 |
See |
| 135 |
.UR #configfile |
| 136 |
CONFIGURATION FILES |
| 137 |
.UE |
| 138 |
\& |
| 139 |
|
| 140 |
|
| 141 |
.PP |
| 142 |
The offset adjustments you specify with \fB-x\fP and \fB-y\fP |
| 143 |
accumulate. I.e. if you specify them multiple times, the total offset |
| 144 |
adjustment is the sum of the adjustments you specify. \fB-x 60 -x 120\fP |
| 145 |
is the same as \fB-x 180\fP. |
| 146 |
.PP |
| 147 |
The \fB-v\fP option undoes any preceding \fB-x\fP and \fB-y\fP |
| 148 |
options, leaving the horizontal and vertical adjustments their |
| 149 |
default values. |
| 150 |
|
| 151 |
|
| 152 |
.UN configfile |
| 153 |
.SH CONFIGURATION FILES |
| 154 |
.PP |
| 155 |
You can use a configuration file to specify parameters rather than |
| 156 |
use invocation options. \fBpbmtoppa\fP processes the file |
| 157 |
\fB/etc/pbmtoppa.conf\fP, if it exists, before processing any |
| 158 |
options. It then processes each configuration file named by a |
| 159 |
\fB-f\fP option in order, applying the parameters from the |
| 160 |
configuration file as if they were invocation options used in the |
| 161 |
place of the \fB-f\fP option. |
| 162 |
.PP |
| 163 |
Configuration files have the following format: |
| 164 |
|
| 165 |
.nf |
| 166 |
\fB#\fP\fIComment\fP |
| 167 |
\fIkey1\fP \fIvalue1\fP |
| 168 |
\fIkey2\fP \fIvalue2\fP |
| 169 |
[etc.] |
| 170 |
|
| 171 |
.fi |
| 172 |
.PP |
| 173 |
Valid \fIkey\fPs are \fBversion\fP, \fBxoffset\fP, |
| 174 |
\fByoffset\fP, \fBtopmargin\fP, \fBleftmargin\fP, |
| 175 |
\fBrightmargin\fP, \fBbottommargin\fP, \fBpapersize\fP, or any |
| 176 |
non-null prefix of these words. Valid values are the same as with the |
| 177 |
corresponding invocation parameters. |
| 178 |
|
| 179 |
.UN examples |
| 180 |
.SH EXAMPLES |
| 181 |
.PP |
| 182 |
Print a test pattern: |
| 183 |
.nf |
| 184 |
\fBpbmpage | pbmppa >/dev/lp1\fP |
| 185 |
|
| 186 |
.fi |
| 187 |
.PP |
| 188 |
Print three pages: |
| 189 |
.nf |
| 190 |
\fBcat page1.pbm page2.pbm page3.pbm | pbmppa >/dev/lp1\fP |
| 191 |
|
| 192 |
.fi |
| 193 |
.PP |
| 194 |
Print the Postscript file myfile.ps: |
| 195 |
.nf |
| 196 |
gs -sDEVICE=rawpbm -q -dNOPAUSE -r600 \e |
| 197 |
-sOutputFile=- myfile.ps ;\e |
| 198 |
| pbmtoppa | lpr |
| 199 |
|
| 200 |
.fi |
| 201 |
|
| 202 |
.UN calibration |
| 203 |
.SH CALIBRATION |
| 204 |
.PP |
| 205 |
To be able to print successfully and properly, you need to tell |
| 206 |
\fBpbmtoppa\fP an X and a Y offset appropriate for your printer to |
| 207 |
use when generating the page. You can specify these offsets with the |
| 208 |
\fB-x\fP and \fB-y\fP invocation options or with the \fBxoff\fP and |
| 209 |
\fByoff\fP parameters in a \fBpbmtoppa\fP configuration file. |
| 210 |
.PP |
| 211 |
To determine the correct offsets, use the \fBpbmpage\fP program. |
| 212 |
.PP |
| 213 |
If while trying to do this calibration, the printer refuses to |
| 214 |
print a page, but just blinks all three lights, specify large margins |
| 215 |
(e.g. 600 pixels -- one inch) via \fBpbmpage\fP invocation options |
| 216 |
while doing the calibration. |
| 217 |
.PP |
| 218 |
For example: |
| 219 |
.nf |
| 220 |
\fBpbmpage | pbmtoppa >/dev/lp1\fP |
| 221 |
|
| 222 |
.fi |
| 223 |
or |
| 224 |
.nf |
| 225 |
\fBpbmpage | pbmtoppa | lpr -l\fP |
| 226 |
|
| 227 |
.fi |
| 228 |
|
| 229 |
(if your printer filter recognizes the '-l' (direct output) parameter). |
| 230 |
.PP |
| 231 |
In the test pattern, the grid is marked off in pixel coordinate |
| 232 |
numbers. Unfortunately, these coordinates are probably cut off before |
| 233 |
the edge of the paper. You'll have to use a ruler to estimate the |
| 234 |
pixel coordinate of the left and top edges of the actual sheet of |
| 235 |
paper (should be within +/- 300, may be negative; there are 600 pixels |
| 236 |
per inch). |
| 237 |
.PP |
| 238 |
Add these coordinates to the X and Y offsets by either editing the |
| 239 |
configuration file or using the \fB-x \fP and \fB-y\fP command-line |
| 240 |
parameters. |
| 241 |
.PP |
| 242 |
When \fBpbmtoppa\fP is properly calibrated, the center mark should |
| 243 |
be in the center of the paper. Also, the margins should be able to be |
| 244 |
as small as 1/4 inch without causing the printer to choke with |
| 245 |
\&'blinking lights syndrome'. |
| 246 |
|
| 247 |
.UN redhat |
| 248 |
.SH RED HAT LINUX INSTALLATION |
| 249 |
.PP |
| 250 |
RedHat users may find the following tip from Panayotis Vryonis |
| 251 |
<\[email protected]\fP> helpful. The |
| 252 |
same should work for the 820 and 1000, but it hasn't been tested. |
| 253 |
Also, use the pbmraw GSDriver if you have it; it's faster. |
| 254 |
.PP |
| 255 |
Here is a tip to integrate HP720C capability in RedHat's printtool: |
| 256 |
.PP |
| 257 |
Install pbmtoppa. Copy pbmtoppa to /usr/bin. |
| 258 |
.PP |
| 259 |
Edit "printerdb" (in my system it is found in |
| 260 |
/usr/lib/rhs/rhs-printfilters ) and append the following lines: |
| 261 |
|
| 262 |
.nf |
| 263 |
\f(CW |
| 264 |
|
| 265 |
----------------------Cut here----------------------- |
| 266 |
|
| 267 |
StartEntry: DeskJet720C |
| 268 |
GSDriver: pbm |
| 269 |
Description:\ {HP\ DeskJet\ 720C} |
| 270 |
About: { \e |
| 271 |
This driver drives the HP DeskJet 720C \e |
| 272 |
inkjet printer. \e |
| 273 |
It cannot do color printing. \e |
| 274 |
IMPORTANT! Insert \e |
| 275 |
"- | pbm2ppa -" \e |
| 276 |
in the "Extra GS Options " field.\e |
| 277 |
} |
| 278 |
|
| 279 |
Resolution: {600} {600} {} |
| 280 |
|
| 281 |
EndEntry |
| 282 |
---------------------------------------------------- |
| 283 |
\fP |
| 284 |
|
| 285 |
.fi |
| 286 |
.PP |
| 287 |
Now you can add an HP720C printer just like any other, using |
| 288 |
printtool. |
| 289 |
|
| 290 |
.UN seealso |
| 291 |
.SH SEE ALSO |
| 292 |
.BR "pbmpage" (1)\c |
| 293 |
\&, |
| 294 |
.BR "pstopnm" (1)\c |
| 295 |
\&, |
| 296 |
.BR "pbm" (1)\c |
| 297 |
\& |
| 298 |
.PP |
| 299 |
This program was derived from \fBpbm2ppa\fP. \fBpbm2ppa\fP is obsolete |
| 300 |
and has been replaced by \fBpnm2ppa\fP, which does the same things as |
| 301 |
\fBpbmtoppa\fP except it also works with color and has lots more features. See |
| 302 |
.UR http://pnm2ppa.sourceforge.net |
| 303 |
http://pnm2ppa.sourceforge.net |
| 304 |
.UE |
| 305 |
\& |
| 306 |
for more information about the PPA protocol and the separately distributed |
| 307 |
\fBpnm2ppa\fP program. |
| 308 |
.PP |
| 309 |
The file INSTALL-MORE in the pbmtoppa directory of the Netpbm |
| 310 |
source code contains detailed instructions on setting up a system to |
| 311 |
use pbmtoppa to allow convenient printing on HP PPA printers. It was |
| 312 |
written by Michael Buehlmann. |
| 313 |
|
| 314 |
.UN author |
| 315 |
.SH AUTHOR |
| 316 |
.PP |
| 317 |
Tim Norman. Copyright (C) 1998. Licensed under GNU General Public License |
| 318 |
.PP |
| 319 |
Manual page by Bryan Henderson, May 2000. |
| 320 |
.SH DOCUMENT SOURCE |
| 321 |
This manual page was generated by the Netpbm tool 'makeman' from HTML |
| 322 |
source. The master documentation is at |
| 323 |
.IP |
| 324 |
.B http://netpbm.sourceforge.net/doc/pbmtoppa.html |
| 325 |
.PP |