1Pnmtopclxl User Manual(0)                            Pnmtopclxl User Manual(0)
2
3
4

NAME

6       pnmtopclxl  -  convert  a  PNM  image  to an HP LaserJet PCL XL printer
7       stream
8
9

SYNOPSIS

11       pnmtopclxl
12
13       { [-dpi=N] [-xoffs=N] [-yoffs=N] [-center]  [-duplex={vertical|horizon‐
14       tal}]   [-format=paperformat]   [-feeder=N]  [-copies=N]  [-rendergray]
15       [-jobsetup=filename]
16
17       | -embedded
18
19       } [-colorok] pnmfile1 pnmfile2 ...
20
21       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
26
27

DESCRIPTION

29       This program is part of Netpbm(1).
30
31       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
36       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
40       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
46       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
49
50

OPTIONS

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
57
58
59
60       -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
64
65       -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
71              -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
75              These options are meaningless if you specify -center.
76
77
78       -yoffs N
79              See -xoffs.
80
81
82       -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
87
88       -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
96
97       -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
102
103
104       ·      letter
105
106       ·      legal
107
108       ·      a3
109
110       ·      a4
111
112       ·      a5
113
114       ·      a6
115
116       ·      jb4
117
118       ·      jb5
119
120       ·      jb6
121
122       ·      exec
123
124       ·      ledger
125
126       ·      b5envelope
127
128       ·      c5envelope
129
130       ·      com10envelope
131
132       ·      monarchenvelope
133
134       ·      dlenvelope
135
136       ·      jpostcard
137
138       ·      jdoublepostcard
139
140
141              The default is letter.
142
143
144       -feeder=N
145              This options selects the media source (e.g. paper tray) that the
146              printer control stream specifies.
147
148
149       -copies=N
150              This option specifies the number of copies that the printer con‐
151              trol stream tells the printer to print.
152
153
154       -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
161              This option was new in Netpbm 10.29 (August 2005).
162
163
164       -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
169              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
173              This option was new in Netpbm 10.29 (August 2005).
174
175
176       -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
189
190       -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
198              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
203              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
207              This option was new in Netpbm 10.54 (March 2011).
208
209
210
211
212

SEE ALSO

214       ppmtolj(1),  pbmtolj(1),  ppmtopj(1),  ppmtopjxl(1),  thinkjettopbm(1),
215       ppm(1)
216
217

HISTORY

219       pnmtopclxl was added to Netpbm in Release 10.6  (July  2002).   It  was
220       contributed by Jochen Karrer.
221

DOCUMENT SOURCE

223       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
224       source.  The master documentation is at
225
226              http://netpbm.sourceforge.net/doc/pnmtopclxl.html
227
228netpbm documentation             22 March 2011       Pnmtopclxl User Manual(0)
Impressum