2007-12-18 01:43:19 +00:00
|
|
|
#ifndef _AL_AUXEFFECTSLOT_H_
|
|
|
|
|
#define _AL_AUXEFFECTSLOT_H_
|
|
|
|
|
|
|
|
|
|
#include "AL/al.h"
|
2008-07-26 02:31:12 +00:00
|
|
|
#include "alEffect.h"
|
|
|
|
|
#include "alFilter.h"
|
2007-12-18 01:43:19 +00:00
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
|
extern "C" {
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
#define AL_EFFECTSLOT_EFFECT 0x0001
|
|
|
|
|
#define AL_EFFECTSLOT_GAIN 0x0002
|
|
|
|
|
#define AL_EFFECTSLOT_AUXILIARY_SEND_AUTO 0x0003
|
|
|
|
|
|
|
|
|
|
#define AL_EFFECTSLOT_NULL 0x0000
|
|
|
|
|
|
2009-05-29 20:30:50 +00:00
|
|
|
typedef struct ALeffectState ALeffectState;
|
|
|
|
|
|
2008-01-16 00:01:27 +00:00
|
|
|
typedef struct ALeffectslot
|
2007-12-18 01:43:19 +00:00
|
|
|
{
|
2007-12-18 22:22:59 +00:00
|
|
|
ALeffect effect;
|
|
|
|
|
|
2007-12-18 23:47:24 +00:00
|
|
|
ALfloat Gain;
|
2007-12-19 01:41:44 +00:00
|
|
|
ALboolean AuxSendAuto;
|
2007-12-18 23:47:24 +00:00
|
|
|
|
2009-05-29 20:30:50 +00:00
|
|
|
ALeffectState *EffectState;
|
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. :)
2008-01-19 05:25:40 +00:00
|
|
|
|
2009-04-12 00:04:55 +00:00
|
|
|
ALfloat WetBuffer[BUFFERSIZE];
|
|
|
|
|
|
2008-01-16 21:20:09 +00:00
|
|
|
ALuint refcount;
|
|
|
|
|
|
2007-12-18 01:43:19 +00:00
|
|
|
// Index to itself
|
|
|
|
|
ALuint effectslot;
|
|
|
|
|
|
2008-01-16 00:01:27 +00:00
|
|
|
struct ALeffectslot *next;
|
2007-12-18 01:43:19 +00:00
|
|
|
} ALeffectslot;
|
|
|
|
|
|
2008-09-06 20:45:27 +00:00
|
|
|
ALvoid AL_APIENTRY alGenAuxiliaryEffectSlots(ALsizei n, ALuint *effectslots);
|
|
|
|
|
ALvoid AL_APIENTRY alDeleteAuxiliaryEffectSlots(ALsizei n, ALuint *effectslots);
|
|
|
|
|
ALboolean AL_APIENTRY alIsAuxiliaryEffectSlot(ALuint effectslot);
|
|
|
|
|
|
|
|
|
|
ALvoid AL_APIENTRY alAuxiliaryEffectSloti(ALuint effectslot, ALenum param, ALint iValue);
|
|
|
|
|
ALvoid AL_APIENTRY alAuxiliaryEffectSlotiv(ALuint effectslot, ALenum param, ALint *piValues);
|
|
|
|
|
ALvoid AL_APIENTRY alAuxiliaryEffectSlotf(ALuint effectslot, ALenum param, ALfloat flValue);
|
|
|
|
|
ALvoid AL_APIENTRY alAuxiliaryEffectSlotfv(ALuint effectslot, ALenum param, ALfloat *pflValues);
|
|
|
|
|
|
|
|
|
|
ALvoid AL_APIENTRY alGetAuxiliaryEffectSloti(ALuint effectslot, ALenum param, ALint *piValue);
|
|
|
|
|
ALvoid AL_APIENTRY alGetAuxiliaryEffectSlotiv(ALuint effectslot, ALenum param, ALint *piValues);
|
|
|
|
|
ALvoid AL_APIENTRY alGetAuxiliaryEffectSlotf(ALuint effectslot, ALenum param, ALfloat *pflValue);
|
|
|
|
|
ALvoid AL_APIENTRY alGetAuxiliaryEffectSlotfv(ALuint effectslot, ALenum param, ALfloat *pflValues);
|
2007-12-18 01:43:19 +00:00
|
|
|
|
2008-01-16 00:22:39 +00:00
|
|
|
ALvoid ReleaseALAuxiliaryEffectSlots(ALCcontext *Context);
|
2007-12-18 01:43:19 +00:00
|
|
|
|
2009-05-29 20:30:50 +00:00
|
|
|
|
|
|
|
|
struct ALeffectState {
|
|
|
|
|
ALvoid (*Destroy)(ALeffectState *State);
|
2009-10-19 14:46:53 +00:00
|
|
|
ALvoid (*Update)(ALeffectState *State, ALCcontext *Context, const ALeffect *Effect);
|
2009-05-29 23:51:00 +00:00
|
|
|
ALvoid (*Process)(ALeffectState *State, const ALeffectslot *Slot, ALuint SamplesToDo, const ALfloat *SamplesIn, ALfloat (*SamplesOut)[OUTPUTCHANNELS]);
|
2009-05-29 20:30:50 +00:00
|
|
|
};
|
|
|
|
|
|
2009-10-19 14:46:53 +00:00
|
|
|
ALeffectState *EAXVerbCreate(void);
|
|
|
|
|
ALeffectState *VerbCreate(void);
|
|
|
|
|
ALeffectState *EchoCreate(void);
|
2009-05-29 20:30:50 +00:00
|
|
|
|
2009-05-29 23:51:00 +00:00
|
|
|
#define ALEffect_Destroy(a) ((a)->Destroy((a)))
|
|
|
|
|
#define ALEffect_Update(a,b,c) ((a)->Update((a),(b),(c)))
|
|
|
|
|
#define ALEffect_Process(a,b,c,d,e) ((a)->Process((a),(b),(c),(d),(e)))
|
2009-05-29 20:30:50 +00:00
|
|
|
|
|
|
|
|
|
2007-12-18 01:43:19 +00:00
|
|
|
#ifdef __cplusplus
|
|
|
|
|
}
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
#endif
|