src/3rdparty/libtiff/html/man/fax2ps.1.html
changeset 30 5dc02b23752f
parent 0 1918ee327afb
equal deleted inserted replaced
29:b72c6db6890b 30:5dc02b23752f
     1 <!-- Creator     : groff version 1.18.1 -->
     1 <!-- Creator     : groff version 1.18.1 -->
     2 <!-- CreationDate: Mon Mar 13 18:03:11 2006 -->
     2 <!-- CreationDate: Fri Jul 13 17:43:18 2007 -->
     3 <html>
     3 <html>
     4 <head>
     4 <head>
     5 <meta name="generator" content="groff -Thtml, see www.gnu.org">
     5 <meta name="generator" content="groff -Thtml, see www.gnu.org">
     6 <meta name="Content-Style" content="text/css">
     6 <meta name="Content-Style" content="text/css">
     7 <title>FAX2PS</title>
     7 <title>FAX2PS</title>
    26        cols="2" cellspacing="0" cellpadding="0">
    26        cols="2" cellspacing="0" cellpadding="0">
    27 <tr valign="top" align="left">
    27 <tr valign="top" align="left">
    28 <td width="8%"></td>
    28 <td width="8%"></td>
    29 <td width="91%">
    29 <td width="91%">
    30 <p>fax2ps &minus; convert a <small>TIFF</small> facsimile to
    30 <p>fax2ps &minus; convert a <small>TIFF</small> facsimile to
    31 compressed &trade;</p>
    31 compressed PostScript&trade;</p>
    32 </td>
    32 </td>
    33 </table>
    33 </table>
    34 <a name="SYNOPSIS"></a>
    34 <a name="SYNOPSIS"></a>
    35 <h2>SYNOPSIS</h2>
    35 <h2>SYNOPSIS</h2>
    36 <!-- INDENTATION -->
    36 <!-- INDENTATION -->
    37 <table width="100%" border=0 rules="none" frame="void"
    37 <table width="100%" border=0 rules="none" frame="void"
    38        cols="2" cellspacing="0" cellpadding="0">
    38        cols="2" cellspacing="0" cellpadding="0">
    39 <tr valign="top" align="left">
    39 <tr valign="top" align="left">
    40 <td width="8%"></td>
    40 <td width="8%"></td>
    41 <td width="91%">
    41 <td width="91%">
    42 <p><b>fax2ps</b> [ <i>options</i> ] [ <i>file</i>... ]</p>
    42 <p><b>fax2ps</b> [ <i>options</i> ] [ <i>file ...</i> ]</p>
    43 </td>
    43 </td>
    44 </table>
    44 </table>
    45 <a name="DESCRIPTION"></a>
    45 <a name="DESCRIPTION"></a>
    46 <h2>DESCRIPTION</h2>
    46 <h2>DESCRIPTION</h2>
    47 <!-- INDENTATION -->
    47 <!-- INDENTATION -->
    49        cols="2" cellspacing="0" cellpadding="0">
    49        cols="2" cellspacing="0" cellpadding="0">
    50 <tr valign="top" align="left">
    50 <tr valign="top" align="left">
    51 <td width="8%"></td>
    51 <td width="8%"></td>
    52 <td width="91%">
    52 <td width="91%">
    53 <p><i>fax2ps</i> reads one or more <small>TIFF</small>
    53 <p><i>fax2ps</i> reads one or more <small>TIFF</small>
    54 facsimile image files and prints a compressed form of on the
    54 facsimile image files and prints a compressed form of
    55 standard output that is suitable for printing.</p>
    55 PostScript on the standard output that is suitable for
       
    56 printing.</p>
    56 <!-- INDENTATION -->
    57 <!-- INDENTATION -->
    57 <p>By default, each page is scaled to reflect the image
    58 <p>By default, each page is scaled to reflect the image
    58 dimensions and resolutions stored in the file. The
    59 dimensions and resolutions stored in the file. The
    59 <b>&minus;x</b> and <b>&minus;y</b> options can be used to
    60 <b>&minus;x</b> and <b>&minus;y</b> options can be used to
    60 specify the horizontal and vertical image resolutions
    61 specify the horizontal and vertical image resolutions
    62 specified, each page is scaled to fill an output page. The
    63 specified, each page is scaled to fill an output page. The
    63 default output page is 8.5 by 11 inches. Alternate page
    64 default output page is 8.5 by 11 inches. Alternate page
    64 dimensions can be specified in inches with the
    65 dimensions can be specified in inches with the
    65 <b>&minus;W</b> and <b>&minus;H</b> options.</p>
    66 <b>&minus;W</b> and <b>&minus;H</b> options.</p>
    66 <!-- INDENTATION -->
    67 <!-- INDENTATION -->
    67 <p>By default <i>fax2ps</i> generates for all pages in the
    68 <p>By default <i>fax2ps</i> generates PostScript for all
    68 file. The <b>&minus;p</b> option can be used to select one
    69 pages in the file. The <b>&minus;p</b> option can be used to
    69 or more pages from a multi-page document.</p>
    70 select one or more pages from a multi-page document.</p>
    70 <!-- INDENTATION -->
    71 <!-- INDENTATION -->
    71 <p><i>fax2ps</i> generates a compressed form of that is
    72 <p><i>fax2ps</i> generates a compressed form of PostScript
    72 optimized for sending pages of text to a printer attached to
    73 that is optimized for sending pages of text to a PostScript
    73 a host through a low-speed link (such as a serial line).
    74 printer attached to a host through a low-speed link (such as
    74 Each output page is filled with white and then only the
    75 a serial line). Each output page is filled with white and
    75 black areas are drawn. The specification of the black
    76 then only the black areas are drawn. The PostScript
    76 drawing operations is optimized by using a special font that
    77 specification of the black drawing operations is optimized
    77 encodes the move-draw operations required to fill the black
    78 by using a special font that encodes the move-draw
    78 regions on the page. This compression scheme typically
    79 operations required to fill the black regions on the page.
    79 results in a substantially reduced description, relative to
    80 This compression scheme typically results in a substantially
    80 the straightforward imaging of the page with a <i>image</i>
    81 reduced PostScript description, relative to the
    81 operator. This algorithm can, however, be ineffective for
    82 straightforward imaging of the page with a PostScript
    82 continuous-tone and white-on-black images. For these images,
    83 <i>image</i> operator. This algorithm can, however, be
    83 it sometimes is more efficient to send the raster bitmap
    84 ineffective for continuous-tone and white-on-black images.
    84 image directly; see <i>tiff2ps</i>(1).</p>
    85 For these images, it sometimes is more efficient to send the
       
    86 raster bitmap image directly; see <b>tiff2ps</b>(1).</p>
    85 </td>
    87 </td>
    86 </table>
    88 </table>
    87 <a name="OPTIONS"></a>
    89 <a name="OPTIONS"></a>
    88 <h2>OPTIONS</h2>
    90 <h2>OPTIONS</h2>
    89 <!-- TABS -->
    91 <!-- TABS -->
    90 <table width="100%" border=0 rules="none" frame="void"
    92 <table width="100%" border=0 rules="none" frame="void"
    91        cols="5" cellspacing="0" cellpadding="0">
    93        cols="4" cellspacing="0" cellpadding="0">
    92 <tr valign="top" align="left">
    94 <tr valign="top" align="left">
    93 <td width="10%"></td>
    95 <td width="11%"></td>
    94 <td width="11%">
    96 <td width="11%">
    95 
    97 
    96 <p><b>&minus;p</b> <i>number</i></p>
    98 <p><b>&minus;p</b> <i>number</i></p>
    97 </td>
    99 </td>
    98 <td width="1%"></td>
       
    99 <td width="76%">
   100 <td width="76%">
   100 
   101 
   101 <p>Print only the indicated page. Multiple pages may be
   102 <p>Print only the indicated page. Multiple pages may be
   102 printed by specifying this option more than once.</p>
   103 printed by specifying this option more than once.</p>
   103 </td>
   104 </td>
   142 taken from the file.</p>
   143 taken from the file.</p>
   143 </td>
   144 </td>
   144 </table>
   145 </table>
   145 <!-- TABS -->
   146 <!-- TABS -->
   146 <table width="100%" border=0 rules="none" frame="void"
   147 <table width="100%" border=0 rules="none" frame="void"
   147        cols="5" cellspacing="0" cellpadding="0">
   148        cols="4" cellspacing="0" cellpadding="0">
   148 <tr valign="top" align="left">
   149 <tr valign="top" align="left">
   149 <td width="10%"></td>
   150 <td width="10%"></td>
   150 <td width="11%">
   151 <td width="12%">
   151 
   152 
   152 <p><b>&minus;S</b></p>
   153 <p><b>&minus;S</b></p>
   153 </td>
   154 </td>
   154 <td width="1%"></td>
       
   155 <td width="76%">
   155 <td width="76%">
   156 
   156 
   157 <p>Scale each page of image data to fill the output page
   157 <p>Scale each page of image data to fill the output page
   158 dimensions. By default images are presented according to the
   158 dimensions. By default images are presented according to the
   159 dimension information recorded in the <small>TIFF</small>
   159 dimension information recorded in the <small>TIFF</small>
   161 </td>
   161 </td>
   162 <td width="0%">
   162 <td width="0%">
   163 </td>
   163 </td>
   164 <tr valign="top" align="left">
   164 <tr valign="top" align="left">
   165 <td width="10%"></td>
   165 <td width="10%"></td>
   166 <td width="11%">
   166 <td width="12%">
   167 
   167 
   168 <p><b>&minus;W</b> <i>width</i></p>
   168 <p><b>&minus;W</b> <i>width</i></p>
   169 </td>
   169 </td>
   170 <td width="1%"></td>
       
   171 <td width="76%">
   170 <td width="76%">
   172 
   171 
   173 <p>Use <i>width</i> as the width, in inches, of the output
   172 <p>Use <i>width</i> as the width, in inches, of the output
   174 page.</p>
   173 page.</p>
   175 </td>
   174 </td>
   176 <td width="0%">
   175 <td width="0%">
   177 </td>
   176 </td>
   178 <tr valign="top" align="left">
   177 <tr valign="top" align="left">
   179 <td width="10%"></td>
   178 <td width="10%"></td>
   180 <td width="11%">
   179 <td width="12%">
   181 
   180 
   182 <p><b>&minus;H</b> <i>height</i></p>
   181 <p><b>&minus;H</b> <i>height</i></p>
   183 </td>
   182 </td>
   184 <td width="1%"></td>
       
   185 <td width="76%">
   183 <td width="76%">
   186 
   184 
   187 <p>Use <i>height</i> as the height, in inches, of the
   185 <p>Use <i>height</i> as the height, in inches, of the
   188 output page.</p>
   186 output page.</p>
   189 </td>
   187 </td>
   204 <p>Various messages about badly formatted facsimile images
   202 <p>Various messages about badly formatted facsimile images
   205 may be generated due to transmission errors in received
   203 may be generated due to transmission errors in received
   206 facsimile. <i>fax2ps</i> attempts to recover from such data
   204 facsimile. <i>fax2ps</i> attempts to recover from such data
   207 errors by resynchronizing decoding at the end of the current
   205 errors by resynchronizing decoding at the end of the current
   208 scanline. This can result in long horizontal black lines in
   206 scanline. This can result in long horizontal black lines in
   209 the resultant image.</p>
   207 the resultant PostScript image.</p>
   210 </td>
   208 </td>
   211 </table>
   209 </table>
   212 <a name="NOTES"></a>
   210 <a name="NOTES"></a>
   213 <h2>NOTES</h2>
   211 <h2>NOTES</h2>
   214 <!-- INDENTATION -->
   212 <!-- INDENTATION -->
   215 <table width="100%" border=0 rules="none" frame="void"
   213 <table width="100%" border=0 rules="none" frame="void"
   216        cols="2" cellspacing="0" cellpadding="0">
   214        cols="2" cellspacing="0" cellpadding="0">
   217 <tr valign="top" align="left">
   215 <tr valign="top" align="left">
   218 <td width="8%"></td>
   216 <td width="8%"></td>
   219 <td width="91%">
   217 <td width="91%">
   220 <p>If the destination printer supports Level II then it is
   218 <p>If the destination printer supports PostScript Level II
   221 always faster to just send the encoded bitmap generated by
   219 then it is always faster to just send the encoded bitmap
   222 the <b>tiff2ps</b>(1) program.</p>
   220 generated by the <b>tiff2ps</b>(1) program.</p>
   223 </td>
   221 </td>
   224 </table>
   222 </table>
   225 <a name="BUGS"></a>
   223 <a name="BUGS"></a>
   226 <h2>BUGS</h2>
   224 <h2>BUGS</h2>
   227 <!-- INDENTATION -->
   225 <!-- INDENTATION -->
   229        cols="2" cellspacing="0" cellpadding="0">
   227        cols="2" cellspacing="0" cellpadding="0">
   230 <tr valign="top" align="left">
   228 <tr valign="top" align="left">
   231 <td width="8%"></td>
   229 <td width="8%"></td>
   232 <td width="91%">
   230 <td width="91%">
   233 <p><i>fax2ps</i> should probably figure out when it is doing
   231 <p><i>fax2ps</i> should probably figure out when it is doing
   234 a poor job of compressing the output and just generate to
   232 a poor job of compressing the output and just generate
   235 image the bitmap raster instead.</p>
   233 PostScript to image the bitmap raster instead.</p>
   236 </td>
   234 </td>
   237 </table>
   235 </table>
   238 <a name="SEE ALSO"></a>
   236 <a name="SEE ALSO"></a>
   239 <h2>SEE ALSO</h2>
   237 <h2>SEE ALSO</h2>
   240 <!-- INDENTATION -->
   238 <!-- INDENTATION -->