PAMFIND(1)

💖 pamfind — the manual, but make it cute 💖

okay bestie, welcome to Pamfind User Manual(1) from the General Commands Manual section 🎀 — this is the page where we learn how to make pamfind spill the tea on exactly where in your image a certain tuple is hiding. no cap.

✨ NAME ✨

pamfind — literally just prints the locations of all tuples of a certain value in an image. that's the whole job. iconic. 👑

🌸 SYNOPSIS 🌸

pamfind { -target=sample0,sample1, ... | -color=color } [-machine]
[imagefile]

okay so housekeeping rules before we get into it 🧚:

• Every option can be abbreviated to its shortest unique prefix. yes, you can be lazy. we love that for you.
• You can use two hyphens instead of one. fancy.
• You can separate an option name and its value with white space instead of an equals sign. flexible king behavior fr fr.

🦋 DESCRIPTION 🦋

So this program is part of Netpbm(1) — you know, the whole crew 💫.

Here's the vibe: pamfind reads a Netpbm image (PNM or PAM), and then it prints out a list of all the locations — and by locations we mean row and column — of the tuples that have the value you asked for. for example? you can list all the places that a visual image is red. like, all of them. every single one. obsessed. 🔥

You get two ways to say what you're hunting for:

• give the actual decimal sample values with the -target option, or
• give it as a color with -color.

Now the important lore: if you specify -color, the program fails if the input image does not have depth 3. 💀 and if it does have depth 3 but the tuples aren't actually colors? you still get results as if they are. (do with that information what you will.)

Want to do the exact opposite — find out what tuple is at a given location? that's a pamcut x pamtable collab moment, and it looks like this:

$ pamcut -left=5 -top=7 -width=1 -height=1 | pamtable

Also, ppmcolormask finds all the tuples of a certain value too, at least in visual images — but instead of printing their coordinates, it generates a mask image. which you can then use to visualise where those tuples are, or feed into another program. different tool, different era. 💅

👑 OPTIONS 👑

On top of the options common to all programs based on libnetpbm (most notably -quiet, see Common Options), pamfind recognises the following command line options:

• -target=sample0,sample1, ... | — this specifies the tuple value to find. you give the sample values in order, and you must specify the proper number of sample values for the depth of the image (e.g. 3 if it's a color image). also: you must specify exactly one of -target and -color. pick a lane bestie 🫶
• -color=color — this is the color to find, assuming the image is a color visual image. color is as described for the argument of the pnm_parsecolor() library routine. and yes, again: you must specify exactly one of -target and -color. 😭
• -machine — this makes the output more convenient for a machine to use, while less convenient for a human. pamfind reports the same information as with no options — same facts, different fit. this option was new in Netpbm 10.87 (March 2020). ⭐

---

🌈 SEE ALSO 🌈

pamdepth(1), pamgetcolor(1), ppmhist(1), ppmcolormask(1), pamcut(1), pamtable(1), pam(1)

go read them, they're all in the family 💜

📜 HISTORY 📜

pamfind was added to Netpbm in Release 10.86 (March 2019). a legend was born, fr fr. ✨

🎀 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/pamfind.html

---

okay that's the whole page bestie, you're fully caught up 💖 signed, sealed, delivered by netpbm documentation, dated 13 March 2019 — Pamfind User Manual(1), periodt. 🌸🦋