<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!--ARC : LSARC 2003/085 libtiff, libjpeg, and libpng-->
<!ENTITY cmd "fax2ps">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY suncopy "Copyright (c) 2004, Sun Microsystems, Inc. All Rights Reserved.">
]>
<?Pub UDT _bookmark _target>
<?Pub Inc>
<refentry id="fax2ps-1">
<!-- %Z%%M% %I% %E% SMI; -->
<refmeta><refentrytitle>fax2ps</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">26 Mar 2004</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&release;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">&suncopy;</refmiscinfo>
</refmeta>
<indexterm><primary>fax2ps</primary></indexterm><indexterm><primary>convert
a TIFF facsimile to compressed PostScript</primary></indexterm>
<refnamediv id="fax2ps-1-name"><refname>fax2ps</refname><refpurpose>convert
a TIFF facsimile to compressed PostScript</refpurpose></refnamediv>
<refsynopsisdiv id="fax2ps-1-synp"><title>&synp-tt;</title>
<cmdsynopsis><command>&cmd;</command><arg choice="opt"><option role="nodash"><replaceable>
options</replaceable></option></arg><arg choice="opt"><option role="nodash"><replaceable>
file</replaceable></option></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1 id="fax2ps-1-desc"><title>&desc-tt;</title>
<para><command>&cmd;</command> reads one or more TIFF facsimile image files
and prints a compressed form of PostScript that is suitable for printing on
the standard output.</para>
</refsect1>
<refsect1 id="fax2ps-1-opts"><title>&opts-tt;</title>
<para>The following options are supported:</para>
<variablelist termlength="narrow">
<varlistentry><term><option>H <replaceable>height</replaceable></option></term>
<listitem><para>Use height as the height, in inches, of the output page. The
default page height is 11 inches.</para>
</listitem></varlistentry>
<varlistentry><term><option>p <replaceable>number</replaceable></option></term>
<listitem><para>Print only the indicated page. To print multiple pages, specify
this option as often as required.</para>
</listitem></varlistentry>
<varlistentry><term><option>S</option></term><listitem><para>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 TIFF file.</para>
</listitem></varlistentry>
<varlistentry><term><option>W <replaceable>width</replaceable></option></term>
<listitem><para>Use <replaceable>width</replaceable> as the width, in inches,
of the output page. The default page width is 8.5 inches.</para>
</listitem></varlistentry>
<varlistentry><term><option>x <replaceable>resolution</replaceable></option></term>
<listitem><para>Use <replaceable>resolution</replaceable> as the horizontal
resolution, in dots per inch, of the image data. By default, this value is
taken from the file.</para>
</listitem></varlistentry>
<varlistentry><term><option>y <replaceable>resolution</replaceable></option></term>
<listitem><para>Use <replaceable>resolution</replaceable> as the vertical
resolution, in lines per inch, of the image data. By default, this value is
taken from the file.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1 id="fax2ps-1-oper"><title>&oper-tt;</title>
<para>The following operands are supported:</para>
<variablelist termlength="narrow">
<varlistentry><term><option role="nodash"><replaceable>file</replaceable></option></term>
<listitem><para>The name of the TIFF facsimile image file to be converted
to compressed PostScript.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1 id="fax2ps-1-exde"><title>&exde-tt;</title>
<para>By default, each page is scaled to reflect the image dimensions and
resolutions stored in the file. The <option>x</option> and <option>y</option>
options can be used to specify the horizontal and vertical image resolutions,
respectively. If the <option>S</option> 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 <option>W</option>
and <option>H</option> options.</para>
<para>By default, <command>&cmd;</command> generates PostScript for all pages
in the file. You can use the <option>p</option> option to select one or more
pages from a multipage document.</para>
<para><command>&cmd;</command> generates a compressed form of PostScript that
is optimized for sending pages of text to a PostScript 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 PostScript
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 PostScript description, relative to the straightforward imaging of
the page with a PostScript image 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 <citerefentry>
<refentrytitle>tiff2ps</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
If the destination printer supports PostScript Level II, it is always faster
to just send the encoded bitmap generated by the <citerefentry><refentrytitle>
tiff2ps</refentrytitle><manvolnum>1</manvolnum></citerefentry> command.</para>
<refsect2 id="fax2ps-1-exde-diags">
<title>Diagnostics</title>
<para>Some messages about malformed TIFF images come from the TIFF library.
</para>
<para>Various messages about badly formatted facsimile images may be generated
due to transmission errors in received facsimile. <command>&cmd;</command>
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 PostScript image.</para>
</refsect2>
</refsect1>
<refsect1 id="fax2ps-1-exam"><title>&exam-tt;</title>
<example role="example">
<title>Converting the Tiff File test.tif to Compressed PostScript</title>
<para><screen>example% <userinput>&cmd; test.tif</userinput></screen></para>
</example>
</refsect1>
<refsect1 id="fax2ps-1-attr"><title>&attr-tt;</title>
<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>
<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>
for descriptions of the following attributes:</para>
<informaltable frame="all">
<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">
<colspec colname="COLSPEC1" colwidth="1*">
<thead>
<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"
valign="middle">ATTRIBUTE VALUE</entry></row>
</thead>
<tbody>
<row><entry><para>Availability</para></entry><entry><para>image/library/libtiff</para></entry>
</row>
<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry
colname="COLSPEC1"><para>Uncommitted</para></entry></row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="fax2ps-1-also"><title>&also-tt;</title>
<!--Reference to another man page-->
<!--Reference to a Help manual-->
<!--Reference to a book.-->
<para><citerefentry><refentrytitle>tiff2ps</refentrytitle><manvolnum>1</manvolnum>
</citerefentry>, <citerefentry><refentrytitle>libtiff</refentrytitle><manvolnum>
3</manvolnum></citerefentry></para>
</refsect1>
<refsect1 id="fax2ps-1-note"><title>&note-tt;</title>
<para>Updated by Breda McColgan, Sun Microsystems Inc., 2004.</para>
</refsect1>
</refentry>
