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 [-dpi N] [-xoffs N] [-yoffs N] [-center] [-duplex {verti‐
12 cal|horizontal}] [-format paperformat] [-feeder N] [-copies N] [-col‐
13 orok] [-rendergray] [-jobsetup=filename] pnmfile1 pnmfile2 ...
14
18 This program is part of Netpbm(1).
19 pnmtopclxl reads one or more PNM input streams, each containing one or
21 more PNM images, and generates a sequence of output pages in the HP
22 PCL-XL (formerly named PCL 6) printer control language. You can send
23 this stream to a PCL-XL printer to print the images.
24 If the input is PPM, the output is a color printer stream (the PCL
26 color space is RGB). Otherwise, the output is grayscale (the PCL color
27 space is grayscale). If you want a grayscale output from a color
28 input, run your input through ppmtopgm(1).Seethe -colorok option for
29 more information about choosing between color and grayscale.
30 The output goes to Standard Output. All of the pages go to one file,
32 concatenated in the same order as the input images.
33
37 -dpi N This option selects the resolution of the image (not the
38 printer!). N is the resolution in dots per inch, from 1 to
39 65535. The default is 300.
40 -xoffs N
43 This option and -yoffs determine the location on the page of the
44 upper left corner of each image. Note that the image may have
45 built in borders tool, which would make the main image within
46 more left and down that what you specify here.
47 -xoffs and -yoffs specify the distance from the left of the page
49 and from the top of the page, respectively, in inches, of the
50 upper left corner of the image. The default for each is zero.
51 These options are meaningless if you specify -center.
53 -yoffs N
56 See -xoffs.
57 -center
60 This option tells pnmtopclxl to center each image on the page.
61 If you don't specify this option, the position of an image on
62 the page is determined by -xoffs and -yoffs (or their defaults).
63 -duplex {vertical|horizontal}
66 This option causes pnmtopclxl to create a printer stream that
67 prints pages on boths sides of the sheet of paper. vertical
68 means to print them so that the left edge of both pages is on
69 the same edge of the sheet, while horizontal means the more
70 usual duplexing where the top of both pages is on the same edge
71 of the sheet.
72 -format paperformat
75 This option selects the media (e.g. paper size) that the printer
76 control stream specifies. paperformat is one of the following
77 self-explanatory keywords:
78 · letter
82 · legal
84 · a3
86 · a4
88 · a5
90 · a6
92 · jb4
94 · jb5
96 · jb6
98 · exec
100 · ledger
102 · b5envelope
104 · c5envelope
106 · com10envelope
108 · monarchenvelope
110 · dlenvelope
112 · jpostcard
114 · jdoublepostcard
116 The default is "letter".
119 -feeder N
122 This options selects the media source (e.g. paper tray) that the
123 printer control stream specifies.
124 -copies N
127 This option specifies the number of copies that the printer con‐
128 trol stream tells the printer to print.
129 -colorok
132 This option simply tells pnmtopclxl not to warn you if you sup‐
133 ply a color input and therefore get color output. By default,
134 pnmtopclxl issues a warning any time it produces a color printer
135 stream because it is usually a mistake. It's a mistake because
136 PCL XL is mainly used for laser printers, and laser printers are
137 mainly black and white. If you send a color print stream to a
138 black and white printer, it typically refuses to print anything,
139 and even if it manages to convert it to black and white and
140 print it, it takes 3 times as long to transmit a color stream to
141 the printer than to transmit the grayscale image that gives the
142 same result.
143 -rendergray
146 This option causes pnmtopclxl to include in the output stream a
147 command to set the RENDERMODE environment variable to GRAYSCALE,
148 which typically causes the printer to print in grayscale regard‐
149 less of the colors in the input, and may cause it to run much
150 faster even if the image is grayscale anyway.
151 This option was new in Netpbm 10.29 (August 2005).
153 -jobsetup=filename
156 This option causes pnmtopclxl to include arbitary job setup PJL
157 commands at the beginning of the output stream. It reads them
158 from the named file.
159 pnmtopclxl does not inspect these commands in any way, but it
161 does expect them to be job setup commands. If you have garbage
162 in your file, you will hear from the printer.
163 This option was new in Netpbm 10.29 (August 2005).
165
171 ppmtolj(1), pbmtolj(1), ppmtopj(1), ppmtopjxl(1), thinkjettopbm(1),
172 ppm(1)
173
176 pnmtopclxl was added to Netpbm in Release 10.6 (July 2002). It was
177 contributed by Jochen Karrer.
178netpbm documentation 20 July 2005 Pnmtopclxl User Manual(0)