1FAX2TIFF(1)                 General Commands Manual                FAX2TIFF(1)
2
3
4

NAME

6       fax2tiff - create a TIFF Class F fax file from raw fax data
7

SYNOPSIS

9       fax2tiff [ options ] [ -o output.tif ] input.raw
10

DESCRIPTION

12       Fax2tiff  creates  a  TIFF  file  containing  CCITT  Group 3 or Group 4
13       encoded data from one or more files containing ``raw'' Group 3 or Group
14       4  encoded  data  (typically  obtained  directly from a fax modem).  By
15       default, each row of data in the resultant TIFF file is 1-dimensionally
16       encoded  and padded or truncated to 1728 pixels, as needed.  The resul‐
17       tant image is a set of low resolution (98 lines/inch) or medium resolu‐
18       tion  (196  lines/inch) pages, each of which is a single strip of data.
19       The generated file conforms to the TIFF Class F (FAX) specification for
20       storing  facsimile  data.  This means, in particular, that each page of
21       the data does not include the trailing return to control (RTC) code; as
22       required  for  transmission  by  the CCITT Group 3 specifications.  The
23       old, ``classic'', format is created if the -c  option  is  used.   (The
24       Class F format can also be requested with the -f option.)
25
26       The  default  name  of the output image is fax.tif; this can be changed
27       with the -o option.  Each input file is assumed to be a  separate  page
28       of  facsimile  data  from  the same document.  The order in which input
29       files are specified on the command line  is  the  order  in  which  the
30       resultant pages appear in the output file.
31

OPTIONS

33       Options that affect the interpretation of input data are:
34
35       -3     Assume input data is CCITT Group 3 encoded (default).
36
37       -4     Assume input data is CCITT Group 4 encoded.
38
39       -U     Assume input data is uncompressed (Group 3 or Group 4).
40
41       -1     Assume  input  data is encoded with the 1-dimensional version of
42              the CCITT Group 3 Huffman encoding algorithm (default).
43
44       -2     Assume input data is 2-dimensional version of the CCITT Group  3
45              Huffman encoding algorithm.
46
47       -P     Assume  input data is not EOL-aligned (default). This option has
48              effect with Group 3 encoded input only.
49
50       -A     Assume input data is EOL-aligned. This option  has  effect  with
51              Group 3 encoded input only.
52
53       -M     Treat input data as having bits filled from most significant bit
54              (MSB) to most least bit (LSB).
55
56       -L     Treat input data as having bits filled  from  least  significant
57              bit (LSB) to most significant bit (MSB) (default).
58
59       -B     Assume input data was encoded with black as 0 and white as 1.
60
61       -W     Assume  input  data  was  encoded with black as 1 and white as 0
62              (default).
63
64       -R     Specify the vertical resolution, in  lines/inch,  of  the  input
65              images.  By default input are assumed to have a vertical resolu‐
66              tion of 196 lines/inch.  If images are low resolution facsimile,
67              a value of 98 lines/inch should be specified.
68
69       -X     Specify  the  width, in pixels, of the input images.  By default
70              input are assumed to have a width of 1728 pixels.
71
72       Options that affect the output file format are:
73
74       -o     Specify the name of the output file.
75
76       -7     Force output to be compressed with the  CCITT  Group  3  Huffman
77              encoding algorithm (default).
78
79       -8     Force  output  to  be  compressed with the CCITT Group 4 Huffman
80              encoding.
81
82       -u     Force output to be uncompressed (Group 3 or Group 4).
83
84       -5     Force output to be encoded with the 1-dimensional version of the
85              CCITT Group 3 Huffman encoding algorithm.
86
87       -6     Force output to be encoded with the 2-dimensional version of the
88              CCITT Group 3 Huffman encoding algorithm (default).
89
90       -a     Force the last bit of each End Of Line (EOL) code to land  on  a
91              byte boundary (default). This ``zero padding'' will be reflected
92              in the contents of the Group3Options tag of the  resultant  TIFF
93              file. This option has effect with Group 3 encoded output only.
94
95       -p     Do  not  EOL-align  output.  This option has effect with Group 3
96              encoded output only.
97
98       -c     Generate "classic" Group 3 TIFF format.
99
100       -f     Generate TIFF Class F (TIFF/F) format (default).
101
102       -m     Force output data to have bits filled from most significant  bit
103              (MSB) to most least bit (LSB).
104
105       -l     Force   output  data  to have bits filled from least significant
106              bit (LSB) to most significant bit (MSB) (default).
107
108       -r     Specify the number of rows (scanlines) in  each  strip  of  data
109              written  to  the  output  file.   By default (or when value 0 is
110              specified), tiffcp attempts to set the rows/strip that  no  more
111              than 8 kilobytes of data appear in a strip (with except of G3/G4
112              compression schemes). If you specify special value  -1  it  will
113              results  in  infinite  number  of the rows per strip. The entire
114              image will be the one strip in that case.  This  is  default  in
115              case of G3/G4 output compression schemes.
116
117       -s     Stretch  the input image vertically by writing each input row of
118              data twice to the output file.
119
120       -v     Force fax2tiff to print the number of rows of data it  retrieved
121              from the input file.
122
123       -z     Force output to be compressed with the LZW encoding.
124

DIAGNOSTICS

126       The  following  warnings  and errors come from the decoding routines in
127       the library.
128
129       Warning, %s: Premature EOL at scanline %d (x %d).\n.   The  input  data
130       had  a row that was shorter than the expected width.  The row is padded
131       with white.
132
133       %s: Premature EOF at scanline %d (x %d).\n.  The  decoder  ran  out  of
134       data  in  the  middle  of a scanline.  The resultant row is padded with
135       white.
136
137       %s: Bad code word at row %d, x %d\n.   An  invalid  Group  3  code  was
138       encountered while decoding the input file.  The row number and horizon‐
139       tal position is given.  The remainder of the input  row  is  discarded,
140       while the corresponding output row is padded with white.
141
142       %s: Bad 2D code word at scanline %d.\n.  An invalid Group 4 or 2D Group
143       3 code was encountered while decoding the input file.  The  row  number
144       and  horizontal  position  is given.  The remainder of the input row is
145       discarded, while the corresponding output row is padded with white.
146

BUGS

148       Input data are assumed to have a a ``top left'' orientation; it  should
149       be possible to override this assumption from the command line.
150

SEE ALSO

152       CCITT  Recommendation T.4 (Standardization of Group 3 Facsimile Appara‐
153       tus for Document Transmission).
154
155       The Spirit of TIFF Class F, an appendix to the TIFF  5.0  specification
156       prepared by Cygnet Technologies.
157
158       tiffinfo(1), tiffdither(1), tiffgt(1), libtiff(3)
159
160       Libtiff library home page: http://www.simplesystems.org/libtiff/
161
162
163
164libtiff                        November 2, 2005                    FAX2TIFF(1)
Impressum