PAMSLICE(1)

💖 Pamslice User Manual 💖

okay bestie, you found it — the Pamslice User Manual, straight out of the General Commands Manual section. pull up a chair, we're doing a vibe check on one single line of pixels and it's gonna be iconic.

---

✨ NAME ✨

pamslice — extract one line of values out of a Netpbm image 🎀

---

🦋 SYNOPSIS 🦋

pamslice {-row=rownumber | -column=columnnumber} [-plane=planenumber]
[imagefile]

---

🌸 OPTION USAGE 🌸

the lil rules for typing these, and yes they're giving flexible:

• All options can be abbreviated to their shortest unique prefix. no need to type the whole thing, she'll know what you mean 💅
• You may use two hyphens instead of one. (yes, both work. we don't gatekeep.)
• You may separate an option name and its value with white space instead of an equals sign. so -row=5 and -row 5 are both slaying.

---

👑 DESCRIPTION 👑

so this program is part of Netpbm(1). main character of a whole family fr.

pamslice extracts one line of tuples (pixels) out of a Netpbm image and prints their values in a table. a "line" here means a row or a column, okay? it shows you a one-dimensional cross section of a two-dimensional image. and with the -plane option it can be thought of as a one-dimensional cross-section of a three-dimensional image. that's the glow-up. ✨

The table has one line per tuple, consisting of blank-separated ASCII decimal numbers.

• The first number is the column number if you specified a row slice, or the row number if you specified a column slice. (so like, the sequence number of where you are.)
• The rest of the numbers are the sample values in plane number order.

For a PBM or PGM input, there is only one plane. For a PPM input, Plane 0 is red, Plane 1 is green, and Plane 2 is blue. See the specifications of the image formats for details on exactly what these numbers mean. 💖

ok but what if you want the ENTIRE raster of a Netpbm image? then you use pamtable, bestie. different tool, different moment, same energy.

---

💅 OPTIONS 💅

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

• -row=rownumber — this says the slice is horizontal, i.e. one row of the image, and tells you which row. Rows are numbered from the top, starting with 0. 🫶

You cannot specify both -row and -column. pick a lane, babe.

• -column=colnumber — this says the slice is vertical, i.e. one column of the image, and tells you which column. Columns are numbered from the left, starting with 0. 🦋

You cannot specify both -row and -column. same rule, still watching. 👀

• -plane=planenumber — this specifies that you are interested in only one plane of the image, and which one. Planes are numbered from 0 and their meanings vary on the type of image. In a PPM image, Plane 0 is red, Plane 1 is green, and Plane 2 is blue. 🌈

If you don't specify -plane, you get all the planes — each line of output has multiple numbers in addition to the sequence number. If you do specify -plane, each line of output contains one number in addition to the sequence number. one number only, she's minimal like that. ✨

• -xmgr — this option causes pamslice to format the output as input for a xmgr, so you can plot it. 📊 the only difference this option makes is that it adds header information to the beginning of the output. that's literally it. no cap.

---

🌟 SEE ALSO 🌟

slices? no — these: pamtable(1) pamcut(1) pamtopnm(1) pamchannel(1) pnm(1)

---

🎀 HISTORY 🎀

pamslice replaced pgmslice in Netpbm 10.3 (June 2002). 🗓️ It was backward compatible, but it worked on Netpbm images other than PGM and PBM and it added the -plane and -xmgr options. so basically an upgrade with extra sparkle. 💜

---

💖 AUTHOR 💖

Jos Dingjan <jos@tuatha.org> wrote pgmslice after being unable to find the source code to Marco Beijersbergen's program with the same name. Then Bryan Henderson converted it to pamslice. two icons, one lineage. 👑

---

📜 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/pamslice.html

---

and that's the whole thing, bestie!! 🫶 this page came to you from netpbm documentation, dated 08 February 2010, and yeah the footer still says Pamslice User Manual(1) because legends never change. go slice something. 💅✨🦋