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
31compressed 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>
54facsimile image files and prints a compressed form of
55PostScript on the standard output that is suitable for
56printing.</p>
57<!-- INDENTATION -->
58<p>By default, each page is scaled to reflect the image
59dimensions and resolutions stored in the file. The
60<b>&minus;x</b> and <b>&minus;y</b> options can be used to
61specify the horizontal and vertical image resolutions
62(lines/inch), respectively. If the <b>&minus;S</b> option is
63specified, each page is scaled to fill an output page. The
64default output page is 8.5 by 11 inches. Alternate page
65dimensions 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
69pages in the file. The <b>&minus;p</b> option can be used to
70select one or more pages from a multi-page document.</p>
71<!-- INDENTATION -->
72<p><i>fax2ps</i> generates a compressed form of PostScript
73that is optimized for sending pages of text to a PostScript
74printer attached to a host through a low-speed link (such as
75a serial line). Each output page is filled with white and
76then only the black areas are drawn. The PostScript
77specification of the black drawing operations is optimized
78by using a special font that encodes the move-draw
79operations required to fill the black regions on the page.
80This compression scheme typically results in a substantially
81reduced PostScript description, relative to the
82straightforward imaging of the page with a PostScript
83<i>image</i> operator. This algorithm can, however, be
84ineffective for continuous-tone and white-on-black images.
85For these images, it sometimes is more efficient to send the
86raster 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
103printed 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
123dots/inch, of the image data. By default this value is taken
124from 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
142lines/inch, of the image data. By default this value is
143taken 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
158dimensions. By default images are presented according to the
159dimension information recorded in the <small>TIFF</small>
160file.</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
173page.</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
186output 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
200come from the <small>TIFF</small> library.</p>
201<!-- INDENTATION -->
202<p>Various messages about badly formatted facsimile images
203may be generated due to transmission errors in received
204facsimile. <i>fax2ps</i> attempts to recover from such data
205errors by resynchronizing decoding at the end of the current
206scanline. This can result in long horizontal black lines in
207the 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
219then it is always faster to just send the encoded bitmap
220generated 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
232a poor job of compressing the output and just generate
233PostScript 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.simplesystems.org/libtiff/</b></p>
248</td>
249</table>
250<hr>
251</body>
252</html>
253