[wxWidgets.git] / src / tiff / html / man / fax2tiff.1.html

<!-- Creator     : groff version 1.18.1 -->
<!-- CreationDate: Mon Mar 13 18:03:12 2006 -->
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta name="Content-Style" content="text/css">
<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>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
<p>fax2tiff &minus; create a <small>TIFF</small> Class F fax
file from raw fax data</p>
</td>
</table>
<a name="SYNOPSIS"></a>
<h2>SYNOPSIS</h2>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
<p><b>fax2tiff</b> [ <i>options</i> ] [ <b>&minus;o</b>
<i>output.tif</i> ] <i>input.raw</i></p>
</td>
</table>
<a name="DESCRIPTION"></a>
<h2>DESCRIPTION</h2>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
<p><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
&lsquo;&lsquo;raw&rsquo;&rsquo; 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,
&lsquo;&lsquo;classic&rsquo;&rsquo;, format is created if
the <b>&minus;c</b> option is used. (The Class F format can
also be requested with the <b>&minus;f</b> option.)</p>
<!-- INDENTATION -->
<p>The default name of the output image is <i>fax.tif</i>;
this can be changed with the <b>&minus;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>
</td>
</table>
<a name="OPTIONS"></a>
<h2>OPTIONS</h2>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
<p>Options that affect the interpretation of input data
are:</p>
</td>
</table>
<!-- TABS -->
<table width="100%" border=0 rules="none" frame="void"
       cols="5" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;3</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Assume input data is <small>CCITT</small> Group 3
encoded (default).</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;4</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Assume input data is <small>CCITT</small> Group 4
encoded.</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;U</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Assume input data is uncompressed (Group 3 or Group
4).</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;1</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Assume input data is encoded with the 1-dimensional
version of the <small>CCITT</small> Group 3 Huffman encoding
algorithm (default).</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;2</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Assume input data is 2-dimensional version of the
<small>CCITT</small> Group 3 Huffman encoding algorithm.</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;P</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Assume input data is <b>not</b> EOL-aligned (default).
This option has effect with Group 3 encoded input only.</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;A</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Assume input data is EOL-aligned. This option has effect
with Group 3 encoded input only.</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;M</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Treat input data as having bits filled from most
significant bit ( <small>MSB</small> ) to most least bit (
<small>LSB</small> ).</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;L</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Treat input data as having bits filled from least
significant bit ( <small>LSB</small> ) to most significant
bit ( <small>MSB</small> ) (default).</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;B</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Assume input data was encoded with black as 0 and white
as 1.</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;W</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Assume input data was encoded with black as 1 and white
as 0 (default).</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;R</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>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>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;X</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Specify the width, in pixels, of the input images. By
default input are assumed to have a width of 1728
pixels.</p>
</td>
<td width="0%">
</td>
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
<p>Options that affect the output file format are:</p>
</td>
</table>
<!-- TABS -->
<table width="100%" border=0 rules="none" frame="void"
       cols="5" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;o</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Specify the name of the output file.</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;7</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Force output to be compressed with the
<small>CCITT</small> Group 3 Huffman encoding algorithm
(default).</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;8</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Force output to be compressed with the
<small>CCITT</small> Group 4 Huffman encoding.</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;u</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Force output to be uncompressed (Group 3 or Group
4).</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;5</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Force output to be encoded with the 1-dimensional
version of the <small>CCITT</small> Group 3 Huffman encoding
algorithm.</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;6</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Force output to be encoded with the 2-dimensional
version of the <small>CCITT</small> Group 3 Huffman encoding
algorithm (default).</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;a</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Force the last bit of each <i>End Of Line</i> (
<small>EOL</small> ) code to land on a byte boundary
(default). This &lsquo;&lsquo;zero padding&rsquo;&rsquo;
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>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;p</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Do not EOL-align output. This option has effect with
Group 3 encoded output only.</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;c</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Generate &quot;classic&quot; Group 3 TIFF format.</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;f</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Generate TIFF Class F (TIFF/F) format (default).</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;m</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Force output data to have bits filled from most
significant bit ( <small>MSB</small> ) to most least bit (
<small>LSB</small> ).</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;l</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Force output data to have bits filled from least
significant bit ( <small>LSB</small> ) to most significant
bit ( <small>MSB</small> ) (default).</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;r</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>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>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;s</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Stretch the input image vertically by writing each input
row of data twice to the output file.</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;v</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Force <i>fax2tiff</i> to print the number of rows of
data it retrieved from the input file.</p>
</td>
<td width="0%">
</td>
<tr valign="top" align="left">
<td width="10%"></td>
<td width="3%">

