TIFF2FAX(8C)

πŸ“¦
version 7.0.11 Β· 5 versions
, in fedora 43, fedora 44

πŸ’– TIFF2FAX β€” like, the TIFF glow-up station πŸ’–

okay bestie, you found the TIFF2FAX(8C) page, section 8C, and I'm gonna walk you through it like we're texting at 2am πŸ¦‹


✨ NAME ✨

tiff2fax β€” converts TIFF for facsimile transmission by HylaFAX, no cap πŸ’…


πŸŽ€ SYNOPSIS πŸŽ€

/var/spool/hylafax/bin/tiff2fax [ options ] file

🌸 DESCRIPTION 🌸

so bin/tiff2fax takes your TIFF input and generates a TIFF Class F image file that's suitable for facsimile transmission. iconic behaviour honestly πŸ‘‘

it's usually invoked by the HylaFAX scheduler process, faxq(8C). and the default implementation? it uses the tiffcheck(8C) program plus tools from the freely available TIFF software distribution to actually implement the conversion operations. teamwork makes the dream work fr fr 🫢

this script can also modify outgoing facsimile β€” like, watermarking and stuff ✨ to do that, you create a shell script etc/FaxModify in the spooling area that alters the document. that's the whole vibe.


πŸ’… OPTIONS πŸ’…

here's the roster of operations it recognizes, and yes we're going through every single one because nobody gets left behind:

  • -1 β€” write Group 3 1D-encoded data to the output file ⭐
  • -2 β€” write Group 3 2D-encoded data to the output file ⭐
  • -3 β€” write Group 4 MMR-encoded data to the output file ⭐
  • -color β€” write color data to an output file. lowkey important detail: this might be a separate file if Group 3 or Group 4 data is also being output 🌈
  • -i jobid β€” how the server references the associated Job ID number 🏷️
  • -m pages β€” set the maximum number of pages that are permitted in the output file. if more pages are present in the input document, then abort processing. like, hard stop πŸ’€
  • -o file β€” write output to the specified file instead of the default foo.tif filename πŸ“
  • -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 POSTSCRIPT πŸ”
  • -S β€” Simple mode. serves as a format conversion interface for RTFCC in faxsend to utilize /usr/bin/tiffcp 🧚

πŸ—‚οΈ FILES πŸ—‚οΈ

the little support squad, in order:

  • /usr/bin/tiffcheck β€” TIFF file conversion examiner πŸ”Ž
  • /var/spool/hylafax/bin/ps2fax β€” POSTSCRIPT RIP for doing complicated conversions πŸ–¨οΈ
  • /usr/bin/tiffcp β€” for converting compression schemes πŸ”„
  • /usr/bin/tiff2ps β€” for colorspace and/or image size conversions 🎨

😭 BUGS 😭

okay so, the not-so-great parts, and I'm telling you straight:

conversions that require re-imaging and resizing may result in images that are poorly placed on the page. it's giving chaos, bestie πŸ™ˆ

and there is no way to control how images are treated when they are resized; e.g. the original aspect ratio is not always maintained. so yeah, expect some squish. 🫠


πŸ‘€ SEE ALSO πŸ‘€

sendfax(1), faxq(8C), hylafax-server(5F) β€” go read those next, iykyk πŸ’œ


and that's the whole page, periodt πŸŽ€ this one's from the HylaFAX source, dated May 12, 1996 β€” yeah, she's vintage, and she ATE. mwah πŸ’‹βœ¨

πŸ“¦ where this page comes from