TIFFCHECK(8C)															     TIFFCHECK(8C)

NAME

       tiffcheck - check TIFF for HylaFAX conversion requirements

SYNOPSIS

       /usr/sbin/tiffcheck [ options ] file.tif

DESCRIPTION

       tiffcheck takes TIFF input and writes a multi-line text message to the standard output describing any work needed to prepare the images for
       facsimile transmission.	tiffcheck is usually invoked by tiff2fax(8C) script that is used by the HylaFAX scheduler to  prepare  TIFF  docu-
       ments submitted for transmission.

       The first line of output is a series of ``+''-separated words that indicate if the input file should be:

       o  rejected (``REJECT''),

       o  reformatted with a different data-encoding scheme (``REFORMAT''),

       o  scaled to different page dimensions (``RESIZE''),

       o  reimaged in a different vertical resolution (``REVRES''), or

       o  reimaged for other reasons such as conversion from color to black&white (``REIMAGE'').

       The  conversion	requirements  string  will  always  have keywords in the above order; e.g. ``RESIZE+REVRES'' if the input file needs to be
       scaled and converted to a different resolution.	Information following the first line is descriptive text that explains the  reason(s)  for
       the  file  conversion(s); this text is suitable for return to a client (should document conversion fail or not be attempted).  The descrip-
       tive text is ordered identically to the keywords in the conversion string; this makes it possible to match up  conversion  requirements	to
       reasons.

OPTIONS

       The following operations are recognized:

       -1	 Set output to be Group 3 1D-encoded.

       -2	 Set output to be Group 3 2D-encoded.

       -3	 Set output to be Group 4 MMR-encoded.

       -w width  Set the output page width, in pixels.	By default, pages are 1728 pixels wide.

       -l length Set the output page length in millimeters.  By default, pages are 297 millimeters long.

       -r vres	 Set the vertical resolution, in lines/inch, at which to image the .

EXAMPLES

       The  following  color image needs to be converted to black&white, resized to the output page dimensions, and reformatted to use Group 3 1D-
       encoded data.

	      hyla% /usr/sbin/tiffcheck jello.tif
	      REFORMAT+RESIZE+REIMAGE
	      Document is not a bilevel image (bits/sample 8).
	      Document requires reformatting, not in Group 3 format.
	      Document requires resizing to adjust page width (convert to 1728, document is 256).

       This image is a facsimile received at high resolution (196 lpi); it only needs to be converted to 98 lpi.

	      hyla% /usr/sbin/tiffcheck faxix.tif
	      REVRES
	      Document requires reformatting to adjust vertical resolution (convert to 98, document is 196).

SEE ALSO

       tiff2fax(8C), faxq(8C), hylafax-server(5F)

								 January 18, 1996						     TIFFCHECK(8C)