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