Pnmtopclxl User Manual



Pnmtopclxl User Manual

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
SEE ALSO
HISTORY

NAME

pnmtopclxl - convert a PNM image to an HP LaserJet PCL XL printer stream

SYNOPSIS

pnmtopclxl <br>{ [-dpi=N] [-xoffs=N] [-yoffs=N] [-center] [-duplex={vertical|horizontal}] [-format=paperformat] [-feeder=N] [-copies=N] [-rendergray] [-jobsetup=filename] <br>| -embedded <br>} [-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.

DESCRIPTION

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) -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.

OPTIONS

-dpi=N

This option selects the resolution of the image (not the printer!). N is the resolution in dots per inch, from 1 to 65535. The default is 300.

-xoffs=N

This option and -yoffs 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.

-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.

-yoffs N

See -xoffs.

-center

This option tells pnmtopclxl 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 -xoffs and -yoffs (or their defaults).

-duplex={vertical|horizontal}

This option causes pnmtopclxl to create a printer stream that prints pages on both sides of the sheet of paper. vertical means to print them so that the left edge of both pages is on the same edge of the sheet, while horizontal means the more usual duplexing where the top of both pages is on the same edge of the sheet.

-format=paperformat

This option selects the media (e.g. paper size) that the printer control stream specifies. paperformat is one of the following self-explanatory keywords:

letter

legal

a3

a4

a5

a6

jb4

jb5

jb6

exec

ledger

b5envelope

c5envelope

com10envelope

monarchenvelope

dlenvelope

jpostcard

jdoublepostcard

The default is letter.

-feeder=N

This options selects the media source (e.g. paper tray) that the printer control stream specifies.

-copies=N

This option specifies the number of copies that the printer control stream tells the printer to print.

-rendergray

This option causes pnmtopclxl 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.

This option was new in Netpbm 10.29 (August 2005).

-jobsetup=filename

This option causes pnmtopclxl to include arbitrary job setup PJL commands at the beginning of the output stream. It reads them from the named file.

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).

-colorok

This option simply tells pnmtopclxl not to warn you if you supply a color input and therefore get color output. By default, pnmtopclxl 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.

-embedded

Without this option, pnmtopclxl generates an entire printer control stream that sets up the printer, ejects pages, and places a lone image on each page. With the option, pnmtopclxl 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.

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).

SEE ALSO

ppmtolj(1) , pbmtolj(1) , ppmtopj(1) , ppmtopjxl(1) , thinkjettopbm(1) , ppm(5)

HISTORY

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




More Linux Commands

manpages/Apache2::Build.3pm.html
Apache2::Build(3pm) - Methods for locating and parsing bits
This module provides methods for locating and parsing bits of Apache source code. Since mod_perl remembers what build options were used to build it, you can use

manpages/in_wchnstr.3ncurses.html
in_wchnstr(3ncurses) - get an array of complex characters an
These functions return an array of complex characters in wchstr, starting at the current cursor position in the named window. Attributes (rendition) are stored

manpages/xdr_callhdr.3.html
xdr_callhdr(3) - library routines for remote procedure calls
These routines allow C programs to make procedure calls on other machines across the network. First, the client calls a procedure to send a data packet to the s

manpages/pkaction.1.html
pkaction(1) - Get details about a registered action.........
pkaction is used to obtain information about registered polkit actions. If called without --action-id then all actions are displayed. Otherwise the action actio

manpages/group.conf.5.html
group.conf(5) - configuration file for the pam_group module
group.conf.5 - The pam_group PAM module does not authenticate the user, but instead it grants group memberships (in the credential setting phase of the authenti

manpages/smbta-util.8.html
smbta-util(8) - control encryption in VFS smb_traffic_analyz
This tool is part of the samba(1) suite. smbta-util is a tool to ease the configuration of the vfs_smb_traffic_analyzer module regarding data encryption. The us

manpages/ldap_install_tls.3.html
ldap_install_tls(3) - LDAP TLS initialization routines......
These routines are used to initiate TLS processing on an LDAP session. ldap_start_tls_s() sends a StartTLS request to a server, waits for the reply, and then in

manpages/x11perfcomp.1.html
x11perfcomp(1) - X11 server performance comparison program
The x11perfcomp program merges the output of several x11perf(1) runs into a nice tabular format. It takes the results in each file, fills in any missing test re

manpages/TAP::Parser::Result::Bailout.3pm.html
TAP::Parser::Result::Bailout(3pm) - Bailout result token....
This is a subclass of TAP::Parser::Result. A token of this class will be returned if a bail out line is encountered. 1..5 ok 1 - woo hooo! Bail out! Well, so mu

manpages/magic.5.html
magic(5) - file command's magic pattern file (Man Page).....
This manual page documents the format of the magic file as used by the file(n) command, version 5.19. The file(n) command identifies the type of a file using, a

manpages/clnt_geterr.3.html
clnt_geterr(3) - library routines for remote procedure calls
These routines allow C programs to make procedure calls on other machines across the network. First, the client calls a procedure to send a data packet to the s

manpages/mouseinterval_sp.3ncurses.html
mouseinterval_sp(3ncurses) - curses screen-pointer extension
This implementation can be configured to provide a set of functions which improve the ability to manage multiple screens. This feature can be added to any of th





We can't live, work or learn in freedom unless the software we use is free.