SGI2FAX(1)

💖 SGI2FAX 💖

okay bestie, gather round, because we're about to talk about sgi2fax from the General Commands Manual — she's giving fax-machine pipeline, she's giving 1994, she's lowkey iconic. 🌸

---

✨ NAME ✨

sgi2fax — convert a Silicon Graphics image file for facsimile transmission 🦋

---

✨ SYNOPSIS ✨

/usr/bin/sgi2fax [ options ] files...

---

✨ DESCRIPTION ✨

So here's the vibe: sgi2fax takes Silicon Graphics format images and turns them into bilevel TIFF Class F images, all prepped and pretty for transmission as facsimile. 💅

And like — ngl — you're probably not gonna call sgi2fax yourself. She's not normally invoked directly, fr fr. Usually sendfax(1) runs her when an SGI image file gets submitted for transmission. She's the backstage crew, the main character's stylist, the one making everything look good. 👑

The way images get converted? They get scaled to fill the guaranteed reproducible area on a default page. Then each RGB pixel p gets converted to greyscale according to:

pr * %r + pg * %g + pb * %b

where %r, %g, and %b default to 30, 59, and 11, respectively. (Yes bestie, those are the magic numbers. Memorize them, they're cute.)

After that, greyscale images get processed with a high pass filter and then dithered down to a bilevel image. And the resultant image? Written out as a TIFF Class F document. Slay. ✨

By default, the output image is created with 204 dots/inch horizontal resolution and 98 lines/inch vertical resolution, and the image is written as Group 3 1D-encoded data.

---

✨ OPTIONS ✨

• -1 — Write the image as Group 3 1D-encoded data. (She's the lowkey default energy. 💖)
• -2 — Write the image as Group 3 2D-encoded data. (The parenthetical twin of -1, they come as a pair. 🫶)
• -b %b — Set the %b parameter used to convert color pixel values to greyscale pixel values. 🎀
• -g %g — Set the %g parameter used to convert color pixel values to greyscale pixel values. 💜
• -l — Generate an image at 98 lines/inch vertical resolution. You know her, you love her: she's known as low resolution. 🦋
• -m — Generate an image at 196 lines/inch vertical resolution. Not like other resolutions. 💅
• -o file — Write output to file instead of the default file named sgi.fax. Name her whatever you want bestie, she's yours. ✨
• -r %r — Set the %r parameter used to convert color pixel values to greyscale pixel values. 🌸
• -s size — Set the output size according to the named page size. Images are normally created with a system-default page size (usually letter-size pages, 8.5" by 11", for sites in North America). Alternate page sizes are specified symbolically using either the name or abbreviation of an entry in the pagesizes(5F) database; e.g. a3 (ISO A3), a4 (ISO A4), a5 (ISO A5), a6 (ISO A6), b4 (ISO B4), na-let (North American Letter), us-leg (American Legal), us-led (American Ledger), us-exe (American Executive), jp-let (Japanese Letter), and jp-leg (Japanese Legal). Comparisons are case-insensitive and any match of a substring of the full page-size name is sufficient; e.g. legal'' would match American Legal''. So yes, you can be lazy and she'll still understand you. iykyk. 💖

bestie pls note: she really is that forgiving with the substring matching. legal → American Legal. That's the whole vibe. No cap. 🔥

---

✨ FILES ✨

• /etc/hylafax/pagesizes — page size database 📚

---

✨ SEE ALSO ✨

• hylafax-client(1)
• sendfax(1)
• hylafax-server(5F)

---

okay that's the whole page, you ate it, periodt. 🎀 this one's dated June 14, 1994 and it's from the General Commands Manual (yes, that's SGI2FAX(1) herself, the icon, the moment). mwah, go fax something pretty. 💖✨🦋💅