]>
Commit | Line | Data |
---|---|---|
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> |