TIFFCHECK(8C)

💖 TIFFCHECK — check TIFF for HylaFAX conversion requirements 💖

okay bestie, so this one lives in section 8C of the manual and it's called tiffcheck — literally the vibe-checker for your TIFFs before HylaFAX faxes them out. 🦋

---

✨ SYNOPSIS ✨

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

---

🌸 DESCRIPTION 🌸

So tiffcheck takes a TIFF as input and writes a multi-line text message to the standard output describing any work that needs to happen to get those images ready for facsimile transmission. No cap. It's usually invoked by the tiff2fax(8C) script, which is the one the HylaFAX scheduler uses to prep TIFF documents that got submitted for transmission. 🎀

The first line of output is a series of +-separated words that tell you 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 that order — like, always, periodt. e.g. RESIZE+REVRES if the input file needs to be scaled and converted to a different resolution. 💅

Everything after that first line is descriptive text explaining the reason(s) for the file conversion(s). This text is suitable for returning to a client (should document conversion fail or not be attempted, lowkey tragic). And here's the cute part: the descriptive text is ordered identically to the keywords in the conversion string, so you can match up conversion requirements to reasons. iykyk. 🫶

---

💅 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 🌈

okay so this next color image needs to be converted to black&white, resized to the output page dimensions, and reformatted to use Group 3 1D-encoded data. it's giving project. 😭

hyla% /usr/bin/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).

And this one is a facsimile received at high resolution (196 lpi) — it only needs to be converted to 98 lpi. iconic, honestly. ✨

hyla% /usr/bin/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)

---

and that's the whole page, bestie — this version dropped on January 18, 1996, part of the TIFFCHECK(8C) manual, section 8C. slay, go check those TIFFs. 💖👑