Imported Upstream version 20130303

1 files changed, 239 insertions, 0 deletions

diff --git a/foo2hbpl2-wrapper.1in b/foo2hbpl2-wrapper.1in
new file mode 100644
index 0000000..b50649e
--- /dev/null
+++ b/foo2hbpl2-wrapper.1in
@@ -0,0 +1,239 @@
+'\" t
+.TH foo2hbpl2-wrapper 1 "${MODpage}" "foo2hbpl2-wrapper ${MODver}"
+#ifndef OLDGROFF
+#include "macros.man"
+#endif
+'\"==========================================================================
+'\"	MANUAL PAGE SOURCE
+'\"==========================================================================
+.SH NAME
+foo2hbpl2-wrapper \- Convert Postscript into a ZJS printer stream
+.SH SYNOPSIS
+.B foo2hbpl2-wrapper
+.RI [ options "] [" ps-file ]
+.SH DESCRIPTION
+.B foo2hbpl2-wrapper
+is a Foomatic compatible printer wrapper for the \fBfoo2hbpl2\fP printer driver.
+This script reads a Postscript \fIps-file\fP or standard input
+and converts it to Zenographics ZjStream printer format
+for driving the Dell 1153,
+Fuji Xerox DocuPrint CM205,
+and Xerox WorkCentre 6015 MFP printers.
+.P
+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.
+
+.SH COMMAND LINE OPTIONS
+.SS Normal Options
+These are the options used to select the parameters of a
+print job that are usually controlled on a per job basis.
+.TP
+.BI \-c
+Print in color (else monochrome).
+.TP
+.BI \-C\0 colormode
+Color correction mode [0].
+.TS
+n l .
+10	ICM color profile (using -G *.icm file)
+.TE
+.TP
+.BI \-d\0 duplex
+Duplex code to send to printer [1].
+.TS
+| n l | n l | n l .
+1	off	2	long edge	3	short edge
+.TE
+.TP
+.BI \-m\0 media
+Media code to send to printer [1].
+.TS
+l r.
+_
+Media	HBPL
+_
+plain	1
+bond	2
+lwcard	3
+lwgcard	4
+labels	5
+envelope	6
+recycled	7
+plain2	8
+bond2	9
+lwcard2	10
+lwgcard2	11
+recycled2	12
+.TE
+.TP
+.BI \-p\0 paper
+Paper size code to send to printer [1].
+.TS
+l r.
+_
+Paper	HBPL
+_
+A4	1
+B5jis	2
+letter	4
+executive	5
+fanfold german legal	6
+folio	6
+legal	7
+env#10	9
+envMonarch	10
+envC5	11
+envDL	12
+.TE
+.TP
+.BI \-n\0 copies
+Number of copies [1].
+.TP
+.BI \-r\0 xres x yres
+Set device resolution in pixels/inch [1200x600].
+.TP
+.BI \-s\0 source
+Source (Input Slot) code to send to printer [7].
+.TS
+| n l | n l.
+1	upper	4	manual
+2	lower	7	auto
+.TE
+.TP
+.BI \-t
+Draft mode.  Every other pixel is white.
+.TP
+.BI \-T\0 density
+Print density (1-5).  The default is 3 (medium).
+.TP
+.BI "\-2 \-3 \-4 \-5 \-6 \-8 \-9 \-10 \-12 \-14 \-15 \-16 \-18"
+Print in N-up.  Requires the \fBpsutils\fP package.
+.TP
+.BI \-o\0 orient
+Orientation used for N-up.
+.TS
+l l l.
+Portrait	-op	(normal)
+Landscape	-ol	(rotated 90 degrees anticlockwise)
+Seascape	-os	(rotated 90 degrees clockwise)
+.TE
+.SS Printer Tweaking Options
+These are the options used to customize the operation of \fBfoo2hbpl2\fP
+for a particular printer.
+.TP
+.BI \-u\0 xoff x yoff
+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.
+.TP
+.BI \-l\0 xoff x yoff
+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.
+.TP
+.BI \-L\0 mask
+Send the logical clipping values from -u/-l in the ZjStream.
+\fBfoo2hbpl2-wrapper\fP 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.
+.TS
+l l.
+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
+.TE
+.TP
+.BI \-P
+Do not send START_PLANE codes on monochrome output.  May be
+needed by some monochrome-only printers, such as the
+HP LaserJet 1000.
+.TP
+.BI \-X\0 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.
+.SS Color Tweaking Options
+These are the options used to control the quality of color output.
+Color correction is currently a WORK IN PROGRESS.
+.TP
+.BI \-g\0 gsopts
+Additional options to pass to Ghostscript, such as -g\(lq-dDITHERPPI=nnn\(rq,
+etc.  This option may appear more than once.
+.TP
+.BI \-G\0 profile.icm
+Convert \fIprofile.icm\fP to a Postscript color rendering
+dictionary (CRD) using \fBfoo2zjs-icc2ps\fP and
+adjust the printer colors by using the Postscript \fBsetcolorrendering\fP
+operator.  (WORK IN PROGRESS).
+.TP
+.BI \-G\0 gamma-file.ps
+Prepend \fIgamma-file.ps\fP to the Postscript input to perform
+color correction using the \fBsetcolortransfer\fP Postscript operator.
+For example, the file might contain:
+.br
+{0.333 exp} {0.333 exp} {0.333 exp} {0.333 exp} setcolortransfer
+.TP
+.BI \-I\0 intent
+Select profile intent from the ICM file.
+0=Perceptual, 1=Colorimetric, 2=Saturation, 3=Absolute.
+Default is 0 (perceptual).
+.SS Debugging Options
+These options are used for debugging \fBfoo2hbpl2\fP and its wrapper.
+.TP
+.BI \-S\0 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.
+.TS
+l l.
+1	Cyan
+2	Magenta
+3	Yellow
+4	Black
+.TE
+.TP
+.BI \-D\0 level
+Set Debug level [0].
+
+.SH EXAMPLES
+Create a monochrome ZjStream from a Postscript document,
+examine it, and then print it using a RAW print queue:
+
+.RS
+.nf
+foo2hbpl2-wrapper testpage.ps > testpage.prn
+hbpl2decode < testpage.prn
+lpr -P raw testpage.prn
+.fi
+.RE
+.P
+Create a color ZjStream stream from a Postscript document:
+
+.RS
+.nf
+foo2hbpl2-wrapper -c testpage.ps > testpage.prn
+.fi
+.RE
+
+.SH FILES
+.BR /usr/bin/foo2hbpl2-wrapper
+.SH SEE ALSO
+.BR foo2hbpl2 (1),
+.BR hbpldecode (1)
+.SH "AUTHOR"
+Rick Richardson <rick.richardson@comcast.net>
+.br
+${URLZJS}/
+'/"
+'/"
+'/"
+.em pdf_outline