Blame html/man/fax2tiff.1.html

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

FAX2TIFF

Packit 994f1a
NAME
Packit 994f1a
SYNOPSIS
Packit 994f1a
DESCRIPTION
Packit 994f1a
OPTIONS
Packit 994f1a
DIAGNOSTICS
Packit 994f1a
BUGS
Packit 994f1a
SEE ALSO
Packit 994f1a
Packit 994f1a

Packit 994f1a
Packit 994f1a

NAME

Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

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

Packit 994f1a
file from raw fax data

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

SYNOPSIS

Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

fax2tiff [ options ] [ −o

Packit 994f1a
output.tif ] input.raw

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

DESCRIPTION

Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

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

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

Packit 994f1a
Packit 994f1a

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

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

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

OPTIONS

Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Options that affect the interpretation of input data

Packit 994f1a
are:

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="5" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−3

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

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

Packit 994f1a
encoded (default).

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−4

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

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

Packit 994f1a
encoded.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−U

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Assume input data is uncompressed (Group 3 or Group

Packit 994f1a
4).

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−1

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Assume input data is encoded with the 1-dimensional

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

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−2

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Assume input data is 2-dimensional version of the

Packit 994f1a
<small>CCITT</small> Group 3 Huffman encoding algorithm.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−P

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

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

Packit 994f1a
This option has effect with Group 3 encoded input only.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−A

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

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

Packit 994f1a
with Group 3 encoded input only.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−M

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Treat input data as having bits filled from most

Packit 994f1a
significant bit ( <small>MSB</small> ) to most least bit (
Packit 994f1a
<small>LSB</small> ).

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−L

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Treat input data as having bits filled from least

Packit 994f1a
significant bit ( <small>LSB</small> ) to most significant
Packit 994f1a
bit ( <small>MSB</small> ) (default).

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−B

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Assume input data was encoded with black as 0 and white

Packit 994f1a
as 1.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−W

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Assume input data was encoded with black as 1 and white

Packit 994f1a
as 0 (default).

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−R

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

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

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

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−X

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

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

Packit 994f1a
default input are assumed to have a width of 1728
Packit 994f1a
pixels.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Options that affect the output file format are:

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="5" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−o

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Specify the name of the output file.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−7

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Force output to be compressed with the

Packit 994f1a
<small>CCITT</small> Group 3 Huffman encoding algorithm
Packit 994f1a
(default).

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−8

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Force output to be compressed with the

Packit 994f1a
<small>CCITT</small> Group 4 Huffman encoding.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−u

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Force output to be uncompressed (Group 3 or Group

Packit 994f1a
4).

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−5

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Force output to be encoded with the 1-dimensional

Packit 994f1a
version of the <small>CCITT</small> Group 3 Huffman encoding
Packit 994f1a
algorithm.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−6

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Force output to be encoded with the 2-dimensional

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

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−a

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Force the last bit of each End Of Line (

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

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−p

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

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

Packit 994f1a
Group 3 encoded output only.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−c

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Generate "classic" Group 3 TIFF format.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−f

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

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

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−m

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Force output data to have bits filled from most

Packit 994f1a
significant bit ( <small>MSB</small> ) to most least bit (
Packit 994f1a
<small>LSB</small> ).

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−l

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Force output data to have bits filled from least

Packit 994f1a
significant bit ( <small>LSB</small> ) to most significant
Packit 994f1a
bit ( <small>MSB</small> ) (default).

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−r

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

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

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

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−s

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Stretch the input image vertically by writing each input

Packit 994f1a
row of data twice to the output file.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−v

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Force fax2tiff to print the number of rows of

Packit 994f1a
data it retrieved from the input file.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

−z

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Force output to be compressed with the LZW encoding.

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

DIAGNOSTICS

Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

The following warnings and errors come from the decoding

Packit 994f1a
routines in the library.

Packit 994f1a
Packit 994f1a

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

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

Packit 994f1a
Packit 994f1a

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

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

Packit 994f1a
Packit 994f1a

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

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

Packit 994f1a
Packit 994f1a

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

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

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

BUGS

Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

Input data are assumed to have a a ‘‘top

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

Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

SEE ALSO

Packit 994f1a
Packit 994f1a
Packit 994f1a
       cols="2" cellspacing="0" cellpadding="0">
Packit 994f1a
Packit 994f1a
Packit 994f1a
Packit 994f1a

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

Packit 994f1a
(Standardization of Group 3 Facsimile Apparatus for Document
Packit 994f1a
Transmission).

Packit 994f1a
Packit 994f1a

The Spirit of TIFF Class F, an appendix to the

Packit 994f1a
TIFF 5.0 specification prepared by Cygnet Technologies.

Packit 994f1a
Packit 994f1a

tiffinfo(1), tiffdither(1),

Packit 994f1a
tiffgt(1), libtiff(3)

Packit 994f1a
Packit 994f1a

Libtiff library home page:

Packit 994f1a
http://www.remotesensing.org/libtiff/

Packit 994f1a
Packit 994f1a
Packit 994f1a

Packit 994f1a
</body>
Packit 994f1a
</html>