fix wxGTK1 compilation after wxTextEntry DoGetValue() change
[wxWidgets.git] / 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>