PAMPICK(1)

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

💖 PAMPICK(1) — Pampick User Manual 💖

okay bestie, welcome to the General Commands Manual, section 1, and lemme tell you about pampick because it's genuinely one of the most useful little gremlins in the whole Netpbm friend group 🫶

✨ NAME ✨

pampick — pick images out of a multi-image Netpbm image stream 💅

🌸 SYNOPSIS 🌸

pampick

image_sequence_number ...

okay quick housekeeping before we go any further, no cap:

  • Minimum unique abbreviation of option is acceptable — like, you don't gotta spell the whole thing out, just enough that it's unambiguously that option ✨
  • You may use double hyphens instead of single hyphen to denote options
  • You may use white space in place of the equals sign to separate an option name from its value

that's just the vibe around here, iykyk 🎀

🦋 DESCRIPTION 🦋

This program is part of Netpbm(1) — one of the family, we love her 👑

So here's the tea: pampick reads a PNM or PAM image stream as input. Then it picks certain images from that stream and copies them to a new image stream on Standard Output. it's giving selective, and honestly? iconic behavior 💅

You identify the images you wanna pick by sequence number within the stream. Each image_sequence_number is a decimal sequence number, and zero means the first image. yes babe, we're zero-indexed, we're programmers, this is normal 🌈

Now the rules, and listen up because this part is fr fr important:

  • The arguments must be in increasing order, without duplicates 🔥
  • The results are undefined if they are not 😭 — like, genuinely undefined. not "kinda weird", not "a little off", undefined. (There are a number of enhancements that might be made in future releases that would make whatever pampick does today when you break this rule change — so like, don't build your whole personality on the current accidental behavior bestie, it might not survive the next version 🙈)
  • pampick outputs the images in the same order as they appear in the input — it does not reorder them to match your argument order, okay? it's preserving the source vibe 💜
  • If you specify no sequence numbers, pampick outputs nothing. like, nothing nothing. empty. 🤷
  • If you specify a sequence number that is beyond what is in the input, pampick fails with an error message to that effect 💀

Also super important detail: pampick always reads the entire input stream. Even if it doesn't need the rest! and why? because that's genuinely a kindness — it's helpful when the input stream is a pipe and whatever is feeding the pipe would be upset if it filled up or broke 🫶 like, she's being polite to the upstream process. not me stanning correct pipeline etiquette 😭

Some recs for your other faves:

  • Wanna see how many images, and what kind, are in a stream? Use pamfile 🍓
  • Wanna extract all the images in a stream into separate named files? Use pamsplit ✨

🎀 OPTIONS 🎀

There are no command line options defined specifically for pampick, sorry bestie, she's a simple queen 💅

But! she does recognize the options common to all programs based on libnetpbm. (See Common Options.) so you're not fully alone in there 🌸

🌟 SEE ALSO 🌟

📜 HISTORY 📜

pampick was new in Netpbm 10.31 (December 2005) — a vintage baddie, we respect the heritage 👑

🧚 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/pampick.html

and that's the whole page bestie 🩷 this documentation came to you from netpbm documentation, dated 25 October 2005, and it says "Pampick User Manual(1)" at the bottom but we already knew that, we read the whole thing. go pick some images, stay zero-indexed, and remember: increasing order, no duplicates, or the rules stop applying to you 💀✨

📦 where this page comes from