<p><b>&minus;z</b></p>
</td>
<td width="5%"></td>
<td width="80%">

<p>Force output to be compressed with the LZW encoding.</p>
</td>
<td width="0%">
</td>
</table>
<a name="DIAGNOSTICS"></a>
<h2>DIAGNOSTICS</h2>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
<p>The following warnings and errors come from the decoding
routines in the library.</p>
<!-- INDENTATION -->
<p><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>
<!-- INDENTATION -->
<p><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>
<!-- INDENTATION -->
<p><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>
<!-- INDENTATION -->
<p><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>
</td>
</table>
<a name="BUGS"></a>
<h2>BUGS</h2>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
<p>Input data are assumed to have a a &lsquo;&lsquo;top
left&rsquo;&rsquo; orientation; it should be possible to
override this assumption from the command line.</p>
</td>
</table>
<a name="SEE ALSO"></a>
<h2>SEE ALSO</h2>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="8%"></td>
<td width="91%">
<p><b><small>CCITT</small> Recommendation T.4</b>
(Standardization of Group 3 Facsimile Apparatus for Document
Transmission).</p>
<!-- INDENTATION -->
<p><b>The Spirit of TIFF Class F</b>, an appendix to the
TIFF 5.0 specification prepared by Cygnet Technologies.</p>
<!-- INDENTATION -->
<p><b>tiffinfo</b>(1), <b>tiffdither</b>(1),
<b>tiffgt</b>(1), <b>libtiff</b>(3)</p>
<!-- INDENTATION -->
<p>Libtiff library home page:
<b>http://www.remotesensing.org/libtiff/</b></p>
</td>
</table>
<hr>
</body>
</html>
Commit	Line	Data
8414a40c VZ	1	<!-- Creator : groff version 1.18.1 -->
	2	<!-- CreationDate: Mon Mar 13 18:03:12 2006 -->
	3	<html>
	4	<head>
	5	<meta name="generator" content="groff -Thtml, see www.gnu.org">
	6	<meta name="Content-Style" content="text/css">
	7	<title>FAX2TIFF</title>
	8	</head>
	9	<body>
	10
	11	<h1 align=center>FAX2TIFF</h1>
	12	<a href="#NAME">NAME</a><br>
	13	<a href="#SYNOPSIS">SYNOPSIS</a><br>
	14	<a href="#DESCRIPTION">DESCRIPTION</a><br>
	15	<a href="#OPTIONS">OPTIONS</a><br>
	16	<a href="#DIAGNOSTICS">DIAGNOSTICS</a><br>
	17	<a href="#BUGS">BUGS</a><br>
	18	<a href="#SEE ALSO">SEE ALSO</a><br>
	19
	20	<hr>
	21	<a name="NAME"></a>
	22	<h2>NAME</h2>
	23	<!-- INDENTATION -->
	24	<table width="100%" border=0 rules="none" frame="void"
	25	cols="2" cellspacing="0" cellpadding="0">
	26	<tr valign="top" align="left">
	27	<td width="8%"></td>
	28	<td width="91%">
	29	<p>fax2tiff − create a <small>TIFF</small> Class F fax
	30	file from raw fax data</p>
	31	</td>
	32	</table>
	33	<a name="SYNOPSIS"></a>
	34	<h2>SYNOPSIS</h2>
	35	<!-- INDENTATION -->
	36	<table width="100%" border=0 rules="none" frame="void"
	37	cols="2" cellspacing="0" cellpadding="0">
	38	<tr valign="top" align="left">
	39	<td width="8%"></td>
	40	<td width="91%">
	41	<p><b>fax2tiff</b> [ <i>options</i> ] [ <b>−o</b>
	42	<i>output.tif</i> ] <i>input.raw</i></p>
	43	</td>
	44	</table>
	45	<a name="DESCRIPTION"></a>
	46	<h2>DESCRIPTION</h2>
	47	<!-- INDENTATION -->
	48	<table width="100%" border=0 rules="none" frame="void"
	49	cols="2" cellspacing="0" cellpadding="0">
	50	<tr valign="top" align="left">
	51	<td width="8%"></td>
	52	<td width="91%">
	53	<p><i>Fax2tiff</i> creates a <small>TIFF</small> file
	54	containing <small>CCITT</small> Group 3 or Group 4 encoded
	55	data from one or more files containing
	56	‘‘raw’’ Group 3 or Group 4 encoded
	57	data (typically obtained directly from a fax modem). By
	58	default, each row of data in the resultant
	59	<small>TIFF</small> file is 1-dimensionally encoded and
	60	padded or truncated to 1728 pixels, as needed. The resultant
	61	image is a set of low resolution (98 lines/inch) or medium
	62	resolution (196 lines/inch) pages, each of which is a single
	63	strip of data. The generated file conforms to the
	64	<small>TIFF</small> Class F ( <small>FAX</small> )
