Initial import
git-svn-id: http://moon:8086/svn/software/trunk/libsrc/libtiff_2007@1 b431acfa-c32f-4a4a-93f1-934dc6c82436
This commit is contained in:
Executable
+257
@@ -0,0 +1,257 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
||||
<HTML><HEAD><TITLE>Manpage of FAX2TIFF</TITLE>
|
||||
</HEAD><BODY BGCOLOR=WHITE><FONT FACE="helvetica, sans, arial">
|
||||
<H1>FAX2TIFF</H1>
|
||||
Section: User Commands (1)<BR>Updated: September 24, 1994<BR><A HREF="#index">Index</A>
|
||||
<BR><A HREF="index.html">Return to Main Contents</A>
|
||||
<HR>
|
||||
|
||||
<A NAME="lbAB"> </A>
|
||||
<H2>NAME</H2>
|
||||
|
||||
fax2tiff - create a
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
Class F fax file from raw fax data
|
||||
<A NAME="lbAC"> </A>
|
||||
<H2>SYNOPSIS</H2>
|
||||
|
||||
<B>fax2tiff</B>
|
||||
|
||||
[
|
||||
<I>options</I>
|
||||
|
||||
] [
|
||||
<B>-o</B>
|
||||
|
||||
<I>output.tif</I>
|
||||
|
||||
]
|
||||
<I>input.g3</I>
|
||||
|
||||
<A NAME="lbAD"> </A>
|
||||
<H2>DESCRIPTION</H2>
|
||||
|
||||
<I>Fax2tiff</I>
|
||||
|
||||
creates a
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file containing
|
||||
<FONT SIZE="-1">CCITT</FONT>
|
||||
Group 3 or Group 4 encoded data from one or more files containing ``raw''
|
||||
Group 3 encoded data (typically obtained directly from a fax modem).
|
||||
By default, each row of data in the resultant
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file is 2-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
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
Class F (<FONT SIZE="-1">FAX</FONT>) 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>
|
||||
|
||||
(<FONT SIZE="-1">RTC</FONT>) code; as required
|
||||
for transmission by the
|
||||
<FONT SIZE="-1">CCITT</FONT>
|
||||
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>
|
||||
|
||||
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.
|
||||
<A NAME="lbAE"> </A>
|
||||
<H2>OPTIONS</H2>
|
||||
|
||||
Options that affect the interpretation of input data are:
|
||||
<DL COMPACT>
|
||||
<DT><B>-2</B>
|
||||
|
||||
<DD>
|
||||
Assume input data is 2-d Huffman encoded.
|
||||
<DT><B>-B</B>
|
||||
|
||||
<DD>
|
||||
Assume input data was encoded with
|
||||
black as 0 and white as 1.
|
||||
<DT><B>-L</B>
|
||||
|
||||
<DD>
|
||||
Treat input data as having bits filled from least
|
||||
significant bit (<FONT SIZE="-1">LSB</FONT>) to most significant bit (<FONT SIZE="-1">MSB</FONT>).
|
||||
(This is the default.)
|
||||
<DT><B>-M</B>
|
||||
|
||||
<DD>
|
||||
Treat input data as having bits filled from most
|
||||
significant bit (<FONT SIZE="-1">MSB</FONT>) to most least bit (<FONT SIZE="-1">LSB</FONT>).
|
||||
<DT><B>-R</B>
|
||||
|
||||
<DD>
|
||||
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.
|
||||
<DT><B>-W</B>
|
||||
|
||||
<DD>
|
||||
Assume input data was encoded with
|
||||
black as 1 and white as 0.
|
||||
(This is the default.)
|
||||
</DL>
|
||||
<P>
|
||||
|
||||
Options that affect the output file format are:
|
||||
<DL COMPACT>
|
||||
<DT><B>-1</B>
|
||||
|
||||
<DD>
|
||||
Force output to be compressed with the 1-dimensional
|
||||
version of the
|
||||
<FONT SIZE="-1">CCITT</FONT>
|
||||
Group 3 Huffman encoding algorithm.
|
||||
<DT><B>-4</B>
|
||||
|
||||
<DD>
|
||||
Force output to be compressed with the
|
||||
<FONT SIZE="-1">CCITT</FONT>
|
||||
Group 4 Huffman encoding.
|
||||
<DT><B>-o</B>
|
||||
|
||||
<DD>
|
||||
Specify the name of the output file.
|
||||
<DT><B>-p</B>
|
||||
|
||||
<DD>
|
||||
Force the last bit of each
|
||||
<I>End Of Line</I>
|
||||
|
||||
(<FONT SIZE="-1">EOL</FONT>) code to land on a byte boundary.
|
||||
This ``zero padding'' will be reflected in the contents of the
|
||||
<I>Group3Options</I>
|
||||
|
||||
tag of the resultant
|
||||
<FONT SIZE="-1">TIFF</FONT>
|
||||
file.
|
||||
<DT><B>-s</B>
|
||||
|
||||
<DD>
|
||||
Stretch the input image vertically by writing each input row of
|
||||
data twice to the output file.
|
||||
<DT><B>-v</B>
|
||||
|
||||
<DD>
|
||||
Force
|
||||
<I>fax2tiff</I>
|
||||
|
||||
to print the number of rows of data it retrieved from the input file.
|
||||
</DL>
|
||||
<A NAME="lbAF"> </A>
|
||||
<H2>DIAGNOSTICS</H2>
|
||||
|
||||
The following warnings and errors come from the decoding
|
||||
routines in the library.
|
||||
<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 value of 1728.
|
||||
The row is padded with white.
|
||||
<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>
|
||||
|
||||
<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>
|
||||
|
||||
<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.
|
||||
<A NAME="lbAG"> </A>
|
||||
<H2>BUGS</H2>
|
||||
|
||||
Should not have the constant width 1728 built into it.
|
||||
Input data are assumed to have a a ``top left'' orientation;
|
||||
it should be possible to override this assumption
|
||||
from the command line.
|
||||
<A NAME="lbAH"> </A>
|
||||
<H2>SEE ALSO</H2>
|
||||
|
||||
<I></I><FONT SIZE="-1"><I>CCITT</I></FONT><I> Recommendation T.4</I>
|
||||
|
||||
(Standardization of Group 3 Facsimile Apparatus for Document Transmission).
|
||||
<P>
|
||||
|
||||
<I>The Spirit of TIFF Class F</I>,
|
||||
|
||||
an appendix to the TIFF 5.0 specification prepared by Cygnet Technologies.
|
||||
<P>
|
||||
|
||||
<I><A HREF="tiffinfo+1.html">tiffinfo</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffdither+1.html">tiffdither</A></I>(1),
|
||||
|
||||
<I><A HREF="tiffgt+1.html">tiffgt</A></I>(1),
|
||||
|
||||
<I><A HREF="libtiff+3">libtiff</A></I>(3).
|
||||
|
||||
|
||||
<HR>
|
||||
<A NAME="index"> </A><H2>Index</H2>
|
||||
<DL>
|
||||
<DT><A HREF="#lbAB">NAME</A><DD>
|
||||
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||||
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||||
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
||||
<DT><A HREF="#lbAF">DIAGNOSTICS</A><DD>
|
||||
<DT><A HREF="#lbAG">BUGS</A><DD>
|
||||
<DT><A HREF="#lbAH">SEE ALSO</A><DD>
|
||||
</DL>
|
||||
<HR>
|
||||
This document was created by
|
||||
<A HREF="index.html">man2html</A>,
|
||||
using the manual pages.<BR>
|
||||
Time: 01:31:47 GMT, November 23, 1999
|
||||
</BODY>
|
||||
</HTML>
|
||||
Reference in New Issue
Block a user