<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [

<!--ArborText, Inc., 1988-1999, v.4002-->

<!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">

<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>

<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>