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 all the pixels in a PPM, PGM, or PBM image in ASCII
39       decimal, pnmtopnm -plain is a good way to do that.
40
41

OPTIONS

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

SEE ALSO

91       pamcut(1) pnmtopnm(1) pnmtoplainpnm(1) pnm(1)
92
93

HISTORY

95       pamslice replaced pgmslice in Netpbm 10.3 (June 2002).  It was backward
96       compatible, but worked on Netpbm images other  than  PGM  and  PBM  and
97       added the -plane and -xmgr options.
98
99

AUTHOR

101       Jos  Dingjan <jos@tuatha.org> wrote pgmslice after being unable to find
102       the source code to Marco Beijersbergen's program with  the  same  name.
103       Bryan Henderson converted it to pamslice.
104
105
106
107netpbm documentation            8 February 2010        Pamslice User Manual(0)
Impressum