foo2oak(1)

📦
version 20200505dfsg0 · 11 versions
, in ubuntu noble, ubuntu questing

💖 NAME 💖

foo2oak — converts Ghostscript pbmraw, pgmraw or bitcmyk format into an OAKT printer stream ✨

okay so real talk, this is the foo2oak(1) page from the General Commands Manual, and it's lowkey iconic. let's get into it bestie 🫶

🌈 SYNOPSIS 🌈

foo2oak [options] <pbmraw-file >OAKT-file

foo2oak [options] <pgmraw-file >OAKT-file

foo2oak [options] <bitcmyk-file >OAKT-file

like, you pipe stuff in, you pipe stuff out. the vibe is flowing 💅

🦋 DESCRIPTION 🦋

foo2oak takes Ghostscript pbmraw or bitcmyk output formats and converts them into monochrome or color OAKT streams. and why do we care?? because those streams are literally what drives the HP Color LaserJet 1500 laser printer, the Kyocera KM-1636/KM-2035 copiers, and honestly just, like, other OAKT-based printers in general. it's giving translator, but make it printer-coded 🖨️✨

🎀 COMMAND LINE OPTIONS 🎀

⭐ Normal Options ⭐

these are the options that pick the parameters of a print job — the stuff you'd usually control on a per-job basis, yk? like the main character settings 👑

  • -c — forces color mode, for when autodetect is simply not picking up what you're putting down.
  • -d duplex — the duplex code you send to the printer. default is 1.
    • 1 — off
    • 2 — long edge
    • 3 — short edge
  • -g xpixxypix — sets the page dimensions in pixels. default is 10200x6600.
  • -m media — the media code you send to the printer. default is 1.
    • autoselect — 0
    • plain — 1
    • preprinted — 2
    • letterhead — 3
    • transparency — 4
    • prepunched — 5
    • labels — 6
    • bond — 7
    • recycled — 8
    • color — 9
    • cardstock — 10
    • envelope — 11
    • light — 13
    • tough — 14
    • vellum — 15
    • rough — 16
    • thick — 19
    • highqual — 20
  • -p paper — the paper code you send to the printer. default is 1.
    • 1 — letter
    • 3 — ledger
    • 5 — legal
    • 6 — statement
    • 7 — executive
    • 8 — A3
    • 9 — A4
    • 11 — A5
    • 12 — B4
    • 13 — B5jis
    • 14 — folio
    • 19 — env9
    • 20 — env10
    • 27 — envDL
    • 28 — envC5
    • 30 — envC4
    • 37 — envMonarch
    • 257 — A6
    • 258 — B6
    • 259 — B5iso
    • 260 — env6
  • -n copies — number of copies. default is 1.
  • -r xresxyres — sets the device resolution in pixels/inch. default is 600x600.
  • -s source — the source (InputSlot) code you send to the printer. default is 7.
    • 1 — tray1
    • 2 — tray2
    • 4 — manual
    • 7 — auto
  • -J filename — a filename string to send to the printer.
  • -U username — a username string to send to the printer.

🌸 Printer Tweaking Options 🌸

these ones are for customizing how foo2oak behaves with one specific printer. personalization era 💖

  • -u xoffxyoff — sets the offset of the start of the printable region from the upper left corner, in pixels. default is 0x0.
  • -l xoffxyoff — sets the offset of the end of the printable region from the lower right corner, in pixels. default is 0x0.
  • -L mask — sends the logical clipping amounts implied by -u/-l in the OAKT stream. default is 3.
    • 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
  • -A — AllIsBlack: converts C=1,M=1,Y=1 to just K=1. works with bitcmyk input only.
  • -B — BlackClears: K=1 forces C,M,Y to 0. works with bitcmyk input only.
  • -M mirror — mirror bytes. Mirror is 0 for Kyocera KM-1635/KM-2035 and 1 for the HP Color LaserJet 1500. the default is 1.
  • -z model — Model is 0 for the HP Color LaserJet 1500, and 1 for the Kyocera KM-1635/KM-2035 copiers. the default is 0.

🔥 Debugging Options 🔥

for when you're debugging foo2oak and things are not giving what they're supposed to give 😭

  • -S plane — outputs just a single color plane from a color print, and prints it on the black plane. the default is to output all color planes.
    • 1 — Cyan
    • 2 — Magenta
    • 3 — Yellow
    • 4 — Black
  • -D level — sets the Debug level. default is 0.

✨ EXAMPLES ✨

okay bestie, here's the actual glow-up. create a black and white OAKT stream:

gs -q -dBATCH -dSAFER -dQUIET -dNOPAUSE
    -sPAPERSIZE=letter -r600x600 -sDEVICE=pbmraw
    -sOutputFile=- - < testpage.ps
| foo2oak -r600x600 -g5100x6600 -p1 >testpage.oak

and now, create a color OAKT stream 🌈:

gs -q -dBATCH -dSAFER -dQUIET -dNOPAUSE
    -sPAPERSIZE=letter -g5100x6600 -r600x600 -sDEVICE=bitcmyk
    -sOutputFile=- - < testpage.ps
| foo2oak -r600x600 -g5100x6600 -p1 >testpage.oak

see how the -sDEVICE switches from pbmraw to bitcmyk?? that's the whole plot twist 🎬

🍓 FILES 🍓

  • /usr/bin/foo2oak

🧚 SEE ALSO 🧚

👑 AUTHOR 👑

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

and that's the whole page, no skips, no cap 💀

this lil masterpiece came out of the General Commands Manual, section 1 — no version or date lines on this one, so just vibes and the manual name, periodt 💅

📦 where this page comes from