Debian Codegraph @

upstream/debian-unstable/man1/pamslice.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Pamslice User Manual" 1 "08 February 2010" "netpbm documentation"
7
8 .SH NAME
9 pamslice - extract one line of values out of a Netpbm image
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBpamslice\fP
15 {\fB-row=\fP\fIrownumber\fP | \fB-column=\fP\fIcolumnnumber\fP}
16 [\fB-plane=\fP\fIplanenumber\fP]
17 [\fIimagefile\fP]
18
19 .SH OPTION USAGE
20 .PP
21 All options can be abbreviated to their shortest unique prefix.
22 You may use two hyphens instead of one. You may separate an option
23 name and its value with white space instead of an equals sign.
24
25 .UN description
26 .SH DESCRIPTION
27 .PP
28 This program is part of
29 .BR "Netpbm" (1)\c
30 \&.
31 .PP
32 \fBpamslice\fP extracts one line of tuples (pixels) out of a
33 Netpbm image and prints their values in a table. A line means a row
34 or column. It shows you a one-dimensional cross section of a
35 two-dimensional image. (With the \fB-plane\fP option, it can be
36 thought of as a one-dimensional cross-section of a three-dimensional
37 image).
38 .PP
39 The table has one line per tuple, consisting of blank-separated
40 ASCII decimal numbers. The first number is the column number if you
41 specified a row slice or the row number if you specified a column
42 slice. The rest of the numbers are the sample values in plane number
43 order. For a PBM or PGM input, there is only one plane. For a PPM
44 input, Plane 0 is red, Plane 1 is green, and Plane 2 is blue. See the
45 specifications of the image formats for details on exactly what these
46 numbers mean.
47 .PP
48 If you want to see the entire raster of a Netpbm image, use
49 \fBpamtable\fP.
50
51 .UN options
52 .SH OPTIONS
53 .PP
54 In addition to the options common to all programs based on libnetpbm
55 (most notably \fB-quiet\fP, see
56 .UR index.html#commonoptions
57 Common Options
58 .UE
59 \&), \fBpamslice\fP recognizes the following
60 command line options:
61
62
63 .TP
64 \fB-row=\fP\fIrownumber\fP
65 This indicates that the slice is to be horizontal -- i.e. one row of the
66 image -- and indicates which row. Rows are numbered from the top
67 starting with 0.
68 .sp
69 You cannot specify both \fB-row\fP and \fB-column\fP.
70
71 .TP
72 \fB-column=\fP\fIcolnumber\fP
73 This indicates that the slice is to be vertical -- i.e. one column of the
74 image -- and indicates which column. Columns are numbered from the left
75 starting with 0.
76 .sp
77 You cannot specify both \fB-row\fP and \fB-column\fP.
78
79 .TP
80 \fB-plane=\fP\fIplanenumber\fP
81 This specifies that you are interested in only one plane of the image
82 and which one. Planes are numbered from 0 and have meanings that vary
83 on the type of image. In a PPM image, Plane 0 is red, Plane 1 is
84 green, and Plane 2 is blue.
85 .sp
86 If you don't specify \fB-plane\fP, you get all the planes -- each
87 line of output has multiple numbers in addition to the sequence number.
88 If you do specify \fB-plane\fP, each line of output contains one
89 number in addition to the sequence number.
90
91 .TP
92 \fB-xmgr\fP
93 This option causes \fBpamslice\fP to format the output as input for a
94 \fBxmgr\fP so you can plot it. The only difference this option makes
95 is that it adds header information to the beginning of the output.
96
97
98
99 .UN seealso
100 .SH SEE ALSO
101 .BR "pamtable" (1)\c
102 \&
103 .BR "pamcut" (1)\c
104 \&
105 .BR "pamtopnm" (1)\c
106 \&
107 .BR "pamchannel" (1)\c
108 \&
109 .BR "pnm" (1)\c
110 \&
111
112 .UN history
113 .SH HISTORY
114 .PP
115 \fBpamslice\fP replaced \fBpgmslice\fP in Netpbm 10.3 (June 2002).
116 It was backward compatible, but worked on Netpbm images other than PGM and
117 PBM and added the \fB-plane\fP and \fB-xmgr\fP options.
118
119 .UN author
120 .SH AUTHOR
121 .PP
122 Jos Dingjan <\[email protected]\fP> wrote
123 \fBpgmslice\fP after being unable to find the source code to Marco
124 Beijersbergen's program with the same name. Bryan Henderson converted it
125 to \fBpamslice\fP.
126 .SH DOCUMENT SOURCE
127 This manual page was generated by the Netpbm tool 'makeman' from HTML
128 source. The master documentation is at
129 .IP
130 .B http://netpbm.sourceforge.net/doc/pamslice.html
131 .PP