PALMTOPNM(1)

💅 PALMTOPNM(1) — the palmtopnm user manual, bestie edition 💅

okay so you found a manual page, and it's about palmtopnm, and I'm gonna walk you through it like we're texting at 1am. let's go 🫶

---

✨ NAME ✨

palmtopnm — convert a Palm Bitmap to a PNM image

like. that's the whole job. glow-up a Palm Bitmap into a PNM image. iconic behavior honestly 💖

---

🌸 SYNOPSIS 🌸

palmtopnm

[-verbose]

[-rendition N]

[-showhist]

[palmfile] palmtopnm

-transparent

[-verbose]

[palmfile]

yes it's written kinda unhinged, but that's literally how it is. two whole modes, bestie. pick your fighter.

---

🦋 DESCRIPTION 🦋

bestie. first things first: this program is part of Netpbm(1). family reunion, she's there 💜

palmtopnm reads a Palm Bitmap as input — either from Standard Input or from palmfile — and produces a PPM image as output. that's the whole main-character arc right there.

OR (and this is the plot twist, when you pass -transparent) palmtopnm writes the value of the transparent color in the Palm Bitmap to Standard Output instead. no image. just the tea. 🍓

now here's the thing — palmtopnm can convert Palm Bitmaps with all these features. and to be SO clear, this does not mean she can't handle other stuff. these are literally just the ones the docs found worth mentioning. humble queen.

• Version 0
• Version 1
• Version 2
• Version 3 (new in Netpbm 10.27 (March 2005)) ✨
• Scanline compression
• RLE compression
• Packbits compression (new in Netpbm 10.27 (March 2005)) 🔥

periodt. look at that range.

---

👑 OPTIONS 👑

so besides the options common to all programs based on libnetpbm (most notably -quiet, see Common Options), palmtopnm also recognizes these command line options:

• -verbose — spills various interesting info about the input file and the process. she's giving commentary 🎀
• -transparent — if the Palm Bitmap has a transparent color set, palmtopnm writes the value for that color to Standard Output in the form #RRGGBB, where RR, GG, and BB are two-digit hexadecimal numbers indicating a value in the range 0 through 255. if there's no transparent color set in the Bitmap, palmtopnm writes nothing. and heads up — palmtopnm does not generate any output image when you specify -transparent. literally none. it's just here for the color info, no pictures. 💅
• -rendition N — Palm Bitmaps may contain several different renditions of the same image, with different depths. by default, palmtopnm operates on the first rendition (rendition number 1) in the image. this switch lets you operate on a different rendition. the value must be between 1 and the number of renditions in the image, inclusive. no skipping past the end, bestie, the math has to math 📐
• -showhist — this option causes palmtopnm to write a histogram of colors in the input file to Standard Error. stats queen 🌈

---

🔍 SEE ALSO 🔍

pnmtopalm(1), pamtopdbimg(1), pnm(1),

---

😭 LIMITATIONS 😭

you cannot generate a transparency mask if the Palm Bitmap has a transparent color. sad. tragic. we've all been there.

HOWEVER — you can still do this with ppmcolormask using a Netpbm pipe similar to:

palmtopnm bitmap.palm | ppmcolormask `palmtopnm -transparent
bitmap.palm`

so like, not all hope is lost. she found a workaround. main character energy 💀

---

📜 HISTORY 📜

before Netpbm 10.23 (July 2004), there was a -forceplain option. but honestly? that had been redundant for a long time, since the Netpbm common option -plain does the same thing. so like. RIP -forceplain, you served your purpose and then the vibes moved on 🕯️

---

💖 AUTHORS 💖

this program was originally written as Tbmptopnm.c, by Ian Goldberg. it was heavily modified by Bill Janssen to add color, compression, and transparency function. legends, both of them 👑

Copyright 1995-2001 by Ian Goldberg and Bill Janssen.

---

🧚 DOCUMENT SOURCE 🧚

this manual page was generated by the Netpbm tool makeman from HTML source. the master documentation is at

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

---

okay and that's the whole page!! ty for reading bestie, you ate 💅✨

netpbm documentation — 26 January 2005 — Palmtopnm User Manual(1) 🎀🦋🌸💜