Penguin
Recent Changes
Annotated edit history of pbmtoppa(1) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 pbmtoppa
2 !!!pbmtoppa
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 CONFIGURATION FILES
7 EXAMPLES
8 CALIBRATION
9 REDHAT LINUX INSTALLATION
10 SEE ALSO
11 AUTHOR
12 ----
13 !!NAME
14
15
16 pbmtoppa - convert PBM image to HP Printer Performance Architecture (PPA)
17 !!SYNOPSIS
18
19
20 __pbmtoppa__
21
22
23 [[''pbm_file'' [[''ppa_file'']]
24 !!DESCRIPTION
25
26
27 __pbmtoppa__ converts page images in PBM format to
28 Hewlett Packard's PPA (Printer Performance Architecture)
29 format, which is the data stream format expected by some HP
30 __
31
32
33 ''pbm_file'' is the file specification of the input file
34 or __-__ for Standard Input. The default is Standard
35 Input.
36
37
38 The input file contains one or more PBM images, with each
39 one being a single page. Each image must have the exact
40 dimensions of a page (at 600 pixels per inch in both
41 directions). Significantly, this is the format the
42 Ghostscript produces.
43
44
45 ''ppa_file'' is the file specification of the output file
46 or __-__ for Standard Output. The default is Standard
47 Output.
48
49
50 To print Postscript on an HP PPA printer, just use
51 Ghostscript with the __pbmraw__ (or __pbm__) device
52 driver.
53
54
55 You can generate a test page for use with this program with
56 __pbmpage__.
57
58
59 You can also set up a printer filter so you can submit PBM
60 input directly to your print queue. See the documentation
61 for your print spooler for information on how to do that, or
62 look in hp820install.doc for an example lpd print filter for
63 Postscript and text files.
64
65
66 Sometimes, __pbmtoppa__ generates a file which the
67 printer will not print (because __pbmtoppa__'s input is
68 unprintable). When this happens, all three lights blink to
69 signal the error. This is usually because there is material
70 outside of the printer's printable area. To make the file
71 print, increase the margins via __pbmtoppa__ options or a
72 configuration file. See the CALIBRATION section
73 below.
74
75
76 __-v__ ''version''
77
78
79 printer version (720, 820, or 1000)
80
81
82 __-x__ ''xoff''
83
84
85 vertical offset adjustment in 1
86
87
88 __-y__ ''yoff''
89
90
91 horizontal offset adjustment in 1
92
93
94 __-t__ ''topmarg''
95
96
97 top margin in 1
98
99
100 __-l__ ''leftmarg''
101
102
103 left margin in 1
104
105
106 __-r__ ''rightmarg''
107
108
109 right margin in 1
110
111
112 __-b__ ''botmarg''
113
114
115 bottom margin in 1
116
117
118 __-s__ ''paper''
119
120
121 paper size: __us__ or __a4__. Default is
122 __us__.
123
124
125 __-f__ ''cfgfile''
126
127
128 read parameters from configuration file
129 ''cfgfile''
130
131
132 The __-x__ and __-y__ options accumulate.
133
134
135 The __-v__ option resets the horizontal and vertical
136 adjustments to an internal default.
137 !!CONFIGURATION FILES
138
139
140 You can use configuration files to specify parameters rather
141 than use invocation options. __pbmtoppa__ processes the
142 file /etc/pbmtoppa.conf, if it exists, before processing any
143 options. It then processes each configuration file named by
144 a __-f__ option in order, applying the parameters from
145 the configuration file as if they were invocation options
146 used in the place of the __-f__ option.
147
148
149 Configuration files have the following format:
150
151
152 __#__''Comment
153 key1 value1
154 key2 value2''
155 [[etc.]
156
157
158 Valid ''key''s are __version__, __xoffset__,
159 __yoffset__, __topmargin__, __leftmargin__,
160 __rightmargin__, __bottommargin__, __papersize__,
161 or any non-null prefix of these words. Valid values are the
162 same as with the corresponding invocation
163 parameters.
164 !!EXAMPLES
165
166
167 Print a test pattern:
168
169
170 __pbmpage | pbmppa __
171
172
173 Print three pages:
174
175
176 __cat page1.pbm page2.pbm page3.pbm | pbmppa
177 __
178
179
180 Print the Postscript file myfile.ps:
181
182
183 __gs -sDEVICE=rawpbm -q -dNOPAUSE -r600 \
184 -sOutputFile=- myfile.ps \
185 | pbmtoppa | lpr__
186 !!CALIBRATION
187
188
189 To be able to print successfully and properly, you need to
190 tell __pbmtoppa__ an X and a Y offset appropriate for
191 your printer to use when generating the page. You can
192 specify these offsets with the __-x__ and __-y__
193 invocation options or with the __xoff__ and __yoff__
194 parameters in a __pbmtoppa__ configuration
195 file.
196
197
198 To determine the correct offsets, use the __pbmpage__
199 program.
200
201
202 If while trying to do this calibration, the printer refuses
203 to print a page, but just blinks all three lights, specify
204 large margins (e.g. 600 pixels -- one inch) via
205 __pbmpage__ invocation options while doing the
206 calibration.
207
208
209 For example:
210
211
212 __pbmpage | pbmtoppa __
213 or__
214 pbmpage | pbmtoppa | lpr -l__
215 (if your printer filter recognizes the '-l' (direct output)
216 parameter).
217
218
219 In the test pattern, the grid is marked off in pixel
220 coordinate numbers. Unfortunately, these coordinates are
221 probably cut off before the edge of the paper. You'll have
222 to use a ruler to estimate the pixel coordinate of the left
223 and top edges of the actual sheet of paper (should be within
224 +/- 300, may be negative; there are 600 pixels per
225 inch).
226
227
228 Add these coordinates to the X and Y offsets by either
229 editing the configuration file or using the __-x__ and
230 __-y__ command-line parameters.
231
232
233 When __pbmtoppa__ is properly calibrated, the center mark
234 should be in the center of the paper. Also, the margins
235 should be able to be as small as 1/4 inch without causing
236 the printer to choke with 'blinking lights
237 syndrome'.
238 !!REDHAT LINUX INSTALLATION
239
240
2 perry 241 !RedHat users may find the following tip from Panayotis
1 perry 242 Vryonis
243
244
2 perry 245 Here is a tip to intergrate HP720C support in !RedHat's
1 perry 246 printtool:
247
248
249 Install pbm2ppa. Copy pbm2ppa to /usr/bin.
250
251
252 Edit
253
254
255 ----------------------Cut here-----------------------
2 perry 256 !StartEntry: DeskJet720C GSDriver: pbm Description: {HP
257 !DeskJet 720C} About: { \ This driver supports the HP !DeskJet
1 perry 258 720C \ inkjet printer. \ It does does not support color
259 printing. \ IMPORTANT! Insert \
260 Resolution: {600} {600} {}
2 perry 261 !EndEntry
1 perry 262 ----------------------------------------------------
263
264
265 Now you can add an HP720C printer just like any other, using
266 printtool.
267 !!SEE ALSO
268
269
270 pbmpage(1), pstopnm(1),
271 pbm(5)
272
273
274 __pnm2ppa__ is not part of Netpbm, but does the same
275 things as __pbmtoppa__ except it also works with color
276 and has lots more features. See
277 __
278
279
280 The file INSTALL-MORE in the pbmtoppa directory of the
281 Netpbm source code contains detailed instructions on setting
282 up a system to use pbmtoppa to allow convenient printing on
283 HP PPA printers. It was written by Michael
284 Buehlmann.
285
286
287 For information about the PPA protocol and the separately
288 distributed pbm2ppa program from which __pbmtoppa__ was
289 derived, see
290 __
291 !!AUTHOR
292
293
294 Tim Norman. Copyright (C) 1998. Licensed under GNU Public
295 License
296
297
298 Manual page by Bryan Henderson, May 2000.
299 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.