Blame html/man/fax2tiff.1.html

Packit 7838c8
Packit 7838c8
Packit 7838c8
<html>
Packit 7838c8
<head>
Packit 7838c8
<meta name="generator" content="groff -Thtml, see www.gnu.org">
Packit 7838c8
<meta name="Content-Style" content="text/css">
Packit 7838c8
<title>FAX2TIFF</title>
Packit 7838c8
</head>
Packit 7838c8
<body>
Packit 7838c8
Packit 7838c8

FAX2TIFF

Packit 7838c8
NAME
Packit 7838c8
SYNOPSIS
Packit 7838c8
DESCRIPTION
Packit 7838c8
OPTIONS
Packit 7838c8
DIAGNOSTICS
Packit 7838c8
BUGS
Packit 7838c8
SEE ALSO
Packit 7838c8
Packit 7838c8

Packit 7838c8
Packit 7838c8

NAME

Packit 7838c8
Packit 7838c8
Packit 7838c8
       cols="2" cellspacing="0" cellpadding="0">
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

fax2tiff − create a <small>TIFF</small> Class F fax

Packit 7838c8
file from raw fax data

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

SYNOPSIS

Packit 7838c8
Packit 7838c8
Packit 7838c8
       cols="2" cellspacing="0" cellpadding="0">
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

fax2tiff [ options ] [ −o

Packit 7838c8
output.tif ] input.raw

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

DESCRIPTION

Packit 7838c8
Packit 7838c8
Packit 7838c8
       cols="2" cellspacing="0" cellpadding="0">
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Fax2tiff creates a <small>TIFF</small> file

Packit 7838c8
containing <small>CCITT</small> Group 3 or Group 4 encoded
Packit 7838c8
data from one or more files containing
Packit 7838c8
‘‘raw’’ Group 3 or Group 4 encoded
Packit 7838c8
data (typically obtained directly from a fax modem). By
Packit 7838c8
default, each row of data in the resultant
Packit 7838c8
<small>TIFF</small> file is 1-dimensionally encoded and
Packit 7838c8
padded or truncated to 1728 pixels, as needed. The resultant
Packit 7838c8
image is a set of low resolution (98 lines/inch) or medium
Packit 7838c8
resolution (196 lines/inch) pages, each of which is a single
Packit 7838c8
strip of data. The generated file conforms to the
Packit 7838c8
<small>TIFF</small> Class F ( <small>FAX</small> )
Packit 7838c8
specification for storing facsimile data. This means, in
Packit 7838c8
particular, that each page of the data does not
Packit 7838c8
include the trailing return to control (
Packit 7838c8
<small>RTC</small> ) code; as required for transmission by
Packit 7838c8
the <small>CCITT</small> Group 3 specifications. The old,
Packit 7838c8
‘‘classic’’, format is created if
Packit 7838c8
the −c option is used. (The Class F format can
Packit 7838c8
also be requested with the −f option.)

Packit 7838c8
Packit 7838c8

The default name of the output image is fax.tif;

Packit 7838c8
this can be changed with the −o option. Each
Packit 7838c8
input file is assumed to be a separate page of facsimile
Packit 7838c8
data from the same document. The order in which input files
Packit 7838c8
are specified on the command line is the order in which the
Packit 7838c8
resultant pages appear in the output file.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

OPTIONS

Packit 7838c8
Packit 7838c8
Packit 7838c8
       cols="2" cellspacing="0" cellpadding="0">
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Options that affect the interpretation of input data

Packit 7838c8
are:

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
       cols="5" cellspacing="0" cellpadding="0">
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−3

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Assume input data is <small>CCITT</small> Group 3

Packit 7838c8
encoded (default).

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−4

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Assume input data is <small>CCITT</small> Group 4

Packit 7838c8
encoded.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−U

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Assume input data is uncompressed (Group 3 or Group

Packit 7838c8
4).

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−1

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Assume input data is encoded with the 1-dimensional

Packit 7838c8
version of the <small>CCITT</small> Group 3 Huffman encoding
Packit 7838c8
algorithm (default).

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−2

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Assume input data is 2-dimensional version of the

Packit 7838c8
<small>CCITT</small> Group 3 Huffman encoding algorithm.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−P

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Assume input data is not EOL-aligned (default).

Packit 7838c8
This option has effect with Group 3 encoded input only.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−A

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Assume input data is EOL-aligned. This option has effect

Packit 7838c8
with Group 3 encoded input only.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−M

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Treat input data as having bits filled from most

Packit 7838c8
significant bit ( <small>MSB</small> ) to most least bit (
Packit 7838c8
<small>LSB</small> ).

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−L

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Treat input data as having bits filled from least

Packit 7838c8
significant bit ( <small>LSB</small> ) to most significant
Packit 7838c8
bit ( <small>MSB</small> ) (default).

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−B

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Assume input data was encoded with black as 0 and white

Packit 7838c8
as 1.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−W

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Assume input data was encoded with black as 1 and white

Packit 7838c8
as 0 (default).

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−R

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Specify the vertical resolution, in lines/inch, of the

Packit 7838c8
input images. By default input are assumed to have a
Packit 7838c8
vertical resolution of 196 lines/inch. If images are low
Packit 7838c8
resolution facsimile, a value of 98 lines/inch should be
Packit 7838c8
specified.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−X

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Specify the width, in pixels, of the input images. By

