Implement AL_EFFECT_REVERB
commit4caf2c7edd42bdbc5c1dd2e9084b4fae92c467a7
authorChris Robinson <chris.kcat@gmail.com>
Sat, 19 Jan 2008 05:25:40 +0000 (18 21:25 -0800)
committerChris Robinson <chris.kcat@gmail.com>
Sat, 19 Jan 2008 05:25:40 +0000 (18 21:25 -0800)
treef415e8f78920a17a67cd4f2d94cec548d298dcc2
parent1b9d740244de7b217c7d3382a7dc3f9bf4c7f403
Implement AL_EFFECT_REVERB
 Here is a quick description of how the reverb effect works:

 +--->---+*(4)
 |       V       new sample
 +-----+---+---+    |
 |extra|ltr|ref| <- +*(1)
 +-----+---+---+
   (3,5)*|   |*(2)
         +-->|
             V
         out sample

 1) Apply master reverb gain to incoming sample and place it at the head of the
    buffer. The master reverb gainhf was already applied when the source was
    initially mixed.
 2) Copy the delayed reflection sample to an output sample and apply the
    reflection gain.
 3) Apply the late reverb gain to the late reverb sample
 4) Copy the end of the buffer, applying a decay gain and the decay hf ratio,
    and add to the late reverb.
 5) Copy the late reverb sample, adding to the output sample.

 Then the head and sampling points are shifted forward, and done again for each
 new sample. The extra buffer length is determined by the Reverb Density
 property. A value of 0 gives a length of 0.1 seconds (long, with fairly
 distinct echos) , and 1 gives 0.075 seconds (short, indistinct echos).
 The decay gain is calculated such that after a number of loops to satisfy the
 Decay Time, a sample will be 1/32768th as powerful (virtually insignificant to
 the resulting output, and only getting further reduced). It is calculated as:

 DecayGain = pow(1.0f/32768.0f, 1.0/(DecayTime/ExtraLength));

 Things to note: Reverb Diffusion is not currently handled, nor is Decay HF
 Limit. Decay HF Ratios above 1 probably give incorrect results. Also, this
 method likely sucks, but it's the best I can come up with before release. :)
Alc/ALu.c
OpenAL32/Include/alAuxEffectSlot.h
OpenAL32/alAuxEffectSlot.c