| 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 − convert a <small>TIFF</small> facsimile to |
| 31 | compressed ™</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>−x</b> and <b>−y</b> options can be used to |
| 60 | specify the horizontal and vertical image resolutions |
| 61 | (lines/inch), respectively. If the <b>−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>−W</b> and <b>−H</b> options.</p> |
| 66 | <!-- INDENTATION --> |
| 67 | <p>By default <i>fax2ps</i> generates for all pages in the |
| 68 | file. The <b>−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>−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>−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>−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>−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>−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>−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> |