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

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