1Pamslice User Manual(0) Pamslice User Manual(0)
2
6 pamslice - extract one line of values out of a Netpbm image
7
10 pamslice {-row=rownumber | -column=columnnumber} [-plane=planenumber]
11 [imagefile]
12
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
21 This program is part of Netpbm(1).
22 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 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 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
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 You cannot specify both -row and -column.
51 -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 You cannot specify both -row and -column.
61 -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 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 -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
91 pamcut(1) pnmtopnm(1) pnmtoplainpnm(1) pnm(1)
92
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
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.
104netpbm documentation 8 February 2010 Pamslice User Manual(0)