1Pamslice User Manual(0)                                Pamslice User Manual(0)
2
3
4

NAME

6       pamslice - extract one line of values out of a Netpbm image
7
8

SYNOPSIS

10       pamslice  {-row=rownumber  | -column=columnnumber} [-plane=planenumber]
11       [imagefile]
12
13

OPTION USAGE

15       All options can be abbreviated to their shortest  unique  prefix.   You
16       may  use  two  hyphens instead of one.  You may separate an option name
17       and its value with white space instead of an equals sign.
18
19

DESCRIPTION

21       This program is part of Netpbm(1).
22
23       pamslice extracts one line of tuples (pixels) out of a Netpbm image and
24       prints  their  values  in  a  table.  A line means a row or column.  It
25       shows you a one-dimensional cross section of a  two-dimensional  image.
26       (With  the  -plane  option,  it  can be thought of as a one-dimensional
27       cross-section of a three-dimensional image).
28
29       The table has one line per tuple, consisting of  blank-separated  ASCII
30       decimal  numbers.   The first number is the column number if you speci‐
31       fied a row slice or the row number if you  specified  a  column  slice.
32       The  rest  of  the numbers are the sample values in plane number order.
33       For a PBM or PGM input, there is only one  plane.   For  a  PPM  input,
34       Plane  0 is red, Plane 1 is green, and Plane 2 is blue.  See the speci‐
35       fications of the image formats for details on exactly what  these  num‐
36       bers mean.
37
38       If you want to see the entire raster of a Netpbm image, use pamtable.
39
40

OPTIONS

42       In  addition  to  the options common to all programs based on libnetpbm
43       (most notably -quiet, see
44        Common Options ⟨index.html#commonoptions⟩ ), pamslice  recognizes  the
45       following command line options:
46
47
48
49       -row=rownumber
50                   This  indicates  that the slice is to be horizontal -- i.e.
51              one row of the
52                   image -- and indicates which row.  Rows are  numbered  from
53              the top
54                   starting with 0.
55
56              You cannot specify both -row and -column.
57
58
59       -column=colnumber
60                   This indicates that the slice is to be vertical -- i.e. one
61              column of the
62                   image -- and indicates which column.  Columns are  numbered
63              from the left
64                   starting with 0.
65
66              You cannot specify both -row and -column.
67
68
69       -plane=planenumber
70                   This specifies that you are interested in only one plane of
71              the image
72                   and which one.  Planes are numbered from 0 and  have  mean‐
73              ings that vary
74                   on  the  type  of  image.   In a PPM image, Plane 0 is red,
75              Plane 1 is
76                   green, and Plane 2 is blue.
77
78              If you don't specify -plane, you get all the planes -- each
79                   line of output has multiple numbers in addition to the  se‐
80              quence number.
81                   If you do specify -plane, each line of output contains one
82                   number in addition to the sequence number.
83
84
85       -xmgr
86                   This  option  causes pamslice to format the output as input
87              for a
88                   xmgr so you can plot it.  The only difference  this  option
89              makes
90                   is  that it adds header information to the beginning of the
91              output.
92
93
94
95

SEE ALSO

97       pamtable(1) pamcut(1) pamtopnm(1) pamchannel(1) pnm(1)
98
99

HISTORY

101       pamslice replaced pgmslice in Netpbm 10.3 (June 2002).  It was backward
102       compatible,  but  worked  on  Netpbm  images other than PGM and PBM and
103       added the -plane and -xmgr options.
104
105

AUTHOR

107       Jos Dingjan <jos@tuatha.org> wrote pgmslice after being unable to  find
108       the  source  code  to Marco Beijersbergen's program with the same name.
109       Bryan Henderson converted it to pamslice.
110

DOCUMENT SOURCE

112       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
113       source.  The master documentation is at
114
115              http://netpbm.sourceforge.net/doc/pamslice.html
116
117netpbm documentation           08 February 2010        Pamslice User Manual(0)
Impressum