/** * Ambisonic reverb engine for the OpenAL cross platform audio library * Copyright (C) 2008-2017 by Chris Robinson and Christopher Fitzgerald. * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Library General Public License for more details. * * You should have received a copy of the GNU Library General Public * License along with this library; if not, write to the * Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. * Or go to http://www.gnu.org/copyleft/lgpl.html */ #include "config.h" #include #include #include #include "alMain.h" #include "alu.h" #include "alAuxEffectSlot.h" #include "alEffect.h" #include "alFilter.h" #include "alError.h" #include "mixer_defs.h" /* This is the maximum number of samples processed for each inner loop * iteration. */ #define MAX_UPDATE_SAMPLES 256 /* The number of samples used for cross-faded delay lines. This can be used * to balance the compensation for abrupt line changes and attenuation due to * minimally lengthed recursive lines. Try to keep this below the device * update size. */ #define FADE_SAMPLES 128 #ifdef __GNUC__ #define UNEXPECTED(x) __builtin_expect((bool)(x), 0) #else #define UNEXPECTED(x) (x) #endif static MixerFunc MixSamples = Mix_C; static RowMixerFunc MixRowSamples = MixRow_C; static alonce_flag mixfunc_inited = AL_ONCE_FLAG_INIT; static void init_mixfunc(void) { MixSamples = SelectMixer(); MixRowSamples = SelectRowMixer(); } typedef struct DelayLine { /* The delay lines use sample lengths that are powers of 2 to allow the * use of bit-masking instead of a modulus for wrapping. */ ALsizei Mask; ALfloat *Line; } DelayLine; typedef struct Allpass { DelayLine Delay; ALsizei Offset[2]; } Allpass; typedef struct ALreverbState { DERIVE_FROM_TYPE(ALeffectState); ALboolean IsEax; /* All delay lines are allocated as a single buffer to reduce memory * fragmentation and management code. */ ALfloat *SampleBuffer; ALuint TotalSamples; /* Master effect filters */ struct { ALfilterState Lp; ALfilterState Hp; /* EAX only */ } Filter[4]; struct { /* Modulator delay lines. */ DelayLine Delay[4]; /* The vibrato time is tracked with an index over a modulus-wrapped * range (in samples). */ ALuint Index; ALuint Range; /* The depth of frequency change (also in samples) and its filter. */ ALfloat Depth; ALfloat Coeff; ALfloat Filter; } Mod; /* EAX only */ /* Core delay line (early reflections and late reverb tap from this). */ DelayLine Delay; /* Tap points for early reflection delay. */ ALsizei EarlyDelayTap[4][2]; ALfloat EarlyDelayCoeff[4]; /* Tap points for late reverb feed and delay. */ ALsizei LateFeedTap; ALsizei LateDelayTap[4][2]; /* The feed-back and feed-forward all-pass coefficient. */ ALfloat ApFeedCoeff; /* Coefficients for the all-pass and line scattering matrices. */ ALfloat MixX; ALfloat MixY; struct { /* A Gerzon vector all-pass filter is used to simulate initial * diffusion. The spread from this filter also helps smooth out the * reverb tail. */ Allpass Ap[4]; /* Echo lines are used to complete the second half of the early * reflections. */ DelayLine Delay[4]; ALsizei Offset[4][2]; ALfloat Coeff[4]; /* The gain for each output channel based on 3D panning. */ ALfloat CurrentGain[4][MAX_OUTPUT_CHANNELS]; ALfloat PanGain[4][MAX_OUTPUT_CHANNELS]; } Early; struct { /* Attenuation to compensate for the modal density and decay rate of * the late lines. */ ALfloat DensityGain; /* Recursive delay lines are used fill in the reverb tail. */ DelayLine Delay[4]; ALsizei Offset[4][2]; /* T60 decay filters are used to simulate absorption. */ struct { ALfloat LFCoeffs[3]; ALfloat HFCoeffs[3]; ALfloat MidCoeff; /* The LF and HF filters keep a state of the last input and last * output sample. */ ALfloat States[2][2]; } Filters[4]; /* A Gerzon vector all-pass filter is used to simulate diffusion. */ Allpass Ap[4]; /* The gain for each output channel based on 3D panning. */ ALfloat CurrentGain[4][MAX_OUTPUT_CHANNELS]; ALfloat PanGain[4][MAX_OUTPUT_CHANNELS]; } Late; /* Indicates the cross-fade point for delay line reads [0,FADE_SAMPLES]. */ ALsizei FadeCount; /* The current write offset for all delay lines. */ ALsizei Offset; /* Temporary storage used when processing. */ alignas(16) ALfloat AFormatSamples[4][MAX_UPDATE_SAMPLES]; alignas(16) ALfloat ReverbSamples[4][MAX_UPDATE_SAMPLES]; alignas(16) ALfloat EarlySamples[4][MAX_UPDATE_SAMPLES]; } ALreverbState; static ALvoid ALreverbState_Destruct(ALreverbState *State); static ALboolean ALreverbState_deviceUpdate(ALreverbState *State, ALCdevice *Device); static ALvoid ALreverbState_update(ALreverbState *State, const ALCdevice *Device, const ALeffectslot *Slot, const ALeffectProps *props); static ALvoid ALreverbState_process(ALreverbState *State, ALsizei SamplesToDo, const ALfloat (*restrict SamplesIn)[BUFFERSIZE], ALfloat (*restrict SamplesOut)[BUFFERSIZE], ALsizei NumChannels); DECLARE_DEFAULT_ALLOCATORS(ALreverbState) DEFINE_ALEFFECTSTATE_VTABLE(ALreverbState); static void ALreverbState_Construct(ALreverbState *state) { ALsizei i, j; ALeffectState_Construct(STATIC_CAST(ALeffectState, state)); SET_VTABLE2(ALreverbState, ALeffectState, state); state->IsEax = AL_FALSE; state->TotalSamples = 0; state->SampleBuffer = NULL; for(i = 0;i < 4;i++) { ALfilterState_clear(&state->Filter[i].Lp); ALfilterState_clear(&state->Filter[i].Hp); state->Mod.Delay[i].Mask = 0; state->Mod.Delay[i].Line = NULL; } state->Mod.Index = 0; state->Mod.Range = 1; state->Mod.Depth = 0.0f; state->Mod.Coeff = 0.0f; state->Mod.Filter = 0.0f; state->Delay.Mask = 0; state->Delay.Line = NULL; for(i = 0;i < 4;i++) { state->EarlyDelayTap[i][0] = 0; state->EarlyDelayTap[i][1] = 0; state->EarlyDelayCoeff[i] = 0.0f; } state->LateFeedTap = 0; for(i = 0;i < 4;i++) { state->LateDelayTap[i][0] = 0; state->LateDelayTap[i][1] = 0; } state->ApFeedCoeff = 0.0f; state->MixX = 0.0f; state->MixY = 0.0f; for(i = 0;i < 4;i++) { state->Early.Ap[i].Delay.Mask = 0; state->Early.Ap[i].Delay.Line = NULL; state->Early.Ap[i].Offset[0] = 0; state->Early.Ap[i].Offset[1] = 0; state->Early.Delay[i].Mask = 0; state->Early.Delay[i].Line = NULL; state->Early.Offset[i][0] = 0; state->Early.Offset[i][1] = 0; state->Early.Coeff[i] = 0.0f; } state->Late.DensityGain = 0.0f; for(i = 0;i < 4;i++) { state->Late.Ap[i].Delay.Mask = 0; state->Late.Ap[i].Delay.Line = NULL; state->Late.Ap[i].Offset[0] = 0; state->Late.Ap[i].Offset[1] = 0; state->Late.Delay[i].Mask = 0; state->Late.Delay[i].Line = NULL; state->Late.Offset[i][0] = 0; state->Late.Offset[i][1] = 0; for(j = 0;j < 3;j++) { state->Late.Filters[i].LFCoeffs[j] = 0.0f; state->Late.Filters[i].HFCoeffs[j] = 0.0f; } state->Late.Filters[i].MidCoeff = 0.0f; state->Late.Filters[i].States[0][0] = 0.0f; state->Late.Filters[i].States[0][1] = 0.0f; state->Late.Filters[i].States[1][0] = 0.0f; state->Late.Filters[i].States[1][1] = 0.0f; } for(i = 0;i < 4;i++) { for(j = 0;j < MAX_OUTPUT_CHANNELS;j++) { state->Early.CurrentGain[i][j] = 0.0f; state->Early.PanGain[i][j] = 0.0f; state->Late.CurrentGain[i][j] = 0.0f; state->Late.PanGain[i][j] = 0.0f; } } state->FadeCount = 0; state->Offset = 0; } static ALvoid ALreverbState_Destruct(ALreverbState *State) { al_free(State->SampleBuffer); State->SampleBuffer = NULL; ALeffectState_Destruct(STATIC_CAST(ALeffectState,State)); } /* The B-Format to A-Format conversion matrix. The arrangement of rows is * deliberately chosen to align the resulting lines to their spatial opposites * (0:above front left <-> 3:above back right, 1:below front right <-> 2:below * back left). It's not quite opposite, since the A-Format results in a * tetrahedron, but it's close enough. Should the model be extended to 8-lines * in the future, true opposites can be used. */ static const aluMatrixf B2A = {{ { 0.288675134595f, 0.288675134595f, 0.288675134595f, 0.288675134595f }, { 0.288675134595f, -0.288675134595f, -0.288675134595f, 0.288675134595f }, { 0.288675134595f, 0.288675134595f, -0.288675134595f, -0.288675134595f }, { 0.288675134595f, -0.288675134595f, 0.288675134595f, -0.288675134595f } }}; /* Converts A-Format to B-Format (transposed). */ static const aluMatrixf A2B = {{ { 0.8660254038f, 0.8660254038f, 0.8660254038f, 0.8660254038f }, { 0.8660254038f, -0.8660254038f, -0.8660254038f, 0.8660254038f }, { 0.8660254038f, 0.8660254038f, -0.8660254038f, -0.8660254038f }, { 0.8660254038f, -0.8660254038f, 0.8660254038f, -0.8660254038f } }}; static const ALfloat FadeStep = 1.0f / FADE_SAMPLES; /* This is a user config option for modifying the overall output of the reverb * effect. */ ALfloat ReverbBoost = 1.0f; /* Specifies whether to use a standard reverb effect in place of EAX reverb (no * high-pass, modulation, or echo). */ ALboolean EmulateEAXReverb = AL_FALSE; /* This coefficient is used to define the maximum frequency range controlled * by the modulation depth. The current value of 0.025 will allow it to * swing from 0.975x to 1.025x. This value must be below 1. At 1 it will * cause the sampler to stall on the downswing, and above 1 it will cause it * to sample backwards. */ static const ALfloat MODULATION_DEPTH_COEFF = 0.025f; /* A filter is used to avoid the terrible distortion caused by changing * modulation time and/or depth. To be consistent across different sample * rates, the coefficient must be raised to a constant divided by the sample * rate: coeff^(constant / rate). */ static const ALfloat MODULATION_FILTER_COEFF = 0.048f; static const ALfloat MODULATION_FILTER_CONST = 100000.0f; /* The all-pass and delay lines have a variable length dependent on the * effect's density parameter. The resulting density multiplier is: * * multiplier = 1 + (density * LINE_MULTIPLIER) * * Thus the line multiplier below will result in a maximum density multiplier * of 10. */ static const ALfloat LINE_MULTIPLIER = 9.0f; /* All delay line lengths are specified in seconds. * * To approximate early reflections, we break them up into primary (those * arriving from the same direction as the source) and secondary (those * arriving from the opposite direction). * * The early taps decorrelate the 4-channel signal to approximate an average * room response for the primary reflections after the initial early delay. * * Given an average room dimension (d_a) and the speed of sound (c) we can * calculate the average reflection delay (r_a) regardless of listener and * source positions as: * * r_a = d_a / c * c = 343.3 * * This can extended to finding the average difference (r_d) between the * maximum (r_1) and minimum (r_0) reflection delays: * * r_0 = 2 / 3 r_a * = r_a - r_d / 2 * = r_d * r_1 = 4 / 3 r_a * = r_a + r_d / 2 * = 2 r_d * r_d = 2 / 3 r_a * = r_1 - r_0 * * As can be determined by integrating the 1D model with a source (s) and * listener (l) positioned across the dimension of length (d_a): * * r_d = int_(l=0)^d_a (int_(s=0)^d_a |2 d_a - 2 (l + s)| ds) dl / c * * The initial taps (T_(i=0)^N) are then specified by taking a power series * that ranges between r_0 and half of r_1 less r_0: * * R_i = 2^(i / (2 N - 1)) r_d * = r_0 + (2^(i / (2 N - 1)) - 1) r_d * = r_0 + T_i * T_i = R_i - r_0 * = (2^(i / (2 N - 1)) - 1) r_d * * Assuming an average of 5m (up to 50m with the density multiplier), we get * the following taps: */ static const ALfloat EARLY_TAP_LENGTHS[4] = { 0.000000e+0f, 1.010676e-3f, 2.126553e-3f, 3.358580e-3f }; /* The early all-pass filter lengths are based on the early tap lengths: * * A_i = R_i / a * * Where a is the approximate maximum all-pass cycle limit (20). */ static const ALfloat EARLY_ALLPASS_LENGTHS[4] = { 4.854840e-4f, 5.360178e-4f, 5.918117e-4f, 6.534130e-4f }; /* The early delay lines are used to transform the primary reflections into * the secondary reflections. The A-format is arranged in such a way that * the channels/lines are spatially opposite: * * C_i is opposite C_(N-i-1) * * The delays of the two opposing reflections (R_i and O_i) from a source * anywhere along a particular dimension always sum to twice its full delay: * * 2 r_a = R_i + O_i * * With that in mind we can determine the delay between the two reflections * and thus specify our early line lengths (L_(i=0)^N) using: * * O_i = 2 r_a - R_(N-i-1) * L_i = O_i - R_(N-i-1) * = 2 (r_a - R_(N-i-1)) * = 2 (r_a - T_(N-i-1) - r_0) * = 2 r_a (1 - (2 / 3) 2^((N - i - 1) / (2 N - 1))) * * Using an average dimension of 5m, we get: */ static const ALfloat EARLY_LINE_LENGTHS[4] = { 2.992520e-3f, 5.456575e-3f, 7.688329e-3f, 9.709681e-3f }; /* The late all-pass filter lengths are based on the late line lengths: * * A_i = (5 / 3) L_i / r_1 */ static const ALfloat LATE_ALLPASS_LENGTHS[4] = { 8.091400e-4f, 1.019453e-3f, 1.407968e-3f, 1.618280e-3f }; /* The late lines are used to approximate the decaying cycle of recursive * late reflections. * * Splitting the lines in half, we start with the shortest reflection paths * (L_(i=0)^(N/2)): * * L_i = 2^(i / (N - 1)) r_d * * Then for the opposite (longest) reflection paths (L_(i=N/2)^N): * * L_i = 2 r_a - L_(i-N/2) * = 2 r_a - 2^((i - N / 2) / (N - 1)) r_d * * For our 5m average room, we get: */ static const ALfloat LATE_LINE_LENGTHS[4] = { 9.709681e-3f, 1.223343e-2f, 1.689561e-2f, 1.941936e-2f }; /* HACK: Workaround for a modff bug in 32-bit Windows, which attempts to write * a 64-bit double to the 32-bit float parameter. */ #if defined(_WIN32) && !defined (_M_X64) && !defined(_M_ARM) static inline float hack_modff(float x, float *y) { double di; double df = modf((double)x, &di); *y = (float)di; return (float)df; } #define modff hack_modff #endif /************************************** * Device Update * **************************************/ /* Given the allocated sample buffer, this function updates each delay line * offset. */ static inline ALvoid RealizeLineOffset(ALfloat *sampleBuffer, DelayLine *Delay) { Delay->Line = &sampleBuffer[(ptrdiff_t)Delay->Line]; } /* Calculate the length of a delay line and store its mask and offset. */ static ALuint CalcLineLength(const ALfloat length, const ptrdiff_t offset, const ALuint frequency, const ALuint extra, DelayLine *Delay) { ALuint samples; /* All line lengths are powers of 2, calculated from their lengths, with * an additional sample in case of rounding errors. */ samples = fastf2u(length*frequency) + extra; samples = NextPowerOf2(samples + 1); /* All lines share a single sample buffer. */ Delay->Mask = samples - 1; Delay->Line = (ALfloat*)offset; /* Return the sample count for accumulation. */ return samples; } /* Calculates the delay line metrics and allocates the shared sample buffer * for all lines given the sample rate (frequency). If an allocation failure * occurs, it returns AL_FALSE. */ static ALboolean AllocLines(const ALuint frequency, ALreverbState *State) { ALuint totalSamples, i; ALfloat multiplier, length; /* All delay line lengths are calculated to accomodate the full range of * lengths given their respective paramters. */ totalSamples = 0; /* The modulator's line length is calculated from the maximum modulation * time and depth coefficient, and halfed for the low-to-high frequency * swing. An additional sample is added to keep it stable when there is no * modulation. */ length = (AL_EAXREVERB_MAX_MODULATION_TIME*MODULATION_DEPTH_COEFF/2.0f); for(i = 0;i < 4;i++) totalSamples += CalcLineLength(length, totalSamples, frequency, 1, &State->Mod.Delay[i]); /* The main delay length includes the maximum early reflection delay, the * largest early tap width, the maximum late reverb delay, and the * largest late tap width. Finally, it must also be extended by the * update size (MAX_UPDATE_SAMPLES*4) for block processing. */ multiplier = 1.0f + LINE_MULTIPLIER; length = AL_EAXREVERB_MAX_REFLECTIONS_DELAY + EARLY_TAP_LENGTHS[3]*multiplier + AL_EAXREVERB_MAX_LATE_REVERB_DELAY + (LATE_LINE_LENGTHS[3] - LATE_LINE_LENGTHS[0])*0.25f*multiplier; /* Multiply length by 4, since we're storing 4 interleaved channels in the * main delay line. */ totalSamples += CalcLineLength(length*4, totalSamples, frequency, MAX_UPDATE_SAMPLES*4, &State->Delay); /* The early all-pass lines. */ for(i = 0;i < 4;i++) { length = EARLY_ALLPASS_LENGTHS[i] * multiplier; totalSamples += CalcLineLength(length, totalSamples, frequency, 0, &State->Early.Ap[i].Delay); } /* The early reflection lines. */ for(i = 0;i < 4;i++) { length = EARLY_LINE_LENGTHS[i] * multiplier; totalSamples += CalcLineLength(length, totalSamples, frequency, 0, &State->Early.Delay[i]); } /* The late vector all-pass lines. */ for(i = 0;i < 4;i++) { length = LATE_ALLPASS_LENGTHS[i] * multiplier; totalSamples += CalcLineLength(length, totalSamples, frequency, 0, &State->Late.Ap[i].Delay); } /* The late delay lines are calculated from the larger of the maximum * density line length or the maximum echo time. */ for(i = 0;i < 4;i++) { length = maxf(AL_EAXREVERB_MAX_ECHO_TIME, LATE_LINE_LENGTHS[i] * multiplier); totalSamples += CalcLineLength(length, totalSamples, frequency, 0, &State->Late.Delay[i]); } if(totalSamples != State->TotalSamples) { ALfloat *newBuffer; TRACE("New reverb buffer length: %u samples\n", totalSamples); newBuffer = al_calloc(16, sizeof(ALfloat) * totalSamples); if(!newBuffer) return AL_FALSE; al_free(State->SampleBuffer); State->SampleBuffer = newBuffer; State->TotalSamples = totalSamples; } /* Update all delays to reflect the new sample buffer. */ RealizeLineOffset(State->SampleBuffer, &State->Delay); for(i = 0;i < 4;i++) { RealizeLineOffset(State->SampleBuffer, &State->Mod.Delay[i]); RealizeLineOffset(State->SampleBuffer, &State->Early.Ap[i].Delay); RealizeLineOffset(State->SampleBuffer, &State->Early.Delay[i]); RealizeLineOffset(State->SampleBuffer, &State->Late.Ap[i].Delay); RealizeLineOffset(State->SampleBuffer, &State->Late.Delay[i]); } /* Clear the sample buffer. */ for(i = 0;i < State->TotalSamples;i++) State->SampleBuffer[i] = 0.0f; return AL_TRUE; } static ALboolean ALreverbState_deviceUpdate(ALreverbState *State, ALCdevice *Device) { ALuint frequency = Device->Frequency, i; ALfloat multiplier; /* Allocate the delay lines. */ if(!AllocLines(frequency, State)) return AL_FALSE; /* Calculate the modulation filter coefficient. Notice that the exponent * is calculated given the current sample rate. This ensures that the * resulting filter response over time is consistent across all sample * rates. */ State->Mod.Coeff = powf(MODULATION_FILTER_COEFF, MODULATION_FILTER_CONST / frequency); multiplier = 1.0f + LINE_MULTIPLIER; /* The late feed taps are set a fixed position past the latest delay tap. */ for(i = 0;i < 4;i++) State->LateFeedTap = fastf2u((AL_EAXREVERB_MAX_REFLECTIONS_DELAY + EARLY_TAP_LENGTHS[3]*multiplier) * frequency); return AL_TRUE; } /************************************** * Effect Update * **************************************/ /* Calculate a decay coefficient given the length of each cycle and the time * until the decay reaches -60 dB. */ static inline ALfloat CalcDecayCoeff(const ALfloat length, const ALfloat decayTime) { return powf(0.001f/*-60 dB*/, length/decayTime); } /* Calculate a decay length from a coefficient and the time until the decay * reaches -60 dB. */ static inline ALfloat CalcDecayLength(const ALfloat coeff, const ALfloat decayTime) { return log10f(coeff) * decayTime / log10f(0.001f)/*-60 dB*/; } /* Calculate an attenuation to be applied to the input of any echo models to * compensate for modal density and decay time. */ static inline ALfloat CalcDensityGain(const ALfloat a) { /* The energy of a signal can be obtained by finding the area under the * squared signal. This takes the form of Sum(x_n^2), where x is the * amplitude for the sample n. * * Decaying feedback matches exponential decay of the form Sum(a^n), * where a is the attenuation coefficient, and n is the sample. The area * under this decay curve can be calculated as: 1 / (1 - a). * * Modifying the above equation to find the area under the squared curve * (for energy) yields: 1 / (1 - a^2). Input attenuation can then be * calculated by inverting the square root of this approximation, * yielding: 1 / sqrt(1 / (1 - a^2)), simplified to: sqrt(1 - a^2). */ return sqrtf(1.0f - a*a); } /* Calculate the scattering matrix coefficients given a diffusion factor. */ static inline ALvoid CalcMatrixCoeffs(const ALfloat diffusion, ALfloat *x, ALfloat *y) { ALfloat n, t; /* The matrix is of order 4, so n is sqrt(4 - 1). */ n = sqrtf(3.0f); t = diffusion * atanf(n); /* Calculate the first mixing matrix coefficient. */ *x = cosf(t); /* Calculate the second mixing matrix coefficient. */ *y = sinf(t) / n; } /* Calculate the limited HF ratio for use with the late reverb low-pass * filters. */ static ALfloat CalcLimitedHfRatio(const ALfloat hfRatio, const ALfloat airAbsorptionGainHF, const ALfloat decayTime) { ALfloat limitRatio; /* Find the attenuation due to air absorption in dB (converting delay * time to meters using the speed of sound). Then reversing the decay * equation, solve for HF ratio. The delay length is cancelled out of * the equation, so it can be calculated once for all lines. */ limitRatio = 1.0f / (CalcDecayLength(airAbsorptionGainHF, decayTime) * SPEEDOFSOUNDMETRESPERSEC); /* Using the limit calculated above, apply the upper bound to the HF * ratio. Also need to limit the result to a minimum of 0.1, just like * the HF ratio parameter. */ return clampf(limitRatio, 0.1f, hfRatio); } /* Calculates the first-order high-pass coefficients following the I3DL2 * reference model. This is the transfer function: * * 1 - z^-1 * H(z) = p ------------ * 1 - p z^-1 * * And this is the I3DL2 coefficient calculation given gain (g) and reference * angular frequency (w): * * g * p = ------------------------------------------------------ * g cos(w) + sqrt((cos(w) - 1) (g^2 cos(w) + g^2 - 2)) * * The coefficient is applied to the partial differential filter equation as: * * c_0 = p * c_1 = -p * c_2 = p * y_i = c_0 x_i + c_1 x_(i-1) + c_2 y_(i-1) * */ static inline void CalcHighpassCoeffs(const ALfloat gain, const ALfloat w, ALfloat coeffs[3]) { ALfloat g, g2, cw, p; if(gain >= 1.0f) { coeffs[0] = 1.0f; coeffs[1] = 0.0f; coeffs[2] = 0.0f; return; } g = maxf(0.001f, gain); g2 = g * g; cw = cosf(w); p = g / (g*cw + sqrt((cw - 1.0f) * (g2*cw + g2 - 2.0f))); coeffs[0] = p; coeffs[1] = -p; coeffs[2] = p; } /* Calculates the first-order low-pass coefficients following the I3DL2 * reference model. This is the transfer function: * * (1 - a) z^0 * H(z) = ---------------- * 1 z^0 - a z^-1 * * And this is the I3DL2 coefficient calculation given gain (g) and reference * angular frequency (w): * * 1 - g^2 cos(w) - sqrt(2 g^2 (1 - cos(w)) - g^4 (1 - cos(w)^2)) * a = ---------------------------------------------------------------- * 1 - g^2 * * The coefficient is applied to the partial differential filter equation as: * * c_0 = 1 - a * c_1 = 0 * c_2 = a * y_i = c_0 x_i + c_1 x_(i-1) + c_2 y_(i-1) * */ static inline void CalcLowpassCoeffs(const ALfloat gain, const ALfloat w, ALfloat coeffs[3]) { ALfloat g, g2, cw, a; if(gain >= 1.0f) { coeffs[0] = 1.0f; coeffs[1] = 0.0f; coeffs[2] = 0.0f; return; } /* Be careful with gains < 0.001, as that causes the coefficient * to head towards 1, which will flatten the signal. */ g = maxf(0.001f, gain); g2 = g * g; cw = cosf(w); a = (1.0f - g2*cw - sqrtf((2.0f*g2*(1.0f - cw)) - g2*g2*(1.0f - cw*cw))) / (1.0f - g2); coeffs[0] = 1.0f - a; coeffs[1] = 0.0f; coeffs[2] = a; } /* Calculates the first-order low-shelf coefficients. The shelf filters are * used in place of low/high-pass filters to preserve the mid-band. This is * the transfer function: * * a_0 + a_1 z^-1 * H(z) = ---------------- * 1 + b_1 z^-1 * * And these are the coefficient calculations given cut gain (g) and a center * angular frequency (w): * * sin(0.5 (pi - w) - 0.25 pi) * p = ----------------------------- * sin(0.5 (pi - w) + 0.25 pi) * * g + 1 g + 1 * a = ------- + sqrt((-------)^2 - 1) * g - 1 g - 1 * * 1 + g + (1 - g) a * b_0 = ------------------- * 2 * * 1 - g + (1 + g) a * b_1 = ------------------- * 2 * * The coefficients are applied to the partial differential filter equation * as: * * b_0 + p b_1 * c_0 = ------------- * 1 + p a * * -(b_1 + p b_0) * c_1 = ---------------- * 1 + p a * * p + a * c_2 = --------- * 1 + p a * * y_i = c_0 x_i + c_1 x_(i-1) + c_2 y_(i-1) * */ static inline void CalcLowShelfCoeffs(const ALfloat gain, const ALfloat w, ALfloat coeffs[3]) { ALfloat g, rw, p, n; ALfloat alpha, beta0, beta1; if(gain >= 1.0f) { coeffs[0] = 1.0f; coeffs[1] = 0.0f; coeffs[2] = 0.0f; return; } g = maxf(0.001f, gain); rw = F_PI - w; p = sinf(0.5f*rw - 0.25f*F_PI) / sinf(0.5f*rw + 0.25f*F_PI); n = (g + 1.0f) / (g - 1.0f); alpha = n + sqrtf(n*n - 1.0f); beta0 = (1.0f + g + (1.0f - g)*alpha) / 2.0f; beta1 = (1.0f - g + (1.0f + g)*alpha) / 2.0f; coeffs[0] = (beta0 + p*beta1) / (1.0f + p*alpha); coeffs[1] = -(beta1 + p*beta0) / (1.0f + p*alpha); coeffs[2] = (p + alpha) / (1.0f + p*alpha); } /* Calculates the first-order high-shelf coefficients. The shelf filters are * used in place of low/high-pass filters to preserve the mid-band. This is * the transfer function: * * a_0 + a_1 z^-1 * H(z) = ---------------- * 1 + b_1 z^-1 * * And these are the coefficient calculations given cut gain (g) and a center * angular frequency (w): * * sin(0.5 w - 0.25 pi) * p = ---------------------- * sin(0.5 w + 0.25 pi) * * g + 1 g + 1 * a = ------- + sqrt((-------)^2 - 1) * g - 1 g - 1 * * 1 + g + (1 - g) a * b_0 = ------------------- * 2 * * 1 - g + (1 + g) a * b_1 = ------------------- * 2 * * The coefficients are applied to the partial differential filter equation * as: * * b_0 + p b_1 * c_0 = ------------- * 1 + p a * * b_1 + p b_0 * c_1 = ------------- * 1 + p a * * -(p + a) * c_2 = ---------- * 1 + p a * * y_i = c_0 x_i + c_1 x_(i-1) + c_2 y_(i-1) * */ static inline void CalcHighShelfCoeffs(const ALfloat gain, const ALfloat w, ALfloat coeffs[3]) { ALfloat g, p, n; ALfloat alpha, beta0, beta1; if(gain >= 1.0f) { coeffs[0] = 1.0f; coeffs[1] = 0.0f; coeffs[2] = 0.0f; return; } g = maxf(0.001f, gain); p = sinf(0.5f*w - 0.25f*F_PI) / sinf(0.5f*w + 0.25f*F_PI); n = (g + 1.0f) / (g - 1.0f); alpha = n + sqrtf(n*n - 1.0f); beta0 = (1.0f + g + (1.0f - g)*alpha) / 2.0f; beta1 = (1.0f - g + (1.0f + g)*alpha) / 2.0f; coeffs[0] = (beta0 + p*beta1) / (1.0f + p*alpha); coeffs[1] = (beta1 + p*beta0) / (1.0f + p*alpha); coeffs[2] = -(p + alpha) / (1.0f + p*alpha); } /* Calculates the 3-band T60 damping coefficients for a particular delay line * of specified length using a combination of two low/high-pass/shelf or * pass-through filter sections (producing 3 coefficients each) and a general * gain (7th coefficient) given decay times for each band split at two (LF/ * HF) reference frequencies (w). */ static void CalcT60DampingCoeffs(const ALfloat length, const ALfloat lfDecayTime, const ALfloat mfDecayTime, const ALfloat hfDecayTime, const ALfloat lfW, const ALfloat hfW, ALfloat lfcoeffs[3], ALfloat hfcoeffs[3], ALfloat *midcoeff) { ALfloat lfGain = CalcDecayCoeff(length, lfDecayTime); ALfloat mfGain = CalcDecayCoeff(length, mfDecayTime); ALfloat hfGain = CalcDecayCoeff(length, hfDecayTime); if(lfGain < mfGain) { if(mfGain < hfGain) { CalcLowShelfCoeffs(mfGain / hfGain, hfW, lfcoeffs); CalcHighpassCoeffs(lfGain / mfGain, lfW, hfcoeffs); *midcoeff = hfGain; } else if(mfGain > hfGain) { CalcHighpassCoeffs(lfGain / mfGain, lfW, lfcoeffs); CalcLowpassCoeffs(hfGain / mfGain, hfW, hfcoeffs); *midcoeff = mfGain; } else { lfcoeffs[0] = 1.0f; lfcoeffs[1] = 0.0f; lfcoeffs[2] = 0.0f; CalcHighpassCoeffs(lfGain / mfGain, lfW, hfcoeffs); *midcoeff = mfGain; } } else if(lfGain > mfGain) { if(mfGain < hfGain) { double hg = mfGain / lfGain; double lg = mfGain / hfGain; CalcHighShelfCoeffs(hg, lfW, lfcoeffs); CalcLowShelfCoeffs(lg, hfW, hfcoeffs); *midcoeff = maxf(lfGain, hfGain) / maxf(hg, lg); } else if(mfGain > hfGain) { CalcHighShelfCoeffs(mfGain / lfGain, lfW, lfcoeffs); CalcLowpassCoeffs(hfGain / mfGain, hfW, hfcoeffs); *midcoeff = lfGain; } else { lfcoeffs[0] = 1.0f; lfcoeffs[1] = 0.0f; lfcoeffs[2] = 0.0f; CalcHighShelfCoeffs(mfGain / lfGain, lfW, hfcoeffs); *midcoeff = lfGain; } } else { lfcoeffs[0] = 1.0f; lfcoeffs[1] = 0.0f; lfcoeffs[2] = 0.0f; if(mfGain < hfGain) { CalcLowShelfCoeffs(mfGain / hfGain, hfW, hfcoeffs); *midcoeff = hfGain; } else if(mfGain > hfGain) { CalcLowpassCoeffs(hfGain / mfGain, hfW, hfcoeffs); *midcoeff = mfGain; } else { hfcoeffs[3] = 1.0f; hfcoeffs[4] = 0.0f; hfcoeffs[5] = 0.0f; *midcoeff = mfGain; } } } /* Update the EAX modulation index, range, and depth. Keep in mind that this * kind of vibrato is additive and not multiplicative as one may expect. The * downswing will sound stronger than the upswing. */ static ALvoid UpdateModulator(const ALfloat modTime, const ALfloat modDepth, const ALuint frequency, ALreverbState *State) { ALuint range; /* Modulation is calculated in two parts. * * The modulation time effects the sinus applied to the change in * frequency. An index out of the current time range (both in samples) * is incremented each sample. The range is bound to a reasonable * minimum (1 sample) and when the timing changes, the index is rescaled * to the new range (to keep the sinus consistent). */ range = maxu(fastf2u(modTime*frequency), 1); State->Mod.Index = (ALuint)(State->Mod.Index * (ALuint64)range / State->Mod.Range); State->Mod.Range = range; /* The modulation depth effects the amount of frequency change over the * range of the sinus. It needs to be scaled by the modulation time so * that a given depth produces a consistent change in frequency over all * ranges of time. Since the depth is applied to a sinus value, it needs * to be halfed once for the sinus range and again for the sinus swing * in time (half of it is spent decreasing the frequency, half is spent * increasing it). */ State->Mod.Depth = modDepth * MODULATION_DEPTH_COEFF * modTime / 2.0f / 2.0f * frequency; } /* Update the offsets for the main effect delay line. */ static ALvoid UpdateDelayLine(const ALfloat earlyDelay, const ALfloat lateDelay, const ALfloat density, const ALfloat decayTime, const ALuint frequency, ALreverbState *State) { ALfloat multiplier, length; ALuint i; multiplier = 1.0f + density*LINE_MULTIPLIER; /* Early reflection taps are decorrelated by means of an average room * reflection approximation described above the definition of the taps. * This approximation is linear and so the above density multiplier can * be applied to adjust the width of the taps. A single-band decay * coefficient is applied to simulate initial attenuation and absorption. * * Late reverb taps are based on the late line lengths to allow a zero- * delay path and offsets that would continue the propagation naturally * into the late lines. */ for(i = 0;i < 4;i++) { length = earlyDelay + EARLY_TAP_LENGTHS[i]*multiplier; State->EarlyDelayTap[i][1] = fastf2u(length * frequency); length = EARLY_TAP_LENGTHS[i]*multiplier; State->EarlyDelayCoeff[i] = CalcDecayCoeff(length, decayTime); length = lateDelay + (LATE_LINE_LENGTHS[i] - LATE_LINE_LENGTHS[0])*0.25f*multiplier; State->LateDelayTap[i][1] = State->LateFeedTap + fastf2u(length * frequency); } } /* Update the early reflection line lengths and gain coefficients. */ static ALvoid UpdateEarlyLines(const ALfloat density, const ALfloat decayTime, const ALuint frequency, ALreverbState *State) { ALfloat multiplier, length; ALsizei i; multiplier = 1.0f + density*LINE_MULTIPLIER; for(i = 0;i < 4;i++) { /* Calculate the length (in seconds) of each all-pass line. */ length = EARLY_ALLPASS_LENGTHS[i] * multiplier; /* Calculate the delay offset for each all-pass line. */ State->Early.Ap[i].Offset[1] = fastf2u(length * frequency); /* Calculate the length (in seconds) of each delay line. */ length = EARLY_LINE_LENGTHS[i] * multiplier; /* Calculate the delay offset for each delay line. */ State->Early.Offset[i][1] = fastf2u(length * frequency); /* Calculate the gain (coefficient) for each line. */ State->Early.Coeff[i] = CalcDecayCoeff(length, decayTime); } } /* Update the late reverb line lengths and T60 coefficients. */ static ALvoid UpdateLateLines(const ALfloat density, const ALfloat diffusion, const ALfloat lfDecayTime, const ALfloat mfDecayTime, const ALfloat hfDecayTime, const ALfloat lfW, const ALfloat hfW, const ALfloat echoTime, const ALfloat echoDepth, const ALuint frequency, ALreverbState *State) { ALfloat multiplier, length, bandWeights[3]; ALsizei i; /* To compensate for changes in modal density and decay time of the late * reverb signal, the input is attenuated based on the maximal energy of * the outgoing signal. This approximation is used to keep the apparent * energy of the signal equal for all ranges of density and decay time. * * The average length of the delay lines is used to calculate the * attenuation coefficient. */ multiplier = 1.0f + density*LINE_MULTIPLIER; length = (LATE_LINE_LENGTHS[0] + LATE_LINE_LENGTHS[1] + LATE_LINE_LENGTHS[2] + LATE_LINE_LENGTHS[3]) / 4.0f * multiplier; /* Include the echo transformation (see below). */ length = lerp(length, echoTime, echoDepth); length += (LATE_ALLPASS_LENGTHS[0] + LATE_ALLPASS_LENGTHS[1] + LATE_ALLPASS_LENGTHS[2] + LATE_ALLPASS_LENGTHS[3]) / 4.0f * multiplier; /* The density gain calculation uses an average decay time weighted by * approximate bandwidth. This attempts to compensate for losses of * energy that reduce decay time due to scattering into highly attenuated * bands. */ bandWeights[0] = lfW; bandWeights[1] = hfW - lfW; bandWeights[2] = F_TAU - hfW; State->Late.DensityGain = CalcDensityGain( CalcDecayCoeff(length, (bandWeights[0]*lfDecayTime + bandWeights[1]*mfDecayTime + bandWeights[2]*hfDecayTime) / F_TAU) ); for(i = 0;i < 4;i++) { /* Calculate the length (in seconds) of each all-pass line. */ length = LATE_ALLPASS_LENGTHS[i] * multiplier; /* Calculate the delay offset for each all-pass line. */ State->Late.Ap[i].Offset[1] = fastf2u(length * frequency); /* Calculate the length (in seconds) of each delay line. This also * applies the echo transformation. As the EAX echo depth approaches * 1, the line lengths approach a length equal to the echoTime. This * helps to produce distinct echoes along the tail. */ length = lerp(LATE_LINE_LENGTHS[i] * multiplier, echoTime, echoDepth); /* Calculate the delay offset for each delay line. */ State->Late.Offset[i][1] = fastf2u(length * frequency); /* Approximate the absorption that the vector all-pass would exhibit * given the current diffusion so we don't have to process a full T60 * filter for each of its four lines. */ length += lerp(LATE_ALLPASS_LENGTHS[i], (LATE_ALLPASS_LENGTHS[0] + LATE_ALLPASS_LENGTHS[1] + LATE_ALLPASS_LENGTHS[2] + LATE_ALLPASS_LENGTHS[3]) / 4.0f, diffusion) * multiplier; /* Calculate the T60 damping coefficients for each line. */ CalcT60DampingCoeffs(length, lfDecayTime, mfDecayTime, hfDecayTime, lfW, hfW, State->Late.Filters[i].LFCoeffs, State->Late.Filters[i].HFCoeffs, &State->Late.Filters[i].MidCoeff); } } /* Creates a transform matrix given a reverb vector. This works by creating a * Z-focus transform, then a rotate transform around X, then Y, to place the * focal point in the direction of the vector, using the vector length as a * focus strength. * * This isn't technically correct since the vector is supposed to define the * aperture and not rotate the perceived soundfield, but in practice it's * probably good enough. */ static aluMatrixf GetTransformFromVector(const ALfloat *vec) { aluMatrixf zfocus, xrot, yrot; aluMatrixf tmp1, tmp2; ALfloat length; ALfloat sa, a; length = sqrtf(vec[0]*vec[0] + vec[1]*vec[1] + vec[2]*vec[2]); /* Define a Z-focus (X in Ambisonics) transform, given the panning vector * length. */ sa = sinf(minf(length, 1.0f) * (F_PI/4.0f)); aluMatrixfSet(&zfocus, 1.0f/(1.0f+sa), 0.0f, 0.0f, (sa/(1.0f+sa))/1.732050808f, 0.0f, sqrtf((1.0f-sa)/(1.0f+sa)), 0.0f, 0.0f, 0.0f, 0.0f, sqrtf((1.0f-sa)/(1.0f+sa)), 0.0f, (sa/(1.0f+sa))*1.732050808f, 0.0f, 0.0f, 1.0f/(1.0f+sa) ); /* Define rotation around X (Y in Ambisonics) */ a = atan2f(vec[1], sqrtf(vec[0]*vec[0] + vec[2]*vec[2])); aluMatrixfSet(&xrot, 1.0f, 0.0f, 0.0f, 0.0f, 0.0f, 1.0f, 0.0f, 0.0f, 0.0f, 0.0f, cosf(a), sinf(a), 0.0f, 0.0f, -sinf(a), cosf(a) ); /* Define rotation around Y (Z in Ambisonics). NOTE: EFX's reverb vectors * use a right-handled coordinate system, compared to the rest of OpenAL * which uses left-handed. This is fixed by negating Z, however it would * need to also be negated to get a proper Ambisonics angle, thus * cancelling it out. */ a = atan2f(-vec[0], vec[2]); aluMatrixfSet(&yrot, 1.0f, 0.0f, 0.0f, 0.0f, 0.0f, cosf(a), 0.0f, sinf(a), 0.0f, 0.0f, 1.0f, 0.0f, 0.0f, -sinf(a), 0.0f, cosf(a) ); #define MATRIX_MULT(_res, _m1, _m2) do { \ int row, col; \ for(col = 0;col < 4;col++) \ { \ for(row = 0;row < 4;row++) \ _res.m[row][col] = _m1.m[row][0]*_m2.m[0][col] + _m1.m[row][1]*_m2.m[1][col] + \ _m1.m[row][2]*_m2.m[2][col] + _m1.m[row][3]*_m2.m[3][col]; \ } \ } while(0) /* Define a matrix that first focuses on Z, then rotates around X then Y to * focus the output in the direction of the vector. */ MATRIX_MULT(tmp1, xrot, zfocus); MATRIX_MULT(tmp2, yrot, tmp1); #undef MATRIX_MULT return tmp2; } /* Update the early and late 3D panning gains. */ static ALvoid Update3DPanning(const ALCdevice *Device, const ALfloat *ReflectionsPan, const ALfloat *LateReverbPan, const ALfloat gain, const ALfloat earlyGain, const ALfloat lateGain, ALreverbState *State) { aluMatrixf transform, rot; ALsizei i; STATIC_CAST(ALeffectState,State)->OutBuffer = Device->FOAOut.Buffer; STATIC_CAST(ALeffectState,State)->OutChannels = Device->FOAOut.NumChannels; /* Note: Both _m2 and _res are transposed. */ #define MATRIX_MULT(_res, _m1, _m2) do { \ int row, col; \ for(col = 0;col < 4;col++) \ { \ for(row = 0;row < 4;row++) \ _res.m[col][row] = _m1.m[row][0]*_m2.m[col][0] + _m1.m[row][1]*_m2.m[col][1] + \ _m1.m[row][2]*_m2.m[col][2] + _m1.m[row][3]*_m2.m[col][3]; \ } \ } while(0) /* Create a matrix that first converts A-Format to B-Format, then rotates * the B-Format soundfield according to the panning vector. */ rot = GetTransformFromVector(ReflectionsPan); MATRIX_MULT(transform, rot, A2B); memset(&State->Early.PanGain, 0, sizeof(State->Early.PanGain)); for(i = 0;i < MAX_EFFECT_CHANNELS;i++) ComputeFirstOrderGains(Device->FOAOut, transform.m[i], gain*earlyGain, State->Early.PanGain[i]); rot = GetTransformFromVector(LateReverbPan); MATRIX_MULT(transform, rot, A2B); memset(&State->Late.PanGain, 0, sizeof(State->Late.PanGain)); for(i = 0;i < MAX_EFFECT_CHANNELS;i++) ComputeFirstOrderGains(Device->FOAOut, transform.m[i], gain*lateGain, State->Late.PanGain[i]); #undef MATRIX_MULT } static ALvoid ALreverbState_update(ALreverbState *State, const ALCdevice *Device, const ALeffectslot *Slot, const ALeffectProps *props) { ALuint frequency = Device->Frequency; ALfloat lfScale, hfScale, hfRatio; ALfloat lfDecayTime, hfDecayTime; ALfloat gain, gainlf, gainhf; ALsizei i; if(Slot->Params.EffectType == AL_EFFECT_EAXREVERB && !EmulateEAXReverb) State->IsEax = AL_TRUE; else if(Slot->Params.EffectType == AL_EFFECT_REVERB || EmulateEAXReverb) State->IsEax = AL_FALSE; /* Calculate the master filters */ hfScale = props->Reverb.HFReference / frequency; /* Restrict the filter gains from going below -40dB to keep the I3DL2 * model from killing most of the signal. */ gainhf = maxf(props->Reverb.GainHF, 0.01f); ALfilterState_setParams(&State->Filter[0].Lp, ALfilterType_HighShelf, gainhf, hfScale, calc_rcpQ_from_slope(gainhf, 1.0f)); lfScale = props->Reverb.LFReference / frequency; gainlf = maxf(props->Reverb.GainLF, 0.01f); ALfilterState_setParams(&State->Filter[0].Hp, ALfilterType_LowShelf, gainlf, lfScale, calc_rcpQ_from_slope(gainlf, 1.0f)); for(i = 1;i < 4;i++) { State->Filter[i].Lp.b0 = State->Filter[0].Lp.b0; State->Filter[i].Lp.b1 = State->Filter[0].Lp.b1; State->Filter[i].Lp.b2 = State->Filter[0].Lp.b2; State->Filter[i].Lp.a1 = State->Filter[0].Lp.a1; State->Filter[i].Lp.a2 = State->Filter[0].Lp.a2; State->Filter[i].Hp.b0 = State->Filter[0].Hp.b0; State->Filter[i].Hp.b1 = State->Filter[0].Hp.b1; State->Filter[i].Hp.b2 = State->Filter[0].Hp.b2; State->Filter[i].Hp.a1 = State->Filter[0].Hp.a1; State->Filter[i].Hp.a2 = State->Filter[0].Hp.a2; } /* Update the modulator line. */ UpdateModulator(props->Reverb.ModulationTime, props->Reverb.ModulationDepth, frequency, State); /* Update the main effect delay and associated taps. */ UpdateDelayLine(props->Reverb.ReflectionsDelay, props->Reverb.LateReverbDelay, props->Reverb.Density, props->Reverb.DecayTime, frequency, State); /* Calculate the all-pass feed-back/forward coefficient. */ State->ApFeedCoeff = sqrtf(0.5f) * powf(props->Reverb.Diffusion, 2.0f); /* Update the early lines. */ UpdateEarlyLines(props->Reverb.Density, props->Reverb.DecayTime, frequency, State); /* Get the mixing matrix coefficients. */ CalcMatrixCoeffs(props->Reverb.Diffusion, &State->MixX, &State->MixY); /* If the HF limit parameter is flagged, calculate an appropriate limit * based on the air absorption parameter. */ hfRatio = props->Reverb.DecayHFRatio; if(props->Reverb.DecayHFLimit && props->Reverb.AirAbsorptionGainHF < 1.0f) hfRatio = CalcLimitedHfRatio(hfRatio, props->Reverb.AirAbsorptionGainHF, props->Reverb.DecayTime); /* Calculate the LF/HF decay times. */ lfDecayTime = clampf(props->Reverb.DecayTime * props->Reverb.DecayLFRatio, AL_EAXREVERB_MIN_DECAY_TIME, AL_EAXREVERB_MAX_DECAY_TIME); hfDecayTime = clampf(props->Reverb.DecayTime * hfRatio, AL_EAXREVERB_MIN_DECAY_TIME, AL_EAXREVERB_MAX_DECAY_TIME); /* Update the late lines. */ UpdateLateLines(props->Reverb.Density, props->Reverb.Diffusion, lfDecayTime, props->Reverb.DecayTime, hfDecayTime, F_TAU * lfScale, F_TAU * hfScale, props->Reverb.EchoTime, props->Reverb.EchoDepth, frequency, State); /* Update early and late 3D panning. */ gain = props->Reverb.Gain * Slot->Params.Gain * ReverbBoost; Update3DPanning(Device, props->Reverb.ReflectionsPan, props->Reverb.LateReverbPan, gain, props->Reverb.ReflectionsGain, props->Reverb.LateReverbGain, State); /* Determine if delay-line cross-fading is required. */ for(i = 0;i < 4;i++) { if((State->EarlyDelayTap[i][1] != State->EarlyDelayTap[i][0]) || (State->Early.Ap[i].Offset[1] != State->Early.Ap[i].Offset[0]) || (State->Early.Offset[i][1] != State->Early.Offset[i][0]) || (State->LateDelayTap[i][1] != State->LateDelayTap[i][0]) || (State->Late.Ap[i].Offset[1] != State->Late.Ap[i].Offset[0]) || (State->Late.Offset[i][1] != State->Late.Offset[i][0])) { State->FadeCount = 0; break; } } } /************************************** * Effect Processing * **************************************/ /* Basic delay line input/output routines. */ static inline ALfloat DelayLineOut(DelayLine *Delay, const ALsizei offset) { return Delay->Line[offset&Delay->Mask]; } /* Cross-faded delay line output routine. Instead of interpolating the * offsets, this interpolates (cross-fades) the outputs at each offset. */ static inline ALfloat FadedDelayLineOut(DelayLine *Delay, const ALsizei off0, const ALsizei off1, const ALfloat mu) { return lerp(Delay->Line[off0&Delay->Mask], Delay->Line[off1&Delay->Mask], mu); } #define DELAY_OUT_Faded(d, o0, o1, mu) FadedDelayLineOut(d, o0, o1, mu) #define DELAY_OUT_Unfaded(d, o0, o1, mu) DelayLineOut(d, o0) static inline ALvoid DelayLineIn(DelayLine *Delay, const ALsizei offset, const ALfloat in) { Delay->Line[offset&Delay->Mask] = in; } static inline ALfloat DelayLineInOut(DelayLine *Delay, const ALsizei offset, const ALsizei outoffset, const ALfloat in) { Delay->Line[offset&Delay->Mask] = in; return Delay->Line[(offset-outoffset)&Delay->Mask]; } static void CalcModulationDelays(ALreverbState *State, ALfloat *restrict delays, const ALsizei todo) { ALfloat sinus, range; ALsizei index, i; index = State->Mod.Index; range = State->Mod.Filter; for(i = 0;i < todo;i++) { /* Calculate the sinus rhythm (dependent on modulation time and the * sampling rate). The center of the sinus is moved to reduce the * delay of the effect when the time or depth are low. */ sinus = 1.0f - cosf(F_TAU * index / State->Mod.Range); /* Step the modulation index forward, keeping it bound to its range. */ index = (index+1) % State->Mod.Range; /* The depth determines the range over which to read the input samples * from, so it must be filtered to reduce the distortion caused by even * small parameter changes. */ range = lerp(range, State->Mod.Depth, State->Mod.Coeff); /* Calculate the read offset with fraction. */ delays[i] = range*sinus; } State->Mod.Index = index; State->Mod.Filter = range; } /* Given some input samples, this function produces modulation for the late * reverb. */ static void EAXModulation(DelayLine *ModDelay, ALsizei offset, const ALfloat *restrict delays, ALfloat*restrict dst, const ALfloat*restrict src, const ALsizei todo) { ALfloat frac, fdelay; ALfloat out0, out1; ALsizei delay, i; for(i = 0;i < todo;i++) { /* Separate the integer offset and fraction between it and the next * sample. */ frac = modff(delays[i], &fdelay); delay = fastf2u(fdelay); /* Add the incoming sample to the delay line, and get the two samples * crossed by the offset delay. */ out0 = DelayLineInOut(ModDelay, offset, delay, src[i]); out1 = DelayLineOut(ModDelay, offset - delay - 1); offset++; /* The output is obtained by linearly interpolating the two samples * that were acquired above. */ dst[i] = lerp(out0, out1, frac); } } /* Applies a scattering matrix to the 4-line (vector) input. This is used * for both the below vector all-pass model and to perform modal feed-back * delay network (FDN) mixing. * * The matrix is derived from a skew-symmetric matrix to form a 4D rotation * matrix with a single unitary rotational parameter: * * [ d, a, b, c ] 1 = a^2 + b^2 + c^2 + d^2 * [ -a, d, c, -b ] * [ -b, -c, d, a ] * [ -c, b, -a, d ] * * The rotation is constructed from the effect's diffusion parameter, * yielding: * * 1 = x^2 + 3 y^2 * * Where a, b, and c are the coefficient y with differing signs, and d is the * coefficient x. The final matrix is thus: * * [ x, y, -y, y ] n = sqrt(matrix_order - 1) * [ -y, x, y, y ] t = diffusion_parameter * atan(n) * [ y, -y, x, y ] x = cos(t) * [ -y, -y, -y, x ] y = sin(t) / n * * Any square orthogonal matrix with an order that is a power of two will * work (where ^T is transpose, ^-1 is inverse): * * M^T = M^-1 * * Using that knowledge, finding an appropriate matrix can be accomplished * naively by searching all combinations of: * * M = D + S - S^T * * Where D is a diagonal matrix (of x), and S is a triangular matrix (of y) * whose combination of signs are being iterated. */ static inline void VectorPartialScatter(ALfloat *restrict vec, const ALfloat xCoeff, const ALfloat yCoeff) { const ALfloat f[4] = { vec[0], vec[1], vec[2], vec[3] }; vec[0] = xCoeff*f[0] + yCoeff*( f[1] + -f[2] + f[3]); vec[1] = xCoeff*f[1] + yCoeff*(-f[0] + f[2] + f[3]); vec[2] = xCoeff*f[2] + yCoeff*( f[0] + -f[1] + f[3]); vec[3] = xCoeff*f[3] + yCoeff*(-f[0] + -f[1] + -f[2] ); } /* This applies a Gerzon multiple-in/multiple-out (MIMO) vector all-pass * filter to the 4-line input. * * It works by vectorizing a regular all-pass filter and replacing the delay * element with a scattering matrix (like the one above) and a diagonal * matrix of delay elements. * * Two static specializations are used for transitional (cross-faded) delay * line processing and non-transitional processing. */ #define DECL_TEMPLATE(T) \ static void VectorAllpass_##T(ALfloat *restrict vec, const ALsizei offset, \ const ALfloat feedCoeff, const ALfloat xCoeff, \ const ALfloat yCoeff, const ALfloat mu, \ Allpass Ap[4]) \ { \ ALfloat input; \ ALfloat f[4]; \ ALsizei i; \ \ (void)mu; /* Ignore for Unfaded. */ \ \ for(i = 0;i < 4;i++) \ { \ input = vec[i]; \ vec[i] = DELAY_OUT_##T(&Ap[i].Delay, offset-Ap[i].Offset[0], \ offset-Ap[i].Offset[1], mu) - \ feedCoeff*input; \ f[i] = input + feedCoeff*vec[i]; \ } \ \ VectorPartialScatter(f, xCoeff, yCoeff); \ \ for(i = 0;i < 4;i++) \ DelayLineIn(&Ap[i].Delay, offset, f[i]); \ } DECL_TEMPLATE(Unfaded) DECL_TEMPLATE(Faded) #undef DECL_TEMPLATE /* A helper to reverse vector components. */ static inline void VectorReverse(ALfloat vec[4]) { const ALfloat f[4] = { vec[0], vec[1], vec[2], vec[3] }; vec[0] = f[3]; vec[1] = f[2]; vec[2] = f[1]; vec[3] = f[0]; } /* This generates early reflections. * * This is done by obtaining the primary reflections (those arriving from the * same direction as the source) from the main delay line. These are * attenuated and all-pass filtered (based on the diffusion parameter). * * The early lines are then fed in reverse (according to the approximately * opposite spatial location of the A-Format lines) to create the secondary * reflections (those arriving from the opposite direction as the source). * * The early response is then completed by combining the primary reflections * with the delayed and attenuated output from the early lines. * * Finally, the early response is reversed, scattered (based on diffusion), * and fed into the late reverb section of the main delay line. * * Two static specializations are used for transitional (cross-faded) delay * line processing and non-transitional processing. */ #define DECL_TEMPLATE(T) \ static ALvoid EarlyReflection_##T(ALreverbState *State, const ALsizei todo, \ ALfloat fade, \ ALfloat (*restrict out)[MAX_UPDATE_SAMPLES])\ { \ ALsizei offset = State->Offset; \ const ALfloat apFeedCoeff = State->ApFeedCoeff; \ const ALfloat mixX = State->MixX; \ const ALfloat mixY = State->MixY; \ ALfloat f[4]; \ ALsizei i, j; \ \ for(i = 0;i < todo;i++) \ { \ for(j = 0;j < 4;j++) \ f[j] = DELAY_OUT_##T(&State->Delay, \ (offset-State->EarlyDelayTap[j][0])*4 + j, \ (offset-State->EarlyDelayTap[j][1])*4 + j, fade \ ) * State->EarlyDelayCoeff[j]; \ \ VectorAllpass_##T(f, offset, apFeedCoeff, mixX, mixY, fade, \ State->Early.Ap); \ \ for(j = 0;j < 4;j++) \ DelayLineIn(&State->Early.Delay[j], offset, f[3 - j]); \ \ for(j = 0;j < 4;j++) \ f[j] += DELAY_OUT_##T(&State->Early.Delay[j], \ offset-State->Early.Offset[j][0], \ offset-State->Early.Offset[j][1], fade) * \ State->Early.Coeff[j]; \ \ for(j = 0;j < 4;j++) \ out[j][i] = f[j]; \ \ VectorReverse(f); \ \ VectorPartialScatter(f, mixX, mixY); \ \ for(j = 0;j < 4;j++) \ DelayLineIn(&State->Delay, (offset-State->LateFeedTap)*4 + j, \ f[j]); \ \ offset++; \ fade += FadeStep; \ } \ } DECL_TEMPLATE(Unfaded) DECL_TEMPLATE(Faded) #undef DECL_TEMPLATE /* Applies a first order filter section. */ static inline ALfloat FirstOrderFilter(const ALfloat in, const ALfloat coeffs[3], ALfloat state[2]) { ALfloat out = coeffs[0]*in + coeffs[1]*state[0] + coeffs[2]*state[1]; state[0] = in; state[1] = out; return out; } /* Applies the two T60 damping filter sections. */ static inline ALfloat LateT60Filter(const ALsizei index, const ALfloat in, ALreverbState *State) { ALfloat out = FirstOrderFilter(in, State->Late.Filters[index].LFCoeffs, State->Late.Filters[index].States[0]); return State->Late.Filters[index].MidCoeff * FirstOrderFilter(out, State->Late.Filters[index].HFCoeffs, State->Late.Filters[index].States[1]); } /* This generates the reverb tail using a modified feed-back delay network * (FDN). * * Results from the early reflections are attenuated by the density gain and * mixed with the output from the late delay lines. * * The late response is then completed by T60 and all-pass filtering the mix. * * Finally, the lines are reversed (so they feed their opposite directions) * and scattered with the FDN matrix before re-feeding the delay lines. * * Two static specializations are used for transitional (cross-faded) delay * line processing and non-transitional processing. */ #define DECL_TEMPLATE(T) \ static ALvoid LateReverb_##T(ALreverbState *State, const ALsizei todo, \ ALfloat fade, \ ALfloat (*restrict out)[MAX_UPDATE_SAMPLES]) \ { \ const ALfloat apFeedCoeff = State->ApFeedCoeff; \ const ALfloat mixX = State->MixX; \ const ALfloat mixY = State->MixY; \ ALsizei offset; \ ALsizei i, j; \ ALfloat f[4]; \ \ offset = State->Offset; \ for(i = 0;i < todo;i++) \ { \ for(j = 0;j < 4;j++) \ f[j] = DELAY_OUT_##T(&State->Delay, \ (offset-State->LateDelayTap[j][0])*4 + j, \ (offset-State->LateDelayTap[j][1])*4 + j, fade \ ) * State->Late.DensityGain; \ \ for(j = 0;j < 4;j++) \ f[j] += DELAY_OUT_##T(&State->Late.Delay[j], \ offset-State->Late.Offset[j][0], \ offset-State->Late.Offset[j][1], fade); \ \ for(j = 0;j < 4;j++) \ f[j] = LateT60Filter(j, f[j], State); \ \ VectorAllpass_##T(f, offset, apFeedCoeff, mixX, mixY, fade, \ State->Late.Ap); \ \ for(j = 0;j < 4;j++) \ out[j][i] = f[j]; \ \ VectorReverse(f); \ \ VectorPartialScatter(f, mixX, mixY); \ \ for(j = 0;j < 4;j++) \ DelayLineIn(&State->Late.Delay[j], offset, f[j]); \ \ offset++; \ fade += FadeStep; \ } \ } DECL_TEMPLATE(Unfaded) DECL_TEMPLATE(Faded) #undef DECL_TEMPLATE typedef ALfloat (*ProcMethodType)(ALreverbState *State, const ALsizei todo, ALfloat fade, const ALfloat (*restrict input)[MAX_UPDATE_SAMPLES], ALfloat (*restrict early)[MAX_UPDATE_SAMPLES], ALfloat (*restrict late)[MAX_UPDATE_SAMPLES]); /* Perform the non-EAX reverb pass on a given input sample, resulting in * four-channel output. */ static ALfloat VerbPass(ALreverbState *State, const ALsizei todo, ALfloat fade, const ALfloat (*restrict input)[MAX_UPDATE_SAMPLES], ALfloat (*restrict early)[MAX_UPDATE_SAMPLES], ALfloat (*restrict late)[MAX_UPDATE_SAMPLES]) { ALsizei i, c; for(c = 0;c < 4;c++) { /* Low-pass filter the incoming samples (use the early buffer as temp * storage). */ ALfilterState_process(&State->Filter[c].Lp, &early[0][0], input[c], todo); /* Feed the initial delay line. */ for(i = 0;i < todo;i++) DelayLineIn(&State->Delay, (State->Offset+i)*4 + c, early[0][i]); } if(fade < 1.0f) { /* Generate early reflections. */ EarlyReflection_Faded(State, todo, fade, early); /* Generate late reverb. */ LateReverb_Faded(State, todo, fade, late); fade = minf(1.0f, fade + todo*FadeStep); } else { /* Generate early reflections. */ EarlyReflection_Unfaded(State, todo, fade, early); /* Generate late reverb. */ LateReverb_Unfaded(State, todo, fade, late); } /* Step all delays forward one sample. */ State->Offset += todo; return fade; } /* Perform the EAX reverb pass on a given input sample, resulting in four- * channel output. */ static ALfloat EAXVerbPass(ALreverbState *State, const ALsizei todo, ALfloat fade, const ALfloat (*restrict input)[MAX_UPDATE_SAMPLES], ALfloat (*restrict early)[MAX_UPDATE_SAMPLES], ALfloat (*restrict late)[MAX_UPDATE_SAMPLES]) { ALsizei i, c; /* Perform any modulation on the input (use the early and late buffers as * temp storage). */ CalcModulationDelays(State, &late[0][0], todo); for(c = 0;c < 4;c++) { /* Apply modulation. */ EAXModulation(&State->Mod.Delay[c], State->Offset, &late[0][0], &early[0][0], input[c], todo); /* Band-pass the incoming samples. */ ALfilterState_process(&State->Filter[c].Lp, &early[1][0], &early[0][0], todo); ALfilterState_process(&State->Filter[c].Hp, &early[2][0], &early[1][0], todo); /* Feed the initial delay line. */ for(i = 0;i < todo;i++) DelayLineIn(&State->Delay, (State->Offset+i)*4 + c, early[2][i]); } if(fade < 1.0f) { /* Generate early reflections. */ EarlyReflection_Faded(State, todo, fade, early); /* Generate late reverb. */ LateReverb_Faded(State, todo, fade, late); fade = minf(1.0f, fade + todo*FadeStep); } else { /* Generate early reflections. */ EarlyReflection_Unfaded(State, todo, fade, early); /* Generate late reverb. */ LateReverb_Unfaded(State, todo, fade, late); } /* Step all delays forward. */ State->Offset += todo; return fade; } static ALvoid ALreverbState_process(ALreverbState *State, ALsizei SamplesToDo, const ALfloat (*restrict SamplesIn)[BUFFERSIZE], ALfloat (*restrict SamplesOut)[BUFFERSIZE], ALsizei NumChannels) { ProcMethodType ReverbProc = State->IsEax ? EAXVerbPass : VerbPass; ALfloat (*restrict afmt)[MAX_UPDATE_SAMPLES] = State->AFormatSamples; ALfloat (*restrict early)[MAX_UPDATE_SAMPLES] = State->EarlySamples; ALfloat (*restrict late)[MAX_UPDATE_SAMPLES] = State->ReverbSamples; ALsizei fadeCount = State->FadeCount; ALfloat fade = (ALfloat)fadeCount / FADE_SAMPLES; ALsizei base, c; /* Process reverb for these samples. */ for(base = 0;base < SamplesToDo;) { ALsizei todo = mini(SamplesToDo-base, MAX_UPDATE_SAMPLES); /* If cross-fading, don't do more samples than there are to fade. */ if(FADE_SAMPLES-fadeCount > 0) todo = mini(todo, FADE_SAMPLES-fadeCount); /* Convert B-Format to A-Format for processing. */ memset(afmt, 0, sizeof(*afmt)*4); for(c = 0;c < 4;c++) MixRowSamples(afmt[c], B2A.m[c], SamplesIn, MAX_EFFECT_CHANNELS, base, todo ); /* Process the samples for reverb. */ fade = ReverbProc(State, todo, fade, afmt, early, late); if(UNEXPECTED(fadeCount < FADE_SAMPLES) && (fadeCount += todo) >= FADE_SAMPLES) { /* Update the cross-fading delay line taps. */ fadeCount = FADE_SAMPLES; fade = 1.0f; for(c = 0;c < 4;c++) { State->EarlyDelayTap[c][0] = State->EarlyDelayTap[c][1]; State->Early.Ap[c].Offset[0] = State->Early.Ap[c].Offset[1]; State->Early.Offset[c][0] = State->Early.Offset[c][1]; State->LateDelayTap[c][0] = State->LateDelayTap[c][1]; State->Late.Ap[c].Offset[0] = State->Late.Ap[c].Offset[1]; State->Late.Offset[c][0] = State->Late.Offset[c][1]; } } /* Mix the A-Format results to output, implicitly converting back to * B-Format. */ for(c = 0;c < 4;c++) MixSamples(early[c], NumChannels, SamplesOut, State->Early.CurrentGain[c], State->Early.PanGain[c], SamplesToDo-base, base, todo ); for(c = 0;c < 4;c++) MixSamples(late[c], NumChannels, SamplesOut, State->Late.CurrentGain[c], State->Late.PanGain[c], SamplesToDo-base, base, todo ); base += todo; } State->FadeCount = fadeCount; } typedef struct ALreverbStateFactory { DERIVE_FROM_TYPE(ALeffectStateFactory); } ALreverbStateFactory; static ALeffectState *ALreverbStateFactory_create(ALreverbStateFactory* UNUSED(factory)) { ALreverbState *state; alcall_once(&mixfunc_inited, init_mixfunc); NEW_OBJ0(state, ALreverbState)(); if(!state) return NULL; return STATIC_CAST(ALeffectState, state); } DEFINE_ALEFFECTSTATEFACTORY_VTABLE(ALreverbStateFactory); ALeffectStateFactory *ALreverbStateFactory_getFactory(void) { static ALreverbStateFactory ReverbFactory = { { GET_VTABLE2(ALreverbStateFactory, ALeffectStateFactory) } }; return STATIC_CAST(ALeffectStateFactory, &ReverbFactory); } void ALeaxreverb_setParami(ALeffect *effect, ALCcontext *context, ALenum param, ALint val) { ALeffectProps *props = &effect->Props; switch(param) { case AL_EAXREVERB_DECAY_HFLIMIT: if(!(val >= AL_EAXREVERB_MIN_DECAY_HFLIMIT && val <= AL_EAXREVERB_MAX_DECAY_HFLIMIT)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.DecayHFLimit = val; break; default: SET_ERROR_AND_RETURN(context, AL_INVALID_ENUM); } } void ALeaxreverb_setParamiv(ALeffect *effect, ALCcontext *context, ALenum param, const ALint *vals) { ALeaxreverb_setParami(effect, context, param, vals[0]); } void ALeaxreverb_setParamf(ALeffect *effect, ALCcontext *context, ALenum param, ALfloat val) { ALeffectProps *props = &effect->Props; switch(param) { case AL_EAXREVERB_DENSITY: if(!(val >= AL_EAXREVERB_MIN_DENSITY && val <= AL_EAXREVERB_MAX_DENSITY)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.Density = val; break; case AL_EAXREVERB_DIFFUSION: if(!(val >= AL_EAXREVERB_MIN_DIFFUSION && val <= AL_EAXREVERB_MAX_DIFFUSION)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.Diffusion = val; break; case AL_EAXREVERB_GAIN: if(!(val >= AL_EAXREVERB_MIN_GAIN && val <= AL_EAXREVERB_MAX_GAIN)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.Gain = val; break; case AL_EAXREVERB_GAINHF: if(!(val >= AL_EAXREVERB_MIN_GAINHF && val <= AL_EAXREVERB_MAX_GAINHF)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.GainHF = val; break; case AL_EAXREVERB_GAINLF: if(!(val >= AL_EAXREVERB_MIN_GAINLF && val <= AL_EAXREVERB_MAX_GAINLF)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.GainLF = val; break; case AL_EAXREVERB_DECAY_TIME: if(!(val >= AL_EAXREVERB_MIN_DECAY_TIME && val <= AL_EAXREVERB_MAX_DECAY_TIME)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.DecayTime = val; break; case AL_EAXREVERB_DECAY_HFRATIO: if(!(val >= AL_EAXREVERB_MIN_DECAY_HFRATIO && val <= AL_EAXREVERB_MAX_DECAY_HFRATIO)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.DecayHFRatio = val; break; case AL_EAXREVERB_DECAY_LFRATIO: if(!(val >= AL_EAXREVERB_MIN_DECAY_LFRATIO && val <= AL_EAXREVERB_MAX_DECAY_LFRATIO)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.DecayLFRatio = val; break; case AL_EAXREVERB_REFLECTIONS_GAIN: if(!(val >= AL_EAXREVERB_MIN_REFLECTIONS_GAIN && val <= AL_EAXREVERB_MAX_REFLECTIONS_GAIN)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.ReflectionsGain = val; break; case AL_EAXREVERB_REFLECTIONS_DELAY: if(!(val >= AL_EAXREVERB_MIN_REFLECTIONS_DELAY && val <= AL_EAXREVERB_MAX_REFLECTIONS_DELAY)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.ReflectionsDelay = val; break; case AL_EAXREVERB_LATE_REVERB_GAIN: if(!(val >= AL_EAXREVERB_MIN_LATE_REVERB_GAIN && val <= AL_EAXREVERB_MAX_LATE_REVERB_GAIN)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.LateReverbGain = val; break; case AL_EAXREVERB_LATE_REVERB_DELAY: if(!(val >= AL_EAXREVERB_MIN_LATE_REVERB_DELAY && val <= AL_EAXREVERB_MAX_LATE_REVERB_DELAY)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.LateReverbDelay = val; break; case AL_EAXREVERB_AIR_ABSORPTION_GAINHF: if(!(val >= AL_EAXREVERB_MIN_AIR_ABSORPTION_GAINHF && val <= AL_EAXREVERB_MAX_AIR_ABSORPTION_GAINHF)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.AirAbsorptionGainHF = val; break; case AL_EAXREVERB_ECHO_TIME: if(!(val >= AL_EAXREVERB_MIN_ECHO_TIME && val <= AL_EAXREVERB_MAX_ECHO_TIME)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.EchoTime = val; break; case AL_EAXREVERB_ECHO_DEPTH: if(!(val >= AL_EAXREVERB_MIN_ECHO_DEPTH && val <= AL_EAXREVERB_MAX_ECHO_DEPTH)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.EchoDepth = val; break; case AL_EAXREVERB_MODULATION_TIME: if(!(val >= AL_EAXREVERB_MIN_MODULATION_TIME && val <= AL_EAXREVERB_MAX_MODULATION_TIME)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.ModulationTime = val; break; case AL_EAXREVERB_MODULATION_DEPTH: if(!(val >= AL_EAXREVERB_MIN_MODULATION_DEPTH && val <= AL_EAXREVERB_MAX_MODULATION_DEPTH)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.ModulationDepth = val; break; case AL_EAXREVERB_HFREFERENCE: if(!(val >= AL_EAXREVERB_MIN_HFREFERENCE && val <= AL_EAXREVERB_MAX_HFREFERENCE)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.HFReference = val; break; case AL_EAXREVERB_LFREFERENCE: if(!(val >= AL_EAXREVERB_MIN_LFREFERENCE && val <= AL_EAXREVERB_MAX_LFREFERENCE)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.LFReference = val; break; case AL_EAXREVERB_ROOM_ROLLOFF_FACTOR: if(!(val >= AL_EAXREVERB_MIN_ROOM_ROLLOFF_FACTOR && val <= AL_EAXREVERB_MAX_ROOM_ROLLOFF_FACTOR)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.RoomRolloffFactor = val; break; default: SET_ERROR_AND_RETURN(context, AL_INVALID_ENUM); } } void ALeaxreverb_setParamfv(ALeffect *effect, ALCcontext *context, ALenum param, const ALfloat *vals) { ALeffectProps *props = &effect->Props; switch(param) { case AL_EAXREVERB_REFLECTIONS_PAN: if(!(isfinite(vals[0]) && isfinite(vals[1]) && isfinite(vals[2]))) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.ReflectionsPan[0] = vals[0]; props->Reverb.ReflectionsPan[1] = vals[1]; props->Reverb.ReflectionsPan[2] = vals[2]; break; case AL_EAXREVERB_LATE_REVERB_PAN: if(!(isfinite(vals[0]) && isfinite(vals[1]) && isfinite(vals[2]))) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.LateReverbPan[0] = vals[0]; props->Reverb.LateReverbPan[1] = vals[1]; props->Reverb.LateReverbPan[2] = vals[2]; break; default: ALeaxreverb_setParamf(effect, context, param, vals[0]); break; } } void ALeaxreverb_getParami(const ALeffect *effect, ALCcontext *context, ALenum param, ALint *val) { const ALeffectProps *props = &effect->Props; switch(param) { case AL_EAXREVERB_DECAY_HFLIMIT: *val = props->Reverb.DecayHFLimit; break; default: SET_ERROR_AND_RETURN(context, AL_INVALID_ENUM); } } void ALeaxreverb_getParamiv(const ALeffect *effect, ALCcontext *context, ALenum param, ALint *vals) { ALeaxreverb_getParami(effect, context, param, vals); } void ALeaxreverb_getParamf(const ALeffect *effect, ALCcontext *context, ALenum param, ALfloat *val) { const ALeffectProps *props = &effect->Props; switch(param) { case AL_EAXREVERB_DENSITY: *val = props->Reverb.Density; break; case AL_EAXREVERB_DIFFUSION: *val = props->Reverb.Diffusion; break; case AL_EAXREVERB_GAIN: *val = props->Reverb.Gain; break; case AL_EAXREVERB_GAINHF: *val = props->Reverb.GainHF; break; case AL_EAXREVERB_GAINLF: *val = props->Reverb.GainLF; break; case AL_EAXREVERB_DECAY_TIME: *val = props->Reverb.DecayTime; break; case AL_EAXREVERB_DECAY_HFRATIO: *val = props->Reverb.DecayHFRatio; break; case AL_EAXREVERB_DECAY_LFRATIO: *val = props->Reverb.DecayLFRatio; break; case AL_EAXREVERB_REFLECTIONS_GAIN: *val = props->Reverb.ReflectionsGain; break; case AL_EAXREVERB_REFLECTIONS_DELAY: *val = props->Reverb.ReflectionsDelay; break; case AL_EAXREVERB_LATE_REVERB_GAIN: *val = props->Reverb.LateReverbGain; break; case AL_EAXREVERB_LATE_REVERB_DELAY: *val = props->Reverb.LateReverbDelay; break; case AL_EAXREVERB_AIR_ABSORPTION_GAINHF: *val = props->Reverb.AirAbsorptionGainHF; break; case AL_EAXREVERB_ECHO_TIME: *val = props->Reverb.EchoTime; break; case AL_EAXREVERB_ECHO_DEPTH: *val = props->Reverb.EchoDepth; break; case AL_EAXREVERB_MODULATION_TIME: *val = props->Reverb.ModulationTime; break; case AL_EAXREVERB_MODULATION_DEPTH: *val = props->Reverb.ModulationDepth; break; case AL_EAXREVERB_HFREFERENCE: *val = props->Reverb.HFReference; break; case AL_EAXREVERB_LFREFERENCE: *val = props->Reverb.LFReference; break; case AL_EAXREVERB_ROOM_ROLLOFF_FACTOR: *val = props->Reverb.RoomRolloffFactor; break; default: SET_ERROR_AND_RETURN(context, AL_INVALID_ENUM); } } void ALeaxreverb_getParamfv(const ALeffect *effect, ALCcontext *context, ALenum param, ALfloat *vals) { const ALeffectProps *props = &effect->Props; switch(param) { case AL_EAXREVERB_REFLECTIONS_PAN: vals[0] = props->Reverb.ReflectionsPan[0]; vals[1] = props->Reverb.ReflectionsPan[1]; vals[2] = props->Reverb.ReflectionsPan[2]; break; case AL_EAXREVERB_LATE_REVERB_PAN: vals[0] = props->Reverb.LateReverbPan[0]; vals[1] = props->Reverb.LateReverbPan[1]; vals[2] = props->Reverb.LateReverbPan[2]; break; default: ALeaxreverb_getParamf(effect, context, param, vals); break; } } DEFINE_ALEFFECT_VTABLE(ALeaxreverb); void ALreverb_setParami(ALeffect *effect, ALCcontext *context, ALenum param, ALint val) { ALeffectProps *props = &effect->Props; switch(param) { case AL_REVERB_DECAY_HFLIMIT: if(!(val >= AL_REVERB_MIN_DECAY_HFLIMIT && val <= AL_REVERB_MAX_DECAY_HFLIMIT)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.DecayHFLimit = val; break; default: SET_ERROR_AND_RETURN(context, AL_INVALID_ENUM); } } void ALreverb_setParamiv(ALeffect *effect, ALCcontext *context, ALenum param, const ALint *vals) { ALreverb_setParami(effect, context, param, vals[0]); } void ALreverb_setParamf(ALeffect *effect, ALCcontext *context, ALenum param, ALfloat val) { ALeffectProps *props = &effect->Props; switch(param) { case AL_REVERB_DENSITY: if(!(val >= AL_REVERB_MIN_DENSITY && val <= AL_REVERB_MAX_DENSITY)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.Density = val; break; case AL_REVERB_DIFFUSION: if(!(val >= AL_REVERB_MIN_DIFFUSION && val <= AL_REVERB_MAX_DIFFUSION)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.Diffusion = val; break; case AL_REVERB_GAIN: if(!(val >= AL_REVERB_MIN_GAIN && val <= AL_REVERB_MAX_GAIN)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.Gain = val; break; case AL_REVERB_GAINHF: if(!(val >= AL_REVERB_MIN_GAINHF && val <= AL_REVERB_MAX_GAINHF)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.GainHF = val; break; case AL_REVERB_DECAY_TIME: if(!(val >= AL_REVERB_MIN_DECAY_TIME && val <= AL_REVERB_MAX_DECAY_TIME)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.DecayTime = val; break; case AL_REVERB_DECAY_HFRATIO: if(!(val >= AL_REVERB_MIN_DECAY_HFRATIO && val <= AL_REVERB_MAX_DECAY_HFRATIO)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.DecayHFRatio = val; break; case AL_REVERB_REFLECTIONS_GAIN: if(!(val >= AL_REVERB_MIN_REFLECTIONS_GAIN && val <= AL_REVERB_MAX_REFLECTIONS_GAIN)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.ReflectionsGain = val; break; case AL_REVERB_REFLECTIONS_DELAY: if(!(val >= AL_REVERB_MIN_REFLECTIONS_DELAY && val <= AL_REVERB_MAX_REFLECTIONS_DELAY)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.ReflectionsDelay = val; break; case AL_REVERB_LATE_REVERB_GAIN: if(!(val >= AL_REVERB_MIN_LATE_REVERB_GAIN && val <= AL_REVERB_MAX_LATE_REVERB_GAIN)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.LateReverbGain = val; break; case AL_REVERB_LATE_REVERB_DELAY: if(!(val >= AL_REVERB_MIN_LATE_REVERB_DELAY && val <= AL_REVERB_MAX_LATE_REVERB_DELAY)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.LateReverbDelay = val; break; case AL_REVERB_AIR_ABSORPTION_GAINHF: if(!(val >= AL_REVERB_MIN_AIR_ABSORPTION_GAINHF && val <= AL_REVERB_MAX_AIR_ABSORPTION_GAINHF)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.AirAbsorptionGainHF = val; break; case AL_REVERB_ROOM_ROLLOFF_FACTOR: if(!(val >= AL_REVERB_MIN_ROOM_ROLLOFF_FACTOR && val <= AL_REVERB_MAX_ROOM_ROLLOFF_FACTOR)) SET_ERROR_AND_RETURN(context, AL_INVALID_VALUE); props->Reverb.RoomRolloffFactor = val; break; default: SET_ERROR_AND_RETURN(context, AL_INVALID_ENUM); } } void ALreverb_setParamfv(ALeffect *effect, ALCcontext *context, ALenum param, const ALfloat *vals) { ALreverb_setParamf(effect, context, param, vals[0]); } void ALreverb_getParami(const ALeffect *effect, ALCcontext *context, ALenum param, ALint *val) { const ALeffectProps *props = &effect->Props; switch(param) { case AL_REVERB_DECAY_HFLIMIT: *val = props->Reverb.DecayHFLimit; break; default: SET_ERROR_AND_RETURN(context, AL_INVALID_ENUM); } } void ALreverb_getParamiv(const ALeffect *effect, ALCcontext *context, ALenum param, ALint *vals) { ALreverb_getParami(effect, context, param, vals); } void ALreverb_getParamf(const ALeffect *effect, ALCcontext *context, ALenum param, ALfloat *val) { const ALeffectProps *props = &effect->Props; switch(param) { case AL_REVERB_DENSITY: *val = props->Reverb.Density; break; case AL_REVERB_DIFFUSION: *val = props->Reverb.Diffusion; break; case AL_REVERB_GAIN: *val = props->Reverb.Gain; break; case AL_REVERB_GAINHF: *val = props->Reverb.GainHF; break; case AL_REVERB_DECAY_TIME: *val = props->Reverb.DecayTime; break; case AL_REVERB_DECAY_HFRATIO: *val = props->Reverb.DecayHFRatio; break; case AL_REVERB_REFLECTIONS_GAIN: *val = props->Reverb.ReflectionsGain; break; case AL_REVERB_REFLECTIONS_DELAY: *val = props->Reverb.ReflectionsDelay; break; case AL_REVERB_LATE_REVERB_GAIN: *val = props->Reverb.LateReverbGain; break; case AL_REVERB_LATE_REVERB_DELAY: *val = props->Reverb.LateReverbDelay; break; case AL_REVERB_AIR_ABSORPTION_GAINHF: *val = props->Reverb.AirAbsorptionGainHF; break; case AL_REVERB_ROOM_ROLLOFF_FACTOR: *val = props->Reverb.RoomRolloffFactor; break; default: SET_ERROR_AND_RETURN(context, AL_INVALID_ENUM); } } void ALreverb_getParamfv(const ALeffect *effect, ALCcontext *context, ALenum param, ALfloat *vals) { ALreverb_getParamf(effect, context, param, vals); } DEFINE_ALEFFECT_VTABLE(ALreverb);