Packit 7838c8
default input are assumed to have a width of 1728
Packit 7838c8
pixels.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
       cols="2" cellspacing="0" cellpadding="0">
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Options that affect the output file format are:

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
       cols="5" cellspacing="0" cellpadding="0">
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−o

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Specify the name of the output file.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−7

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Force output to be compressed with the

Packit 7838c8
<small>CCITT</small> Group 3 Huffman encoding algorithm
Packit 7838c8
(default).

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−8

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Force output to be compressed with the

Packit 7838c8
<small>CCITT</small> Group 4 Huffman encoding.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−u

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Force output to be uncompressed (Group 3 or Group

Packit 7838c8
4).

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−5

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Force output to be encoded with the 1-dimensional

Packit 7838c8
version of the <small>CCITT</small> Group 3 Huffman encoding
Packit 7838c8
algorithm.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−6

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Force output to be encoded with the 2-dimensional

Packit 7838c8
version of the <small>CCITT</small> Group 3 Huffman encoding
Packit 7838c8
algorithm (default).

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−a

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Force the last bit of each End Of Line (

Packit 7838c8
<small>EOL</small> ) code to land on a byte boundary
Packit 7838c8
(default). This ‘‘zero padding’’
Packit 7838c8
will be reflected in the contents of the
Packit 7838c8
Group3Options tag of the resultant
Packit 7838c8
<small>TIFF</small> file. This option has effect with Group
Packit 7838c8
3 encoded output only.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−p

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Do not EOL-align output. This option has effect with

Packit 7838c8
Group 3 encoded output only.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−c

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Generate "classic" Group 3 TIFF format.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−f

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Generate TIFF Class F (TIFF/F) format (default).

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−m

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Force output data to have bits filled from most

Packit 7838c8
significant bit ( <small>MSB</small> ) to most least bit (
Packit 7838c8
<small>LSB</small> ).

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−l

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Force output data to have bits filled from least

Packit 7838c8
significant bit ( <small>LSB</small> ) to most significant
Packit 7838c8
bit ( <small>MSB</small> ) (default).

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−r

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Specify the number of rows (scanlines) in each strip of

Packit 7838c8
data written to the output file. By default (or when value
Packit 7838c8
0 is specified), tiffcp attempts to set the
Packit 7838c8
rows/strip that no more than 8 kilobytes of data appear in a
Packit 7838c8
strip (with except of G3/G4 compression schemes). If you
Packit 7838c8
specify special value −1 it will results in
Packit 7838c8
infinite number of the rows per strip. The entire image will
Packit 7838c8
be the one strip in that case. This is default in case of
Packit 7838c8
G3/G4 output compression schemes.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−s

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Stretch the input image vertically by writing each input

Packit 7838c8
row of data twice to the output file.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−v

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Force fax2tiff to print the number of rows of

Packit 7838c8
data it retrieved from the input file.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

−z

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Force output to be compressed with the LZW encoding.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

DIAGNOSTICS

Packit 7838c8
Packit 7838c8
Packit 7838c8
       cols="2" cellspacing="0" cellpadding="0">
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

The following warnings and errors come from the decoding

Packit 7838c8
routines in the library.

Packit 7838c8
Packit 7838c8

Warning, %s: Premature EOL at scanline %d (x

Packit 7838c8
%d).\n. The input data had a row that was shorter than
Packit 7838c8
the expected width. The row is padded with white.

Packit 7838c8
Packit 7838c8

%s: Premature EOF at scanline %d (x %d).\n. The

Packit 7838c8
decoder ran out of data in the middle of a scanline. The
Packit 7838c8
resultant row is padded with white.

Packit 7838c8
Packit 7838c8

%s: Bad code word at row %d, x %d\n. An invalid

Packit 7838c8
Group 3 code was encountered while decoding the input
Packit 7838c8
file. The row number and horizontal position is given. The
Packit 7838c8
remainder of the input row is discarded, while the
Packit 7838c8
corresponding output row is padded with white.

Packit 7838c8
Packit 7838c8

%s: Bad 2D code word at scanline %d.\n. An invalid

Packit 7838c8
Group 4 or 2D Group 3 code was encountered while
Packit 7838c8
decoding the input file. The row number and horizontal
Packit 7838c8
position is given. The remainder of the input row is
Packit 7838c8
discarded, while the corresponding output row is padded with
Packit 7838c8
white.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

BUGS

Packit 7838c8
Packit 7838c8
Packit 7838c8
       cols="2" cellspacing="0" cellpadding="0">
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

Input data are assumed to have a a ‘‘top

Packit 7838c8
left’’ orientation; it should be possible to
Packit 7838c8
override this assumption from the command line.

Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

SEE ALSO

Packit 7838c8
Packit 7838c8
Packit 7838c8
       cols="2" cellspacing="0" cellpadding="0">
Packit 7838c8
Packit 7838c8
Packit 7838c8
Packit 7838c8

<small>CCITT</small> Recommendation T.4

Packit 7838c8
(Standardization of Group 3 Facsimile Apparatus for Document
Packit 7838c8
Transmission).

Packit 7838c8
Packit 7838c8

The Spirit of TIFF Class F, an appendix to the

Packit 7838c8
TIFF 5.0 specification prepared by Cygnet Technologies.

Packit 7838c8
Packit 7838c8

tiffinfo(1), tiffdither(1),

Packit 7838c8
tiffgt(1), libtiff(3)

Packit 7838c8
Packit 7838c8

Libtiff library home page:

Packit 7838c8
http://www.simplesystems.org/libtiff/

Packit 7838c8
Packit 7838c8
Packit 7838c8

Packit 7838c8
</body>
Packit 7838c8
</html>