1Pnmtopclxl User Manual(0) Pnmtopclxl User Manual(0)
2
6 pnmtopclxl - convert a PNM image to an HP LaserJet PCL XL printer
7 stream
8
11 pnmtopclxl
12 { [-dpi=N] [-xoffs=N] [-yoffs=N] [-center] [-duplex={vertical|horizon‐
14 tal}] [-format=paperformat] [-feeder=N] [-copies=N] [-rendergray]
15 [-jobsetup=filename]
16 | -embedded
18 } [-colorok] pnmfile1 pnmfile2 ...
20 Minimum unique abbreviation of option is acceptable. You may use dou‐
22 ble hyphens instead of single hyphen to denote options. You may use
23 white space in place of the equals sign to separate an option name from
24 its value.
25
29 This program is part of Netpbm(1).
30 pnmtopclxl reads one or more PNM input streams, each containing one or
32 more PNM images, and generates a sequence of output pages in the HP
33 PCL-XL (formerly named PCL 6) printer control language. You can send
34 this stream to a PCL-XL printer to print the images.
35 Alternatively, you can make pnmtopclxl generate just the PCL-XL
37 instructions to print an image, which you can embed in your own PCL-XL
38 stream to place an image on one of your pages. (-embedded option).
39 If the input is PPM, the output is a color printer stream (the PCL
41 color space is RGB). Otherwise, the output is grayscale (the PCL color
42 space is grayscale). If you want a grayscale output from a color
43 input, run your input through ppmtopgm(1). See the -colorok option for
44 more information about choosing between color and grayscale.
45 The output goes to Standard Output. All of the pages go to one file,
47 concatenated in the same order as the input images.
48
52 In addition to the options common to all programs based on libnetpbm
53 (most notably -quiet, see
54 Common Options ⟨index.html#commonoptions⟩ ), pnmtopclxl recognizes the
55 following command line options:
56 -dpi=N This option selects the resolution of the image (not the
61 printer!). N is the resolution in dots per inch, from 1 to
62 65535. The default is 300.
63 -xoffs=N
66 This option and -yoffs determine the location on the page of the
67 upper left corner of each image. Note that the image may have
68 built in borders too, which would make the main image within
69 more left and down that what you specify here.
70 -xoffs and -yoffs specify the distance from the left of the page
72 and from the top of the page, respectively, in inches, of the
73 upper left corner of the image. The default for each is zero.
74 These options are meaningless if you specify -center.
76 -yoffs N
79 See -xoffs.
80 -center
83 This option tells pnmtopclxl to center each image on the page.
84 If you don't specify this option, the position of an image on
85 the page is determined by -xoffs and -yoffs (or their defaults).
86 -duplex={vertical|horizontal}
89 This option causes pnmtopclxl to create a printer stream that
90 prints pages on both sides of the sheet of paper. vertical
91 means to print them so that the left edge of both pages is on
92 the same edge of the sheet, while horizontal means the more
93 usual duplexing where the top of both pages is on the same edge
94 of the sheet.
95 -format=paperformat
98 This option selects the media (e.g. paper size) that the printer
99 control stream specifies. paperformat is one of the following
100 self-explanatory keywords:
101 · letter
105 · legal
107 · a3
109 · a4
111 · a5
113 · a6
115 · jb4
117 · jb5
119 · jb6
121 · exec
123 · ledger
125 · b5envelope
127 · c5envelope
129 · com10envelope
131 · monarchenvelope
133 · dlenvelope
135 · jpostcard
137 · jdoublepostcard
139 The default is letter.
142 -feeder=N
145 This options selects the media source (e.g. paper tray) that the
146 printer control stream specifies.
147 -copies=N
150 This option specifies the number of copies that the printer con‐
151 trol stream tells the printer to print.
152 -rendergray
155 This option causes pnmtopclxl to include in the output stream a
156 command to set the RENDERMODE environment variable to GRAYSCALE,
157 which typically causes the printer to print in grayscale regard‐
158 less of the colors in the input, and may cause it to run much
159 faster even if the image is grayscale anyway.
160 This option was new in Netpbm 10.29 (August 2005).
162 -jobsetup=filename
165 This option causes pnmtopclxl to include arbitrary job setup PJL
166 commands at the beginning of the output stream. It reads them
167 from the named file.
168 pnmtopclxl does not inspect these commands in any way, but it
170 does expect them to be job setup commands. If you have garbage
171 in your file, you will hear from the printer.
172 This option was new in Netpbm 10.29 (August 2005).
174 -colorok
177 This option simply tells pnmtopclxl not to warn you if you sup‐
178 ply a color input and therefore get color output. By default,
179 pnmtopclxl issues a warning any time it produces a color printer
180 stream because it is usually a mistake. It's a mistake because
181 PCL XL is mainly used for laser printers, and laser printers are
182 mainly black and white. If you send a color print stream to a
183 black and white printer, it typically refuses to print anything,
184 and even if it manages to convert it to black and white and
185 print it, it takes 3 times as long to transmit a color stream to
186 the printer than to transmit the grayscale image that gives the
187 same result.
188 -embedded
191 Without this option, pnmtopclxl generates an entire printer con‐
192 trol stream that sets up the printer, ejects pages, and places a
193 lone image on each page. With the option, pnmtopclxl generates
194 only the instructions to generate the image itself. This is not
195 useful all by itself, but you can embed it in a suitable PCL-XL
196 stream in order to add an image to it.
197 This makes sense only for a single image, so you cannot specify
199 multiple input files and if an input file has multiple images in
200 it, pnmtopclxl ignores any after the first (it won't even read
201 them).
202 All the options that control the printer control stream outside
204 the image itself, such as -xoffs and -feeder are invalid with
205 -embedded.
206 This option was new in Netpbm 10.54 (March 2011).
208
214 ppmtolj(1), pbmtolj(1), ppmtopj(1), ppmtopjxl(1), thinkjettopbm(1),
215 ppm(1)
216
219 pnmtopclxl was added to Netpbm in Release 10.6 (July 2002). It was
220 contributed by Jochen Karrer.
221
223 This manual page was generated by the Netpbm tool 'makeman' from HTML
224 source. The master documentation is at
225 http://netpbm.sourceforge.net/doc/pnmtopclxl.html
227netpbm documentation 22 March 2011 Pnmtopclxl User Manual(0)