| 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 <<a |
| 108 |
href="mailto:[email protected]">[email protected]</a>> 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 |
|