src/tiff/html/man/fax2ps.1.html

   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>