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       -dpi=N This  option  selects  the  resolution  of  the  image  (not the
53              printer!).  N is the resolution in dots  per  inch,  from  1  to
54              65535.  The default is 300.
55
56
57       -xoffs=N
58              This option and -yoffs determine the location on the page of the
59              upper left corner of each image.  Note that the image  may  have
60              built  in  borders  too,  which would make the main image within
61              more left and down that what you specify here.
62
63              -xoffs and -yoffs specify the distance from the left of the page
64              and  from  the  top of the page, respectively, in inches, of the
65              upper left corner of the image.  The default for each is zero.
66
67              These options are meaningless if you specify -center.
68
69
70       -yoffs N
71              See -xoffs.
72
73
74       -center
75              This option tells pnmtopclxl to center each image on  the  page.
76              If  you  don't  specify this option, the position of an image on
77              the page is determined by -xoffs and -yoffs (or their defaults).
78
79
80       -duplex={vertical|horizontal}
81              This option causes pnmtopclxl to create a  printer  stream  that
82              prints  pages  on  both  sides  of the sheet of paper.  vertical
83              means to print them so that the left edge of both  pages  is  on
84              the  same  edge  of  the  sheet, while horizontal means the more
85              usual duplexing where the top of both pages is on the same  edge
86              of the sheet.
87
88
89       -format=paperformat
90              This option selects the media (e.g. paper size) that the printer
91              control stream specifies.  paperformat is one of  the  following
92              self-explanatory keywords:
93
94
95
96       ·      letter
97
98       ·      legal
99
100       ·      a3
101
102       ·      a4
103
104       ·      a5
105
106       ·      a6
107
108       ·      jb4
109
110       ·      jb5
111
112       ·      jb6
113
114       ·      exec
115
116       ·      ledger
117
118       ·      b5envelope
119
120       ·      c5envelope
121
122       ·      com10envelope
123
124       ·      monarchenvelope
125
126       ·      dlenvelope
127
128       ·      jpostcard
129
130       ·      jdoublepostcard
131
132
133              The default is letter.
134
135
136       -feeder=N
137              This options selects the media source (e.g. paper tray) that the
138              printer control stream specifies.
139
140
141       -copies=N
142              This option specifies the number of copies that the printer con‐
143              trol stream tells the printer to print.
144
145
146       -rendergray
147              This  option causes pnmtopclxl to include in the output stream a
148              command to set the RENDERMODE environment variable to GRAYSCALE,
149              which typically causes the printer to print in grayscale regard‐
150              less of the colors in the input, and may cause it  to  run  much
151              faster even if the image is grayscale anyway.
152
153              This option was new in Netpbm 10.29 (August 2005).
154
155
156       -jobsetup=filename
157              This option causes pnmtopclxl to include arbitrary job setup PJL
158              commands at the beginning of the output stream.  It  reads  them
159              from the named file.
160
161              pnmtopclxl  does  not  inspect these commands in any way, but it
162              does expect them to be job setup commands.  If you have  garbage
163              in your file, you will hear from the printer.
164
165              This option was new in Netpbm 10.29 (August 2005).
166
167
168       -colorok
169              This  option simply tells pnmtopclxl not to warn you if you sup‐
170              ply a color input and therefore get color output.   By  default,
171              pnmtopclxl issues a warning any time it produces a color printer
172              stream because it is usually a mistake.  It's a mistake  because
173              PCL XL is mainly used for laser printers, and laser printers are
174              mainly black and white.  If you send a color print stream  to  a
175              black and white printer, it typically refuses to print anything,
176              and even if it manages to convert it  to  black  and  white  and
177              print it, it takes 3 times as long to transmit a color stream to
178              the printer than to transmit the grayscale image that gives  the
179              same result.
180
181
182       -embedded
183              Without this option, pnmtopclxl generates an entire printer con‐
184              trol stream that sets up the printer, ejects pages, and places a
185              lone  image on each page.  With the option, pnmtopclxl generates
186              only the instructions to generate the image itself.  This is not
187              useful  all by itself, but you can embed it in a suitable PCL-XL
188              stream in order to add an image to it.
189
190              This makes sense only for a single image, so you cannot  specify
191              multiple input files and if an input file has multiple images in
192              it, pnmtopclxl ignores any after the first (it won't  even  read
193              them).
194
195              All  the options that control the printer control stream outside
196              the image itself, such as -xoffs and -feeder  are  invalid  with
197              -embedded.
198
199              This option was new in Netpbm 10.54 (March 2011).
200
201
202
203
204

SEE ALSO

206       ppmtolj(1),  pbmtolj(1),  ppmtopj(1),  ppmtopjxl(1),  thinkjettopbm(1),
207       ppm(1)
208
209

HISTORY

211       pnmtopclxl was added to Netpbm in Release 10.6  (July  2002).   It  was
212       contributed by Jochen Karrer.
213

DOCUMENT SOURCE

215       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
216       source.  The master documentation is at
217
218              http://netpbm.sourceforge.net/doc/pnmtopclxl.html
219
220netpbm documentation             22 March 2011       Pnmtopclxl User Manual(0)
Impressum