diff options
Diffstat (limited to 'pamslice.html')
-rw-r--r-- | pamslice.html | 130 |
1 files changed, 130 insertions, 0 deletions
diff --git a/pamslice.html b/pamslice.html new file mode 100644 index 00000000..efb42efe --- /dev/null +++ b/pamslice.html @@ -0,0 +1,130 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN"> +<HTML> +<HEAD><TITLE>Pamslice User Manual</TITLE></HEAD> +<BODY> +<H1>pamslice</H1> +Updated: 22 June 2002 +<BR> +<A HREF="#index">Table Of Contents</A> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> +pamslice - extract one line of values out of a Netpbm image + +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>pamslice</B> +{<B>-row=</B><i>rownumber</i> | <B>-column=</B><i>columnnumber</i>} +[<B>-plane=</b><i>planenumber</i>] +[<I>imagefile</I>] + +<?makeman .SH OPTION USAGE ?> +<P>All options can be abbreviated to their shortest unique prefix. +You may use two hyphens instead of one. You may separate an option +name and its value with white space instead of an equals sign. + +<A NAME="lbAD"> </A> +<H2>DESCRIPTION</H2> + +<p>This program is part of <a href="index.html">Netpbm</a>. + +<p><b>pamslice</b> extracts one line of tuples (pixels) out of a +Netpbm image and prints their values in a table. A line means a row +or column. It shows you a one-dimensional cross section of a +two-dimensional image. (With the <b>-plane</b> option, it can be +thought of as a one-dimensional cross-section of a three-dimensional +image). + +<p>The table has one line per tuple, consisting of blank-separated +ASCII decimal numbers. The first number is the column number if you +specified a row slice or the row number if you specified a column +slice. The rest of the numbers are the sample values in plane number +order. For a PBM or PGM input, there is only one plane. For a PPM +input, Plane 0 is red, Plane 1 is green, and Plane 2 is blue. See the +specifications of the image formats for details on exactly what these +numbers mean. + +If you want to see all the pixels in a PPM, PGM, or PBM image in ASCII +decimal, <b>pnmtoplainpnm</b> is a good way to do that. + +<A NAME="lbAE"> </A> +<H2>OPTIONS</H2> + +<DL COMPACT> +<DT><B>-row=</B><i>rownumber</i> +<DD> + This indicates that the slice is to be horizontal -- i.e. one row of the + image -- and indicates which row. Rows are numbered from the top + starting with 0. + + <P>You cannot specify both <b>-row</b> and <b>-column</b>. + +<DT><B>-column=</B><i>colnumber</i> +<DD> + This indicates that the slice is to be vertical -- i.e. one column of the + image -- and indicates which column. Columns are numbered from the left + starting with 0. + + <P>You cannot specify both <b>-row</b> and <b>-column</b>. + +<DT><B>-plane=</B><i>planenumber</i> +<DD> + This specifies that you are interested in only one plane of the image + and which one. Planes are numbered from 0 and have meanings that vary + on the type of image. In a PPM image, Plane 0 is red, Plane 1 is + green, and Plane 2 is blue. + + <p>If you don't specify <b>-plane</b>, you get all the planes -- each + line of output has multiple numbers in addition to the sequence number. + If you do specify <b>-plane</b>, each line of output contains one + number in addition to the sequence number. + +<DT><B>-xmgr</B> +<DD> + This option causes <b>pamslice</b> to format the output as input for a + <b>xmgr</b> so you can plot it. The only difference this option makes + is that it adds header information to the beginning of the output. + +</DL> + +<A NAME="lbAF"> </A> +<H2>SEE ALSO</H2> + +<A HREF="pamcut.html">pamcut</A> +<A HREF="pnmtoplainpnm.html">pnmtoplainpnm</A> +<A HREF="pamchannel.html">pnmtoplainpnm</A> +<A HREF="pnm.html">pnm</A> +<A NAME="lbAG"> </A> + +<a name="history"> </a> +<H2>HISTORY</H2> + +<P><b>pamslice</b> replaced <b>pgmslice</b> in Netpbm 10.3 (June 2002). +It was backward compatible, but worked on Netpbm images other than PGM and +PBM and added the <b>-plane</b> and <b>-xmgr</b> options. + +<a name="author"></a> +<H2>AUTHOR</H2> + +<P>Jos Dingjan <<A +HREF="mailto:jos@tuatha.org">jos@tuatha.org</A>> wrote +<b>pgmslice</b> after being unable to find the source code to Marco +Beijersbergen's program with the same name. Bryan Henderson converted it +to <b>pamslice</b>. + +<HR> +<A NAME="index"> </A> +<H2>Table Of Contents</H2> +<UL> +<LI><A HREF="#lbAB">NAME</A> +<LI><A HREF="#lbAC">SYNOPSIS</A> +<LI><A HREF="#lbAD">DESCRIPTION</A> +<LI><A HREF="#lbAE">OPTIONS</A> +<LI><A HREF="#lbAF">SEE ALSO</A> +<LI><A HREF="#history">HISTORY</A> +<LI><A HREF="#author">AUTHOR</A> +</UL> +</BODY> +</HTML> + |