PAMTABLE(1)

💖 PAMTABLE(1) — the pamtable user manual, bestie edition 💖

okay so you found the pamtable page, welcome, pull up a chair, this one's actually adorable. it lives in the General Commands Manual section, and yes it's a Netpbm thing, we love her for that.

---

✨ NAME ✨

pamtable — print the raster as a table of numerical sample values 🎀

---

✨ SYNOPSIS ✨

pamtable

[-tuple] [-hex]

[netpbmfile]

---

✨ DESCRIPTION ✨

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

pamtable prints the raster of a Netpbm image as a table of numerical sample values. that's it, that's the job, and she does it flawlessly.

for example — a 5-pixel wide, 2-pixel high rainbow (black, red, green, blue, white) PPM image with maxval 255 would appear as follows:

        0   0   0|255   0   0|  0 255   0|  0   0 255|255 255 255
        0   0   0|255   0   0|  0 255   0|  0   0 255|255 255 255

literally iconic. 🌈

but bestie, there are other output formats possible. see the command line options below, we'll get there. 👑

if you care to see only certain rows or columns, use pamcut to filter the input. yes, filter first, table after. self care. 💅

if you care to see only certain planes, use pamchannel to filter the input.

pamtable prints vertical bars between tuples, unless there is only one sample per tuple, in which case it prints a single space between tuples. the way she adapts?? main character behavior fr fr.

pamtable prints a single space between samples within a tuple.

for each sample, pamtable prints the numerical value from the Netpbm image, uninterpreted. no editorializing, no vibes, just the raw number. she prints it in decimal, right justified in the minimum number of spaces required to print the maxval of the image.

if you want the samples to print more densely, use pamdepth to reduce the maxval — that makes the decimal numbers for the samples narrower. narrowing your numbers = narrowing your problems, sort of. 🌸

the less program (not part of Netpbm, she's a guest) is good for browsing through the table. use its --chop-long-lines option and use cursor movement keys to scroll around in the image. genuinely so satisfying, you'll lose an hour. 😭

---

✨ ARGUMENTS ✨

the only possible argument is the name of the file containing the input Netpbm image. it's optional — if you don't specify any arguments, the input comes from Standard Input. lowkey the easiest thing ever. 💖

---

✨ OPTIONS ✨

in addition to the options common to all programs based on libnetpbm (most notably -quiet, see Common Options), pamtable recognizes the following command line options:

• -tuple — print the tuple values in mathematical tuple notation, like this:

(0, 0, 0) (255, 0, 0) (0, 255, 0) (0, 0, 255) (255, 255, 255)
(0, 0, 0) (255, 0, 0) (0, 255, 0) (0, 0, 255) (255, 255, 255)

this option was new in Netpbm 10.11.00 (September 2022). ⭐

• -hex — display sample values in hexadecimal instead of decimal.

🚨 this option is not valid with -tuple. pick one, bestie, you can't have both.

this option was new in Netpbm 10.11.00 (September 2022). ✨

• -verbose — print additional messages about the processing. she's chatty and we support her. 💬

---

✨ SEE ALSO ✨

pamfile(1), pamcut(1), pamchannel(1), pnm(1), pam(1), pamslice(1), ppmtoarbtxt(1), ppmtoterm(1),

a whole friend group. go say hi. 🦋

---

✨ HISTORY ✨

pamtable was new in Netpbm 10.79 (June 2017). she's been serving looks since 2017 and she has not stopped. 👑

---

✨ 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/pamtable.html

---

and that's the whole page, bestie!! this doc came out under the netpbm documentation, dated 15 April 2017, and it's a Pamtable User Manual(1) through and through. go read a raster, print a table, slay. 💖✨🎀🦋🌸💅🫶