Unix/Linux Go Back    


OpenSolaris 2009.06 - man page for fax2tiff (opensolaris section 1)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


fax2tiff(1)				  User Commands 			      fax2tiff(1)

NAME
       fax2tiff - create a TIFF Class F fax file from raw fax data

SYNOPSIS
       fax2tiff [options] [-o output.tif] input.g3

DESCRIPTION
       fax2tiff  creates a TIFF file containing CCITT 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 TIFF file is 2-dimensionally encoded and
       padded or truncated to 1728 pixels, as needed. The resultant image is a set of low resolu-
       tion (98 lines per inch) or medium resolution (196 lines per inch) pages, each of which is
       a single strip of data.

OPTIONS
   Input Data Options
       The following input data options are supported:

       -2	       Assume input data is 2-d Huffman encoded.

       -B	       Assume input data was encoded with black as 0 and white as 1.

       -L	       Treat input data as having bits filled from least significant bit (LSB) to
		       most significant bit (MSB). This is the default.

       -M	       Treat  input data as having bits filled from most significant bit (MSB) to
		       least significant bit (LSB).

       -R	       Specify the vertical resolution, in lines per inch, of the  input  images.
		       By  default, input images are assumed to have a vertical resolution of 196
		       lines per inch. If images are low resolution facsimile, specify a value of
		       98 lines per inch.

       -W	       Assume  input data was encoded with black as 1 and white as 0. This is the
		       default.

   Output File Options
       The following output file options are supported:

       -1	       Force output to be compressed with the 1-dimensional version of the  CCITT
		       Group 3 Huffman encoding algorithm.

       -4	       Force output to be compressed with the CCITT Group 4 Huffman encoding.

       -o	       Specify the name of the output file.

       -p	       Force the last bit of each End Of Line (EOL) code to land on a byte bound-
		       ary. This "zero padding" is reflected in the contents of the Group3Options
		       tag of the resultant TIFF file.

       -s	       Stretch the input image vertically by writing each input row of data twice
		       to the output file.

       -v	       Force fax2tiff to print the number of rows  of  data  retrieved	from  the
		       input file.

OPERANDS
       The following operands are supported:

       input.g3        The name of the input file that contains raw fax data.

EXTENDED DESCRIPTION
       The  generated file conforms to the TIFF Class F (FAX) specification for storing facsimile
       data. This means, in particular, that each page of the data does not include the  trailing
       return to control (RTC) code, as required for transmission by the CCITT Group 3 specifica-
       tions. The old, "classic" format is created if the -c option is used. The Class	F  format
       can also be requested with the -f option.

       The  default name of the output image is fax.tif.  You can use the -o option to change the
       output filename.

       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.

   Diagnostics
       The following warnings and errors come from the decoding routines in the library.

       Warning, %s: Premature ETheainputndata had(a row.that was shorter than the expected  value
			       of 1728. The row is padded with white.

       %s: Premature EOF at scaThenedecoder%dran  out  of  data  in the middle of a scanline. The
			       resultant row is padded with white.

       %s: Bad code word at rowAndinvalid Group 3 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.

       %s: Bad 2D code word at AnainvaliddGroup 4 or 2D Group 3 code was encountered while decod-
			       ing the input file. The row  number  and  horizontal  position  is
			       given. The remainder of the input row is discarded, while the cor-
			       responding output row is padded with white.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWTiff			   |
       +-----------------------------+-----------------------------+
       |Interface stability	     |Uncommitted		   |
       +-----------------------------+-----------------------------+

SEE ALSO
       CCITT Recommendation T.4 (Standardization of Group  3  Facsimile  Apparatus  for  Document
       Transmission).

       The  Spirit  of TIFF Class F, an appendix to the TIFF 5.0 specification prepared by Cygnet
       Technologies.

       tiffinfo(1), tiffdither(1), tiffgt(1), libtiff(3)

NOTES
       Updated by Breda McColgan, Sun Microsystems Inc., 2004.

SunOS 5.11				   26 Mar 2004				      fax2tiff(1)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 11:36 AM.