Pamslice User Manual(1) General Commands Manual Pamslice User Manual(1)
NAME
pamslice - extract one line of values out of a Netpbm image
SYNOPSIS
pamslice {-row=rownumber | -column=columnnumber} [-plane=planenumber]
[imagefile]
OPTION USAGE
All options can be abbreviated to their shortest unique prefix. You may
use two hyphens instead of one. You may separate an option name and its
value with white space instead of an equals sign.
DESCRIPTION
This program is part of Netpbm(1).
pamslice extracts one line of tuples (pixels) out of a Netpbm image and
prints their values in a table. A line means a row or column. It shows
you a one-dimensional cross section of a two-dimensional image. (With
the -plane option, it can be thought of as a one-dimensional cross-sec-
tion of a three-dimensional image).
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. 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.
If you want to see the entire raster of a Netpbm image, use pamtable.
OPTIONS
In addition to the options common to all programs based on libnetpbm
(most notably -quiet, see ]8;;index.html#commonoptions\ Common Options]8;;\ ), pamslice recognizes the
following command line options:
-row=rownumber
This indicates that the slice is to be horizontal -- i.e.
one row of the
image -- and indicates which row. Rows are numbered from
the top
starting with 0.
You cannot specify both -row and -column.
-column=colnumber
This indicates that the slice is to be vertical -- i.e. one
column of the
image -- and indicates which column. Columns are numbered
from the left
starting with 0.
You cannot specify both -row and -column.
-plane=planenumber
This specifies that you are interested in only one plane of
the image
and which one. Planes are numbered from 0 and have meanings
that 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 se-
quence number.
If you do specify -plane, each line of output contains one
number in addition to the sequence number.
-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.
SEE ALSO
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 worked on Netpbm images other than PGM and PBM and added
the -plane and -xmgr options.
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.
Bryan Henderson converted it to pamslice.
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
netpbm documentation 08 February 2010 Pamslice User Manual(1)
Generated by dwww version 1.16 on Tue Dec 16 04:28:07 CET 2025.