bionic (8) tiffcheck.8.gz

Provided by: hylafax-server_6.0.6-8.1~ubuntu0.18.04.1_amd64 bug

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(8)  script  that  is  used  by  the  HylaFAX  scheduler  to prepare TIFF documents submitted for
       transmission.

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

       •  rejected (``REJECT''),

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

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

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

       •  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 descriptive
       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 TIFF.

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(8), faxq(8), hylafax-server(5)

                                                January 18, 1996                                    TIFFCHECK(8)