.TH CHANNEL 1carl CARL
.SH NAME
channel - select channel or list of channels from floatsam stream
.SH SYNOPSIS
\f3channel\f1 [flags] < floatsams > floatsams or text
.nf
.RS 1i
flags:
-CN	set total number of channels to N
-cS	select channels S, which is either:
		comma separated list of channel numbers, or
		NxM, where N is a channel number, M is a skip count.
-t	force text output instead of floatsams
-h	terse help message
.RE
.fi
Channels are numbered from 1.
.SH DESCRIPTION
\f3channel\f1
reads floatsams (32-bit binary floating point samples) on its
standard input and copies selected channels to its standard output.
It assumes a channel-interleaved sample order.
.PP
By default, it assumes 1 channel, and selects channel 1, making it
have no effect.  To extract a selected channel, supply the number
of channels as 
.B -CN
where N is the number of channels, and 
.B -cS
where S is a comma-separated list of selected channel numbers.
For example,
.RS .5i
% wave | channel -C5 -c2,3
.RE
will treat the output of
\f3wave\f1
as though it were a stream of 5 interleaved channels, and copy on
its output channels 2 and 3.
.PP
An alternate channel specification is 
.B NxM
where N is a channel number, and M is a count of the number of channels
to skip by, up to the limit of the number of channels set with -C.
For example,
.RS .5i
% wave | channel -C10 -c1x2
.RE
will select channels 1, 3, 5, 7, 9.
The notations can be safely combined.
.RS .5i
% wave | channel -C10 -c1x5,2
selects channels 1, 2 and 5.
.SH AUTHORS
F.R. Moore, Gareth Loy.
