foo2hiperc(1)

✨ foo2hiperc — the glow-up ✨

okay bestie, so this whole page is foo2hiperc(1) from the General Commands Manual — a real one, section 1, a whole command, and she is so useful. sit down, grab a strawberry 🍓, and let's get into it.

💖 NAME 💖

foo2hiperc — the girl who takes Ghostscript pbmraw or bitcmyk format and turns it into a HIPERC printer stream. literally a translator but make it fashion 💅

---

🦋 SYNOPSIS 🦋

three ways to run her, all iconic, all piping into your hiperc-file:

foo2hiperc [options] <pbmraw-file >hiperc-file

foo2hiperc [options] <bitcmyk-file >hiperc-file

foo2hiperc [options] <pksmraw-file >hiperc-file

🌸 DESCRIPTION 🌸

foo2hiperc converts Ghostscript pbmraw, bitcmyk, or pksmraw output formats into monochrome or color HIPERC streams. and what is she driving with all that? she's feeding the Oki C310dn, C3100, C3200, C3300n, C3400n, C5100n, C5500n, C5600n, and the C5800n HIPERC printers. yes, that many. she's booked and busy 👑

---

⭐ COMMAND LINE OPTIONS ⭐

🎀 Normal Options

these are the ones you'll be picking out per print job — the everyday slay, the fit you wear to every occasion. usually controlled on a per job basis, periodt.

• -c — Force color mode. only reach for this when autodetect doesn't work and you're like excuse me? 🙈
• -d duplex — the Duplex code to send to printer [1]. the lineup:
  • 1 — off
  • 2 — long edge
  • 3 — short edge
• -g xpixxypix — Set page dimensions in pixels [5100x6600].
• -m media — Media code to send to printer [0]. the menu:
  • plain → 0
  • labels → 1
  • transparency → 2
• -p paper — Paper code to send to printer [2]. the whole roster, no gatekeeping:
  • 1 — A4
  • 2 — letter
  • 3 — legal
  • - — -
  • 5 — A5
  • 6 — B5jis
  • 7 — A6
  • 8 — env Monarch
  • 9 — env DL
  • 10 — env C5
  • 11 — env #10
  • 12 — executive
  • 13 — env #9
  • 14 — legal 13.5"
  • 15 — A3
  • 16 — tabloid/ledger
• -n copies — Number of copies [1]. one is a choice, but she supports more.
• -r xresxyres — Set device resolution in pixels/inch [600x600].
• -s source — the Source (InputSlot) code to send to printer [0]:
  • 0 — auto select
  • 1 — tray1
  • 2 — tray2
  • 3 — multi
  • 4 — manual
• -t — Draft mode. Every other pixel is white. she's giving "we have ink at home" energy 💀
• -J filename — Filename string to send to printer.
• -U username — Username string to send to printer.

🧚 Printer Tweaking Options

these are the ones for customizing how foo2hiperc operates for a particular printer — the bespoke tailoring, the alterations, iykyk.

• -u xoffxyoff — Set the offset of the start of the printable region from the upper left corner, in pixels [0x0].
• -l xoffxyoff — Set the offset of the end of the printable region from the lower right corner, in pixels [0x0].
• -L mask — Send logical clipping amounts implied by -u/-l in the HIPERC stream [3]. your choices, choose wisely:
  • 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: convert C=1,M=1,Y=1 to just K=1. Works with bitcmyk input only. (so don't try it elsewhere, she will simply not.)
• -B — BlackClears: K=1 forces C,M,Y to 0. Works with bitcmyk input only. same rule, bestie.
• -Z compressed — Use uncompressed (0) or compressed (1) JBIG data.

💜 Debugging Options

for when you're debugging foo2hiperc and you need to see the receipts 🔍

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

---

🔥 EXAMPLES 🔥

create a black and white HIPERC stream

gs -q -dBATCH -dSAFER -dQUIET -dNOPAUSE
    -sPAPERSIZE=letter -r600x600 -sDEVICE=pbmraw
    -sOutputFile=- - < testpage.ps
| foo2hiperc -r600x600 -g5100x6600 -p0 >testpage.zm

create a color HIPERC stream

gs -q -dBATCH -dSAFER -dQUIET -dNOPAUSE
    -sPAPERSIZE=letter -g5100x6600 -r600x600 -sDEVICE=bitcmyk
    -sOutputFile=- - < testpage.ps
| foo2hiperc -r600x600 -g5100x6600 -p0 >testpage.zc

---

🫶 FILES 🫶

• /usr/bin/foo2hiperc — yeah, that's her. that's the whole file list. she's low maintenance 💖

🌈 SEE ALSO 🌈

• foo2hiperc-wrapper(1)
• hipercdecode(1)

👑 AUTHOR 👑

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

---

ok and that's the whole page, no cap. every option, every default, every code, every single one — nothing skipped, bestie. 🎀

and yeah, one last thing: this whole thing is foo2hiperc(1) straight out of the General Commands Manual — that's the source, that's the section, that's the vibe. now go print something iconic ✨🦋💅