.TL
Pamchannel User Manual
.SH 1
pamchannel
.LP
Updated: 10 January 2006
.br
Table Of Contents
.SH 2
NAME
.LP
pamchannel - extract channels from a PAM image
.SH 2
SYNOPSIS
.LP
\fBpamchannel\fR
[\fB-infile \fR\fIinfile\fR]
[\fB-tupletype \fR\fItupletype\fR]
[\fIchannum\fR ...]
.LP
Minimum unique abbreviation of option is acceptable.  You may use double
hyphens instead of single hyphen to denote options.  You may use white
space in place of the equals sign to separate an option name from its value.
.SH 2
DESCRIPTION
.LP
.LP
This program is part of Netpbm.
.LP
\fBpamchannel\fR reads a PAM or PNM image as input and produces a
PAM image as output, consisting of the indicated channels (planes) of
the input.
.LP
The output is the same dimensions as the input, except that the depth
is the number of \fIchannum\fR arguments you supply.  The tuple type
is a null string unless you specify the \fB-tupletype\fR option.
.LP
This program works on multi-image streams, producing a
corresponding output stream.  But before Netpbm 10.32 (February 2006),
it ignored every image after the first.
.LP
\fBpamstack\fR does the opposite of \fBpamchannel\fR:  It takes multiple
PAM or PNM images as input and stacks their planes (channels) on top of
one another to yield a single PAM.
.SH 2
OPTIONS
.LP
.RS
.IP "\fB-infile\fR \fIinfile\fR"
This specifies the input file, which defaults to Standard Input.  You
may specify \fB-\fR to select Standard Input explicitly.
.LP
This is a little unconventional for Netpbm programs, which usually 
have the input file specification as an argument.  For \fBpamchannel\fR,
the arguments are channel numbers.
.IP "\fB-tupletype\fR \fItupletype\fR"
This specified the tuple type name to be recorded in the output.  You may
use any string up to 255 characters.  Some programs recognize some names.
If you omit this option, the default tuple type name is null.
.RE
.SH 2
SEE ALSO
.LP
\fBpam\fR
\fBpamstack\fR
.SH 2
HISTORY
.LP
.LP
\fBpamchannel\fR was new, along with the PAM format, in Netpbm
9.7 (August 2000).
.br
\l'5i'
.SH 2
Table Of Contents
.LP
.IP \(bu
NAME
.IP \(bu
SYNOPSIS
.IP \(bu
DESCRIPTION
.IP \(bu
OPTIONS
.IP \(bu
SEE ALSO
.IP \(bu
HISTORY
.LP