NAME

       pamchannel - extract channels from a PAM image

SYNOPSIS

       pamchannel [-infile=infile] [-tupletype=tupletype] [channum ...]

       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.

DESCRIPTION

       This program is part of Netpbm(1).

       pamchannel reads a Netpbm image as input and produces a PAM image as output, consisting of
       the indicated channels (planes) of the input.

       Each channum argument is the number of a channel of the  input,  with  the  first  channel
       being zero.  The channels in the output are in the order of these arguments.

       The  output  is  the  same dimensions as the input, except that the depth is the number of
       channum arguments you supply.  The tuple type is a null  string  unless  you  specify  the
       -tupletype option.

       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.

       pamstack does the opposite of pamchannel:  It takes multiple PAM or PNM  images  as  input
       and stacks their planes (channels) on top of one another to yield a single PAM.

OPTIONS

       In addition to the options common to all programs based on libnetpbm (most notably -quiet,
       see
        Common Options ⟨index.html#commonoptions⟩ ), pamchannel recognizes the following  command
       line options:

       -infile infile
              This specifies the input file, which defaults to Standard Input.  You may specify -
              to select Standard Input explicitly.

              This is a little unconventional for Netpbm programs, which usually have  the  input
              file  specification  as  an  argument.   For  pamchannel, the arguments are channel
              numbers.

       -tupletype tupletype
              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.

SEE ALSO

       pam(1) pamstack(1)

HISTORY

       pamchannel was new, along with the PAM format, in Netpbm 9.7 (August 2000).

DOCUMENT SOURCE

       This manual page was generated by the Netpbm tool 'makeman' from HTML source.  The  master
       documentation is at

              http://netpbm.sourceforge.net/doc/pamchannel.html