foo2zjs-wrapper man page

foo2zjs-wrapper — Convert Postscript into a ZJS printer stream

Synopsis

foo2zjs-wrapper [options] [ps-file]

Description

foo2zjs-wrapper is a Foomatic compatible printer wrapper for the foo2zjs printer driver. This script reads a Postscript ps-file or standard input and converts it to Zenographics ZjStream printer format for driving the Minolta/QMS 2300 DL network color laser printer and other Zenographics-based printers.

This script can be used in a standalone fashion, but is intended to be called from a printer spooler system which uses the Foomatic printer database.

Command Line Options

Normal Options

These are the options used to select the parameters of a print job that are usually controlled on a per job basis.

-c

Print in color (else monochrome).

-C colormode

Color correction mode [0].

1 Photos (using m2300w CRDs)
2 Photos and text (using m2300w CRDs)
3 Graphics and text (using m2300w CRDs)
10 ICM color profile (using -G *.icm file)
-d duplex

Duplex code to send to printer [1].

1 off 2 long edge 3 short edge
-m media

Media code to send to printer [1].

Media 2300DL 2200DL HP 1018 HP P1102 HP
HP 1005 HP 1020 HP P1606 CP1025
-z0 -z0 -z1 -z2 -z3
standard 1 1 1 1 1
transparency 2 2 2 2 2
envelope 257 na 267 267 267
letterhead 259 na 513 513 513
bond na na 260 260 260
thick 261 4 261 na na
postcard 262 na na na na
rough na na 263 263 263
heavy na na 262 262 262
labels 263 3 263 265 265
vellum na na 273 273 273
medium na na na 282 282
extraheavy na na na 283 283
color na na 512 512 512
light na na 258 258 258
preprinted na na 514 514 514
prepunched na na 515 515 515
recycled na na 516 516 516
-p paper

Paper size code to send to printer [1].

Paper MC 2300DL HP 1018 HP P1102 HP
HP 1005 HP 1020 HP P1606 CP1025
-z0 -z1 -z2 -z3
letter 1 1 1 1
legal 5 5 5 5
executive 7 7 7 7
A4 9 9 9 9
A5 11 11 11 11
B5jis 13 13 13 13
env #10 20 20 20 20
env DL 27 27 27 27
env CL 28 28 28 28
env B5 34 34 34 34
env Monarch 37 37 37 37
postcard (japan) na 260 43 43
B5iso na 259 na na
A6 na 262 70 70
double postcard rotated na 261 82 82
16k 197x273 na 257 257 257
fanfold german legal na 258 258 258
16k 184x260 na na 263 263
16k 195x270 na na 264 264
photo 4x6 na na na 268
photo 5x8 na na na 269
photo 10x15 na na na 270
-n copies

Number of copies [1].

-r xresxyres

Set device resolution in pixels/inch [1200x600].

-s source

Source (Input Slot) code to send to printer [7].

1 upper 4 manual
2 lower 7 auto
-t

Draft mode.  Every other pixel is white.

-T density

Print density (1-5).  The default is 3 (medium).

-2 -3 -4 -5 -6 -8 -9 -10 -12 -14 -15 -16 -18

Print in N-up.  Requires the psutils package.

-o orient

Orientation used for N-up.

Portrait -op (normal)
Landscape -ol (rotated 90 degrees anticlockwise)
Seascape -os (rotated 90 degrees clockwise)

Printer Tweaking Options

These are the options used to customize the operation of foo2zjs for a particular printer.

-u xoffxyoff

Set the offset of the start of the printable region from the upper left corner, in pixels [varies with paper size]. The defaults should work on the 2200DL and 2300DL, and have not been tested on any other printers.

-l xoffxyoff

Set the offset of the end of the printable region from the lower right corner, in pixels [varies with paper size]. The defaults should work on the 2200DL and 2300DL, and have not been tested on any other printers.

-L mask

Send the logical clipping values from -u/-l in the ZjStream. foo2zjs-wrapper always runs Ghostscript with the ideal page dimensions, so that the scale of the image is correct, regardless whether or not the printer has unprintable regions. This option is used to move the position of the clipped image back to where it belongs on the page.  The default is to send the amount which was clipped by -u and -l, and should be good in most cases.

0 don't send any logical clipping amounts
1 only send Y clipping amount
2 only send X clipping amount
3 send both X and Y clipping amounts
-P

Do not send START_PLANE codes on monochrome output.  May be needed by some monochrome-only printers, such as the HP LaserJet 1000.

-X padlen

Add extra zero padding to the end of BID segments.  The default is 16 bytes.  Padding 16 bytes of zeroes is needed for older ZjStream printers, such as the Minolta 2200DL and HP LaserJet 1000, and seems harmless to newer ones, such as the Minolta 2300DL.  So the default should be good for all cases.

-z model

Model. Default is 0.

0 KM 2300DL / HP 1000 / HP 1005
1 HP 1018 / HP 1020 / HP 1022
2 HP Pro P1102 / P1566 / P1606dn
3 HP Pro CP1025

Color Tweaking Options

These are the options used to control the quality of color output. Color correction is currently a WORK IN PROGRESS.

-g gsopts

Additional options to pass to Ghostscript, such as -g“-dDITHERPPI=nnn”, etc.  This option may appear more than once.

-G profile.icm

Convert profile.icm to a Postscript color rendering dictionary (CRD) using icc2ps and adjust the printer colors by using the Postscript setcolorrendering operator.  (WORK IN PROGRESS).

-G gamma-file.ps

Prepend gamma-file.ps to the Postscript input to perform color correction using the setcolortransfer Postscript operator. For example, the file might contain:
{0.333 exp} {0.333 exp} {0.333 exp} {0.333 exp} setcolortransfer

-I intent

Select profile intent from the ICM file. 0=Perceptual, 1=Colorimetric, 2=Saturation, 3=Absolute. Default is 0 (perceptual).

Debugging Options

These options are used for debugging foo2zjs and its wrapper.

-S plane

Output just a single color plane from a color print and print it on the black plane.  The default is to output all color planes.

1 Cyan
2 Magenta
3 Yellow
4 Black
-D level

Set Debug level [0].

Examples

Create a monochrome ZjStream from a Postscript document, examine it, and then print it using a RAW print queue:

foo2zjs-wrapper testpage.ps > testpage.zm
zjsdecode < testpage.zm
lpr -P raw testpage.zm

Create a color ZjStream stream from a Postscript document:

foo2zjs-wrapper -c testpage.ps > testpage.zc

Files

/usr/bin/foo2zjs-wrapper

See Also

foo2zjs(1), zjsdecode(1)

Author

Rick Richardson <rick.richardson@comcast.net>
http://foo2zjs.rkkda.com/

Referenced By

foo2zjs(1), foo2zjs-icc2ps(1), foo2zjs-pstops(1), zjsdecode(1).

Mon Nov 20 17:47:48 2017 foo2zjs-wrapper 0.0