diff options
Diffstat (limited to 'tiff/man/fax2tiff.1')
-rw-r--r-- | tiff/man/fax2tiff.1 | 286 |
1 files changed, 0 insertions, 286 deletions
diff --git a/tiff/man/fax2tiff.1 b/tiff/man/fax2tiff.1 deleted file mode 100644 index 1ac4d7d..0000000 --- a/tiff/man/fax2tiff.1 +++ /dev/null @@ -1,286 +0,0 @@ -.\" $Id: fax2tiff.1,v 1.7 2006/04/20 12:17:19 dron Exp $ -.\" -.\" Copyright (c) 1990-1997 Sam Leffler -.\" Copyright (c) 1991-1997 Silicon Graphics, Inc. -.\" -.\" Permission to use, copy, modify, distribute, and sell this software and -.\" its documentation for any purpose is hereby granted without fee, provided -.\" that (i) the above copyright notices and this permission notice appear in -.\" all copies of the software and related documentation, and (ii) the names of -.\" Sam Leffler and Silicon Graphics may not be used in any advertising or -.\" publicity relating to the software without the specific, prior written -.\" permission of Sam Leffler and Silicon Graphics. -.\" -.\" THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, -.\" EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY -.\" WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. -.\" -.\" IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR -.\" ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, -.\" OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, -.\" WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF -.\" LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE -.\" OF THIS SOFTWARE. -.\" -.if n .po 0 -.TH FAX2TIFF 1 "November 2, 2005" "libtiff" -.SH NAME -fax2tiff \- create a -.SM TIFF -Class F fax file from raw fax data -.SH SYNOPSIS -.B fax2tiff -[ -.I options -] [ -.B \-o -.I output.tif -] -.I input.raw -.SH DESCRIPTION -.I Fax2tiff -creates a -.SM TIFF -file containing -.SM CCITT -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 -.SM TIFF -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 -.SM TIFF -Class F (\c -.SM FAX\c -) specification for storing facsimile data. -This means, in particular, that each page of the data does -.B not -include the trailing -.I "return to control" -(\c -.SM RTC\c -) code; as required -for transmission by the -.SM CCITT -Group 3 specifications. -The old, ``classic'', format is created if the -.B \-c -option is used. -(The Class F format can also be requested with the -.B \-f -option.) -.PP -The default name of the output image is -.IR fax.tif ; -this can be changed with the -.B \-o -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. -.SH OPTIONS -Options that affect the interpretation of input data are: -.TP -.B \-3 -Assume input data is -.SM CCITT -Group 3 encoded (default). -.TP -.B \-4 -Assume input data is -.SM CCITT -Group 4 encoded. -.TP -.B \-U -Assume input data is uncompressed (Group 3 or Group 4). -.TP -.B \-1 -Assume input data is encoded with the 1-dimensional version of the -.SM CCITT -Group 3 Huffman encoding algorithm (default). -.TP -.B \-2 -Assume input data is 2-dimensional version of the -.SM CCITT -Group 3 Huffman encoding algorithm. -.TP -.B \-P -Assume input data is -.B not -EOL-aligned (default). This option has effect with Group 3 encoded input only. -.TP -.B \-A -Assume input data is EOL-aligned. This option has effect with Group 3 -encoded input only. -.TP -.B \-M -Treat input data as having bits filled from most significant bit (\c -.SM MSB\c -) to most least bit (\c -.SM LSB\c -). -.TP -.B \-L -Treat input data as having bits filled from least significant bit (\c -.SM LSB\c -) to most significant bit (\c -.SM MSB\c -) (default). -.TP -.B \-B -Assume input data was encoded with black as 0 and white as 1. -.TP -.B \-W -Assume input data was encoded with black as 1 and white as 0 (default). -.TP -.B \-R -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. -.TP -.B \-X -Specify the width, in pixels, of the input images. -By default input are assumed to have a width of 1728 pixels. -.PP -Options that affect the output file format are: -.TP -.B \-o -Specify the name of the output file. -.TP -.B \-7 -Force output to be compressed with the -.SM CCITT -Group 3 Huffman encoding algorithm (default). -.TP -.B \-8 -Force output to be compressed with the -.SM CCITT -Group 4 Huffman encoding. -.TP -.B \-u -Force output to be uncompressed (Group 3 or Group 4). -.TP -.B \-5 -Force output to be encoded with the 1-dimensional version of the -.SM CCITT -Group 3 Huffman encoding algorithm. -.TP -.B \-6 -Force output to be encoded with the 2-dimensional version of the -.SM CCITT -Group 3 Huffman encoding algorithm (default). -.TP -.B \-a -Force the last bit of each -.I "End Of Line" -(\c -.SM EOL\c -) code to land on a byte boundary (default). This ``zero padding'' will -be reflected in the contents of the -.I Group3Options -tag of the resultant -.SM TIFF -file. This option has effect with Group 3 encoded output only. -.TP -.B \-p -Do not EOL-align output. This option has effect with Group 3 encoded -output only. -.TP -.B \-c -Generate "classic" Group 3 TIFF format. -.TP -.B \-f -Generate TIFF Class F (TIFF/F) format (default). -.TP -.B \-m -Force output data to have bits filled from most significant bit (\c -.SM MSB\c -) to most least bit (\c -.SM LSB\c -). -.TP -.B \-l -Force output data to have bits filled from least significant bit (\c -.SM LSB\c -) to most significant bit (\c -.SM MSB\c -) (default). -.TP -.B \-r -Specify the number of rows (scanlines) in each strip of data -written to the output file. -By default (or when value -.B 0 -is specified), -.I tiffcp -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 -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. -.TP -.B \-s -Stretch the input image vertically by writing each input row of -data twice to the output file. -.TP -.B \-v -Force -.I fax2tiff -to print the number of rows of data it retrieved from the input file. -.TP -.B \-z -Force output to be compressed with the LZW encoding. -.SH DIAGNOSTICS -The following warnings and errors come from the decoding -routines in the library. -.PP -.BR "Warning, %s: Premature EOL at scanline %d (x %d).\en" . -The input data had a row that was shorter than the expected width. -The row is padded with white. -.PP -.BR "%s: Premature EOF at scanline %d (x %d).\en" . -The decoder ran out of data in the middle of a scanline. -The resultant row is padded with white. -.PP -.BR "%s: Bad code word at row %d, x %d\en" . -An invalid Group 3 -.I code -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. -.PP -.BR "%s: Bad 2D code word at scanline %d.\en" . -An invalid Group 4 or 2D Group 3 -.I code -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. -.SH BUGS -Input data are assumed to have a a ``top left'' orientation; -it should be possible to override this assumption -from the command line. -.SH "SEE ALSO" -.BR "\s-1CCITT\s+1 Recommendation T.4" -(Standardization of Group 3 Facsimile Apparatus for Document Transmission). -.PP -.BR "The Spirit of TIFF Class F", -an appendix to the TIFF 5.0 specification prepared by Cygnet Technologies. -.PP -.BR tiffinfo (1), -.BR tiffdither (1), -.BR tiffgt (1), -.BR libtiff (3) -.PP -Libtiff library home page: -.BR http://www.remotesensing.org/libtiff/ |