1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN">
<html><head><title>Pnmtopclxl User Manual</title></head>
<body>
<h1>pnmtopclxl</h1>
Updated: 22 March 2011
<a href="#index">Table Of Contents</a>
<h2>NAME</h2>
pnmtopclxl - convert a PNM image to an HP LaserJet PCL XL printer stream
<h2 id="synopsis">SYNOPSIS</h2>
<b>pnmtopclxl</b>
<br>{<br>
[<b>-dpi=</b><i>N</i>]
[<b>-xoffs=</b><i>N</i>]
[<b>-yoffs=</b><i>N</i>]
[<b>-center</b>]
[<b>-duplex=</b>{<b>vertical</b>|<b>horizontal</b>}]
[<b>-format=</b><i>paperformat</i>]
[<b>-feeder=</b><i>N</i>]
[<b>-copies=</b><i>N</i>]
[<b>-rendergray</b>]
[<b>-jobsetup=</b><i>filename</i>]
<br>|<br>
<b>-embedded</b>
<br>}<br>
[<b>-colorok</b>]
<i>pnmfile1</i> <i>pnmfile2</i> ...
<p>Minimum unique abbreviation of option is acceptable. You may use double
hyphens instead of single hyphen to denote options. You may use white
space in place of the equals sign to separate an option name from its value.
<h2 id="description">DESCRIPTION</h2>
<p>This program is part of <a href="index.html">Netpbm</a>.
<p><b>pnmtopclxl</b> reads one or more PNM input streams, each containing one
or more PNM images, and generates a sequence of output pages in the
HP PCL-XL (formerly named PCL 6) printer control language. You can send
this stream to a PCL-XL printer to print the images.
<p>Alternatively, you can make <b>pnmtopclxl</b> generate just the PCL-XL
instructions to print an image, which you can embed in your own PCL-XL
stream to place an image on one of your pages. (<b>-embedded</b> option).
<p>If the input is PPM, the output is a color printer stream (the PCL
color space is RGB). Otherwise, the output is grayscale (the PCL color space
is grayscale). If you want a grayscale output from a color input, run your
input through <b><a href="ppmtopgm.html">ppmtopgm</a></b>. See the
<b>-colorok</b> option for more information about choosing between color
and grayscale.
<p>The output goes to Standard Output. All of the pages go to one
file, concatenated in the same order as the input images.
<h2 id="options">OPTIONS</h2>
<p>In addition to the options common to all programs based on libnetpbm
(most notably <b>-quiet</b>, see <a href="index.html#commonoptions">
Common Options</a>), <b>pnmtopclxl</b> recognizes the following
command line options:
<dl compact>
<dt><b>-dpi=</b><i>N</i>
<dd>This option selects the resolution of the image (not the printer!).
<i>N</i> is the resolution in dots per inch, from 1 to 65535. The default
is 300.
<dt><b>-xoffs=</b><i>N</i>
<dd>This option and <b>-yoffs</b> determine the location on the page of the
upper left corner of each image. Note that the image may have built in
borders too, which would make the main image within more left and down
that what you specify here.
<p><b>-xoffs</b> and <b>-yoffs</b> specify the distance from the left of the
page and from the top of the page, respectively, in inches, of the upper left
corner of the image. The default for each is zero.
<p>These options are meaningless if you specify <b>-center</b>.
<dt><b>-yoffs</b> <i>N</i>
<dd>See <b>-xoffs</b>.
<dt><b>-center</b>
<dd>This option tells <b>pnmtopclxl</b> to center each image on the page.
If you don't specify this option, the position of an image on the page is
determined by <b>-xoffs</b> and <b>-yoffs</b> (or their defaults).
<dt><b>-duplex=</b>{<b>vertical</b>|<b>horizontal</b>} <dd>This option
causes <b>pnmtopclxl</b> to create a printer stream that prints pages
on both sides of the sheet of paper. <b>vertical</b> means to print
them so that the left edge of both pages is on the same edge of the
sheet, while <b>horizontal</b> means the more usual duplexing where the
top of both pages is on the same edge of the sheet.
<dt><b>-format=</b><i>paperformat</i>
<dd>This option selects the media (e.g. paper size) that the printer
control stream specifies. <i>paperformat</i> is one of the following
self-explanatory keywords:
<ul>
<li>letter
<li>legal
<li>a3
<li>a4
<li>a5
<li>a6
<li>jb4
<li>jb5
<li>jb6
<li>exec
<li>ledger
<li>b5envelope
<li>c5envelope
<li>com10envelope
<li>monarchenvelope
<li>dlenvelope
<li>jpostcard
<li>jdoublepostcard
</ul>
<p>The default is <b>letter</b>.
<dt><b>-feeder=</b><i>N</i>
<dd>This options selects the media source (e.g. paper tray) that the
printer control stream specifies.
<dt><b>-copies=</b><i>N</i>
<dd>This option specifies the number of copies that the printer control
stream tells the printer to print.
<dt><b>-rendergray</b>
<dd>This option causes <b>pnmtopclxl</b> to include in the output
stream a command to set the RENDERMODE environment variable to
GRAYSCALE, which typically causes the printer to print in grayscale
regardless of the colors in the input, and may cause it to run much
faster even if the image is grayscale anyway.
<p>This option was new in Netpbm 10.29 (August 2005).
<dt><b>-jobsetup=</b><i>filename</i>
<dd>This option causes <b>pnmtopclxl</b> to include arbitrary job setup
PJL commands at the beginning of the output stream. It reads them from
the named file.
<p><b>pnmtopclxl</b> does not inspect these commands in any way, but it
does expect them to be job setup commands. If you have garbage in your
file, you will hear from the printer.
<p>This option was new in Netpbm 10.29 (August 2005).
<dt><b>-colorok</b>
<dd>This option simply tells <b>pnmtopclxl</b> not to warn you if you supply
a color input and therefore get color output. By default, <b>pnmtopclxl</b>
issues a warning any time it produces a color printer stream because it is
usually a mistake. It's a mistake because PCL XL is mainly used for laser
printers, and laser printers are mainly black and white. If you send a color
print stream to a black and white printer, it typically refuses to print
anything, and even if it manages to convert it to black and white and print
it, it takes 3 times as long to transmit a color stream to the printer than
to transmit the grayscale image that gives the same result.
<dt><b>-embedded</b>
<dd>
Without this option, <b>pnmtopclxl</b> generates an entire printer control
stream that sets up the printer, ejects pages, and places a lone image on
each page. With the option, <b>pnmtopclxl</b> generates only the instructions
to generate the image itself. This is not useful all by itself, but you
can embed it in a suitable PCL-XL stream in order to add an image to it.
<p>This makes sense only for a single image, so you cannot specify multiple
input files and if an input file has multiple images in it, <b>pnmtopclxl</b>
ignores any after the first (it won't even read them).
<p>All the options that control the printer control stream outside the image
itself, such as <b>-xoffs</b> and <b>-feeder</b> are invalid
with <b>-embedded</b>.
<p>This option was new in Netpbm 10.54 (March 2011).
</dl>
<h2 id="seealso">SEE ALSO</h2>
<a href="ppmtolj.html"><b>ppmtolj</b></a>,
<a href="pbmtolj.html"><b>pbmtolj</b></a>,
<a href="ppmtopj.html"><b>ppmtopj</b></a>,
<a href="ppmtopjxl.html"><b>ppmtopjxl</b></a>,
<a href="thinkjettopbm.html"><b>thinkjettopbm</b></a>,
<a href="ppm.html"><b>ppm</b></a>
<h2 id="history">HISTORY</h2>
<p><b>pnmtopclxl</b> was added to Netpbm in Release 10.6 (July 2002).
It was contributed by
<a href="mailto:cip307@cip.physik.uni-wuerzburg.de">Jochen Karrer</a>.
<hr>
<h2 id="index">Table Of Contents</h2>
<ul>
<li><a href="#synopsis">SYNOPSIS</a>
<li><a href="#description">DESCRIPTION</a>
<li><a href="#options">OPTIONS</a>
<li><a href="#seealso">SEE ALSO</a>
<li><a href="#history">HISTORY</a>
</ul>
</body>
</html>
|
