[Previous] [Contents] [Index] [Next]

Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

phs-to-pcl

Convert .phs output for a Hewlett-Packard PCL compatible printer

Syntax:

phs-to-pcl [-A] [-B size] [-b size] [-C]
           [-c colors] [-D debug_fname] [-d]
           [-h height] [-L] [-M model] [-m model]
           [-n name] [-ocn] [-odn] [-of] [-oh]
           [-oin] [-omn] [-opn] [-oQn] [-oq]
           [-orn] [-oSX,Y] [-osn]
           [-oyn] [-P file]
           [-p start[,end]] [-pr] [-s level]
           [-U filename]
           [-V] [-w width] [-x offset] [-y offset]
           filename

Options:

-A
Force anti-aliasing of fonts.
-B size
Specify the size of the printer buffer in bytes. This buffer is used if the specified input file is a FIFO.
-b size
Specify the size of the printer buffer in bytes.
-C
Disable the compression of output data.
-c colors
The number of colors available; a value of 1 indicates 256 colors, and a value of 3 indicates 16 million colors.
-D debug_fname
Send debug information to the specified file.
-d
Delete the input file after processing.
-h height
Specify the initial height of the source image. The default is 480 pixels.
-L
Enable landscape mode.
-M model
Select the model by specifying the QNX model ID, which is a hexadecimal integer.
-m model
Select the model by specifying the MicroSoft model ID, which is a string of up to 20 ASCII characters.
-n name
Specify the name of the printer.
-ocn
Adjust the cyan gamma correction for Floyd-Steinberg dithering. A negative value means less, positive means more.
-odn
Set printer graphical depletion (default: 2). Ranges between 0 (disabled) and 5 (remove every fifth pixel).
-of
Enable Floyd-Steinberg dithering (default: -oq).
-oh
Enable halftone dithering (default: -oq).
-oin
Adjust the intensity (0-49 is dark, 50 is normal, and 51-99 is light). The default is 50.
-omn
Adjust the magenta gamma correction for Floyd-Steinberg dithering. A negative value means less, positive means more.
-opn
Specify printing type. Choices are: 1 (B/W); 3 (CMY color); 4 (CMYK).
-oQn
Set the print quality (0 is draft, 1 is normal, 2 is high). The default is 1.
-oq
Use the QNX dithering method (default).
-orn
Set the resolution; the default is 360 DPI unless specified by the source file. Valid choices are 75, 150, 300, and 600.
-oSX,Y
Scale the image in the X or Y dimension (e.g. -oS0.75,0.6). The scale value may be:
Negative
Scale as a multiple of the source image size. For example, use -oS-1,-1 to print the image at exactly its source size. Each pixel of the image will correspond to one printed dot on the page. The size of the printed image will vary depending on the printer resolution (DPI).
Positive
Scale as a multiple of the page size. For example, use -oS1,1 to print the image at the full page size. In this example, the image will be distorted if its aspect ratio (X:Y) is different from the page's width:height ratio.
0
Use the maximum size while respecting the aspect ratio of the source image. For example, -oS0,0.5 scales the image to half the height of the page and scales the width of the image proportionately.

If you set only the X scale factor, the Y scale factor is assumed to be the same value. For example, -oS0.5 sets both X and Y to 0.5, meaning the image will fill 1/4 of the page.

-osn
Specify the printer shingling (multiple-pass printing). The value of n must be in the range from 0 to 2; the default is 1.
-oyn
Adjust the yellow gamma correction for Floyd-Steinberg dithering. A negative value means less, positive means more.
-P file
The name of the Photon palette file to use. The default is default.pal.
-p start[,end]
Specify the starting (and optionally ending) page number to print. If start is greater than end, the pages are printed in reverse order.
-pr
Print the entire file in reverse order.
-s level
Specify the reporting level, where level is an integer.
-U filename
Delete this file when the print job is completed.
-V
Be verbose (-VV: be more verbose).
-w width
Specify the initial width of the source image. The default is 640 pixels.
-x offset
The initial x offset (default: 0).
-y offset
The initial y offset (default: 0).
filename
Name of a Photon draw-stream (*.phs) file.

Description:

This utility converts Photon draw-stream (.phs) output into a form that Hewlett-Packard PCL-compatible printers can understand. The configuration for HP PCL printers, /etc/printers/pcl.cfg, specifies phs-to-pcl as a filter for spooler to use.

Hewlett-Packard suggests the following settings:

Paper Type Shingling Depletion
Plain paper (Fast) 0 (none) 5 (50% with gamma correction)
Plain paper (Normal) 1 (50%) 1 (25%)
Plain paper (Better) 2 (25%) 4 (25% with gamma correction)
Plain paper (Best) 2 (25%) 5 (50% with gamma correction)
HP glossy paper (Normal) 2 (25%) 1 (25%)
HP glossy paper (Best) 0 (0%) 1 (25%)
Black transparency film 2 (25%) 0 (No depletion)
Color transparency film (Normal) 1 (50%) 1 (25%)
Color transparency film (Best) 2 (25%) 0 (No depletion)

The output is sent to stdout. Typically this is redirected to a printer device, as shown in the example.

Examples:

phs-to-pcl file.phs >/dev/par

See also:

phs-to-bjc, phs-to-bmp, phs-to-escp2, phs-to-ijs, phs-to-ps, spooler

"Printing with spooler" in the Printing chapter of the Neutrino User's Guide


[Previous] [Contents] [Index] [Next]