.TH GAIN 1carl CARL
.SH NAME
gain \- scales a digital sound signal
.SH SYNOPSIS
.B gain
factor < floatsams > floatsams
.SH DESCRIPTION
.B gain 
reads floatsams (32 bit binary floating point numbers)
from stdin, scales them by the gain 
.I factor 
supplied
as its argument, and writes the scaled values on stdout.  
Factor may be an expression following the expression rules given
for 
.I expr(3carl).
If the output is connected to a terminal, ASCII data is produced.
.I gain
is intended to be included in pipes with programs such as 
.I para, 
.I chan,
.I sndin, 
.I cmusic, 
.I impulse, 
etc. The following example generates an impulse
signal 50 samples long, consisting of .707, followed by 49 zero values:
.DS
impulse 50 | gain -3dB
.DE
.SH AUTHOR
F. R. Moore
.SH SEE ALSO
wire(1carl), para(1carl), chan(1carl), impulse(1carl), getfloat(3carl)
