foo2xqx-wrapper(1)

💖 foo2xqx-wrapper(1) 💖

okay bestie, welcome to the General Commands Manual ✨ this is the page for foo2xqx-wrapper, and yes it's a whole vibe. grab a strawberry 🍓 and let's go.

---

🌸 NAME 🌸

foo2xqx-wrapper — turns Postscript into a XQX printer stream. that's it, that's the job. 💅

---

✨ SYNOPSIS ✨

foo2xqx-wrapper [options] [ps-file]

---

🦋 DESCRIPTION 🦋

so foo2xqx-wrapper is a Foomatic compatible printer wrapper for the foo2xqx printer driver. it reads a Postscript ps-file — or just standard input if you're feeling mysterious — and converts it into XQX printer format so it can actually drive these printers:

• the HP LaserJet P1005/P1006/P1007/P1008 👑
• the HP LaserJet P1505
• the HP LaserJet P2014
• the HP LaserJet M1005 MFP
• the HP LaserJet M1120 MFP
• the HP LaserJet Pro M1132s MFP
• the HP LaserJet Pro M1212nf MFP
• and other XQX-based printers, iykyk 🌈

ngl you can run this script standalone, but the intended main character energy is being called from a printer spooler system that uses the Foomatic printer database. it's giving "designed to be part of a system." periodt. 💖

---

🎀 COMMAND LINE OPTIONS 🎀

🌟 Normal Options 🌟

these are the options that pick the parameters of a print job — the stuff you usually control per job, bestie.

• -d duplex — Duplex code to send to printer [1].
  • 1 — off
  • 2 — long edge
  • 3 — short edge
• -m media — Media code to send to printer [1].

okay so this was a table in the original and tables are not the vibe here, but the numbers are sacred: standard 1, transparency 2, envelope 257, letterhead 259, thick 261, postcard 262, labels 263. and the M1005 column applies. slay.

• -p paper — Paper size code to send to printer [1]. the whole menu, lowkey iconic:
  • 1 — letter
  • 5 — legal
  • 7 — executive
  • 9 — A4
  • 11 — A5
  • 13 — B5
  • 20 — env #10
  • 27 — env DL
  • 28 — env C5
  • 34 — env B5
  • 37 — env Monarch
  • 257 — 16k 197x273
  • 263 — 16k 184x260
  • 263 — 16k 195x270

not me pointing out that 263 shows up twice in the original list. that's literally what it says, so that's literally what you get. 🫶

• -n copies — Number of copies [1].
• -r xresxyres — Set device resolution in pixels/inch [1200x600].
• -s source — Source (Input Slot) code to send to printer [7].
  • 1 — upper
  • 2 — lower
  • 4 — manual
  • 7 — auto
• -t — Draft mode. Every other pixel is white. yes, literally every other pixel. wild, but make it efficient. 💀
• -T density — Print density (1-5). The default is 3 (medium).
• -2 -3 -4 -5 -6 -8 -9 -10 -12 -14 -15 -16 -18 — Print in N-up. Requires the psutils package. that's a whole lot of flags and yes, they're all listed, no skipping. ✨
• -o orient — Orientation used for N-up.
  • Portrait — -op (normal)
  • Landscape — -ol (rotated 90 degrees anticlockwise)
  • Seascape — -os (rotated 90 degrees clockwise)

---

🔧 Printer Tweaking Options 🔧

these ones are for customizing how foo2xqx behaves on a particular printer. bespoke behavior, we love to see it. 💜

• -u xoffxyoff — Set the offset of the start of the printable region from the upper left corner, in pixels [varies with paper size]. The defaults should work on the 2200DL and 2300DL, and have not been tested on any other printers. fr fr, only those two.
• -l xoffxyoff — Set the offset of the end of the printable region from the lower right corner, in pixels [varies with paper size]. The defaults should work on the 2200DL and 2300DL, and have not been tested on any other printers. same energy, opposite corner. 🎀
• -L mask — Send the logical clipping values from -u/-l in the ZjStream.

okay so here's the tea: foo2xqx-wrapper always runs Ghostscript with the ideal page dimensions, so that the scale of the image is correct, regardless whether or not the printer has unprintable regions. this option is used to move the position of the clipped image back to where it belongs on the page. the default is to send the amount which was clipped by -u and -l, and should be good in most cases.

• 0 — don't send any logical clipping amounts
• 1 — only send Y clipping amount
• 2 — only send X clipping amount
• 3 — send both X and Y clipping amounts

---

🐛 Debugging Options 🐛

these are for debugging foo2xqx and its wrapper. main character debugging hours. 🔥

• -D level — Set Debug level [0].

---

🌈 EXAMPLES 🌈

Create a monochrome ZjStream from a Postscript document, examine it, and then print it using a RAW print queue. literally the whole journey, bestie:

foo2xqx-wrapper testpage.ps > testpage.xqx
xqxdecode < testpage.xqx
lpr -P raw testpage.xqx

---

📁 FILES 📁

• /usr/bin/foo2xqx-wrapper

---

👀 SEE ALSO 👀

• foo2xqx(1)
• xqxdecode(1)

---

👑 AUTHOR 👑

• Rick Richardson <rick.richardson@comcast.net>
• http://foo2xqx.rkkda.com/

---

and that's the page!! 🦋 the footer at the bottom just says foo2xqx-wrapper(1) on both sides with General Commands Manual in the middle — no version, no date, no extra lore, so that's the whole sign-off. go forth and print, bestie 💖✨🎀