Pnmtopclxl User Manual(1) | General Commands Manual | Pnmtopclxl User Manual(1) |
pnmtopclxl - convert a PNM image to an HP LaserJet PCL XL printer stream
pnmtopclxl
{ [-dpi=N] [-xoffs=N] [-yoffs=N] [-center] [-duplex={vertical|horizontal}] [-format=paperformat] [-feeder=N] [-copies=N] [-rendergray] [-jobsetup=filename]
| -embedded
} [-colorok] pnmfile1 pnmfile2 ...
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.
This program is part of Netpbm(1).
pnmtopclxl 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.
Alternatively, you can make pnmtopclxl 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. (-embedded option).
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 ppmtopgm(1). See the -colorok option for more information about choosing between color and grayscale.
The output goes to Standard Output. All of the pages go to one file, concatenated in the same order as the input images.
In addition to the options common to all programs based on
libnetpbm (most notably -quiet, see
Common Options ), pnmtopclxl recognizes the following command line
options:
-xoffs and -yoffs 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.
These options are meaningless if you specify -center.
The default is letter.
This option was new in Netpbm 10.29 (August 2005).
pnmtopclxl 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.
This option was new in Netpbm 10.29 (August 2005).
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, pnmtopclxl ignores any after the first (it won't even read them).
All the options that control the printer control stream outside the image itself, such as -xoffs and -feeder are invalid with -embedded.
This option was new in Netpbm 10.54 (March 2011).
ppmtolj(1), pbmtolj(1), ppmtopj(1), ppmtopjxl(1), thinkjettopbm(1), ppm(1)
pnmtopclxl was added to Netpbm in Release 10.6 (July 2002). It was contributed by Jochen Karrer.
This manual page was generated by the Netpbm tool 'makeman' from HTML source. The master documentation is at
22 March 2011 | netpbm documentation |