Debian Codegraph @

userguide/pamslice.html

raw
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN">
2 <html><head><title>Pamslice User Manual</title></head>
3 <body>
4 <h1>pamslice</h1>
5 Updated: 08 February 2010
6 <br>
7 <a href="#index">Table Of Contents</a>
8
9 <h2>NAME</h2>
10 pamslice - extract one line of values out of a Netpbm image
11
12 <h2 id="synopsis">SYNOPSIS</h2>
13
14 <b>pamslice</b>
15 {<b>-row=</b><i>rownumber</i> | <b>-column=</b><i>columnnumber</i>}
16 [<b>-plane=</b><i>planenumber</i>]
17 [<i>imagefile</i>]
18
19 <?makeman .SH OPTION USAGE ?>
20 <p>All options can be abbreviated to their shortest unique prefix.
21 You may use two hyphens instead of one. You may separate an option
22 name and its value with white space instead of an equals sign.
23
24 <h2 id="description">DESCRIPTION</h2>
25
26 <p>This program is part of <a href="index.html">Netpbm</a>.
27
28 <p><b>pamslice</b> extracts one line of tuples (pixels) out of a
29 Netpbm image and prints their values in a table. A line means a row
30 or column. It shows you a one-dimensional cross section of a
31 two-dimensional image. (With the <b>-plane</b> option, it can be
32 thought of as a one-dimensional cross-section of a three-dimensional
33 image).
34
35 <p>The table has one line per tuple, consisting of blank-separated
36 ASCII decimal numbers. The first number is the column number if you
37 specified a row slice or the row number if you specified a column
38 slice. The rest of the numbers are the sample values in plane number
39 order. For a PBM or PGM input, there is only one plane. For a PPM
40 input, Plane 0 is red, Plane 1 is green, and Plane 2 is blue. See the
41 specifications of the image formats for details on exactly what these
42 numbers mean.
43
44 <p>If you want to see the entire raster of a Netpbm image, use
45 <b>pamtable</b>.
46
47 <h2 id="options">OPTIONS</h2>
48
49 <p>In addition to the options common to all programs based on libnetpbm
50 (most notably <b>-quiet</b>, see <a href="index.html#commonoptions">
51 Common Options</a>), <b>pamslice</b> recognizes the following
52 command line options:
53
54 <dl compact>
55 <dt><b>-row=</b><i>rownumber</i>
56 <dd>
57 This indicates that the slice is to be horizontal -- i.e. one row of the
58 image -- and indicates which row. Rows are numbered from the top
59 starting with 0.
60
61 <p>You cannot specify both <b>-row</b> and <b>-column</b>.
62
63 <dt><b>-column=</b><i>colnumber</i>
64 <dd>
65 This indicates that the slice is to be vertical -- i.e. one column of the
66 image -- and indicates which column. Columns are numbered from the left
67 starting with 0.
68
69 <p>You cannot specify both <b>-row</b> and <b>-column</b>.
70
71 <dt><b>-plane=</b><i>planenumber</i>
72 <dd>
73 This specifies that you are interested in only one plane of the image
74 and which one. Planes are numbered from 0 and have meanings that vary
75 on the type of image. In a PPM image, Plane 0 is red, Plane 1 is
76 green, and Plane 2 is blue.
77
78 <p>If you don't specify <b>-plane</b>, you get all the planes -- each
79 line of output has multiple numbers in addition to the sequence number.
80 If you do specify <b>-plane</b>, each line of output contains one
81 number in addition to the sequence number.
82
83 <dt><b>-xmgr</b>
84 <dd>
85 This option causes <b>pamslice</b> to format the output as input for a
86 <b>xmgr</b> so you can plot it. The only difference this option makes
87 is that it adds header information to the beginning of the output.
88
89 </dl>
90
91 <h2 id="seealso">SEE ALSO</h2>
92
93 <a href="pamtable.html">pamtable</a>
94 <a href="pamcut.html">pamcut</a>
95 <a href="pamtopnm.html">pamtopnm</a>
96 <a href="pamchannel.html">pamchannel</a>
97 <a href="pnm.html">pnm</a>
98
99 <h2 id="history">HISTORY</h2>
100
101 <p><b>pamslice</b> replaced <b>pgmslice</b> in Netpbm 10.3 (June 2002).
102 It was backward compatible, but worked on Netpbm images other than PGM and
103 PBM and added the <b>-plane</b> and <b>-xmgr</b> options.
104
105 <h2 id="author">AUTHOR</h2>
106
107 <p>Jos Dingjan &lt;<a
108 href="mailto:[email protected]">[email protected]</a>&gt; wrote
109 <b>pgmslice</b> after being unable to find the source code to Marco
110 Beijersbergen's program with the same name. Bryan Henderson converted it
111 to <b>pamslice</b>.
112
113 <hr>
114 <h2 id="index">Table Of Contents</h2>
115 <ul>
116 <li><a href="#synopsis">SYNOPSIS</a>
117 <li><a href="#description">DESCRIPTION</a>
118 <li><a href="#options">OPTIONS</a>
119 <li><a href="#seealso">SEE ALSO</a>
120 <li><a href="#history">HISTORY</a>
121 <li><a href="#author">AUTHOR</a>
122 </ul>
123 </body>
124 </html>
125