|
1 <!-- Creator : groff version 1.18.1 --> |
|
2 <!-- CreationDate: Mon Mar 13 18:03:12 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>FAX2TIFF</title> |
|
8 </head> |
|
9 <body> |
|
10 |
|
11 <h1 align=center>FAX2TIFF</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="#BUGS">BUGS</a><br> |
|
18 <a href="#SEE ALSO">SEE ALSO</a><br> |
|
19 |
|
20 <hr> |
|
21 <a name="NAME"></a> |
|
22 <h2>NAME</h2> |
|
23 <!-- INDENTATION --> |
|
24 <table width="100%" border=0 rules="none" frame="void" |
|
25 cols="2" cellspacing="0" cellpadding="0"> |
|
26 <tr valign="top" align="left"> |
|
27 <td width="8%"></td> |
|
28 <td width="91%"> |
|
29 <p>fax2tiff − create a <small>TIFF</small> Class F fax |
|
30 file from raw fax data</p> |
|
31 </td> |
|
32 </table> |
|
33 <a name="SYNOPSIS"></a> |
|
34 <h2>SYNOPSIS</h2> |
|
35 <!-- INDENTATION --> |
|
36 <table width="100%" border=0 rules="none" frame="void" |
|
37 cols="2" cellspacing="0" cellpadding="0"> |
|
38 <tr valign="top" align="left"> |
|
39 <td width="8%"></td> |
|
40 <td width="91%"> |
|
41 <p><b>fax2tiff</b> [ <i>options</i> ] [ <b>−o</b> |
|
42 <i>output.tif</i> ] <i>input.raw</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>Fax2tiff</i> creates a <small>TIFF</small> file |
|
54 containing <small>CCITT</small> Group 3 or Group 4 encoded |
|
55 data from one or more files containing |
|
56 ‘‘raw’’ Group 3 or Group 4 encoded |
|
57 data (typically obtained directly from a fax modem). By |
|
58 default, each row of data in the resultant |
|
59 <small>TIFF</small> file is 1-dimensionally encoded and |
|
60 padded or truncated to 1728 pixels, as needed. The resultant |
|
61 image is a set of low resolution (98 lines/inch) or medium |
|
62 resolution (196 lines/inch) pages, each of which is a single |
|
63 strip of data. The generated file conforms to the |
|
64 <small>TIFF</small> Class F ( <small>FAX</small> ) |
|
65 specification for storing facsimile data. This means, in |
|
66 particular, that each page of the data does <b>not</b> |
|
67 include the trailing <i>return to control</i> ( |
|
68 <small>RTC</small> ) code; as required for transmission by |
|
69 the <small>CCITT</small> Group 3 specifications. The old, |
|
70 ‘‘classic’’, format is created if |
|
71 the <b>−c</b> option is used. (The Class F format can |
|
72 also be requested with the <b>−f</b> option.)</p> |
|
73 <!-- INDENTATION --> |
|
74 <p>The default name of the output image is <i>fax.tif</i>; |
|
75 this can be changed with the <b>−o</b> option. Each |
|
76 input file is assumed to be a separate page of facsimile |
|
77 data from the same document. The order in which input files |
|
78 are specified on the command line is the order in which the |
|
79 resultant pages appear in the output file.</p> |
|
80 </td> |
|
81 </table> |
|
82 <a name="OPTIONS"></a> |
|
83 <h2>OPTIONS</h2> |
|
84 <!-- INDENTATION --> |
|
85 <table width="100%" border=0 rules="none" frame="void" |
|
86 cols="2" cellspacing="0" cellpadding="0"> |
|
87 <tr valign="top" align="left"> |
|
88 <td width="8%"></td> |
|
89 <td width="91%"> |
|
90 <p>Options that affect the interpretation of input data |
|
91 are:</p> |
|
92 </td> |
|
93 </table> |
|
94 <!-- TABS --> |
|
95 <table width="100%" border=0 rules="none" frame="void" |
|
96 cols="5" cellspacing="0" cellpadding="0"> |
|
97 <tr valign="top" align="left"> |
|
98 <td width="10%"></td> |
|
99 <td width="3%"> |
|
100 |
|
101 <p><b>−3</b></p> |
|
102 </td> |
|
103 <td width="5%"></td> |
|
104 <td width="80%"> |
|
105 |
|
106 <p>Assume input data is <small>CCITT</small> Group 3 |
|
107 encoded (default).</p> |
|
108 </td> |
|
109 <td width="0%"> |
|
110 </td> |
|
111 <tr valign="top" align="left"> |
|
112 <td width="10%"></td> |
|
113 <td width="3%"> |
|
114 |
|
115 <p><b>−4</b></p> |
|
116 </td> |
|
117 <td width="5%"></td> |
|
118 <td width="80%"> |
|
119 |
|
120 <p>Assume input data is <small>CCITT</small> Group 4 |
|
121 encoded.</p> |
|
122 </td> |
|
123 <td width="0%"> |
|
124 </td> |
|
125 <tr valign="top" align="left"> |
|
126 <td width="10%"></td> |
|
127 <td width="3%"> |
|
128 |
|
129 <p><b>−U</b></p> |
|
130 </td> |
|
131 <td width="5%"></td> |
|
132 <td width="80%"> |
|
133 |
|
134 <p>Assume input data is uncompressed (Group 3 or Group |
|
135 4).</p> |
|
136 </td> |
|
137 <td width="0%"> |
|
138 </td> |
|
139 <tr valign="top" align="left"> |
|
140 <td width="10%"></td> |
|
141 <td width="3%"> |
|
142 |
|
143 <p><b>−1</b></p> |
|
144 </td> |
|
145 <td width="5%"></td> |
|
146 <td width="80%"> |
|
147 |
|
148 <p>Assume input data is encoded with the 1-dimensional |
|
149 version of the <small>CCITT</small> Group 3 Huffman encoding |
|
150 algorithm (default).</p> |
|
151 </td> |
|
152 <td width="0%"> |
|
153 </td> |
|
154 <tr valign="top" align="left"> |
|
155 <td width="10%"></td> |
|
156 <td width="3%"> |
|
157 |
|
158 <p><b>−2</b></p> |
|
159 </td> |
|
160 <td width="5%"></td> |
|
161 <td width="80%"> |
|
162 |
|
163 <p>Assume input data is 2-dimensional version of the |
|
164 <small>CCITT</small> Group 3 Huffman encoding algorithm.</p> |
|
165 </td> |
|
166 <td width="0%"> |
|
167 </td> |
|
168 <tr valign="top" align="left"> |
|
169 <td width="10%"></td> |
|
170 <td width="3%"> |
|
171 |
|
172 <p><b>−P</b></p> |
|
173 </td> |
|
174 <td width="5%"></td> |
|
175 <td width="80%"> |
|
176 |
|
177 <p>Assume input data is <b>not</b> EOL-aligned (default). |
|
178 This option has effect with Group 3 encoded input only.</p> |
|
179 </td> |
|
180 <td width="0%"> |
|
181 </td> |
|
182 <tr valign="top" align="left"> |
|
183 <td width="10%"></td> |
|
184 <td width="3%"> |
|
185 |
|
186 <p><b>−A</b></p> |
|
187 </td> |
|
188 <td width="5%"></td> |
|
189 <td width="80%"> |
|
190 |
|
191 <p>Assume input data is EOL-aligned. This option has effect |
|
192 with Group 3 encoded input only.</p> |
|
193 </td> |
|
194 <td width="0%"> |
|
195 </td> |
|
196 <tr valign="top" align="left"> |
|
197 <td width="10%"></td> |
|
198 <td width="3%"> |
|
199 |
|
200 <p><b>−M</b></p> |
|
201 </td> |
|
202 <td width="5%"></td> |
|
203 <td width="80%"> |
|
204 |
|
205 <p>Treat input data as having bits filled from most |
|
206 significant bit ( <small>MSB</small> ) to most least bit ( |
|
207 <small>LSB</small> ).</p> |
|
208 </td> |
|
209 <td width="0%"> |
|
210 </td> |
|
211 <tr valign="top" align="left"> |
|
212 <td width="10%"></td> |
|
213 <td width="3%"> |
|
214 |
|
215 <p><b>−L</b></p> |
|
216 </td> |
|
217 <td width="5%"></td> |
|
218 <td width="80%"> |
|
219 |
|
220 <p>Treat input data as having bits filled from least |
|
221 significant bit ( <small>LSB</small> ) to most significant |
|
222 bit ( <small>MSB</small> ) (default).</p> |
|
223 </td> |
|
224 <td width="0%"> |
|
225 </td> |
|
226 <tr valign="top" align="left"> |
|
227 <td width="10%"></td> |
|
228 <td width="3%"> |
|
229 |
|
230 <p><b>−B</b></p> |
|
231 </td> |
|
232 <td width="5%"></td> |
|
233 <td width="80%"> |
|
234 |
|
235 <p>Assume input data was encoded with black as 0 and white |
|
236 as 1.</p> |
|
237 </td> |
|
238 <td width="0%"> |
|
239 </td> |
|
240 <tr valign="top" align="left"> |
|
241 <td width="10%"></td> |
|
242 <td width="3%"> |
|
243 |
|
244 <p><b>−W</b></p> |
|
245 </td> |
|
246 <td width="5%"></td> |
|
247 <td width="80%"> |
|
248 |
|
249 <p>Assume input data was encoded with black as 1 and white |
|
250 as 0 (default).</p> |
|
251 </td> |
|
252 <td width="0%"> |
|
253 </td> |
|
254 <tr valign="top" align="left"> |
|
255 <td width="10%"></td> |
|
256 <td width="3%"> |
|
257 |
|
258 <p><b>−R</b></p> |
|
259 </td> |
|
260 <td width="5%"></td> |
|
261 <td width="80%"> |
|
262 |
|
263 <p>Specify the vertical resolution, in lines/inch, of the |
|
264 input images. By default input are assumed to have a |
|
265 vertical resolution of 196 lines/inch. If images are low |
|
266 resolution facsimile, a value of 98 lines/inch should be |
|
267 specified.</p> |
|
268 </td> |
|
269 <td width="0%"> |
|
270 </td> |
|
271 <tr valign="top" align="left"> |
|
272 <td width="10%"></td> |
|
273 <td width="3%"> |
|
274 |
|
275 <p><b>−X</b></p> |
|
276 </td> |
|
277 <td width="5%"></td> |
|
278 <td width="80%"> |
|
279 |
|
280 <p>Specify the width, in pixels, of the input images. By |
|
281 default input are assumed to have a width of 1728 |
|
282 pixels.</p> |
|
283 </td> |
|
284 <td width="0%"> |
|
285 </td> |
|
286 </table> |
|
287 <!-- INDENTATION --> |
|
288 <table width="100%" border=0 rules="none" frame="void" |
|
289 cols="2" cellspacing="0" cellpadding="0"> |
|
290 <tr valign="top" align="left"> |
|
291 <td width="8%"></td> |
|
292 <td width="91%"> |
|
293 <p>Options that affect the output file format are:</p> |
|
294 </td> |
|
295 </table> |
|
296 <!-- TABS --> |
|
297 <table width="100%" border=0 rules="none" frame="void" |
|
298 cols="5" cellspacing="0" cellpadding="0"> |
|
299 <tr valign="top" align="left"> |
|
300 <td width="10%"></td> |
|
301 <td width="3%"> |
|
302 |
|
303 <p><b>−o</b></p> |
|
304 </td> |
|
305 <td width="5%"></td> |
|
306 <td width="80%"> |
|
307 |
|
308 <p>Specify the name of the output file.</p> |
|
309 </td> |
|
310 <td width="0%"> |
|
311 </td> |
|
312 <tr valign="top" align="left"> |
|
313 <td width="10%"></td> |
|
314 <td width="3%"> |
|
315 |
|
316 <p><b>−7</b></p> |
|
317 </td> |
|
318 <td width="5%"></td> |
|
319 <td width="80%"> |
|
320 |
|
321 <p>Force output to be compressed with the |
|
322 <small>CCITT</small> Group 3 Huffman encoding algorithm |
|
323 (default).</p> |
|
324 </td> |
|
325 <td width="0%"> |
|
326 </td> |
|
327 <tr valign="top" align="left"> |
|
328 <td width="10%"></td> |
|
329 <td width="3%"> |
|
330 |
|
331 <p><b>−8</b></p> |
|
332 </td> |
|
333 <td width="5%"></td> |
|
334 <td width="80%"> |
|
335 |
|
336 <p>Force output to be compressed with the |
|
337 <small>CCITT</small> Group 4 Huffman encoding.</p> |
|
338 </td> |
|
339 <td width="0%"> |
|
340 </td> |
|
341 <tr valign="top" align="left"> |
|
342 <td width="10%"></td> |
|
343 <td width="3%"> |
|
344 |
|
345 <p><b>−u</b></p> |
|
346 </td> |
|
347 <td width="5%"></td> |
|
348 <td width="80%"> |
|
349 |
|
350 <p>Force output to be uncompressed (Group 3 or Group |
|
351 4).</p> |
|
352 </td> |
|
353 <td width="0%"> |
|
354 </td> |
|
355 <tr valign="top" align="left"> |
|
356 <td width="10%"></td> |
|
357 <td width="3%"> |
|
358 |
|
359 <p><b>−5</b></p> |
|
360 </td> |
|
361 <td width="5%"></td> |
|
362 <td width="80%"> |
|
363 |
|
364 <p>Force output to be encoded with the 1-dimensional |
|
365 version of the <small>CCITT</small> Group 3 Huffman encoding |
|
366 algorithm.</p> |
|
367 </td> |
|
368 <td width="0%"> |
|
369 </td> |
|
370 <tr valign="top" align="left"> |
|
371 <td width="10%"></td> |
|
372 <td width="3%"> |
|
373 |
|
374 <p><b>−6</b></p> |
|
375 </td> |
|
376 <td width="5%"></td> |
|
377 <td width="80%"> |
|
378 |
|
379 <p>Force output to be encoded with the 2-dimensional |
|
380 version of the <small>CCITT</small> Group 3 Huffman encoding |
|
381 algorithm (default).</p> |
|
382 </td> |
|
383 <td width="0%"> |
|
384 </td> |
|
385 <tr valign="top" align="left"> |
|
386 <td width="10%"></td> |
|
387 <td width="3%"> |
|
388 |
|
389 <p><b>−a</b></p> |
|
390 </td> |
|
391 <td width="5%"></td> |
|
392 <td width="80%"> |
|
393 |
|
394 <p>Force the last bit of each <i>End Of Line</i> ( |
|
395 <small>EOL</small> ) code to land on a byte boundary |
|
396 (default). This ‘‘zero padding’’ |
|
397 will be reflected in the contents of the |
|
398 <i>Group3Options</i> tag of the resultant |
|
399 <small>TIFF</small> file. This option has effect with Group |
|
400 3 encoded output only.</p> |
|
401 </td> |
|
402 <td width="0%"> |
|
403 </td> |
|
404 <tr valign="top" align="left"> |
|
405 <td width="10%"></td> |
|
406 <td width="3%"> |
|
407 |
|
408 <p><b>−p</b></p> |
|
409 </td> |
|
410 <td width="5%"></td> |
|
411 <td width="80%"> |
|
412 |
|
413 <p>Do not EOL-align output. This option has effect with |
|
414 Group 3 encoded output only.</p> |
|
415 </td> |
|
416 <td width="0%"> |
|
417 </td> |
|
418 <tr valign="top" align="left"> |
|
419 <td width="10%"></td> |
|
420 <td width="3%"> |
|
421 |
|
422 <p><b>−c</b></p> |
|
423 </td> |
|
424 <td width="5%"></td> |
|
425 <td width="80%"> |
|
426 |
|
427 <p>Generate "classic" Group 3 TIFF format.</p> |
|
428 </td> |
|
429 <td width="0%"> |
|
430 </td> |
|
431 <tr valign="top" align="left"> |
|
432 <td width="10%"></td> |
|
433 <td width="3%"> |
|
434 |
|
435 <p><b>−f</b></p> |
|
436 </td> |
|
437 <td width="5%"></td> |
|
438 <td width="80%"> |
|
439 |
|
440 <p>Generate TIFF Class F (TIFF/F) format (default).</p> |
|
441 </td> |
|
442 <td width="0%"> |
|
443 </td> |
|
444 <tr valign="top" align="left"> |
|
445 <td width="10%"></td> |
|
446 <td width="3%"> |
|
447 |
|
448 <p><b>−m</b></p> |
|
449 </td> |
|
450 <td width="5%"></td> |
|
451 <td width="80%"> |
|
452 |
|
453 <p>Force output data to have bits filled from most |
|
454 significant bit ( <small>MSB</small> ) to most least bit ( |
|
455 <small>LSB</small> ).</p> |
|
456 </td> |
|
457 <td width="0%"> |
|
458 </td> |
|
459 <tr valign="top" align="left"> |
|
460 <td width="10%"></td> |
|
461 <td width="3%"> |
|
462 |
|
463 <p><b>−l</b></p> |
|
464 </td> |
|
465 <td width="5%"></td> |
|
466 <td width="80%"> |
|
467 |
|
468 <p>Force output data to have bits filled from least |
|
469 significant bit ( <small>LSB</small> ) to most significant |
|
470 bit ( <small>MSB</small> ) (default).</p> |
|
471 </td> |
|
472 <td width="0%"> |
|
473 </td> |
|
474 <tr valign="top" align="left"> |
|
475 <td width="10%"></td> |
|
476 <td width="3%"> |
|
477 |
|
478 <p><b>−r</b></p> |
|
479 </td> |
|
480 <td width="5%"></td> |
|
481 <td width="80%"> |
|
482 |
|
483 <p>Specify the number of rows (scanlines) in each strip of |
|
484 data written to the output file. By default (or when value |
|
485 <b>0</b> is specified), <i>tiffcp</i> attempts to set the |
|
486 rows/strip that no more than 8 kilobytes of data appear in a |
|
487 strip (with except of G3/G4 compression schemes). If you |
|
488 specify special value <b>-1</b> it will results in infinite |
|
489 number of the rows per strip. The entire image will be the |
|
490 one strip in that case. This is default in case of G3/G4 |
|
491 output compression schemes.</p> |
|
492 </td> |
|
493 <td width="0%"> |
|
494 </td> |
|
495 <tr valign="top" align="left"> |
|
496 <td width="10%"></td> |
|
497 <td width="3%"> |
|
498 |
|
499 <p><b>−s</b></p> |
|
500 </td> |
|
501 <td width="5%"></td> |
|
502 <td width="80%"> |
|
503 |
|
504 <p>Stretch the input image vertically by writing each input |
|
505 row of data twice to the output file.</p> |
|
506 </td> |
|
507 <td width="0%"> |
|
508 </td> |
|
509 <tr valign="top" align="left"> |
|
510 <td width="10%"></td> |
|
511 <td width="3%"> |
|
512 |
|
513 <p><b>−v</b></p> |
|
514 </td> |
|
515 <td width="5%"></td> |
|
516 <td width="80%"> |
|
517 |
|
518 <p>Force <i>fax2tiff</i> to print the number of rows of |
|
519 data it retrieved from the input file.</p> |
|
520 </td> |
|
521 <td width="0%"> |
|
522 </td> |
|
523 <tr valign="top" align="left"> |
|
524 <td width="10%"></td> |
|
525 <td width="3%"> |
|
526 |
|
527 <p><b>−z</b></p> |
|
528 </td> |
|
529 <td width="5%"></td> |
|
530 <td width="80%"> |
|
531 |
|
532 <p>Force output to be compressed with the LZW encoding.</p> |
|
533 </td> |
|
534 <td width="0%"> |
|
535 </td> |
|
536 </table> |
|
537 <a name="DIAGNOSTICS"></a> |
|
538 <h2>DIAGNOSTICS</h2> |
|
539 <!-- INDENTATION --> |
|
540 <table width="100%" border=0 rules="none" frame="void" |
|
541 cols="2" cellspacing="0" cellpadding="0"> |
|
542 <tr valign="top" align="left"> |
|
543 <td width="8%"></td> |
|
544 <td width="91%"> |
|
545 <p>The following warnings and errors come from the decoding |
|
546 routines in the library.</p> |
|
547 <!-- INDENTATION --> |
|
548 <p><b>Warning, %s: Premature EOL at scanline %d (x |
|
549 %d).\n</b>. The input data had a row that was shorter than |
|
550 the expected width. The row is padded with white.</p> |
|
551 <!-- INDENTATION --> |
|
552 <p><b>%s: Premature EOF at scanline %d (x %d).\n</b>. The |
|
553 decoder ran out of data in the middle of a scanline. The |
|
554 resultant row is padded with white.</p> |
|
555 <!-- INDENTATION --> |
|
556 <p><b>%s: Bad code word at row %d, x %d\n</b>. An invalid |
|
557 Group 3 <i>code</i> was encountered while decoding the input |
|
558 file. The row number and horizontal position is given. The |
|
559 remainder of the input row is discarded, while the |
|
560 corresponding output row is padded with white.</p> |
|
561 <!-- INDENTATION --> |
|
562 <p><b>%s: Bad 2D code word at scanline %d.\n</b>. An invalid |
|
563 Group 4 or 2D Group 3 <i>code</i> was encountered while |
|
564 decoding the input file. The row number and horizontal |
|
565 position is given. The remainder of the input row is |
|
566 discarded, while the corresponding output row is padded with |
|
567 white.</p> |
|
568 </td> |
|
569 </table> |
|
570 <a name="BUGS"></a> |
|
571 <h2>BUGS</h2> |
|
572 <!-- INDENTATION --> |
|
573 <table width="100%" border=0 rules="none" frame="void" |
|
574 cols="2" cellspacing="0" cellpadding="0"> |
|
575 <tr valign="top" align="left"> |
|
576 <td width="8%"></td> |
|
577 <td width="91%"> |
|
578 <p>Input data are assumed to have a a ‘‘top |
|
579 left’’ orientation; it should be possible to |
|
580 override this assumption from the command line.</p> |
|
581 </td> |
|
582 </table> |
|
583 <a name="SEE ALSO"></a> |
|
584 <h2>SEE ALSO</h2> |
|
585 <!-- INDENTATION --> |
|
586 <table width="100%" border=0 rules="none" frame="void" |
|
587 cols="2" cellspacing="0" cellpadding="0"> |
|
588 <tr valign="top" align="left"> |
|
589 <td width="8%"></td> |
|
590 <td width="91%"> |
|
591 <p><b><small>CCITT</small> Recommendation T.4</b> |
|
592 (Standardization of Group 3 Facsimile Apparatus for Document |
|
593 Transmission).</p> |
|
594 <!-- INDENTATION --> |
|
595 <p><b>The Spirit of TIFF Class F</b>, an appendix to the |
|
596 TIFF 5.0 specification prepared by Cygnet Technologies.</p> |
|
597 <!-- INDENTATION --> |
|
598 <p><b>tiffinfo</b>(1), <b>tiffdither</b>(1), |
|
599 <b>tiffgt</b>(1), <b>libtiff</b>(3)</p> |
|
600 <!-- INDENTATION --> |
|
601 <p>Libtiff library home page: |
|
602 <b>http://www.remotesensing.org/libtiff/</b></p> |
|
603 </td> |
|
604 </table> |
|
605 <hr> |
|
606 </body> |
|
607 </html> |