417 lines
9.6 KiB
HTML
417 lines
9.6 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of pbmtoppa</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>pbmtoppa</H1>
|
|
Section: User Commands (1)<BR>Updated: 01 May 2000<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="ixAAB"></A>
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
pbmtoppa - convert PBM image to HP Printer Performance Architecture (PPA)
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>pbmtoppa</B>
|
|
|
|
<P>
|
|
[<I>pbm_file</I>
|
|
|
|
[<I>ppa_file</I>]]
|
|
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>pbmtoppa</B>
|
|
|
|
converts page images in PBM format to Hewlett Packard's PPA (Printer
|
|
Performance Architecture) format, which is the data stream format
|
|
expected by some HP "Windows-only" printers including the HP Deskjet
|
|
820C series, the HP DeskJet 720 series, and the HP DeskJet 1000
|
|
series.
|
|
<P>
|
|
<I>pbm_file</I>
|
|
|
|
is the file specification of the input file or
|
|
<B>-</B>
|
|
|
|
for Standard Input. The default is Standard Input.
|
|
<P>
|
|
The input file contains one or more PBM images, with each one being a
|
|
single page. Each image must have the exact dimensions of a page (at
|
|
600 pixels per inch in both directions). Significantly, this is the
|
|
format the Ghostscript produces.
|
|
<P>
|
|
<I>ppa_file</I>
|
|
|
|
is the file specification of the output file or
|
|
<B>-</B>
|
|
|
|
for Standard Output. The default is Standard Output.
|
|
<P>
|
|
<P>
|
|
To print Postscript on an HP PPA printer, just use Ghostscript with
|
|
the
|
|
<B>pbmraw</B>
|
|
|
|
(or
|
|
<B>pbm</B>)
|
|
|
|
device driver.
|
|
<P>
|
|
You can generate a test page for use with this program with
|
|
<B>pbmpage</B>.
|
|
|
|
<P>
|
|
You can also set up a printer filter so you can submit PBM input
|
|
directly to your print queue. See the documentation for your print
|
|
spooler for information on how to do that, or look in hp820install.doc
|
|
for an example lpd print filter for Postscript and text files.
|
|
<P>
|
|
Sometimes,
|
|
<B>pbmtoppa</B>
|
|
|
|
generates a file which the printer will not print (because
|
|
<B>pbmtoppa</B>'s
|
|
|
|
input is unprintable). When this happens, all three lights blink to
|
|
signal the error. This is usually because there is material outside
|
|
of the printer's printable area. To make the file print, increase the
|
|
margins via
|
|
<B>pbmtoppa</B>
|
|
|
|
options or a configuration file. See the CALIBRATION section below.
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-v </B><I>version</I>
|
|
|
|
<DD>
|
|
printer version (720, 820, or 1000)
|
|
<DT id="2"><B>-x </B><I>xoff</I>
|
|
|
|
<DD>
|
|
vertical offset adjustment in 1"/600
|
|
<DT id="3"><B>-y </B><I>yoff</I>
|
|
|
|
<DD>
|
|
horizontal offset adjustment in 1"/600
|
|
<DT id="4"><B>-t </B><I>topmarg</I>
|
|
|
|
<DD>
|
|
top margin in 1"/600 (default: 150 = 0.25")
|
|
<DT id="5"><B>-l </B><I>leftmarg</I>
|
|
|
|
<DD>
|
|
left margin in 1"/600 (default: 150 = 0.25")
|
|
<DT id="6"><B>-r </B><I>rightmarg</I>
|
|
|
|
<DD>
|
|
right margin in 1"/600 (default: 150 = 0.25")
|
|
<DT id="7"><B>-b </B><I>botmarg</I>
|
|
|
|
<DD>
|
|
bottom margin in 1"/600 (default: 150 = 0.25")
|
|
<DT id="8"><B>-s </B><I>paper</I>
|
|
|
|
<DD>
|
|
paper size:
|
|
<B>us </B>
|
|
|
|
or
|
|
<B>a4</B>.
|
|
|
|
Default is
|
|
<B>us</B>.
|
|
|
|
<DT id="9"><B>-f </B><I>cfgfile</I>
|
|
|
|
<DD>
|
|
read parameters from configuration file
|
|
<I>cfgfile </I>
|
|
|
|
<P>
|
|
</DL>
|
|
<P>
|
|
|
|
The
|
|
<B>-x </B>
|
|
|
|
and
|
|
<B>-y </B>
|
|
|
|
options accumulate.
|
|
<P>
|
|
The
|
|
<B>-v </B>
|
|
|
|
option resets the horizontal and vertical adjustments to an internal
|
|
default.
|
|
<P>
|
|
<P>
|
|
<P>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>CONFIGURATION FILES</H2>
|
|
|
|
<P>
|
|
You can use configuration files to specify parameters rather than use
|
|
invocation options.
|
|
<B>pbmtoppa</B>
|
|
|
|
processes the file /etc/pbmtoppa.conf, if it exists, before processing
|
|
any options. It then processes each configuration file named by a
|
|
<B>-f</B>
|
|
|
|
option in order, applying the parameters from the configuration file as
|
|
if they were invocation options used in the place of the
|
|
<B>-f</B>
|
|
|
|
option.
|
|
<P>
|
|
Configuration files have the following format:
|
|
<P>
|
|
<B>#</B><I>Comment</I>
|
|
|
|
<BR>
|
|
|
|
<I>key1</I>
|
|
|
|
<I>value1</I>
|
|
|
|
<BR>
|
|
|
|
<I>key2</I>
|
|
|
|
<I>value2</I>
|
|
|
|
<BR>
|
|
|
|
[etc.]
|
|
<P>
|
|
Valid
|
|
<I>key</I>s
|
|
|
|
are
|
|
<B>version</B>,
|
|
|
|
<B>xoffset</B>,
|
|
|
|
<B>yoffset</B>,
|
|
|
|
<B>topmargin</B>,
|
|
|
|
<B>leftmargin</B>,
|
|
|
|
<B>rightmargin</B>,
|
|
|
|
<B>bottommargin</B>,
|
|
|
|
<B>papersize</B>,
|
|
|
|
or any non-null prefix of these words. Valid values are the same as
|
|
with the corresponding invocation parameters.
|
|
<P>
|
|
<P>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>EXAMPLES</H2>
|
|
|
|
<P>
|
|
Print a test pattern:
|
|
<P>
|
|
<B>pbmpage | pbmppa >/dev/lp1</B>
|
|
|
|
<P>
|
|
Print three pages:
|
|
<P>
|
|
<B>cat page1.pbm page2.pbm page3.pbm | pbmppa >/dev/lp1</B>
|
|
|
|
<P>
|
|
Print the Postscript file myfile.ps:
|
|
<P>
|
|
<B>gs -sDEVICE=rawpbm -q -dNOPAUSE -r600 \
|
|
<BR>
|
|
|
|
<BR> -sOutputFile=- myfile.ps \
|
|
<BR>
|
|
|
|
| pbmtoppa | lpr
|
|
</B>
|
|
<P>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>CALIBRATION</H2>
|
|
|
|
To be able to print successfully and properly, you need to tell
|
|
<B>pbmtoppa</B>
|
|
|
|
an X and a Y offset appropriate for your printer to use when
|
|
generating the page. You can specify these offsets with the
|
|
<B>-x </B>
|
|
|
|
and
|
|
<B>-y</B>
|
|
|
|
invocation options or with the
|
|
<B>xoff</B>
|
|
|
|
and
|
|
<B>yoff</B>
|
|
|
|
parameters in a
|
|
<B>pbmtoppa</B>
|
|
|
|
configuration file.
|
|
<P>
|
|
To determine the correct offsets, use the
|
|
<B>pbmpage</B>
|
|
|
|
program.
|
|
<P>
|
|
If while trying to do this calibration, the printer refuses to print a page,
|
|
but just blinks all three lights, specify large margins (e.g. 600 pixels --
|
|
one inch) via
|
|
<B>pbmpage</B>
|
|
|
|
invocation options while doing the calibration.
|
|
<P>
|
|
For example:
|
|
<P>
|
|
<B>pbmpage | pbmtoppa >/dev/lp1</B>
|
|
|
|
<BR>
|
|
|
|
or
|
|
<BR>
|
|
|
|
<B>pbmpage | pbmtoppa | lpr -l</B>
|
|
|
|
<BR>
|
|
|
|
(if your printer filter recognizes the '-l' (direct output) parameter).
|
|
<P>
|
|
In the test pattern, the grid is marked off in pixel coordinate numbers.
|
|
Unfortunately, these coordinates are probably cut off before the edge of the
|
|
paper. You'll have to use a ruler to estimate the pixel coordinate of the
|
|
left and top edges of the actual sheet of paper (should be within +/- 300, may
|
|
be negative; there are 600 pixels per inch).
|
|
<P>
|
|
Add these coordinates to the X and Y offsets by either editing the
|
|
configuration file or using the
|
|
<B>-x </B>
|
|
|
|
and
|
|
<B>-y</B>
|
|
|
|
command-line parameters.
|
|
<P>
|
|
When
|
|
<B>pbmtoppa</B>
|
|
|
|
is properly calibrated, the center mark should be in the center of the
|
|
paper. Also, the margins should be able to be as small as 1/4 inch
|
|
without causing the printer to choke with 'blinking lights syndrome'.
|
|
<P>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>REDHAT LINUX INSTALLATION</H2>
|
|
|
|
<P>
|
|
RedHat users may find the following tip from Panayotis Vryonis
|
|
<<A HREF="mailto:vrypan@hol.gr">vrypan@hol.gr</A>> helpful. The same should work for the 820 and 1000,
|
|
but it hasn't been tested. Also, use the pbmraw GSDriver if you have
|
|
it; it's faster.
|
|
<P>
|
|
Here is a tip to intergrate HP720C support in RedHat's printtool:
|
|
<P>
|
|
Install pbm2ppa. Copy pbm2ppa to /usr/bin.
|
|
<P>
|
|
Edit "printerdb" (in my system it is found in
|
|
/usr/lib/rhs/rhs-printfilters ) and append the following lines:
|
|
<P>
|
|
----------------------Cut here-----------------------
|
|
<BR>
|
|
|
|
StartEntry: DeskJet720C
|
|
<BR> GSDriver: pbm
|
|
<BR> Description: {HP DeskJet 720C}
|
|
<BR> About: { \
|
|
<BR> This driver supports the HP DeskJet 720C \
|
|
<BR> inkjet printer. \
|
|
<BR> It does does not support color printing. \
|
|
<BR> IMPORTANT! Insert \
|
|
<BR> "- | pbm2ppa -" \
|
|
<BR> in the "Extra GS Otions" field.\
|
|
<BR> }
|
|
<BR>
|
|
|
|
<BR> Resolution: {600} {600} {}
|
|
<BR>
|
|
|
|
EndEntry
|
|
----------------------------------------------------
|
|
<P>
|
|
Now you can add an HP720C printer just like any other, using printtool.
|
|
<P>
|
|
<P>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pbmpage">pbmpage</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+pstopnm">pstopnm</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+pbm">pbm</A></B>(5)
|
|
|
|
<P>
|
|
<B>pnm2ppa</B>
|
|
|
|
is not part of Netpbm, but does the same things as
|
|
<B>pbmtoppa</B>
|
|
|
|
except it also works with color and has lots more features.
|
|
See <<A HREF="http://sourceforge.net/project/?group_id=1322">http://sourceforge.net/project/?group_id=1322</A>>.
|
|
<P>
|
|
The file INSTALL-MORE in the pbmtoppa directory of the Netpbm source
|
|
code contains detailed instructions on setting up a system to use
|
|
pbmtoppa to allow convenient printing on HP PPA printers. It was
|
|
written by Michael Buehlmann.
|
|
<P>
|
|
For information about the PPA protocol and the separately distributed
|
|
pbm2ppa program from which
|
|
<B>pbmtoppa</B>
|
|
|
|
was derived, see <<A HREF="http://www.httptech.com/ppa">http://www.httptech.com/ppa</A>>.
|
|
<P>
|
|
<A NAME="lbAK"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
Tim Norman. Copyright (C) 1998. Licensed under GNU Public License
|
|
<P>
|
|
Manual page by Bryan Henderson, May 2000.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="10"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="11"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="12"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="13"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="14"><A HREF="#lbAF">CONFIGURATION FILES</A><DD>
|
|
<DT id="15"><A HREF="#lbAG">EXAMPLES</A><DD>
|
|
<DT id="16"><A HREF="#lbAH">CALIBRATION</A><DD>
|
|
<DT id="17"><A HREF="#lbAI">REDHAT LINUX INSTALLATION</A><DD>
|
|
<DT id="18"><A HREF="#lbAJ">SEE ALSO</A><DD>
|
|
<DT id="19"><A HREF="#lbAK">AUTHOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:21 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|