65	specification for storing facsimile data. This means, in
66	particular, that each page of the data does <b>not</b>
67	include the trailing <i>return to control</i> (
68	<small>RTC</small> ) code; as required for transmission by
69	the <small>CCITT</small> Group 3 specifications. The old,
70	‘‘classic’’, format is created if
71	the <b>−c</b> option is used. (The Class F format can
72	also be requested with the <b>−f</b> option.)</p>
73	<!-- INDENTATION -->
74	<p>The default name of the output image is <i>fax.tif</i>;
75	this can be changed with the <b>−o</b> option. Each
76	input file is assumed to be a separate page of facsimile
77	data from the same document. The order in which input files
78	are specified on the command line is the order in which the
79	resultant pages appear in the output file.</p>
80	</td>
81	</table>
82	<a name="OPTIONS"></a>
83	<h2>OPTIONS</h2>
84	<!-- INDENTATION -->
85	<table width="100%" border=0 rules="none" frame="void"
86	cols="2" cellspacing="0" cellpadding="0">
87	<tr valign="top" align="left">
88	<td width="8%"></td>
89	<td width="91%">
90	<p>Options that affect the interpretation of input data
91	are:</p>
92	</td>
93	</table>
94	<!-- TABS -->
95	<table width="100%" border=0 rules="none" frame="void"
96	cols="5" cellspacing="0" cellpadding="0">
97	<tr valign="top" align="left">
98	<td width="10%"></td>
99	<td width="3%">
100
101	<p><b>−3</b></p>
102	</td>
103	<td width="5%"></td>
104	<td width="80%">
105
106	<p>Assume input data is <small>CCITT</small> Group 3
107	encoded (default).</p>
108	</td>
109	<td width="0%">
110	</td>
111	<tr valign="top" align="left">
112	<td width="10%"></td>
113	<td width="3%">
114
115	<p><b>−4</b></p>
116	</td>
117	<td width="5%"></td>
118	<td width="80%">
119
120	<p>Assume input data is <small>CCITT</small> Group 4
121	encoded.</p>
122	</td>
123	<td width="0%">
124	</td>
125	<tr valign="top" align="left">
126	<td width="10%"></td>
127	<td width="3%">
128
129	<p><b>−U</b></p>
130	</td>
131	<td width="5%"></td>
132	<td width="80%">
133
134	<p>Assume input data is uncompressed (Group 3 or Group
135	4).</p>
136	</td>
137	<td width="0%">
138	</td>
139	<tr valign="top" align="left">
140	<td width="10%"></td>
141	<td width="3%">
142
143	<p><b>−1</b></p>
144	</td>
145	<td width="5%"></td>
146	<td width="80%">
147
148	<p>Assume input data is encoded with the 1-dimensional
149	version of the <small>CCITT</small> Group 3 Huffman encoding
150	algorithm (default).</p>
151	</td>
152	<td width="0%">
153	</td>
154	<tr valign="top" align="left">
155	<td width="10%"></td>
156	<td width="3%">
157
158	<p><b>−2</b></p>
159	</td>
160	<td width="5%"></td>
161	<td width="80%">
162
163	<p>Assume input data is 2-dimensional version of the
164	<small>CCITT</small> Group 3 Huffman encoding algorithm.</p>
165	</td>
166	<td width="0%">
167	</td>
168	<tr valign="top" align="left">
169	<td width="10%"></td>
170	<td width="3%">
171
172	<p><b>−P</b></p>
173	</td>
174	<td width="5%"></td>
175	<td width="80%">
176
177	<p>Assume input data is <b>not</b> EOL-aligned (default).
178	This option has effect with Group 3 encoded input only.</p>
179	</td>
180	<td width="0%">
181	</td>
182	<tr valign="top" align="left">
183	<td width="10%"></td>
184	<td width="3%">
185
186	<p><b>−A</b></p>
187	</td>
188	<td width="5%"></td>
189	<td width="80%">
190
191	<p>Assume input data is EOL-aligned. This option has effect
192	with Group 3 encoded input only.</p>
193	</td>
194	<td width="0%">
195	</td>
196	<tr valign="top" align="left">
197	<td width="10%"></td>
198	<td width="3%">
199
200	<p><b>−M</b></p>
201	</td>
202	<td width="5%"></td>
203	<td width="80%">
204
205	<p>Treat input data as having bits filled from most
206	significant bit ( <small>MSB</small> ) to most least bit (
207	<small>LSB</small> ).</p>
208	</td>
209	<td width="0%">
210	</td>
211	<tr valign="top" align="left">
212	<td width="10%"></td>
213	<td width="3%">
214
215	<p><b>−L</b></p>
216	</td>
217	<td width="5%"></td>
218	<td width="80%">
219
220	<p>Treat input data as having bits filled from least
221	significant bit ( <small>LSB</small> ) to most significant
222	bit ( <small>MSB</small> ) (default).</p>
223	</td>
224	<td width="0%">
225	</td>
226	<tr valign="top" align="left">
227	<td width="10%"></td>
228	<td width="3%">
229
230	<p><b>−B</b></p>
231	</td>
232	<td width="5%"></td>
233	<td width="80%">
234
235	<p>Assume input data was encoded with black as 0 and white
236	as 1.</p>
237	</td>
238	<td width="0%">
239	</td>
240	<tr valign="top" align="left">
241	<td width="10%"></td>
242	<td width="3%">
243
244	<p><b>−W</b></p>
245	</td>
246	<td width="5%"></td>
247	<td width="80%">
248
249	<p>Assume input data was encoded with black as 1 and white
250	as 0 (default).</p>
251	</td>
252	<td width="0%">
253	</td>
254	<tr valign="top" align="left">
255	<td width="10%"></td>
256	<td width="3%">
257
258	<p><b>−R</b></p>
259	</td>
260	<td width="5%"></td>
261	<td width="80%">
262
263	<p>Specify the vertical resolution, in lines/inch, of the
264	input images. By default input are assumed to have a
265	vertical resolution of 196 lines/inch. If images are low
266	resolution facsimile, a value of 98 lines/inch should be
267	specified.</p>
268	</td>
269	<td width="0%">
270	</td>
271	<tr valign="top" align="left">
272	<td width="10%"></td>
273	<td width="3%">
274
275	<p><b>−X</b></p>
276	</td>
277	<td width="5%"></td>
278	<td width="80%">
279
280	<p>Specify the width, in pixels, of the input images. By
281	default input are assumed to have a width of 1728
282	pixels.</p>
283	</td>
284	<td width="0%">
285	</td>
286	</table>
287	<!-- INDENTATION -->
288	<table width="100%" border=0 rules="none" frame="void"
289	cols="2" cellspacing="0" cellpadding="0">
290	<tr valign="top" align="left">
291	<td width="8%"></td>
292	<td width="91%">
293	<p>Options that affect the output file format are:</p>
294	</td>
295	</table>
296	<!-- TABS -->
297	<table width="100%" border=0 rules="none" frame="void"
298	cols="5" cellspacing="0" cellpadding="0">
299	<tr valign="top" align="left">
300	<td width="10%"></td>
301	<td width="3%">
302
303	<p><b>−o</b></p>
304	</td>
305	<td width="5%"></td>
306	<td width="80%">
307
308	<p>Specify the name of the output file.</p>
309	</td>
310	<td width="0%">
311	</td>
312	<tr valign="top" align="left">
313	<td width="10%"></td>
314	<td width="3%">
315
316	<p><b>−7</b></p>
317	</td>
318	<td width="5%"></td>
319	<td width="80%">
320
321	<p>Force output to be compressed with the
322	<small>CCITT</small> Group 3 Huffman encoding algorithm
323	(default).</p>
324	</td>
325	<td width="0%">
326	</td>
327	<tr valign="top" align="left">
328	<td width="10%"></td>
329	<td width="3%">
330
331	<p><b>−8</b></p>
332	</td>
333	<td width="5%"></td>
334	<td width="80%">
335
336	<p>Force output to be compressed with the
337	<small>CCITT</small> Group 4 Huffman encoding.</p>
338	</td>
339	<td width="0%">
340	</td>
341	<tr valign="top" align="left">
342	<td width="10%"></td>
343	<td width="3%">
344
345	<p><b>−u</b></p>
346	</td>
347	<td width="5%"></td>
348	<td width="80%">
349
350	<p>Force output to be uncompressed (Group 3 or Group
351	4).</p>
352	</td>
353	<td width="0%">
354	</td>
355	<tr valign="top" align="left">
356	<td width="10%"></td>
357	<td width="3%">
358
359	<p><b>−5</b></p>
360	</td>
361	<td width="5%"></td>
362	<td width="80%">
363
364	<p>Force output to be encoded with the 1-dimensional
365	version of the <small>CCITT</small> Group 3 Huffman encoding
366	algorithm.</p>
367	</td>
368	<td width="0%">
369	</td>
370	<tr valign="top" align="left">
371	<td width="10%"></td>
372	<td width="3%">
373
374	<p><b>−6</b></p>
375	</td>
376	<td width="5%"></td>
377	<td width="80%">
378
379	<p>Force output to be encoded with the 2-dimensional
380	version of the <small>CCITT</small> Group 3 Huffman encoding
381	algorithm (default).</p>
382	</td>
383	<td width="0%">
384	</td>
385	<tr valign="top" align="left">
386	<td width="10%"></td>
387	<td width="3%">
388
389	<p><b>−a</b></p>
390	</td>
391	<td width="5%"></td>
392	<td width="80%">
393
394	<p>Force the last bit of each <i>End Of Line</i> (
395	<small>EOL</small> ) code to land on a byte boundary
396	(default). This ‘‘zero padding’’
397	will be reflected in the contents of the
398	<i>Group3Options</i> tag of the resultant
399	<small>TIFF</small> file. This option has effect with Group
400	3 encoded output only.</p>
401	</td>
402	<td width="0%">
403	</td>
404	<tr valign="top" align="left">
405	<td width="10%"></td>
406	<td width="3%">
407
408	<p><b>−p</b></p>
409	</td>
410	<td width="5%"></td>
411	<td width="80%">
412
413	<p>Do not EOL-align output. This option has effect with
414	Group 3 encoded output only.</p>
415	</td>
416	<td width="0%">
417	</td>
418	<tr valign="top" align="left">
419	<td width="10%"></td>
420	<td width="3%">
421
422	<p><b>−c</b></p>
423	</td>
424	<td width="5%"></td>
425	<td width="80%">
426
427	<p>Generate "classic" Group 3 TIFF format.</p>
428	</td>
429	<td width="0%">
430	</td>
431	<tr valign="top" align="left">
432	<td width="10%"></td>
433	<td width="3%">
434
435	<p><b>−f</b></p>
436	</td>
437	<td width="5%"></td>
438	<td width="80%">
439
440	<p>Generate TIFF Class F (TIFF/F) format (default).</p>
441	</td>
442	<td width="0%">
443	</td>
444	<tr valign="top" align="left">
445	<td width="10%"></td>
446	<td width="3%">
447
448	<p><b>−m</b></p>
449	</td>
450	<td width="5%"></td>
451	<td width="80%">
452
453	<p>Force output data to have bits filled from most
454	significant bit ( <small>MSB</small> ) to most least bit (
455	<small>LSB</small> ).</p>
456	</td>
457	<td width="0%">
458	</td>
459	<tr valign="top" align="left">
460	<td width="10%"></td>
461	<td width="3%">
462
463	<p><b>−l</b></p>
464	</td>
465	<td width="5%"></td>
466	<td width="80%">
467
468	<p>Force output data to have bits filled from least
469	significant bit ( <small>LSB</small> ) to most significant
470	bit ( <small>MSB</small> ) (default).</p>
471	</td>
472	<td width="0%">
473	</td>
474	<tr valign="top" align="left">
475	<td width="10%"></td>
476	<td width="3%">
477
478	<p><b>−r</b></p>
479	</td>
480	<td width="5%"></td>
481	<td width="80%">
482
483	<p>Specify the number of rows (scanlines) in each strip of
484	data written to the output file. By default (or when value
485	<b>0</b> is specified), <i>tiffcp</i> attempts to set the
486	rows/strip that no more than 8 kilobytes of data appear in a
487	strip (with except of G3/G4 compression schemes). If you
488	specify special value <b>-1</b> it will results in infinite
489	number of the rows per strip. The entire image will be the
490	one strip in that case. This is default in case of G3/G4
491	output compression schemes.</p>
492	</td>
493	<td width="0%">
494	</td>
495	<tr valign="top" align="left">
496	<td width="10%"></td>
497	<td width="3%">
498
499	<p><b>−s</b></p>
500	</td>
501	<td width="5%"></td>
502	<td width="80%">
503
504	<p>Stretch the input image vertically by writing each input
505	row of data twice to the output file.</p>
506	</td>
507	<td width="0%">
508	</td>
509	<tr valign="top" align="left">
510	<td width="10%"></td>
511	<td width="3%">
512
513	<p><b>−v</b></p>
514	</td>
515	<td width="5%"></td>
516	<td width="80%">
517
518	<p>Force <i>fax2tiff</i> to print the number of rows of
519	data it retrieved from the input file.</p>
520	</td>
521	<td width="0%">
522	</td>
523	<tr valign="top" align="left">
524	<td width="10%"></td>
525	<td width="3%">
526
527	<p><b>−z</b></p>
528	</td>
529	<td width="5%"></td>
530	<td width="80%">
531
532	<p>Force output to be compressed with the LZW encoding.</p>
533	</td>
534	<td width="0%">
535	</td>
536	</table>
537	<a name="DIAGNOSTICS"></a>
538	<h2>DIAGNOSTICS</h2>
539	<!-- INDENTATION -->
540	<table width="100%" border=0 rules="none" frame="void"
541	cols="2" cellspacing="0" cellpadding="0">
542	<tr valign="top" align="left">
543	<td width="8%"></td>
544	<td width="91%">
545	<p>The following warnings and errors come from the decoding
546	routines in the library.</p>
547	<!-- INDENTATION -->
548	<p><b>Warning, %s: Premature EOL at scanline %d (x
549	%d).\n</b>. The input data had a row that was shorter than
550	the expected width. The row is padded with white.</p>
551	<!-- INDENTATION -->
552	<p><b>%s: Premature EOF at scanline %d (x %d).\n</b>. The
553	decoder ran out of data in the middle of a scanline. The
554	resultant row is padded with white.</p>
555	<!-- INDENTATION -->
556	<p><b>%s: Bad code word at row %d, x %d\n</b>. An invalid
557	Group 3 <i>code</i> was encountered while decoding the input
558	file. The row number and horizontal position is given. The
559	remainder of the input row is discarded, while the
560	corresponding output row is padded with white.</p>
561	<!-- INDENTATION -->
562	<p><b>%s: Bad 2D code word at scanline %d.\n</b>. An invalid
563	Group 4 or 2D Group 3 <i>code</i> was encountered while
564	decoding the input file. The row number and horizontal
565	position is given. The remainder of the input row is
566	discarded, while the corresponding output row is padded with
567	white.</p>
568	</td>
569	</table>
570	<a name="BUGS"></a>
571	<h2>BUGS</h2>
572	<!-- INDENTATION -->
573	<table width="100%" border=0 rules="none" frame="void"
574	cols="2" cellspacing="0" cellpadding="0">
575	<tr valign="top" align="left">
576	<td width="8%"></td>
577	<td width="91%">
578	<p>Input data are assumed to have a a ‘‘top
579	left’’ orientation; it should be possible to
580	override this assumption from the command line.</p>
581	</td>
582	</table>
583	<a name="SEE ALSO"></a>
584	<h2>SEE ALSO</h2>
585	<!-- INDENTATION -->
586	<table width="100%" border=0 rules="none" frame="void"
587	cols="2" cellspacing="0" cellpadding="0">
588	<tr valign="top" align="left">
589	<td width="8%"></td>
590	<td width="91%">
591	<p><b><small>CCITT</small> Recommendation T.4</b>
592	(Standardization of Group 3 Facsimile Apparatus for Document
593	Transmission).</p>
594	<!-- INDENTATION -->
595	<p><b>The Spirit of TIFF Class F</b>, an appendix to the
596	TIFF 5.0 specification prepared by Cygnet Technologies.</p>
597	<!-- INDENTATION -->
598	<p><b>tiffinfo</b>(1), <b>tiffdither</b>(1),
599	<b>tiffgt</b>(1), <b>libtiff</b>(3)</p>
600	<!-- INDENTATION -->
601	<p>Libtiff library home page:
602	<b>http://www.remotesensing.org/libtiff/</b></p>
603	</td>
604	</table>
605	<hr>
606	</body>
607	</html>