c3402403ea
be used if build directory is not the same as source directory.
* man/{TIFFGetField.3tiff, man/TIFFSetField.3tiff}: Documented
TIFFTAG_PHOTOSHOP, TIFFTAG_RICHTIFFIPTC, and TIFFTAG_XMLPACKET,
and re-sorted tag names in alphabetical order.
582 lines
15 KiB
HTML
582 lines
15 KiB
HTML
<!-- Creator : groff version 1.19.2 -->
|
|
<!-- CreationDate: Mon Jan 2 17:41:51 2006 -->
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
|
|
"http://www.w3.org/TR/html4/loose.dtd">
|
|
<html>
|
|
<head>
|
|
<meta name="generator" content="groff -Thtml, see www.gnu.org">
|
|
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
|
|
<meta name="Content-Style" content="text/css">
|
|
<style type="text/css">
|
|
p { margin-top: 0; margin-bottom: 0; }
|
|
pre { margin-top: 0; margin-bottom: 0; }
|
|
table { margin-top: 0; margin-bottom: 0; }
|
|
</style>
|
|
<title>FAX2TIFF</title>
|
|
|
|
</head>
|
|
<body>
|
|
|
|
<h1 align=center>FAX2TIFF</h1>
|
|
|
|
<a href="#NAME">NAME</a><br>
|
|
<a href="#SYNOPSIS">SYNOPSIS</a><br>
|
|
<a href="#DESCRIPTION">DESCRIPTION</a><br>
|
|
<a href="#OPTIONS">OPTIONS</a><br>
|
|
<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br>
|
|
<a href="#BUGS">BUGS</a><br>
|
|
<a href="#SEE ALSO">SEE ALSO</a><br>
|
|
|
|
<hr>
|
|
|
|
|
|
<a name="NAME"></a>
|
|
<h2>NAME</h2>
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">fax2tiff
|
|
− create a <small>TIFF</small> Class F fax file from
|
|
raw fax data</p>
|
|
|
|
<a name="SYNOPSIS"></a>
|
|
<h2>SYNOPSIS</h2>
|
|
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em"><b>fax2tiff</b>
|
|
[ <i>options</i> ] [ <b>−o</b> <i>output.tif</i> ]
|
|
<i>input.raw</i></p>
|
|
|
|
<a name="DESCRIPTION"></a>
|
|
<h2>DESCRIPTION</h2>
|
|
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em"><i>Fax2tiff</i>
|
|
creates a <small>TIFF</small> file containing
|
|
<small>CCITT</small> Group 3 or Group 4 encoded data from
|
|
one or more files containing ‘‘raw’’
|
|
Group 3 or Group 4 encoded data (typically obtained directly
|
|
from a fax modem). By default, each row of data in the
|
|
resultant <small>TIFF</small> file is 1-dimensionally
|
|
encoded and padded or truncated to 1728 pixels, as needed.
|
|
The resultant image is a set of low resolution (98
|
|
lines/inch) or medium resolution (196 lines/inch) pages,
|
|
each of which is a single strip of data. The generated file
|
|
conforms to the <small>TIFF</small> Class F (
|
|
<small>FAX</small> ) specification for storing facsimile
|
|
data. This means, in particular, that each page of the data
|
|
does <b>not</b> include the trailing <i>return to
|
|
control</i> ( <small>RTC</small> ) code; as required for
|
|
transmission by the <small>CCITT</small> Group 3
|
|
specifications. The old,
|
|
‘‘classic’’, format is created if
|
|
the <b>−c</b> option is used. (The Class F format can
|
|
also be requested with the <b>−f</b> option.)</p>
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">The default
|
|
name of the output image is <i>fax.tif</i>; this can be
|
|
changed with the <b>−o</b> option. Each input file is
|
|
assumed to be a separate page of facsimile 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.</p>
|
|
|
|
<a name="OPTIONS"></a>
|
|
<h2>OPTIONS</h2>
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">Options that
|
|
affect the interpretation of input data are:</p>
|
|
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−3</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Assume input data
|
|
is <small>CCITT</small> Group 3 encoded (default).</p></td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−4</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Assume input data
|
|
is <small>CCITT</small> Group 4 encoded.</p></td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−U</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Assume input data
|
|
is uncompressed (Group 3 or Group 4).</p></td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−1</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Assume input data
|
|
is encoded with the 1-dimensional version of the
|
|
<small>CCITT</small> Group 3 Huffman encoding algorithm
|
|
(default).</p> </td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−2</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Assume input data
|
|
is 2-dimensional version of the <small>CCITT</small> Group 3
|
|
Huffman encoding algorithm.</p></td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−P</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Assume input data
|
|
is <b>not</b> EOL-aligned (default). This option has effect
|
|
with Group 3 encoded input only.</p></td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−A</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Assume input data
|
|
is EOL-aligned. This option has effect with Group 3 encoded
|
|
input only.</p></td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−M</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Treat input data as
|
|
having bits filled from most significant bit (
|
|
<small>MSB</small> ) to most least bit ( <small>LSB</small>
|
|
).</p> </td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−L</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Treat input data as
|
|
having bits filled from least significant bit (
|
|
<small>LSB</small> ) to most significant bit (
|
|
<small>MSB</small> ) (default).</p></td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−B</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Assume input data
|
|
was encoded with black as 0 and white as 1.</p></td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−W</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Assume input data
|
|
was encoded with black as 1 and white as 0 (default).</p></td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−R</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Specify the
|
|
vertical resolution, in lines/inch, of the input images. By
|
|
default input are assumed to have a vertical resolution of
|
|
196 lines/inch. If images are low resolution facsimile, a
|
|
value of 98 lines/inch should be specified.</p></td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−X</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Specify the width,
|
|
in pixels, of the input images. By default input are assumed
|
|
to have a width of 1728 pixels.</p></td>
|
|
</table>
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">Options that
|
|
affect the output file format are:</p>
|
|
|
|
<table width="100%" border=0 rules="none" frame="void"
|
|
cellspacing="0" cellpadding="0">
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−o</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Specify the name of
|
|
the output file.</p></td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−7</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Force output to be
|
|
compressed with the <small>CCITT</small> Group 3 Huffman
|
|
encoding algorithm (default).</p></td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−8</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Force output to be
|
|
compressed with the <small>CCITT</small> Group 4 Huffman
|
|
encoding.</p> </td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−u</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Force output to be
|
|
uncompressed (Group 3 or Group 4).</p></td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−5</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Force output to be
|
|
encoded with the 1-dimensional version of the
|
|
<small>CCITT</small> Group 3 Huffman encoding algorithm.</p></td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−6</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Force output to be
|
|
encoded with the 2-dimensional version of the
|
|
<small>CCITT</small> Group 3 Huffman encoding algorithm
|
|
(default).</p> </td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−a</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Force the last bit
|
|
of each <i>End Of Line</i> ( <small>EOL</small> ) code to
|
|
land on a byte boundary (default). This ‘‘zero
|
|
padding’’ will be reflected in the contents of
|
|
the <i>Group3Options</i> tag of the resultant
|
|
<small>TIFF</small> file. This option has effect with Group
|
|
3 encoded output only.</p></td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−p</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Do not EOL-align
|
|
output. This option has effect with Group 3 encoded output
|
|
only.</p> </td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−c</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Generate
|
|
"classic" Group 3 TIFF format.</p></td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−f</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Generate TIFF Class
|
|
F (TIFF/F) format (default).</p></td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−m</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Force output data
|
|
to have bits filled from most significant bit (
|
|
<small>MSB</small> ) to most least bit ( <small>LSB</small>
|
|
).</p> </td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−l</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Force output data
|
|
to have bits filled from least significant bit (
|
|
<small>LSB</small> ) to most significant bit (
|
|
<small>MSB</small> ) (default).</p></td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−r</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Specify the number
|
|
of rows (scanlines) in each strip of data written to the
|
|
output file. By default (or when value <b>0</b> is
|
|
specified), <i>tiffcp</i> attempts to set the rows/strip
|
|
that no more than 8 kilobytes of data appear in a strip
|
|
(with except of G3/G4 compression schemes). If you specify
|
|
special value <b>-1</b> it will results in infinite number
|
|
of the rows per strip. The entire image will be the one
|
|
strip in that case. This is default in case of G3/G4 output
|
|
compression schemes.</p></td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−s</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Stretch the input
|
|
image vertically by writing each input row of data twice to
|
|
the output file.</p></td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−v</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Force
|
|
<i>fax2tiff</i> to print the number of rows of data it
|
|
retrieved from the input file.</p></td>
|
|
<tr valign="top" align="left">
|
|
<td width="11%"></td>
|
|
<td width="3%">
|
|
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top"><b>−z</b></p> </td>
|
|
<td width="8%"></td>
|
|
<td width="78%">
|
|
|
|
|
|
<p style="margin-top: 1em" valign="top">Force output to be
|
|
compressed with the LZW encoding.</p></td>
|
|
</table>
|
|
|
|
<a name="DIAGNOSTICS"></a>
|
|
<h2>DIAGNOSTICS</h2>
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">The following
|
|
warnings and errors come from the decoding routines in the
|
|
library.</p>
|
|
|
|
<p style="margin-left:11%; margin-top: 1em"><b>Warning, %s:
|
|
Premature EOL at scanline %d (x %d).\n</b>. The input data
|
|
had a row that was shorter than the expected width. The row
|
|
is padded with white.</p>
|
|
|
|
<p style="margin-left:11%; margin-top: 1em"><b>%s:
|
|
Premature EOF at scanline %d (x %d).\n</b>. The decoder ran
|
|
out of data in the middle of a scanline. The resultant row
|
|
is padded with white.</p>
|
|
|
|
<p style="margin-left:11%; margin-top: 1em"><b>%s: Bad code
|
|
word at row %d, x %d\n</b>. An invalid Group 3 <i>code</i>
|
|
was encountered while decoding the input file. The row
|
|
number and horizontal position is given. The remainder of
|
|
the input row is discarded, while the corresponding output
|
|
row is padded with white.</p>
|
|
|
|
<p style="margin-left:11%; margin-top: 1em"><b>%s: Bad 2D
|
|
code word at scanline %d.\n</b>. An invalid Group 4 or 2D
|
|
Group 3 <i>code</i> was encountered while decoding the input
|
|
file. The row number and horizontal position is given. The
|
|
remainder of the input row is discarded, while the
|
|
corresponding output row is padded with white.</p>
|
|
|
|
<a name="BUGS"></a>
|
|
<h2>BUGS</h2>
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">Input data are
|
|
assumed to have a a ‘‘top left’’
|
|
orientation; it should be possible to override this
|
|
assumption from the command line.</p>
|
|
|
|
<a name="SEE ALSO"></a>
|
|
<h2>SEE ALSO</h2>
|
|
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em"><b><small>CCITT</small>
|
|
Recommendation T.4</b> (Standardization of Group 3 Facsimile
|
|
Apparatus for Document Transmission).</p>
|
|
|
|
<p style="margin-left:11%; margin-top: 1em"><b>The Spirit
|
|
of TIFF Class F</b>, an appendix to the TIFF 5.0
|
|
specification prepared by Cygnet Technologies.</p>
|
|
|
|
|
|
<p style="margin-left:11%; margin-top: 1em"><b>tiffinfo</b>(1),
|
|
<b>tiffdither</b>(1), <b>tiffgt</b>(1),
|
|
<b>libtiff</b>(3)</p>
|
|
|
|
<p style="margin-left:11%; margin-top: 1em">Libtiff library
|
|
home page: <b>http://www.remotesensing.org/libtiff/</b></p>
|
|
<hr>
|
|
</body>
|
|
</html>
|