LISPMTOPGM(1)

📦
version 11.13.03 · 4 versions
, in debian bookworm, debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 LISPMTOPGM 💖

okay bestie, so this is lispmtopgm — it's section 1 of the Lispmtopgm User Manual (General Commands Manual, iykyk) and it converts a Lisp Machine bitmap file into a PGM. yes. we're going back in time. it's giving vintage-tech-slay. 👑

✨ NAME ✨

lispmtopgm — convert a Lisp Machine bitmap file to PGM 🦋

🎀 SYNOPSIS 🎀

lispmtopgm [lispmfile]

🌸 DESCRIPTION 🌸

ok so first things first: this program is part of Netpbm(1). family reunion energy. 🫶

listpmfile reads a Lisp Machine bitmap as input and produces a PGM image as output. literally that's the whole job, and it does it well fr fr.

so the tea about this file format: it's the one written by the tv:write-bit-array-file function on TI Explorer and Symbolics lisp machines. very specific. very niche. very iconic of them honestly. 💅

here's the part that lives in my head rent free though — multi-plane bitmaps on lisp machines are color, periodt. BUT. the Lispm image file format does not include a color map, so we have no choice but to treat it as a monochrome image instead and produce PGM. and yeah. that's unfortunate. 😭 we said what we said.

💅 OPTIONS 💅

ngl there are no command line options defined specifically for lispmtopgm bestie, sorry to disappoint.

  • but — it does recognize the options common to all programs based on libnetpbm. (See Common Options. 👀)

so you're not fully optionless, you're just borrowing the group chat's options instead of having your own. main character adjacent. ✨

🔥 SEE ALSO 🔥

  • pgmtolispm(1) — the reverse bestie, the other direction 🦋
  • pgm(1) — the format we're producing, the moment 💜

💀 LIMITATIONS 💀

buckle up. this is the "we need to talk" section. 🫠

One. the Lispm bitmap file format is a bit quirky. usually, the image in the file has its width rounded up to the next higher multiple of 32 — but not always. and if the width is not a multiple of 32, we do not deal with it properly. 😭 the small mercy here is that because of the Lispm microcode, such arrays are probably not image data anyway. so like... probably fine? probably. 🙈

Two. also — and this is the messiest part — the Lispm code for saving bitmaps has a bug: if you are writing a bitmap which is not mod32 across, the file may be up to 7 bits too short! 😱 they round down instead of up, and we do not handle this bug gracefully. no cap. consider yourself warned bestie. 💀

👑 AUTHOR 👑

Copyright (C) 1991 by Jamie Zawinski and Jef Poskanzer. 🫶 legends, honestly.

🌈 DOCUMENT SOURCE 🌈

This manual page was generated by the Netpbm tool makeman from HTML source. the master documentation lives at:

http://netpbm.sourceforge.net/doc/lispmtopgm.html

and that's the whole page bestie, we ate and left no crumbs 🍓✨ this was netpbm documentation, dated 06 March 1990, from the Lispmtopgm User Manual(1) — mwah, love u, go convert some ancient bitmap files 💖🎀🦋

📦 where this page comes from