User Commands fax2tiff(1)
NAME
fax2tiff - create a TIF Class F fax file from raw fax data
SYNOPSIS
fax2tiff [options] [-o output.tif] input.g3
DESCRIPTION
fax2tiff creates a TIF file containing CIT Group 3 or
Group 4 encoded data from one or more files containing "raw"
Group 3 encoded data, typically obtained directly from a fax
modem.
By default, each row of data in the resultant TIF file is
2-dimensionally encoded and padded or truncated to 1728 pix-
els, as needed. The resultant image is a set of low resolu-
tion (98 lines per inch) or medium resolution (196 lines per
inch) pages, each of which is a single strip of data.
OPTIONS
Input Data Options
The following input data options are supported:
-2 Assume input data is 2-d Huffman encoded.
-B Assume input data was encoded with black as
0 and white as 1.
-L Treat input data as having bits filled from
least significant bit (LSB) to most signifi-
cant bit (MSB). This is the default.
-M Treat input data as having bits filled from
most significant bit (MSB) to least signifi-
cant bit (LSB).
-R Specify the vertical resolution, in lines
per inch, of the input images. By default,
input images are assumed to have a vertical
resolution of 196 lines per inch. If images
are low resolution facsimile, specify a
value of 98 lines per inch.
SunOS 5.11 Last change: 26 Mar 2004 1
User Commands fax2tiff(1)
-W Assume input data was encoded with black as
1 and white as 0. This is the default.
Output File Options
The following output file options are supported:
-1 Force output to be compressed with the 1-
dimensional version of the CIT Group 3
Huffman encoding algorithm.
-4 Force output to be compressed with the CIT
Group 4 Huffman encoding.
-o Specify the name of the output file.
-p Force the last bit of each End Of Line (EOL)
code to land on a byte boundary. This "zero
padding" is reflected in the contents of the
Group3Options tag of the resultant TIF
file.
-s Stretch the input image vertically by writ-
ing each input row of data twice to the out-
put file.
-v Force fax2tiff to print the number of rows
of data retrieved from the input file.
OPERANDS
The following operands are supported:
input.g3 The name of the input file that contains raw
fax data.
EXTENDED DESCRIPTION
SunOS 5.11 Last change: 26 Mar 2004 2
User Commands fax2tiff(1)
The generated file conforms to the TIF Class F (FAX)
specification for storing facsimile data. This means, in
particular, that each page of the data does not include the
trailing return to control (RTC) code, as required for
transmission by the CIT Group 3 specifications. The old,
"classic" format is created if the -c option is used. The
Class F format can also be requested with the -f option.
The default name of the output image is fax.tif. You can
use the -o option to change the output filename.
Each input file is assumed to be a separate page of fac-
simile data from the same document. The order in which input
files are specified on the command line is the order in
which the resultant pages appear in the output file.
Diagnostics
The following warnings and errors come from the decoding
routines in the library.
Warning, %s: Premature EOTLheainputndata %had(a %row0.that was
shorter than the expected value of
1728. The row is padded with white.
%s: Premature EOF at scaThende%coder %ran.0out of data in the
middle of a scanline. The resultant
row is padded with white.
%s: Bad code word at rowA%nd,inva%li0d.Group 3 code was encoun-
tered while decoding the input file.
The row number and horizontal posi-
tion is given. The remainder of the
input row is discarded, while the
corresponding output row is padded
with white.
%s: Bad 2D code word at Anainvali%ddG0roup 4 or 2D Group 3
code was encountered while decoding
the input file. The row number and
horizontal position is given. The
remainder of the input row is dis-
carded, while the corresponding out-
put row is padded with white.
SunOS 5.11 Last change: 26 Mar 2004 3
User Commands fax2tiff(1)
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWTiff
Interface stability Uncommitted
SEE ALSO
CIT Recommendation T.4 (Standardization of Group 3 Fac-
simile Apparatus for Document Transmission).
The Spirit of TIF Class F, an appendix to the TIF 5.0
specification prepared by Cygnet Technologies.
tiffinfo(1), tiffdither(1), tiffgt(1), libtiff(3)
NOTES
Updated by Breda McColgan, Sun Microsystems Inc., 2004.
SunOS 5.11 Last change: 26 Mar 2004 4
|
