tiffcheck (8)

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

tiffcheck takes \*(Tf 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(8) script that is used by the \*(Fx scheduler to prepare \*(Tf documents submitted for transmission.

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

• rejected (``\s-1REJECT\s+1''),

• reformatted with a different data-encoding scheme (``\s-1REFORMAT\s+1''),

• scaled to different page dimensions (``\s-1RESIZE\s+1''),

• reimaged in a different vertical resolution (``\s-1REVRES\s+1''), or

• reimaged for other reasons such as conversion from color to black&white (``\s-1REIMAGE\s+1'').

The conversion requirements string will always have keywords in the above order; e.g. ``\s-1RESIZE+REVRES\s+1'' 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 descriptive text is ordered identically to the keywords in the conversion string; this makes it possible to match up conversion requirements to reasons.

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 \*(Tf.

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.

\s-1hyla% /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).\s+1

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

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

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