278 lines
8.1 KiB
HTML
278 lines
8.1 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of pnm2ppa</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>pnm2ppa</H1>
|
|
Section: User Commands (1)<BR>Updated: 23 Jun 2002<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
pnm2ppa - convert portable anymap (PNM) images to HP's PPA printer format.
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
pnm2ppa [options] [ -i <I>infile</I> ] [ -o <I>outfile</I> ]
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
Reads portable anymap (PNM) format as input. Binary PNM formats pnmraw =
|
|
{ppmraw (color pixmap), pgmraw (graymap), and pbmraw (black-and-white bitmap)}
|
|
are strongly preferred. Output stream can be locally processed by
|
|
Hewlett-Packard's
|
|
Printing Performance Architecture (PPA) printers (HP DeskJet 710C, 712C, 720C,
|
|
722C, 820C, and 1000C series).
|
|
<P>
|
|
|
|
(PNM format output can be produced from PostScript(tm) input by the
|
|
GhostScript output devices "pbmraw", "pgmraw" or "ppmraw", or by "pnmraw",
|
|
which will choose one of these formats as appropriate for the document.)
|
|
<B>pnm2ppa</B> assumes the input resolution is 600dpi (or 300dpi if
|
|
the command-line option <B>--dpi300</B> is used): input at higher/lower
|
|
resolutions will result in a correspondingly larger/smaller printed image,
|
|
provided it is within the printer's allowed size range.
|
|
<P>
|
|
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-b </B><I>bottommargin</I><DD>
|
|
Sets the bottom margin <I>bottommargin</I> in units of 1/600 inches (e.g., <B> -b 150</B> corresponds to 0.25").
|
|
|
|
<P>
|
|
|
|
<DT id="2"><B>-B </B><I>blackness</I><DD>
|
|
Sets the black ink density <I>blackness</I> in drops per pixel (0,1,2,3,4).
|
|
|
|
<P>
|
|
|
|
<DT id="3"><B>--bi</B><DD>
|
|
Force bidirectional print sweeps.
|
|
|
|
<P>
|
|
|
|
<DT id="4"><B>--bw</B><DD>
|
|
Disables the color cartridge; will print in grey scale using only the black cartridge.
|
|
|
|
<P>
|
|
|
|
<DT id="5"><B>-d</B><DD>
|
|
Displays the current configuration.
|
|
|
|
<P>
|
|
|
|
<DT id="6"><B>--dpi300</B><DD>
|
|
Treat input resolution as 300dpi instead of 600dpi.
|
|
|
|
<P>
|
|
|
|
<DT id="7"><B>--eco</B><DD>
|
|
Econofast mode: lower print quality that is faster and saves ink.
|
|
|
|
<P>
|
|
|
|
<DT id="8"><B>-f </B><I>configFile</I><DD>
|
|
Re-reads configuration from <I>configFile</I> (after
|
|
initially reading it from /etc/pnm2ppa.conf).
|
|
|
|
<P>
|
|
|
|
<DT id="9"><B>-F </B><I>GammaFile</I><DD>
|
|
Overrides reading the color-correction table (Gamma curve) from the default
|
|
file /etc/pnm2ppa.gamma, and uses <I>GammaFile</I> instead.
|
|
|
|
<P>
|
|
|
|
<DT id="10"><B>--fd</B><DD>
|
|
Enable fast ordered dithering instead of using the slower, but beautiful, Floyd-Steinberg dithering. (Has no effect in --bw mode.)
|
|
|
|
<P>
|
|
|
|
<DT id="11"><B>-g</B><DD>
|
|
Prints a page of color intensity samples (for comparison with gamma.ppm
|
|
data produced by calibrate_ppa).
|
|
This is part of a <B>color-correction</B> procedure; see COLOR.txt for more details.
|
|
|
|
<P>
|
|
|
|
<DT id="12"><B>-h, --help</B><DD>
|
|
Displays program usage.
|
|
|
|
<P>
|
|
|
|
<DT id="13"><B>-i </B><I>infile</I><DD>
|
|
Input file <I>infile</I> is either a path to a PPM file, or '-' to indicate stdin (defaults to stdin).
|
|
|
|
<P>
|
|
|
|
<DT id="14"><B>-l </B><I>leftmargin</I><DD>
|
|
Sets the left margin <I>leftmargin</I> in units of 1/600 inches (e.g., <B>-l 150</B> corresponds to 0.25").
|
|
|
|
<P>
|
|
|
|
<DT id="15"><B>--noGamma</B><DD>
|
|
Switches off any color-correction.
|
|
|
|
<P>
|
|
|
|
<DT id="16"><B>-o </B><I>outfile</I> | - <DD>
|
|
Output file <I>outfile</I> is either a path to a file or device, or '-' to indicate stdout (defaults to stdout).
|
|
|
|
<P>
|
|
|
|
<DT id="17"><B>-p</B><DD>
|
|
Disables the black ink cartridge; i.e., print using only the color ink cartridge, even for printing "black". This might be useful for printing high-quality
|
|
color images.
|
|
|
|
<P>
|
|
|
|
<DT id="18"><B>-r </B><I>rightmargin</I><DD>
|
|
Sets the right margin <I>rightmargin</I> in units of 1/600 inches (e.g., <B>-r 150</B> corresponds to 0.25").
|
|
|
|
<P>
|
|
|
|
<DT id="19"><B>-s </B><I>papersize</I><DD>
|
|
Sets the default paper size (now used only for color-correction output
|
|
produced by the <B>-g</B> option).
|
|
In normal use, pnm2ppa now instead reads the paper dimensions from
|
|
pnm input file headers, and
|
|
checks that it is a valid papersize for the given printer model.
|
|
Possible values for <I>papersize</I> are <B>a4</B> (A4),
|
|
<B>letter</B> or <B>us</B> (US Letter, 8.5"x11"), <B>legal</B> (US Legal,
|
|
8.5"x14").
|
|
The default is US Letter.
|
|
|
|
<P>
|
|
|
|
<DT id="20"><B>-t </B><I>topmargin</I><DD>
|
|
Sets the top margin <I>topmargin</I> in units of 1/600 inches (ie <B>-t 150</B> corresponds to 0.25").
|
|
|
|
<P>
|
|
|
|
<DT id="21"><B>--uni</B><DD>
|
|
Force unidirectional (left to right) print sweeps. Useful if
|
|
"shearing" is a problem for high quality color images.
|
|
|
|
<P>
|
|
|
|
<DT id="22"><B>-v </B><I>printertype</I><DD>
|
|
Selects the printer model. Possible values of <I>printertype</I> are:
|
|
<B>710</B>, <B>712</B>, <B>720</B>, <B>722</B>, <B>820</B> and <B>1000</B>.
|
|
The default is the HP DeskJet 7X0 Series (710, 712, 720, 722).
|
|
|
|
<P>
|
|
|
|
<DT id="23"><B>--verbose</B><DD>
|
|
Displays the program's System Log messages on the standard output, as well.
|
|
|
|
<P>
|
|
|
|
<DT id="24"><B>--version</B><DD>
|
|
Displays the program's version information.
|
|
|
|
<P>
|
|
|
|
<DT id="25"><B>-x </B><I>xoffset</I><DD>
|
|
Sets the x-offset <I>xoffset</I> from the left of the page. Units are 1/600 inches.
|
|
|
|
<P>
|
|
|
|
<DT id="26"><B>-y </B><I>yoffset</I><DD>
|
|
Sets the y-offset <I>yoffset</I> from the top of the page. Units are 1/600 inches.
|
|
|
|
<P>
|
|
<BR>
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>NOTES</H2>
|
|
|
|
The default configuration file <I>/etc/pnm2ppa.conf</I> is read in first. Command line arguments then modify the resulting definitions.
|
|
<P>
|
|
|
|
The <B>-v</B> option resets all definitions (margins, offsets, etc.) back to
|
|
the inbuilt defaults for that printer and should be used before subsequent
|
|
<B>-b</B>, <B>-l</B>, <B>-r</B>, <B>-t</B>, <B>-x</B> and <B>-y</B> arguments.
|
|
<A NAME="lbAG"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?5+pnm">pnm</A>(5), <A HREF="/cgi-bin/man/man2html?5+ppm">ppm</A>(5), <A HREF="/cgi-bin/man/man2html?5+pbm">pbm</A>(5)
|
|
<P>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="27"><B></B><I>/etc/pnm2ppa.conf</I><DD>
|
|
Default configuration file.
|
|
|
|
<P>
|
|
|
|
<DT id="28"><B></B><I>/etc/pnm2ppa.gamma</I><DD>
|
|
Default Gamma (color-correction) file.
|
|
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
This code is licensed under the GNU Public License version 2. See
|
|
LICENSE for details.
|
|
<P>
|
|
|
|
(c) 1998-1999<TT> </TT>Tim Norman<BR>
|
|
<P>
|
|
|
|
(c) 1999<TT> </TT>Giorgio Marzano<BR>
|
|
<P>
|
|
|
|
(c) 1999<TT> </TT>Andrew van der Stock<BR>
|
|
<P>
|
|
|
|
(c) 1998-2002<TT> </TT>Various authors for many, many fixes<BR>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>HISTORY</H2>
|
|
|
|
This program was originally pbm2ppa, written by Tim Norman. It originally
|
|
supported black and white output on the 820 series.
|
|
Tim added nascent color support in early
|
|
1999. In May 1999, Giorgio Marzano started making real headway in getting
|
|
color support working properly. Andrew van der Stock has maintained
|
|
the code since September 1999, and made it available at
|
|
<A HREF="http://sourceforge.net/projects/pnm2ppa.">http://sourceforge.net/projects/pnm2ppa.</A>
|
|
<A NAME="lbAK"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
Faint horizontal lines marking boundaries between print sweeps may be visible.
|
|
You may get better results when printing images, with the options:
|
|
<BR> <B> -p --uni </B> (this may no longer apply since recent code improvements).
|
|
<P>
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="29"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="30"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="31"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="32"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="33"><A HREF="#lbAF">NOTES</A><DD>
|
|
<DT id="34"><A HREF="#lbAG">SEE ALSO</A><DD>
|
|
<DT id="35"><A HREF="#lbAH">FILES</A><DD>
|
|
<DT id="36"><A HREF="#lbAI">AUTHOR</A><DD>
|
|
<DT id="37"><A HREF="#lbAJ">HISTORY</A><DD>
|
|
<DT id="38"><A HREF="#lbAK">BUGS</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:23 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|