g3toxwd(1)

✨ NAME ✨

okay so bestie, welcome to g3toxwd 💖 — it converts a Group 3 fax file into a displayable xwd file. that's the whole job. that's the vibe. 🎀

🌸 SYNOPSIS 🌸

g3toxwd [-kludge] [-reversebits] [-scale N] [-aspect N] [-skiprows N]
[-name xwdname] [g3file]

🦋 DESCRIPTION 🦋

so like, it reads a Group 3 fax file as input — raw or digifax, both work 💅. if you don't hand it a filename? it just grabs stdin, no questions asked. and then it produces a displayable xwd file as the output. iconic behavior fr fr. ✨

💅 OPTIONS 💅

• -kludge — tells g3toxwd to skip the first lines for synchronisation. little warm-up stretch before the real work, yk? 🧚
• -reversebits — tells g3toxwd to interpret bits least-significant first, instead of the default most-significant first. apparently some fax modems do it one way and others do it the other way — no cap, they really can't agree 🙈. so if you're getting a whole bunch of "invalid code" messages? try this flag. it's giving "have you tried turning it off and on again" but make it bits. 💀
• -scale N — scales the output to match the printer resolution and paper size. the default of 0.58 will do in most cases, she's versatile like that. 👑
• -aspect N — scales the output to match the printer resolution and paper size. the default of 1.0 will do for high resolution faxes, and 2.0 will do for low resolution faxes. pick your fighter. 🌈
• -skiprows N — N faxrows of the input file will be skipped. bye bye rows, we don't know them. 👋
• -name <name> — the name <name> will be put in the output file for xwd. giving your baby a name, so cute. 🎀

📚 REFERENCES 📚

the standard for Group 3 fax is defined in CCITT Recommendation T.4. yes bestie, there's a whole official document, iykyk. 📖

😭 BUGS 😭

long fax files are not handled properly. lowkey a crime but we move. 😔

output size is fixed at 1000x1350 pixels, defined at compile time — so yeah, that's baked in, not adjustable. 💀

please report bugs to chel@vangennip.nl. they wanna hear about it, fr fr. 📬

🔥 SEE ALSO 🔥

• pbmtog3(1)
• pbm(5)
• g3cat(1)
• sendfax(8)
• mgetty(1)

👑 AUTHOR 👑

g3toxwd is Copyright (C) 1994 by Chel van Gennip, <chel@vangennip.nl>.

sources of the g3topbm and pbmtoxwd programs in Jef Poskanzers pbmplus package have been used, but a lot of code has been changed or added to simplify its use for displaying faxes. and the value added? low use of memory, fast scaling. ate. 💅✨

Chel wrote this on 22 may 94, and this little page is part of the mgetty+sendfax manual, filed under g3toxwd(1). mwah, go read your faxes bestie 🫶💖