libtiff/html/man/fax2ps.1.html
1999-11-23 04:29:23 +00:00

211 lines
5.3 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML><HEAD><TITLE>Manpage of FAX2PS</TITLE>
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
<H1>FAX2PS</H1>
Section: User Commands (1)<BR>Updated: March 16, 1995<BR><A HREF="#index">Index</A>
<BR><A HREF="index.html">Return to Main Contents</A>
<HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
fax2ps - convert a
<FONT SIZE="-1">TIFF</FONT>
facsimile to compressed P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT>tm
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>fax2ps</B>
[
<I>options</I>
] [
<I>file</I>...
]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<I>fax2ps</I>
reads one or more
<FONT SIZE="-1">TIFF</FONT>
facsimile image files and prints a compressed form of
P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> on the standard output that is suitable for printing.
<P>
By default, each page is scaled to reflect the
image dimensions and resolutions stored in the file.
The
<B>-x</B>
and
<B>-y</B>
options can be used to specify the horizontal and vertical
image resolutions (lines/inch), respectively.
If the
<B>-S</B>
option is specified, each page is scaled to fill an output page.
The default output page is 8.5 by 11 inches.
Alternate page dimensions can be specified in inches with the
<B>-W</B>
and
<B>-H</B>
options.
<P>
By default
<I>fax2ps</I>
generates P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> for all pages in the file.
The
<B>-p</B>
option can be used to select one or more pages from
a multi-page document.
<P>
<I>fax2ps</I>
generates a compressed form of P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> that is
optimized for sending pages of text to a P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT>
printer attached to a host through a low-speed link (such
as a serial line).
Each output page is filled with white and then only
the black areas are drawn.
The P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> specification of the black drawing operations
is optimized by using a special font that encodes the
move-draw operations required to fill
the black regions on the page.
This compression scheme typically results in a substantially
reduced P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> description, relative to the straightforward
imaging of the page with a P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT>
<I>image</I>
operator.
This algorithm can, however, be ineffective
for continuous-tone and white-on-black images.
For these images, it sometimes is more efficient to send
the raster bitmap image directly; see
<I><A HREF="tiff2ps+1.html">tiff2ps</A></I>(1).
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT><B>-p</B><I> number</I>
<DD>
Print only the indicated page.
Multiple pages may be printed by specifying
this option more than once.
<DT><B>-x</B><I> resolution</I>
<DD>
Use
<I>resolution</I>
as the horizontal resolution, in dots/inch, of the image data.
By default this value is taken from the file.
<DT><B>-y</B><I> resolution</I>
<DD>
Use
<I>resolution</I>
as the vertical resolution, in lines/inch, of the image data.
By default this value is taken from the file.
<DT><B>-S</B>
<DD>
Scale each page of image data to fill the output page dimensions.
By default images are presented according to the dimension
information recorded in the
<FONT SIZE="-1">TIFF</FONT>
file.
<DT><B>-W</B><I> width</I>
<DD>
Use
<I>width</I>
as the width, in inches, of the output page.
The default page width is 8.5 inches.
<DT><B>-H</B><I> height</I>
<DD>
Use
<I>height</I>
as the height, in inches, of the output page.
The default page height is 11 inches.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>DIAGNOSTICS</H2>
Some messages about malformed
<FONT SIZE="-1">TIFF</FONT>
images come from the
<FONT SIZE="-1">TIFF</FONT>
library.
<P>
Various messages about badly formatted facsimile images
may be generated due to transmission errors in received
facsimile.
<I>fax2ps</I>
attempts to recover from such data errors by resynchronizing
decoding at the end of the current scanline.
This can result in long horizontal black lines in the resultant
P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> image.
<A NAME="lbAG">&nbsp;</A>
<H2>NOTES</H2>
If the destination printer supports P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> Level II then
it is always faster to just send the encoded bitmap generated
by the
<I><A HREF="tiff2ps+1.html">tiff2ps</A></I>(1)
program.
<A NAME="lbAH">&nbsp;</A>
<H2>BUGS</H2>
<I>fax2ps</I>
should probably figure out when it is doing a poor
job of compressing the output and just generate
P<FONT SIZE="-2">OST</FONT>S<FONT SIZE="-2">CRIPT</FONT> to image the bitmap raster instead.
<A NAME="lbAI">&nbsp;</A>
<H2>SEE ALSO</H2>
<I><A HREF="tiff2ps+1.html">tiff2ps</A></I>(1),
<I><A HREF="libtiff+3">libtiff</A></I>(3)
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT><A HREF="#lbAB">NAME</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT><A HREF="#lbAE">OPTIONS</A><DD>
<DT><A HREF="#lbAF">DIAGNOSTICS</A><DD>
<DT><A HREF="#lbAG">NOTES</A><DD>
<DT><A HREF="#lbAH">BUGS</A><DD>
<DT><A HREF="#lbAI">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="index.html">man2html</A>,
using the manual pages.<BR>
Time: 01:31:47 GMT, November 23, 1999
</BODY>
</HTML>