| 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 |