.TH CONVOLVESF 1carl CARL
.SH NAME
convolvesf \- convolve stdin with a soundfile containing a room response
.SH SYNOPSIS
.B convolvesf
[flags] impulse_response_ soundfile < floatsams > floatsams
.nf
.RS .5i
flags:
g = gain factor (1.)
b = begin time in impulse response (first sample to use) (0.)
e = end time in impulse response (last sample to use) (end)
d = duration of impulse response (end - begin)
.RE
.fi
.SH DESCRIPTION 
.I convolvesf
is identical to
.I convolve
except that where
.I convolve
expects a filterfile
.I convolvesf
expects a soundfile.  (Also, \fIconvolve\fR eliminates the filter delay
whereas \fIconvolvesf\fR does not, but this is very minor.)  If the
soundfile contains the impulse response
of a room or of some resonator, then the effect is to provide the
input signal with precisely the reverberation which would
have resulted had the sound really been produced in that
room or resonator.  If only a part of the soundfile contains the
desired impulse response, this part can be specified with -b and -e flags.
It may also be necessary to adjust the overall gain (-g) by trial and error.
The program tries to do something sensible about this, but it does not always
succeed.
.LP
The one problem with this program is that it takes an incredible
amount of memory, and impulse responses longer than 1.3 seconds at 48KHz may
have trouble running.  For a 16KHz sample rate, this translates to a 3.9
second maximum; but longer responses may work in either case.
For information about generating impulse responses which are useful as
synthetic room responses, see the helpfile for this program.
.SH AUTHOR
Mark Dolson

