Debian Codegraph @

upstream/debian-unstable/man1/pnmtopclxl.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 "Pnmtopclxl User Manual" 1 "22 March 2011" "netpbm documentation"
7
8 .SH NAME
9 pnmtopclxl - convert a PNM image to an HP LaserJet PCL XL printer stream
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBpnmtopclxl\fP
15
16 {
17 [\fB-dpi=\fP\fIN\fP]
18 [\fB-xoffs=\fP\fIN\fP]
19 [\fB-yoffs=\fP\fIN\fP]
20 [\fB-center\fP]
21 [\fB-duplex=\fP{\fBvertical\fP|\fBhorizontal\fP}]
22 [\fB-format=\fP\fIpaperformat\fP]
23 [\fB-feeder=\fP\fIN\fP]
24 [\fB-copies=\fP\fIN\fP]
25 [\fB-rendergray\fP]
26 [\fB-jobsetup=\fP\fIfilename\fP]
27
28 |
29 \fB-embedded\fP
30
31 }
32 [\fB-colorok\fP]
33 \fIpnmfile1\fP \fIpnmfile2\fP ...
34 .PP
35 Minimum unique abbreviation of option is acceptable. You may use double
36 hyphens instead of single hyphen to denote options. You may use white
37 space in place of the equals sign to separate an option name from its value.
38
39
40 .UN description
41 .SH DESCRIPTION
42 .PP
43 This program is part of
44 .BR "Netpbm" (1)\c
45 \&.
46 .PP
47 \fBpnmtopclxl\fP reads one or more PNM input streams, each containing one
48 or more PNM images, and generates a sequence of output pages in the
49 HP PCL-XL (formerly named PCL 6) printer control language. You can send
50 this stream to a PCL-XL printer to print the images.
51 .PP
52 Alternatively, you can make \fBpnmtopclxl\fP generate just the PCL-XL
53 instructions to print an image, which you can embed in your own PCL-XL
54 stream to place an image on one of your pages. (\fB-embedded\fP option).
55 .PP
56 If the input is PPM, the output is a color printer stream (the PCL
57 color space is RGB). Otherwise, the output is grayscale (the PCL color space
58 is grayscale). If you want a grayscale output from a color input, run your
59 input through
60 .BR "ppmtopgm" (1)\c
61 \&. See the
62 \fB-colorok\fP option for more information about choosing between color
63 and grayscale.
64 .PP
65 The output goes to Standard Output. All of the pages go to one
66 file, concatenated in the same order as the input images.
67
68
69 .UN options
70 .SH OPTIONS
71 .PP
72 In addition to the options common to all programs based on libnetpbm
73 (most notably \fB-quiet\fP, see
74 .UR index.html#commonoptions
75 Common Options
76 .UE
77 \&), \fBpnmtopclxl\fP recognizes the following
78 command line options:
79
80
81
82 .TP
83 \fB-dpi=\fP\fIN\fP
84 This option selects the resolution of the image (not the printer!).
85 \fIN\fP is the resolution in dots per inch, from 1 to 65535. The default
86 is 300.
87
88 .TP
89 \fB-xoffs=\fP\fIN\fP
90 This option and \fB-yoffs\fP determine the location on the page of the
91 upper left corner of each image. Note that the image may have built in
92 borders too, which would make the main image within more left and down
93 that what you specify here.
94 .sp
95 \fB-xoffs\fP and \fB-yoffs\fP specify the distance from the left of the
96 page and from the top of the page, respectively, in inches, of the upper left
97 corner of the image. The default for each is zero.
98 .sp
99 These options are meaningless if you specify \fB-center\fP.
100
101 .TP
102 \fB-yoffs\fP \fIN\fP
103 See \fB-xoffs\fP.
104
105 .TP
106 \fB-center\fP
107 This option tells \fBpnmtopclxl\fP to center each image on the page.
108 If you don't specify this option, the position of an image on the page is
109 determined by \fB-xoffs\fP and \fB-yoffs\fP (or their defaults).
110
111 .TP
112 \fB-duplex=\fP{\fBvertical\fP|\fBhorizontal\fP}
113 This option
114 causes \fBpnmtopclxl\fP to create a printer stream that prints pages
115 on both sides of the sheet of paper. \fBvertical\fP means to print
116 them so that the left edge of both pages is on the same edge of the
117 sheet, while \fBhorizontal\fP means the more usual duplexing where the
118 top of both pages is on the same edge of the sheet.
119
120 .TP
121 \fB-format=\fP\fIpaperformat\fP
122 This option selects the media (e.g. paper size) that the printer
123 control stream specifies. \fIpaperformat\fP is one of the following
124 self-explanatory keywords:
125
126
127 .IP \(bu
128 letter
129 .IP \(bu
130 legal
131 .IP \(bu
132 a3
133 .IP \(bu
134 a4
135 .IP \(bu
136 a5
137 .IP \(bu
138 a6
139 .IP \(bu
140 jb4
141 .IP \(bu
142 jb5
143 .IP \(bu
144 jb6
145 .IP \(bu
146 exec
147 .IP \(bu
148 ledger
149 .IP \(bu
150 b5envelope
151 .IP \(bu
152 c5envelope
153 .IP \(bu
154 com10envelope
155 .IP \(bu
156 monarchenvelope
157 .IP \(bu
158 dlenvelope
159 .IP \(bu
160 jpostcard
161 .IP \(bu
162 jdoublepostcard
163
164 .sp
165 The default is \fBletter\fP.
166
167 .TP
168 \fB-feeder=\fP\fIN\fP
169 This options selects the media source (e.g. paper tray) that the
170 printer control stream specifies.
171
172 .TP
173 \fB-copies=\fP\fIN\fP
174 This option specifies the number of copies that the printer control
175 stream tells the printer to print.
176
177 .TP
178 \fB-rendergray\fP
179 This option causes \fBpnmtopclxl\fP to include in the output
180 stream a command to set the RENDERMODE environment variable to
181 GRAYSCALE, which typically causes the printer to print in grayscale
182 regardless of the colors in the input, and may cause it to run much
183 faster even if the image is grayscale anyway.
184 .sp
185 This option was new in Netpbm 10.29 (August 2005).
186
187 .TP
188 \fB-jobsetup=\fP\fIfilename\fP
189 This option causes \fBpnmtopclxl\fP to include arbitrary job setup
190 PJL commands at the beginning of the output stream. It reads them from
191 the named file.
192 .sp
193 \fBpnmtopclxl\fP does not inspect these commands in any way, but it
194 does expect them to be job setup commands. If you have garbage in your
195 file, you will hear from the printer.
196 .sp
197 This option was new in Netpbm 10.29 (August 2005).
198
199 .TP
200 \fB-colorok\fP
201 This option simply tells \fBpnmtopclxl\fP not to warn you if you supply
202 a color input and therefore get color output. By default, \fBpnmtopclxl\fP
203 issues a warning any time it produces a color printer stream because it is
204 usually a mistake. It's a mistake because PCL XL is mainly used for laser
205 printers, and laser printers are mainly black and white. If you send a color
206 print stream to a black and white printer, it typically refuses to print
207 anything, and even if it manages to convert it to black and white and print
208 it, it takes 3 times as long to transmit a color stream to the printer than
209 to transmit the grayscale image that gives the same result.
210
211 .TP
212 \fB-embedded\fP
213 Without this option, \fBpnmtopclxl\fP generates an entire printer control
214 stream that sets up the printer, ejects pages, and places a lone image on
215 each page. With the option, \fBpnmtopclxl\fP generates only the instructions
216 to generate the image itself. This is not useful all by itself, but you
217 can embed it in a suitable PCL-XL stream in order to add an image to it.
218 .sp
219 This makes sense only for a single image, so you cannot specify multiple
220 input files and if an input file has multiple images in it, \fBpnmtopclxl\fP
221 ignores any after the first (it won't even read them).
222 .sp
223 All the options that control the printer control stream outside the image
224 itself, such as \fB-xoffs\fP and \fB-feeder\fP are invalid
225 with \fB-embedded\fP.
226 .sp
227 This option was new in Netpbm 10.54 (March 2011).
228
229
230
231
232 .UN seealso
233 .SH SEE ALSO
234 .BR "\fBppmtolj\fP" (1)\c
235 \&,
236 .BR "\fBpbmtolj\fP" (1)\c
237 \&,
238 .BR "\fBppmtopj\fP" (1)\c
239 \&,
240 .BR "\fBppmtopjxl\fP" (1)\c
241 \&,
242 .BR "\fBthinkjettopbm\fP" (1)\c
243 \&,
244 .BR "\fBppm\fP" (1)\c
245 \&
246
247 .UN history
248 .SH HISTORY
249 .PP
250 \fBpnmtopclxl\fP was added to Netpbm in Release 10.6 (July 2002).
251 It was contributed by
252 \fIJochen Karrer\fP.
253 .SH DOCUMENT SOURCE
254 This manual page was generated by the Netpbm tool 'makeman' from HTML
255 source. The master documentation is at
256 .IP
257 .B http://netpbm.sourceforge.net/doc/pnmtopclxl.html
258 .PP