projects / wxWidgets.git / blame
| Commit | Line | Data |
|---|---|---|
| 8414a40c | 1 | <!-- Creator : groff version 1.18.1 --> |
| 80ed523f | 2 | <!-- CreationDate: Sat Feb 24 18:37:18 2007 --> |
| 8414a40c VZ |
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 | |
| 80ed523f | 31 | compressed PostScript™</p> |
| 8414a40c VZ |
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%"> | |
| 80ed523f | 42 | <p><b>fax2ps</b> [ <i>options</i> ] [ <i>file ...</i> ]</p> |
| 8414a40c VZ |
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> | |
| 80ed523f VZ |
54 | facsimile image files and prints a compressed form of |
| 55 | PostScript on the standard output that is suitable for | |
| 56 | printing.</p> | |
| 8414a40c VZ |
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>−x</b> and <b>−y</b> options can be used to | |
| 61 | specify the horizontal and vertical image resolutions | |
| 62 | (lines/inch), respectively. If the <b>−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>−W</b> and <b>−H</b> options.</p> | |
| 67 | <!-- INDENTATION --> | |
| 80ed523f VZ |
68 | <p>By default <i>fax2ps</i> generates PostScript for all |
| 69 | pages in the file. The <b>−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> | |
| 8414a40c VZ |
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" | |
| 80ed523f | 93 | cols="4" cellspacing="0" cellpadding="0"> |
| 8414a40c | 94 | <tr valign="top" align="left"> |
| 80ed523f | 95 | <td width="11%"></td> |
| 8414a40c VZ |
96 | <td width="11%"> |
| 97 | ||
| 98 | <p><b>−p</b> <i>number</i></p> | |
| 99 | </td> | |
| 8414a40c VZ |
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>−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>−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" | |
| 80ed523f | 148 | cols="4" cellspacing="0" cellpadding="0"> |
| 8414a40c VZ |
149 | <tr valign="top" align="left"> |
| 150 | <td width="10%"></td> | |
| 80ed523f | 151 | <td width="12%"> |
| 8414a40c VZ |
152 | |
| 153 | <p><b>−S</b></p> | |
| 154 | </td> | |
| 8414a40c VZ |
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> | |
| 80ed523f | 166 | <td width="12%"> |
| 8414a40c VZ |
167 | |
| 168 | <p><b>−W</b> <i>width</i></p> | |
| 169 | </td> | |
| 8414a40c VZ |
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> | |
| 80ed523f | 179 | <td width="12%"> |
| 8414a40c VZ |
180 | |
| 181 | <p><b>−H</b> <i>height</i></p> | |
| 182 | </td> | |
| 8414a40c VZ |
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 | |
| 80ed523f | 207 | the resultant PostScript image.</p> |
| 8414a40c VZ |
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%"> | |
| 80ed523f VZ |
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> | |
| 8414a40c VZ |
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 | |
| 80ed523f VZ |
232 | a poor job of compressing the output and just generate |
| 233 | PostScript to image the bitmap raster instead.</p> | |
| 8414a40c VZ |
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> |