foo2zjs-wrapper(1)

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

💖 foo2zjs-wrapper — bestie edition 💖

okay so this is the foo2zjs-wrapper page from the General Commands Manual (that's the man section 1, the "you just type it in a shell" zone), and bestie, I'm about to make you obsessed with a printer wrapper. no cap. 🎀

✨ NAME ✨

foo2zjs-wrapper — the thing that turns Postscript into a ZJS printer stream. that's the whole job. it's giving translator, it's giving bridge, it's giving middle management for your laser printer. 💅

🌈 SYNOPSIS 🌈

foo2zjs-wrapper [options] [ps-file]

🦋 DESCRIPTION 🦋

So. foo2zjs-wrapper is a Foomatic compatible printer wrapper for the foo2zjs printer driver. Foomatic is that whole printer database situation, and this script is the wrapper that plays nice with it.

What it actually does: it reads a Postscript ps-file — or standard input if you don't hand it a file — and converts it into Zenographics ZjStream printer format. And why would you want that? Because that's the language needed to drive the Minolta/QMS 2300 DL network color laser printer plus other Zenographics-based printers. iconic lineage honestly.

You can run this script standalone, all by itself, living its main character life. But the intended vibe is to be called from a printer spooler system that uses the Foomatic printer database. that's where it really shines. ✨

👑 COMMAND LINE OPTIONS 👑

🌸 Normal Options 🌸

These are the options for picking the parameters of a print job — the stuff you usually control on a per-job basis. lowkey the everyday essentials.

  • -c — Print in color. (If you don't say this, you get monochrome. simple as that. 💀)
  • -C colormode — Color correction mode, default is 0.
    • 1 — Photos (using m2300w CRDs)
    • 2 — Photos and text (using m2300w CRDs)
    • 3 — Graphics and text (using m2300w CRDs)
    • 10 — ICM color profile (using -G *.icm file)
  • -d duplex — Duplex code to send to the printer, default is 1.
    • 1 — off
    • 2 — long edge
    • 3 — short edge
  • -m media — Media code to send to the printer, default is 1.

The codes depend on your model, so here's the whole menu, no skipping:

  • standard — 2300DL/HP 1005 (-z0): 1 · 2200DL (-z0): 1 · HP 1018/HP 1020 (-z1): 1 · HP P1102/HP P1606 (-z2): 1 · HP CP1025 (-z3): 1
  • transparency — 2300DL/HP 1005 (-z0): 2 · 2200DL (-z0): 2 · HP 1018/HP 1020 (-z1): 2 · HP P1102/HP P1606 (-z2): 2 · HP CP1025 (-z3): 2
  • envelope — 2300DL/HP 1005 (-z0): 257 · 2200DL (-z0): na · HP 1018/HP 1020 (-z1): 267 · HP P1102/HP P1606 (-z2): 267 · HP CP1025 (-z3): 267
  • letterhead — 2300DL/HP 1005 (-z0): 259 · 2200DL (-z0): na · HP 1018/HP 1020 (-z1): 513 · HP P1102/HP P1606 (-z2): 513 · HP CP1025 (-z3): 513
  • bond — 2300DL/HP 1005 (-z0): na · 2200DL (-z0): na · HP 1018/HP 1020 (-z1): 260 · HP P1102/HP P1606 (-z2): 260 · HP CP1025 (-z3): 260
  • thick — 2300DL/HP 1005 (-z0): 261 · 2200DL (-z0): 4 · HP 1018/HP 1020 (-z1): 261 · HP P1102/HP P1606 (-z2): na · HP CP1025 (-z3): na
  • postcard — 2300DL/HP 1005 (-z0): 262 · 2200DL (-z0): na · HP 1018/HP 1020 (-z1): na · HP P1102/HP P1606 (-z2): na · HP CP1025 (-z3): na
  • rough — 2300DL/HP 1005 (-z0): na · 2200DL (-z0): na · HP 1018/HP 1020 (-z1): 263 · HP P1102/HP P1606 (-z2): 263 · HP CP1025 (-z3): 263
  • heavy — 2300DL/HP 1005 (-z0): na · 2200DL (-z0): na · HP 1018/HP 1020 (-z1): 262 · HP P1102/HP P1606 (-z2): 262 · HP CP1025 (-z3): 262
  • labels — 2300DL/HP 1005 (-z0): 263 · 2200DL (-z0): 3 · HP 1018/HP 1020 (-z1): 263 · HP P1102/HP P1606 (-z2): 265 · HP CP1025 (-z3): 265
  • vellum — 2300DL/HP 1005 (-z0): na · 2200DL (-z0): na · HP 1018/HP 1020 (-z1): 273 · HP P1102/HP P1606 (-z2): 273 · HP CP1025 (-z3): 273
  • medium — 2300DL/HP 1005 (-z0): na · 2200DL (-z0): na · HP 1018/HP 1020 (-z1): na · HP P1102/HP P1606 (-z2): 282 · HP CP1025 (-z3): 282
  • extraheavy — 2300DL/HP 1005 (-z0): na · 2200DL (-z0): na · HP 1018/HP 1020 (-z1): na · HP P1102/HP P1606 (-z2): 283 · HP CP1025 (-z3): 283
  • color — 2300DL/HP 1005 (-z0): na · 2200DL (-z0): na · HP 1018/HP 1020 (-z1): 512 · HP P1102/HP P1606 (-z2): 512 · HP CP1025 (-z3): 512
  • light — 2300DL/HP 1005 (-z0): na · 2200DL (-z0): na · HP 1018/HP 1020 (-z1): 258 · HP P1102/HP P1606 (-z2): 258 · HP CP1025 (-z3): 258
  • preprinted — 2300DL/HP 1005 (-z0): na · 2200DL (-z0): na · HP 1018/HP 1020 (-z1): 514 · HP P1102/HP P1606 (-z2): 514 · HP CP1025 (-z3): 514
  • prepunched — 2300DL/HP 1005 (-z0): na · 2200DL (-z0): na · HP 1018/HP 1020 (-z1): 515 · HP P1102/HP P1606 (-z2): 515 · HP CP1025 (-z3): 515
  • recycled — 2300DL/HP 1005 (-z0): na · 2200DL (-z0): na · HP 1018/HP 1020 (-z1): 516 · HP P1102/HP P1606 (-z2): 516 · HP CP1025 (-z3): 516
  • -p paper — Paper size code to send to the printer, default is 1. and here's the whole chart because we do not gatekeep:
    • letter — MC 2300DL/HP 1005 (-z0): 1 · HP 1018/HP 1020 (-z1): 1 · HP P1102/HP P1606 (-z2): 1 · HP CP1025 (-z3): 1
    • legal — MC 2300DL/HP 1005 (-z0): 5 · HP 1018/HP 1020 (-z1): 5 · HP P1102/HP P1606 (-z2): 5 · HP CP1025 (-z3): 5
    • executive — MC 2300DL/HP 1005 (-z0): 7 · HP 1018/HP 1020 (-z1): 7 · HP P1102/HP P1606 (-z2): 7 · HP CP1025 (-z3): 7
    • A4 — MC 2300DL/HP 1005 (-z0): 9 · HP 1018/HP 1020 (-z1): 9 · HP P1102/HP P1606 (-z2): 9 · HP CP1025 (-z3): 9
    • A5 — MC 2300DL/HP 1005 (-z0): 11 · HP 1018/HP 1020 (-z1): 11 · HP P1102/HP P1606 (-z2): 11 · HP CP1025 (-z3): 11
    • B5jis — MC 2300DL/HP 1005 (-z0): 13 · HP 1018/HP 1020 (-z1): 13 · HP P1102/HP P1606 (-z2): 13 · HP CP1025 (-z3): 13
    • env #10 — MC 2300DL/HP 1005 (-z0): 20 · HP 1018/HP 1020 (-z1): 20 · HP P1102/HP P1606 (-z2): 20 · HP CP1025 (-z3): 20
    • env DL — MC 2300DL/HP 1005 (-z0): 27 · HP 1018/HP 1020 (-z1): 27 · HP P1102/HP P1606 (-z2): 27 · HP CP1025 (-z3): 27
    • env CL — MC 2300DL/HP 1005 (-z0): 28 · HP 1018/HP 1020 (-z1): 28 · HP P1102/HP P1606 (-z2): 28 · HP CP1025 (-z3): 28
    • env B5 — MC 2300DL/HP 1005 (-z0): 34 · HP 1018/HP 1020 (-z1): 34 · HP P1102/HP P1606 (-z2): 34 · HP CP1025 (-z3): 34
    • env Monarch — MC 2300DL/HP 1005 (-z0): 37 · HP 1018/HP 1020 (-z1): 37 · HP P1102/HP P1606 (-z2): 37 · HP CP1025 (-z3): 37
    • postcard (japan) — MC 2300DL/HP 1005 (-z0): na · HP 1018/HP 1020 (-z1): 260 · HP P1102/HP P1606 (-z2): 43 · HP CP1025 (-z3): 43
    • B5iso — MC 2300DL/HP 1005 (-z0): na · HP 1018/HP 1020 (-z1): 259 · HP P1102/HP P1606 (-z2): na · HP CP1025 (-z3): na
    • A6 — MC 2300DL/HP 1005 (-z0): na · HP 1018/HP 1020 (-z1): 262 · HP P1102/HP P1606 (-z2): 70 · HP CP1025 (-z3): 70
    • double postcard rotated — MC 2300DL/HP 1005 (-z0): na · HP 1018/HP 1020 (-z1): 261 · HP P1102/HP P1606 (-z2): 82 · HP CP1025 (-z3): 82
    • 16k 197x273 — MC 2300DL/HP 1005 (-z0): na · HP 1018/HP 1020 (-z1): 257 · HP P1102/HP P1606 (-z2): 257 · HP CP1025 (-z3): 257
    • fanfold german legal — MC 2300DL/HP 1005 (-z0): na · HP 1018/HP 1020 (-z1): 258 · HP P1102/HP P1606 (-z2): 258 · HP CP1025 (-z3): 258
    • 16k 184x260 — MC 2300DL/HP 1005 (-z0): na · HP 1018/HP 1020 (-z1): na · HP P1102/HP P1606 (-z2): 263 · HP CP1025 (-z3): 263
    • 16k 195x270 — MC 2300DL/HP 1005 (-z0): na · HP 1018/HP 1020 (-z1): na · HP P1102/HP P1606 (-z2): 264 · HP CP1025 (-z3): 264
    • photo 4x6 — MC 2300DL/HP 1005 (-z0): na · HP 1018/HP 1020 (-z1): na · HP P1102/HP P1606 (-z2): na · HP CP1025 (-z3): 268
    • photo 5x8 — MC 2300DL/HP 1005 (-z0): na · HP 1018/HP 1020 (-z1): na · HP P1102/HP P1606 (-z2): na · HP CP1025 (-z3): 269
    • photo 10x15 — MC 2300DL/HP 1005 (-z0): na · HP 1018/HP 1020 (-z1): na · HP P1102/HP P1606 (-z2): na · HP CP1025 (-z3): 270
  • -n copies — Number of copies, default is 1. yes queen, print it twelve times, go off.
  • -r xresxyres — Set device resolution in pixels/inch, default is 1200x600.
  • -s source — Source (Input Slot) code to send to the printer, default is 7.
    • 1 — upper
    • 2 — lower
    • 4 — manual
    • 7 — auto
  • -t — Draft mode. Every other pixel is white. it's giving ✨sparse✨
  • -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. (yeah, that's a lot of flags, and yeah, you need the package, no shortcuts 💅)
  • -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 are the options used to customize the operation of foo2zjs for a particular printer. it's giving bespoke, it's giving tailoring. 🪡

  • -u xoffxyoff — Set the offset of the start of the printable region from the upper left corner, in pixels (default varies with paper size). The defaults should work on the 2200DL and 2300DL, and have not been tested on any other printers. 👀
  • -l xoffxyoff — Set the offset of the end of the printable region from the lower right corner, in pixels (default varies with paper size). Same deal: the defaults should work on the 2200DL and 2300DL, and have not been tested on any other printers.
  • -L mask — Send the logical clipping values from -u/-l in the ZjStream.

Okay so context, because this one is lowkey galaxy-brain: foo2zjs-wrapper always runs Ghostscript with the ideal page dimensions, so that the scale of the image is correct — regardless of 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 that 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
  • -P — Do not send START_PLANE codes on monochrome output. May be needed by some monochrome-only printers, such as the HP LaserJet 1000. so if your printer is strictly a black-and-white girly, this might be the one.
  • -X padlen — Add extra zero padding to the end of BID segments. The default is 16 bytes. Padding 16 bytes of zeroes is needed for older ZjStream printers, such as the Minolta 2200DL and HP LaserJet 1000, and seems harmless to newer ones, such as the Minolta 2300DL. So the default should be good for all cases. slay, backwards compatibility. 🫶
  • -z model — Model. Default is 0.
    • 0 — KM 2300DL / HP 1000 / HP 1005
    • 1 — HP 1018 / HP 1020 / HP 1022
    • 2 — HP Pro P1102 / P1566 / P1606dn
    • 3 — HP Pro CP1025

🎀 Color Tweaking Options 🎀

These are the options used to control the quality of color output.

⚠️ Color correction is currently a WORK IN PROGRESS. not me warning you, the manpage said it. 😭
  • -g gsopts — Additional options to pass to Ghostscript, such as -g“-dDITHERPPI=nnn”, etc. This option may appear more than once. stack them like stickers on a laptop. ✨
  • -G profile.icm — Convert profile.icm to a Postscript color rendering dictionary (CRD) using foo2zjs-icc2ps and adjust the printer colors by using the Postscript setcolorrendering operator. (WORK IN PROGRESS). 💀
  • -G gamma-file.ps — Prepend gamma-file.ps to the Postscript input to perform color correction using the setcolortransfer Postscript operator. For example, the file might contain:
{0.333 exp} {0.333 exp} {0.333 exp} {0.333 exp} setcolortransfer
  • -I intent — Select profile intent from the ICM file. 0=Perceptual, 1=Colorimetric, 2=Saturation, 3=Absolute. Default is 0 (perceptual).

🔥 Debugging Options 🔥

These options are used for debugging foo2zjs and its wrapper. detective mode activated. 🔍

  • -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, default is 0.

🌟 EXAMPLES 🌟

Create a monochrome ZjStream from a Postscript document, examine it, and then print it using a RAW print queue:

foo2zjs-wrapper testpage.ps > testpage.zm
zjsdecode < testpage.zm
lpr -P raw testpage.zm

Create a color ZjStream stream from a Postscript document:

foo2zjs-wrapper -c testpage.ps > testpage.zc

🍓 FILES 🍓

  • /usr/bin/foo2zjs-wrapper

💜 SEE ALSO 💜

⭐ AUTHOR ⭐

okay bestie that's the whole page, every flag, every code, every table cell, all of it. no gatekeeping, no skimming, we ate and left no crumbs. 🫶

This is the foo2zjs-wrapper(1) page from the General Commands Manual — shoutout to the standard manual setup that keeps our pages looking cute and consistent — and the author credit belongs to Rick Richardson, with the project living at http://foo2zjs.rkkda.com/. go forth and print. 💅✨

📦 where this page comes from