1TIFFCHECK(8C) TIFFCHECK(8C)
2
3
4
6 tiffcheck - check TIFF for HylaFAX conversion requirements
7
9 /usr/sbin/tiffcheck [ options ] file.tif
10
12 tiffcheck takes TIFF input and writes a multi-line text message to the
13 standard output describing any work needed to prepare the images for
14 facsimile transmission. tiffcheck is usually invoked by tiff2fax(8C)
15 script that is used by the HylaFAX scheduler to prepare TIFF documents
16 submitted for transmission.
17
18 The first line of output is a series of ``+''-separated words that
19 indicate if the input file should be:
20
21 · rejected (``REJECT''),
22
23 · reformatted with a different data-encoding scheme (``REFORMAT''),
24
25 · scaled to different page dimensions (``RESIZE''),
26
27 · reimaged in a different vertical resolution (``REVRES''), or
28
29 · reimaged for other reasons such as conversion from color to
30 black&white (``REIMAGE'').
31
32 The conversion requirements string will always have keywords in the
33 above order; e.g. ``RESIZE+REVRES'' if the input file needs to be
34 scaled and converted to a different resolution. Information following
35 the first line is descriptive text that explains the reason(s) for the
36 file conversion(s); this text is suitable for return to a client
37 (should document conversion fail or not be attempted). The descriptive
38 text is ordered identically to the keywords in the conversion string;
39 this makes it possible to match up conversion requirements to reasons.
40
42 The following operations are recognized:
43
44 -1 Set output to be Group 3 1D-encoded.
45
46 -2 Set output to be Group 3 2D-encoded.
47
48 -3 Set output to be Group 4 MMR-encoded.
49
50 -w width Set the output page width, in pixels. By default, pages are
51 1728 pixels wide.
52
53 -l length Set the output page length in millimeters. By default, pages
54 are 297 millimeters long.
55
56 -r vres Set the vertical resolution, in lines/inch, at which to image
57 the TIFF.
58
60 The following color image needs to be converted to black&white, resized
61 to the output page dimensions, and reformatted to use Group 3 1D-
62 encoded data.
63
64 hyla% /usr/sbin/tiffcheck jello.tif
65 REFORMAT+RESIZE+REIMAGE
66 Document is not a bilevel image (bits/sample 8).
67 Document requires reformatting, not in Group 3 format.
68 Document requires resizing to adjust page width (convert to 1728, document is 256).
69
70 This image is a facsimile received at high resolution (196 lpi); it
71 only needs to be converted to 98 lpi.
72
73 hyla% /usr/sbin/tiffcheck faxix.tif
74 REVRES
75 Document requires reformatting to adjust vertical resolution (convert to 98, document is 196).
76
78 tiff2fax(8C), faxq(8C), hylafax-server(5F)
79
80
81
82 January 18, 1996 TIFFCHECK(8C)