OpenAL32/Include/alAuxEffectSlot.h

   1 #ifndef _AL_AUXEFFECTSLOT_H_
   2 #define _AL_AUXEFFECTSLOT_H_
   3
   4 #include "alMain.h"
   5 #include "alEffect.h"
   6
   7 #include "align.h"
   8
   9 #ifdef __cplusplus
  10 extern "C" {
  11 #endif
  12
  13 struct ALeffectStateVtable;
  14 struct ALeffectslot;
  15
  16 typedef struct ALeffectState {
  17     const struct ALeffectStateVtable *vtbl;
  18
  19     ALfloat (*OutBuffer)[BUFFERSIZE];
  20     ALuint OutChannels;
  21 } ALeffectState;
  22
  23 void ALeffectState_Destruct(ALeffectState *state);
  24
  25 struct ALeffectStateVtable {
  26     void (*const Destruct)(ALeffectState *state);
  27
  28     ALboolean (*const deviceUpdate)(ALeffectState *state, ALCdevice *device);
  29     void (*const update)(ALeffectState *state, const ALCdevice *device, const struct ALeffectslot *slot, const union ALeffectProps *props);
  30     void (*const process)(ALeffectState *state, ALuint samplesToDo, const ALfloat (*restrict samplesIn)[BUFFERSIZE], ALfloat (*restrict samplesOut)[BUFFERSIZE], ALuint numChannels);
  31
  32     void (*const Delete)(void *ptr);
  33 };
  34
  35 #define DEFINE_ALEFFECTSTATE_VTABLE(T)                                        \
  36 DECLARE_THUNK(T, ALeffectState, void, Destruct)                               \
  37 DECLARE_THUNK1(T, ALeffectState, ALboolean, deviceUpdate, ALCdevice*)         \
  38 DECLARE_THUNK3(T, ALeffectState, void, update, const ALCdevice*, const ALeffectslot*, const ALeffectProps*) \
  39 DECLARE_THUNK4(T, ALeffectState, void, process, ALuint, const ALfloatBUFFERSIZE*restrict, ALfloatBUFFERSIZE*restrict, ALuint) \
  40 static void T##_ALeffectState_Delete(void *ptr)                               \
  41 { return T##_Delete(STATIC_UPCAST(T, ALeffectState, (ALeffectState*)ptr)); }  \
  42                                                                               \
  43 static const struct ALeffectStateVtable T##_ALeffectState_vtable = {          \
  44     T##_ALeffectState_Destruct,                                               \
  45                                                                               \
  46     T##_ALeffectState_deviceUpdate,                                           \
  47     T##_ALeffectState_update,                                                 \
  48     T##_ALeffectState_process,                                                \
  49                                                                               \
  50     T##_ALeffectState_Delete,                                                 \
  51 }
  52
  53
  54 struct ALeffectStateFactoryVtable;
  55
  56 typedef struct ALeffectStateFactory {
  57     const struct ALeffectStateFactoryVtable *vtbl;
  58 } ALeffectStateFactory;
  59
  60 struct ALeffectStateFactoryVtable {
  61     ALeffectState *(*const create)(ALeffectStateFactory *factory);
  62 };
  63
  64 #define DEFINE_ALEFFECTSTATEFACTORY_VTABLE(T)                                 \
  65 DECLARE_THUNK(T, ALeffectStateFactory, ALeffectState*, create)                \
  66                                                                               \
  67 static const struct ALeffectStateFactoryVtable T##_ALeffectStateFactory_vtable = { \
  68     T##_ALeffectStateFactory_create,                                          \
  69 }
  70
  71
  72 #define MAX_EFFECT_CHANNELS (4)
  73
  74
  75 struct ALeffectslotProps {
  76     ATOMIC(ALfloat)   Gain;
  77     ATOMIC(ALboolean) AuxSendAuto;
  78
  79     ATOMIC(ALenum) Type;
  80     ALeffectProps Props;
  81
  82     ATOMIC(ALeffectState*) State;
  83
  84     ATOMIC(struct ALeffectslotProps*) next;
  85 };
  86
  87
  88 typedef struct ALeffectslot {
  89     ALfloat   Gain;
  90     ALboolean AuxSendAuto;
  91
  92     struct {
  93         ALenum Type;
  94         ALeffectProps Props;
  95
  96         ALeffectState *State;
  97     } Effect;
  98
  99     RefCount ref;
 100
 101     ATOMIC(struct ALeffectslotProps*) Update;
 102     ATOMIC(struct ALeffectslotProps*) FreeList;
 103
 104     struct {
 105         ALfloat   Gain;
 106         ALboolean AuxSendAuto;
 107
 108         ALenum EffectType;
 109         ALeffectState *EffectState;
 110
 111         ALfloat RoomRolloff; /* Added to the source's room rolloff, not multiplied. */
 112         ALfloat DecayTime;
 113         ALfloat AirAbsorptionGainHF;
 114     } Params;
 115
 116     /* Self ID */
 117     ALuint id;
 118
 119     ALuint NumChannels;
 120     BFChannelConfig ChanMap[MAX_EFFECT_CHANNELS];
 121     /* Wet buffer configuration is ACN channel order with N3D scaling:
 122      * * Channel 0 is the unattenuated mono signal.
 123      * * Channel 1 is OpenAL -X
 124      * * Channel 2 is OpenAL Y
 125      * * Channel 3 is OpenAL -Z
 126      * Consequently, effects that only want to work with mono input can use
 127      * channel 0 by itself. Effects that want multichannel can process the
 128      * ambisonics signal and make a B-Format pan (ComputeFirstOrderGains) for
 129      * first-order device output (FOAOut).
 130      */
 131     alignas(16) ALfloat WetBuffer[MAX_EFFECT_CHANNELS][BUFFERSIZE];
 132
 133     ATOMIC(struct ALeffectslot*) next;
 134 } ALeffectslot;
 135
 136 inline void LockEffectSlotsRead(ALCcontext *context)
 137 { LockUIntMapRead(&context->EffectSlotMap); }
 138 inline void UnlockEffectSlotsRead(ALCcontext *context)
 139 { UnlockUIntMapRead(&context->EffectSlotMap); }
 140 inline void LockEffectSlotsWrite(ALCcontext *context)
 141 { LockUIntMapWrite(&context->EffectSlotMap); }
 142 inline void UnlockEffectSlotsWrite(ALCcontext *context)
 143 { UnlockUIntMapWrite(&context->EffectSlotMap); }
 144
 145 inline struct ALeffectslot *LookupEffectSlot(ALCcontext *context, ALuint id)
 146 { return (struct ALeffectslot*)LookupUIntMapKeyNoLock(&context->EffectSlotMap, id); }
 147 inline struct ALeffectslot *RemoveEffectSlot(ALCcontext *context, ALuint id)
 148 { return (struct ALeffectslot*)RemoveUIntMapKeyNoLock(&context->EffectSlotMap, id); }
 149
 150 ALenum InitEffectSlot(ALeffectslot *slot);
 151 void DeinitEffectSlot(ALeffectslot *slot);
 152 void UpdateEffectSlotProps(ALeffectslot *slot);
 153 ALvoid ReleaseALAuxiliaryEffectSlots(ALCcontext *Context);
 154
 155
 156 ALeffectStateFactory *ALnullStateFactory_getFactory(void);
 157 ALeffectStateFactory *ALreverbStateFactory_getFactory(void);
 158 ALeffectStateFactory *ALautowahStateFactory_getFactory(void);
 159 ALeffectStateFactory *ALchorusStateFactory_getFactory(void);
 160 ALeffectStateFactory *ALcompressorStateFactory_getFactory(void);
 161 ALeffectStateFactory *ALdistortionStateFactory_getFactory(void);
 162 ALeffectStateFactory *ALechoStateFactory_getFactory(void);
 163 ALeffectStateFactory *ALequalizerStateFactory_getFactory(void);
 164 ALeffectStateFactory *ALflangerStateFactory_getFactory(void);
 165 ALeffectStateFactory *ALmodulatorStateFactory_getFactory(void);
 166
 167 ALeffectStateFactory *ALdedicatedStateFactory_getFactory(void);
 168
 169
 170 ALenum InitializeEffect(ALCdevice *Device, ALeffectslot *EffectSlot, ALeffect *effect);
 171
 172 void InitEffectFactoryMap(void);
 173 void DeinitEffectFactoryMap(void);
 174
 175 #ifdef __cplusplus
 176 }
 177 #endif
 178
 179 #endif