Manual: pamslice

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-section of a three-dimensional image).

       The  table has one line per tuple, consisting of blank-separated ASCII decimal numbers.	The first number is the col‐
       umn 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  Common Options ),
       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 sequence 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  wrote pgmslice after being unable to find the source code to Marco Beijersbergen's	pro‐
       gram 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)