Blame html/man/fax2tiff.1.html

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

FAX2TIFF

Packit Service 2594b8
NAME
Packit Service 2594b8
SYNOPSIS
Packit Service 2594b8
DESCRIPTION
Packit Service 2594b8
OPTIONS
Packit Service 2594b8
DIAGNOSTICS
Packit Service 2594b8
BUGS
Packit Service 2594b8
SEE ALSO
Packit Service 2594b8
Packit Service 2594b8

Packit Service 2594b8
Packit Service 2594b8

NAME

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

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

Packit Service 2594b8
file from raw fax data

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

SYNOPSIS

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

fax2tiff [ options ] [ −o

Packit Service 2594b8
output.tif ] input.raw

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

DESCRIPTION

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

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

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

Packit Service 2594b8
Packit Service 2594b8

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

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

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

OPTIONS

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Options that affect the interpretation of input data

Packit Service 2594b8
are:

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="5" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−3

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

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

Packit Service 2594b8
encoded (default).

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−4

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

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

Packit Service 2594b8
encoded.

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−U

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Assume input data is uncompressed (Group 3 or Group

Packit Service 2594b8
4).

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−1

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Assume input data is encoded with the 1-dimensional

Packit Service 2594b8
version of the <small>CCITT</small> Group 3 Huffman encoding
Packit Service 2594b8
algorithm (default).

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−2

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Assume input data is 2-dimensional version of the

Packit Service 2594b8
<small>CCITT</small> Group 3 Huffman encoding algorithm.

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−P

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

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

Packit Service 2594b8
This option has effect with Group 3 encoded input only.

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−A

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

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

Packit Service 2594b8
with Group 3 encoded input only.

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−M

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Treat input data as having bits filled from most

Packit Service 2594b8
significant bit ( <small>MSB</small> ) to most least bit (
Packit Service 2594b8
<small>LSB</small> ).

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−L

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Treat input data as having bits filled from least

Packit Service 2594b8
significant bit ( <small>LSB</small> ) to most significant
Packit Service 2594b8
bit ( <small>MSB</small> ) (default).

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−B

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Assume input data was encoded with black as 0 and white

Packit Service 2594b8
as 1.

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−W

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Assume input data was encoded with black as 1 and white

Packit Service 2594b8
as 0 (default).

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−R

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

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

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

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−X

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

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

Packit Service 2594b8
default input are assumed to have a width of 1728
Packit Service 2594b8
pixels.

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Options that affect the output file format are:

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="5" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−o

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Specify the name of the output file.

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−7

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Force output to be compressed with the

Packit Service 2594b8
<small>CCITT</small> Group 3 Huffman encoding algorithm
Packit Service 2594b8
(default).

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−8

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Force output to be compressed with the

Packit Service 2594b8
<small>CCITT</small> Group 4 Huffman encoding.

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−u

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Force output to be uncompressed (Group 3 or Group

Packit Service 2594b8
4).

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−5

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Force output to be encoded with the 1-dimensional

Packit Service 2594b8
version of the <small>CCITT</small> Group 3 Huffman encoding
Packit Service 2594b8
algorithm.

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−6

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Force output to be encoded with the 2-dimensional

Packit Service 2594b8
version of the <small>CCITT</small> Group 3 Huffman encoding
Packit Service 2594b8
algorithm (default).

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−a

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Force the last bit of each End Of Line (

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

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−p

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

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

Packit Service 2594b8
Group 3 encoded output only.

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−c

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Generate "classic" Group 3 TIFF format.

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−f

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

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

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−m

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Force output data to have bits filled from most

Packit Service 2594b8
significant bit ( <small>MSB</small> ) to most least bit (
Packit Service 2594b8
<small>LSB</small> ).

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−l

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Force output data to have bits filled from least

Packit Service 2594b8
significant bit ( <small>LSB</small> ) to most significant
Packit Service 2594b8
bit ( <small>MSB</small> ) (default).

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−r

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

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

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

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−s

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Stretch the input image vertically by writing each input

Packit Service 2594b8
row of data twice to the output file.

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−v

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Force fax2tiff to print the number of rows of

Packit Service 2594b8
data it retrieved from the input file.

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

−z

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Force output to be compressed with the LZW encoding.

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

DIAGNOSTICS

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

The following warnings and errors come from the decoding

Packit Service 2594b8
routines in the library.

Packit Service 2594b8
Packit Service 2594b8

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

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

Packit Service 2594b8
Packit Service 2594b8

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

Packit Service 2594b8
decoder ran out of data in the middle of a scanline. The
Packit Service 2594b8
resultant row is padded with white.

Packit Service 2594b8
Packit Service 2594b8

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

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

Packit Service 2594b8
Packit Service 2594b8

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

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

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

BUGS

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Input data are assumed to have a a ‘‘top

Packit Service 2594b8
left’’ orientation; it should be possible to
Packit Service 2594b8
override this assumption from the command line.

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

SEE ALSO

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
       cols="2" cellspacing="0" cellpadding="0">
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

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

Packit Service 2594b8
(Standardization of Group 3 Facsimile Apparatus for Document
Packit Service 2594b8
Transmission).

Packit Service 2594b8
Packit Service 2594b8

The Spirit of TIFF Class F, an appendix to the

Packit Service 2594b8
TIFF 5.0 specification prepared by Cygnet Technologies.

Packit Service 2594b8
Packit Service 2594b8

tiffinfo(1), tiffdither(1),

Packit Service 2594b8
tiffgt(1), libtiff(3)

Packit Service 2594b8
Packit Service 2594b8

Libtiff library home page:

Packit Service 2594b8
http://www.simplesystems.org/libtiff/

Packit Service 2594b8
Packit Service 2594b8
Packit Service 2594b8

Packit Service 2594b8
</body>
Packit Service 2594b8
</html>