Debian Codegraph @

upstream/debian-unstable/man1/pbmtoppa.1

raw
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