\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Pamseq User Manual" 0 "8 May 2002" "netpbm documentation"


.UN lbAB
.SH NAME

pamseq - generate PAM image of all possible tuple values, in sequence

.SH SYNOPSIS

\fBpamseq\fP
[\fB-tupletype=\fP\fItupletype\fP]
\fIdepth\fP
\fImaxval\fP
.PP
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.

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR Netpbm (1)
.
.PP
\fBpamseq\fP 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.
.PP
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.

.UN options
.SH OPTIONS


.TP
\fB-tupletype\fP
This is the value of the "tuple_type" attribute of the created PAM image.
It can be any string up to 255 characters.



.UN usage
.SH USAGE
.PP
To create a simple ramp of the values 0..255, for input to various matrix
calculations, try
.nf
\f(CW
  pamseq 1 255 
\fP
.fi
(Before \fBpamseq\fP existed, \fBpgmramp\fP was often pressed into service
for this).
.PP
To create a PPM color map of all the possible colors representable with a
maxval of 5, do
.nf
\f(CW
  pamseq 3 5 -tupletype=RGB | pamtopnm
\fP
.fi

Again, with a modern program based on the Netpbm library, you don't need
the \fBpamtopnm\fP because a PAM RGB image is equivalent to a PPM image.
.PP
You can use such a color map with
.BR pnmremap (1)
 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).

.UN seealso
.SH SEE ALSO
.BR pnmremap (1)
,
.BR pamtopnm (1)
,
.BR pam (5)


.UN history
.SH HISTORY
\fBpamseq\fP was added to Netpbm in June 2002.