diff options
author | giraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8> | 2006-12-25 03:06:05 +0000 |
---|---|---|
committer | giraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8> | 2006-12-25 03:06:05 +0000 |
commit | 1017cbebe5d5edd859e0fddad0a8600f509f4821 (patch) | |
tree | 78bdf336648566f7a7d55f42837357dea3dd674c /pamseq.html | |
parent | 16f2ac126651015a376eba864a3a35f738b0b25a (diff) | |
download | netpbm-mirror-1017cbebe5d5edd859e0fddad0a8600f509f4821.tar.gz netpbm-mirror-1017cbebe5d5edd859e0fddad0a8600f509f4821.tar.xz netpbm-mirror-1017cbebe5d5edd859e0fddad0a8600f509f4821.zip |
Place user guide into Subversion repository
git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@181 9d0c8265-081b-0410-96cb-a4ca84ce46f8
Diffstat (limited to 'pamseq.html')
-rw-r--r-- | pamseq.html | 110 |
1 files changed, 110 insertions, 0 deletions
diff --git a/pamseq.html b/pamseq.html new file mode 100644 index 00000000..ba772ae9 --- /dev/null +++ b/pamseq.html @@ -0,0 +1,110 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN"> +<HTML><HEAD><title>Pamseq User Manual</title></HEAD> +<BODY> +<H1>pamseq</H1> +<BR> +Updated: 8 May 2002 +<BR> +<A HREF="#index">Table Of Contents</A> +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +pamseq - generate PAM image of all possible tuple values, in sequence + +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>pamseq</B> +[<B>-tupletype</B> <I>tupletype</I>] +<I>depth</I> +<I>maxval</I> + +<P>All options can be abbreviated to their shortest unique prefix. You +may use two hyphens instead of one to designate an option. You may +use either white space or an equals sign between an option name and its +value. + +<A NAME="lbAD"> </A> +<H2>DESCRIPTION</H2> + +<p>This program is part of <a href="index.html">Netpbm</a>. + +<P><B>pamseq</B> generates a PAM image of a specified depth and specified +maxval that consists of a single row. The row consists of one tuple of +every possible value, in order. + +<P>For a depth of one, the order is simple: From 0 to maxval, going from +left to right. For higher depths, the highest numbered plane goes from +0 to maxval (going left to right) while all the other planes have value 0. +Then the sequence repeats except with the next highest plane set to a value +of 1, then 2, etc. + +<A NAME="lbAE"> </A> +<H2>OPTIONS</H2> + +<DL COMPACT> +<DT><B>-tupletype</B> +<DD> +This is the value of the "tuple_type" attribute of the created PAM image. +It can be any string up to 255 characters. +</DL> + + +<A NAME="lbAF"> </A> +<H2>USAGE</H2> + +<p>To create a simple ramp of the values 0..255, for input to various matrix +calculations, try +<pre> +<kbd> + pamseq 1 255 +</kbd> +</pre> +(Before <b>pamseq</b> existed, <b>pgmramp</b> was often pressed into service +for this). + +<P>To create a PPM color map of all the possible colors representable with a +maxval of 5, do +<pre> +<kbd> + pamseq 3 5 -tupletype=RGB | pamtopnm +</kbd> +</pre> + +Again, with a modern program based on the Netpbm library, you don't need +the <b>pamtopnm</b> because a PAM RGB image is equivalent to a PPM image. + +<p>You can use such a color map with <b><a +href="pnmremap.html">pnmremap</a></b> to quantize the colors in an +image. With the maxval of 5 given in the example, you get a color map +of the set of "web safe" colors as defined by Netscape. Most web +browsers guarantee that they can produce at least these 216 colors +(215 plus black). + +<A NAME="lbAG"> </A> +<H2>SEE ALSO</H2> + +<B><A HREF="pnmremap.html">pnmremap</A></B>, +<B><A HREF="pamtopnm.html">pamtopnm</A></B>, +<B><A HREF="pam.html">pam</A></B> + +<A NAME="history"> </A> +<H2>HISTORY</H2> +<b>pamseq</b> was added to Netpbm in June 2002. + +<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">USAGE</A> +<LI><A HREF="#lbAG">SEE ALSO</A> +<LI><A HREF="#history">HISTORY</A> +</UL> +</BODY> +</HTML> + + |