Avoid holding the device lock when it isn't needed
[dsound-openal.git] / efx.h
blob0ccef95d6bafd41f0fe930f062d611c77d77f877
1 #ifndef AL_EFX_H
2 #define AL_EFX_H
5 #ifdef __cplusplus
6 extern "C" {
7 #endif
9 #define ALC_EXT_EFX_NAME "ALC_EXT_EFX"
11 #define ALC_EFX_MAJOR_VERSION 0x20001
12 #define ALC_EFX_MINOR_VERSION 0x20002
13 #define ALC_MAX_AUXILIARY_SENDS 0x20003
16 /* Listener properties. */
17 #define AL_METERS_PER_UNIT 0x20004
19 /* Source properties. */
20 #define AL_DIRECT_FILTER 0x20005
21 #define AL_AUXILIARY_SEND_FILTER 0x20006
22 #define AL_AIR_ABSORPTION_FACTOR 0x20007
23 #define AL_ROOM_ROLLOFF_FACTOR 0x20008
24 #define AL_CONE_OUTER_GAINHF 0x20009
25 #define AL_DIRECT_FILTER_GAINHF_AUTO 0x2000A
26 #define AL_AUXILIARY_SEND_FILTER_GAIN_AUTO 0x2000B
27 #define AL_AUXILIARY_SEND_FILTER_GAINHF_AUTO 0x2000C
30 /* Effect properties. */
32 /* Reverb effect parameters */
33 #define AL_REVERB_DENSITY 0x0001
34 #define AL_REVERB_DIFFUSION 0x0002
35 #define AL_REVERB_GAIN 0x0003
36 #define AL_REVERB_GAINHF 0x0004
37 #define AL_REVERB_DECAY_TIME 0x0005
38 #define AL_REVERB_DECAY_HFRATIO 0x0006
39 #define AL_REVERB_REFLECTIONS_GAIN 0x0007
40 #define AL_REVERB_REFLECTIONS_DELAY 0x0008
41 #define AL_REVERB_LATE_REVERB_GAIN 0x0009
42 #define AL_REVERB_LATE_REVERB_DELAY 0x000A
43 #define AL_REVERB_AIR_ABSORPTION_GAINHF 0x000B
44 #define AL_REVERB_ROOM_ROLLOFF_FACTOR 0x000C
45 #define AL_REVERB_DECAY_HFLIMIT 0x000D
47 /* EAX Reverb effect parameters */
48 #define AL_EAXREVERB_DENSITY 0x0001
49 #define AL_EAXREVERB_DIFFUSION 0x0002
50 #define AL_EAXREVERB_GAIN 0x0003
51 #define AL_EAXREVERB_GAINHF 0x0004
52 #define AL_EAXREVERB_GAINLF 0x0005
53 #define AL_EAXREVERB_DECAY_TIME 0x0006
54 #define AL_EAXREVERB_DECAY_HFRATIO 0x0007
55 #define AL_EAXREVERB_DECAY_LFRATIO 0x0008
56 #define AL_EAXREVERB_REFLECTIONS_GAIN 0x0009
57 #define AL_EAXREVERB_REFLECTIONS_DELAY 0x000A
58 #define AL_EAXREVERB_REFLECTIONS_PAN 0x000B
59 #define AL_EAXREVERB_LATE_REVERB_GAIN 0x000C
60 #define AL_EAXREVERB_LATE_REVERB_DELAY 0x000D
61 #define AL_EAXREVERB_LATE_REVERB_PAN 0x000E
62 #define AL_EAXREVERB_ECHO_TIME 0x000F
63 #define AL_EAXREVERB_ECHO_DEPTH 0x0010
64 #define AL_EAXREVERB_MODULATION_TIME 0x0011
65 #define AL_EAXREVERB_MODULATION_DEPTH 0x0012
66 #define AL_EAXREVERB_AIR_ABSORPTION_GAINHF 0x0013
67 #define AL_EAXREVERB_HFREFERENCE 0x0014
68 #define AL_EAXREVERB_LFREFERENCE 0x0015
69 #define AL_EAXREVERB_ROOM_ROLLOFF_FACTOR 0x0016
70 #define AL_EAXREVERB_DECAY_HFLIMIT 0x0017
72 /* Chorus effect parameters */
73 #define AL_CHORUS_WAVEFORM 0x0001
74 #define AL_CHORUS_PHASE 0x0002
75 #define AL_CHORUS_RATE 0x0003
76 #define AL_CHORUS_DEPTH 0x0004
77 #define AL_CHORUS_FEEDBACK 0x0005
78 #define AL_CHORUS_DELAY 0x0006
80 /* Distortion effect parameters */
81 #define AL_DISTORTION_EDGE 0x0001
82 #define AL_DISTORTION_GAIN 0x0002
83 #define AL_DISTORTION_LOWPASS_CUTOFF 0x0003
84 #define AL_DISTORTION_EQCENTER 0x0004
85 #define AL_DISTORTION_EQBANDWIDTH 0x0005
87 /* Echo effect parameters */
88 #define AL_ECHO_DELAY 0x0001
89 #define AL_ECHO_LRDELAY 0x0002
90 #define AL_ECHO_DAMPING 0x0003
91 #define AL_ECHO_FEEDBACK 0x0004
92 #define AL_ECHO_SPREAD 0x0005
94 /* Flanger effect parameters */
95 #define AL_FLANGER_WAVEFORM 0x0001
96 #define AL_FLANGER_PHASE 0x0002
97 #define AL_FLANGER_RATE 0x0003
98 #define AL_FLANGER_DEPTH 0x0004
99 #define AL_FLANGER_FEEDBACK 0x0005
100 #define AL_FLANGER_DELAY 0x0006
102 /* Frequency shifter effect parameters */
103 #define AL_FREQUENCY_SHIFTER_FREQUENCY 0x0001
104 #define AL_FREQUENCY_SHIFTER_LEFT_DIRECTION 0x0002
105 #define AL_FREQUENCY_SHIFTER_RIGHT_DIRECTION 0x0003
107 /* Vocal morpher effect parameters */
108 #define AL_VOCAL_MORPHER_PHONEMEA 0x0001
109 #define AL_VOCAL_MORPHER_PHONEMEA_COARSE_TUNING 0x0002
110 #define AL_VOCAL_MORPHER_PHONEMEB 0x0003
111 #define AL_VOCAL_MORPHER_PHONEMEB_COARSE_TUNING 0x0004
112 #define AL_VOCAL_MORPHER_WAVEFORM 0x0005
113 #define AL_VOCAL_MORPHER_RATE 0x0006
115 /* Pitchshifter effect parameters */
116 #define AL_PITCH_SHIFTER_COARSE_TUNE 0x0001
117 #define AL_PITCH_SHIFTER_FINE_TUNE 0x0002
119 /* Ringmodulator effect parameters */
120 #define AL_RING_MODULATOR_FREQUENCY 0x0001
121 #define AL_RING_MODULATOR_HIGHPASS_CUTOFF 0x0002
122 #define AL_RING_MODULATOR_WAVEFORM 0x0003
124 /* Autowah effect parameters */
125 #define AL_AUTOWAH_ATTACK_TIME 0x0001
126 #define AL_AUTOWAH_RELEASE_TIME 0x0002
127 #define AL_AUTOWAH_RESONANCE 0x0003
128 #define AL_AUTOWAH_PEAK_GAIN 0x0004
130 /* Compressor effect parameters */
131 #define AL_COMPRESSOR_ONOFF 0x0001
133 /* Equalizer effect parameters */
134 #define AL_EQUALIZER_LOW_GAIN 0x0001
135 #define AL_EQUALIZER_LOW_CUTOFF 0x0002
136 #define AL_EQUALIZER_MID1_GAIN 0x0003
137 #define AL_EQUALIZER_MID1_CENTER 0x0004
138 #define AL_EQUALIZER_MID1_WIDTH 0x0005
139 #define AL_EQUALIZER_MID2_GAIN 0x0006
140 #define AL_EQUALIZER_MID2_CENTER 0x0007
141 #define AL_EQUALIZER_MID2_WIDTH 0x0008
142 #define AL_EQUALIZER_HIGH_GAIN 0x0009
143 #define AL_EQUALIZER_HIGH_CUTOFF 0x000A
145 /* Effect type */
146 #define AL_EFFECT_FIRST_PARAMETER 0x0000
147 #define AL_EFFECT_LAST_PARAMETER 0x8000
148 #define AL_EFFECT_TYPE 0x8001
150 /* Effect types, used with the AL_EFFECT_TYPE property */
151 #define AL_EFFECT_NULL 0x0000
152 #define AL_EFFECT_REVERB 0x0001
153 #define AL_EFFECT_CHORUS 0x0002
154 #define AL_EFFECT_DISTORTION 0x0003
155 #define AL_EFFECT_ECHO 0x0004
156 #define AL_EFFECT_FLANGER 0x0005
157 #define AL_EFFECT_FREQUENCY_SHIFTER 0x0006
158 #define AL_EFFECT_VOCAL_MORPHER 0x0007
159 #define AL_EFFECT_PITCH_SHIFTER 0x0008
160 #define AL_EFFECT_RING_MODULATOR 0x0009
161 #define AL_EFFECT_AUTOWAH 0x000A
162 #define AL_EFFECT_COMPRESSOR 0x000B
163 #define AL_EFFECT_EQUALIZER 0x000C
164 #define AL_EFFECT_EAXREVERB 0x8000
166 /* Auxiliary Effect Slot properties. */
167 #define AL_EFFECTSLOT_EFFECT 0x0001
168 #define AL_EFFECTSLOT_GAIN 0x0002
169 #define AL_EFFECTSLOT_AUXILIARY_SEND_AUTO 0x0003
171 /* NULL Auxiliary Slot ID to disable a source send. */
172 #define AL_EFFECTSLOT_NULL 0x0000
175 /* Filter properties. */
177 /* Lowpass filter parameters */
178 #define AL_LOWPASS_GAIN 0x0001
179 #define AL_LOWPASS_GAINHF 0x0002
181 /* Highpass filter parameters */
182 #define AL_HIGHPASS_GAIN 0x0001
183 #define AL_HIGHPASS_GAINLF 0x0002
185 /* Bandpass filter parameters */
186 #define AL_BANDPASS_GAIN 0x0001
187 #define AL_BANDPASS_GAINLF 0x0002
188 #define AL_BANDPASS_GAINHF 0x0003
190 /* Filter type */
191 #define AL_FILTER_FIRST_PARAMETER 0x0000
192 #define AL_FILTER_LAST_PARAMETER 0x8000
193 #define AL_FILTER_TYPE 0x8001
195 /* Filter types, used with the AL_FILTER_TYPE property */
196 #define AL_FILTER_NULL 0x0000
197 #define AL_FILTER_LOWPASS 0x0001
198 #define AL_FILTER_HIGHPASS 0x0002
199 #define AL_FILTER_BANDPASS 0x0003
202 /* Effect object function types. */
203 typedef void (AL_APIENTRY *LPALGENEFFECTS)(ALsizei, ALuint*);
204 typedef void (AL_APIENTRY *LPALDELETEEFFECTS)(ALsizei, ALuint*);
205 typedef ALboolean (AL_APIENTRY *LPALISEFFECT)(ALuint);
206 typedef void (AL_APIENTRY *LPALEFFECTI)(ALuint, ALenum, ALint);
207 typedef void (AL_APIENTRY *LPALEFFECTIV)(ALuint, ALenum, ALint*);
208 typedef void (AL_APIENTRY *LPALEFFECTF)(ALuint, ALenum, ALfloat);
209 typedef void (AL_APIENTRY *LPALEFFECTFV)(ALuint, ALenum, ALfloat*);
210 typedef void (AL_APIENTRY *LPALGETEFFECTI)(ALuint, ALenum, ALint*);
211 typedef void (AL_APIENTRY *LPALGETEFFECTIV)(ALuint, ALenum, ALint*);
212 typedef void (AL_APIENTRY *LPALGETEFFECTF)(ALuint, ALenum, ALfloat*);
213 typedef void (AL_APIENTRY *LPALGETEFFECTFV)(ALuint, ALenum, ALfloat*);
215 /* Filter object function types. */
216 typedef void (AL_APIENTRY *LPALGENFILTERS)(ALsizei, ALuint*);
217 typedef void (AL_APIENTRY *LPALDELETEFILTERS)(ALsizei, ALuint*);
218 typedef ALboolean (AL_APIENTRY *LPALISFILTER)(ALuint);
219 typedef void (AL_APIENTRY *LPALFILTERI)(ALuint, ALenum, ALint);
220 typedef void (AL_APIENTRY *LPALFILTERIV)(ALuint, ALenum, ALint*);
221 typedef void (AL_APIENTRY *LPALFILTERF)(ALuint, ALenum, ALfloat);
222 typedef void (AL_APIENTRY *LPALFILTERFV)(ALuint, ALenum, ALfloat*);
223 typedef void (AL_APIENTRY *LPALGETFILTERI)(ALuint, ALenum, ALint*);
224 typedef void (AL_APIENTRY *LPALGETFILTERIV)(ALuint, ALenum, ALint*);
225 typedef void (AL_APIENTRY *LPALGETFILTERF)(ALuint, ALenum, ALfloat*);
226 typedef void (AL_APIENTRY *LPALGETFILTERFV)(ALuint, ALenum, ALfloat*);
228 /* Auxiliary Effect Slot object function types. */
229 typedef void (AL_APIENTRY *LPALGENAUXILIARYEFFECTSLOTS)(ALsizei, ALuint*);
230 typedef void (AL_APIENTRY *LPALDELETEAUXILIARYEFFECTSLOTS)(ALsizei, ALuint*);
231 typedef ALboolean (AL_APIENTRY *LPALISAUXILIARYEFFECTSLOT)(ALuint);
232 typedef void (AL_APIENTRY *LPALAUXILIARYEFFECTSLOTI)(ALuint, ALenum, ALint);
233 typedef void (AL_APIENTRY *LPALAUXILIARYEFFECTSLOTIV)(ALuint, ALenum, ALint*);
234 typedef void (AL_APIENTRY *LPALAUXILIARYEFFECTSLOTF)(ALuint, ALenum, ALfloat);
235 typedef void (AL_APIENTRY *LPALAUXILIARYEFFECTSLOTFV)(ALuint, ALenum, ALfloat*);
236 typedef void (AL_APIENTRY *LPALGETAUXILIARYEFFECTSLOTI)(ALuint, ALenum, ALint*);
237 typedef void (AL_APIENTRY *LPALGETAUXILIARYEFFECTSLOTIV)(ALuint, ALenum, ALint*);
238 typedef void (AL_APIENTRY *LPALGETAUXILIARYEFFECTSLOTF)(ALuint, ALenum, ALfloat*);
239 typedef void (AL_APIENTRY *LPALGETAUXILIARYEFFECTSLOTFV)(ALuint, ALenum, ALfloat*);
241 #ifdef AL_ALEXT_PROTOTYPES
242 AL_API ALvoid AL_APIENTRY alGenEffects(ALsizei n, ALuint *effects);
243 AL_API ALvoid AL_APIENTRY alDeleteEffects(ALsizei n, ALuint *effects);
244 AL_API ALboolean AL_APIENTRY alIsEffect(ALuint effect);
245 AL_API ALvoid AL_APIENTRY alEffecti(ALuint effect, ALenum param, ALint iValue);
246 AL_API ALvoid AL_APIENTRY alEffectiv(ALuint effect, ALenum param, ALint *piValues);
247 AL_API ALvoid AL_APIENTRY alEffectf(ALuint effect, ALenum param, ALfloat flValue);
248 AL_API ALvoid AL_APIENTRY alEffectfv(ALuint effect, ALenum param, ALfloat *pflValues);
249 AL_API ALvoid AL_APIENTRY alGetEffecti(ALuint effect, ALenum param, ALint *piValue);
250 AL_API ALvoid AL_APIENTRY alGetEffectiv(ALuint effect, ALenum param, ALint *piValues);
251 AL_API ALvoid AL_APIENTRY alGetEffectf(ALuint effect, ALenum param, ALfloat *pflValue);
252 AL_API ALvoid AL_APIENTRY alGetEffectfv(ALuint effect, ALenum param, ALfloat *pflValues);
254 AL_API ALvoid AL_APIENTRY alGenFilters(ALsizei n, ALuint *filters);
255 AL_API ALvoid AL_APIENTRY alDeleteFilters(ALsizei n, ALuint *filters);
256 AL_API ALboolean AL_APIENTRY alIsFilter(ALuint filter);
257 AL_API ALvoid AL_APIENTRY alFilteri(ALuint filter, ALenum param, ALint iValue);
258 AL_API ALvoid AL_APIENTRY alFilteriv(ALuint filter, ALenum param, ALint *piValues);
259 AL_API ALvoid AL_APIENTRY alFilterf(ALuint filter, ALenum param, ALfloat flValue);
260 AL_API ALvoid AL_APIENTRY alFilterfv(ALuint filter, ALenum param, ALfloat *pflValues);
261 AL_API ALvoid AL_APIENTRY alGetFilteri(ALuint filter, ALenum param, ALint *piValue);
262 AL_API ALvoid AL_APIENTRY alGetFilteriv(ALuint filter, ALenum param, ALint *piValues);
263 AL_API ALvoid AL_APIENTRY alGetFilterf(ALuint filter, ALenum param, ALfloat *pflValue);
264 AL_API ALvoid AL_APIENTRY alGetFilterfv(ALuint filter, ALenum param, ALfloat *pflValues);
266 AL_API ALvoid AL_APIENTRY alGenAuxiliaryEffectSlots(ALsizei n, ALuint *effectslots);
267 AL_API ALvoid AL_APIENTRY alDeleteAuxiliaryEffectSlots(ALsizei n, ALuint *effectslots);
268 AL_API ALboolean AL_APIENTRY alIsAuxiliaryEffectSlot(ALuint effectslot);
269 AL_API ALvoid AL_APIENTRY alAuxiliaryEffectSloti(ALuint effectslot, ALenum param, ALint iValue);
270 AL_API ALvoid AL_APIENTRY alAuxiliaryEffectSlotiv(ALuint effectslot, ALenum param, ALint *piValues);
271 AL_API ALvoid AL_APIENTRY alAuxiliaryEffectSlotf(ALuint effectslot, ALenum param, ALfloat flValue);
272 AL_API ALvoid AL_APIENTRY alAuxiliaryEffectSlotfv(ALuint effectslot, ALenum param, ALfloat *pflValues);
273 AL_API ALvoid AL_APIENTRY alGetAuxiliaryEffectSloti(ALuint effectslot, ALenum param, ALint *piValue);
274 AL_API ALvoid AL_APIENTRY alGetAuxiliaryEffectSlotiv(ALuint effectslot, ALenum param, ALint *piValues);
275 AL_API ALvoid AL_APIENTRY alGetAuxiliaryEffectSlotf(ALuint effectslot, ALenum param, ALfloat *pflValue);
276 AL_API ALvoid AL_APIENTRY alGetAuxiliaryEffectSlotfv(ALuint effectslot, ALenum param, ALfloat *pflValues);
277 #endif
279 /* Filter ranges and defaults. */
281 /* Lowpass filter */
282 #define LOWPASS_MIN_GAIN (0.0f)
283 #define LOWPASS_MAX_GAIN (1.0f)
284 #define LOWPASS_DEFAULT_GAIN (1.0f)
286 #define LOWPASS_MIN_GAINHF (0.0f)
287 #define LOWPASS_MAX_GAINHF (1.0f)
288 #define LOWPASS_DEFAULT_GAINHF (1.0f)
290 /* Highpass filter */
291 #define HIGHPASS_MIN_GAIN (0.0f)
292 #define HIGHPASS_MAX_GAIN (1.0f)
293 #define HIGHPASS_DEFAULT_GAIN (1.0f)
295 #define HIGHPASS_MIN_GAINLF (0.0f)
296 #define HIGHPASS_MAX_GAINLF (1.0f)
297 #define HIGHPASS_DEFAULT_GAINLF (1.0f)
299 /* Bandpass filter */
300 #define BANDPASS_MIN_GAIN (0.0f)
301 #define BANDPASS_MAX_GAIN (1.0f)
302 #define BANDPASS_DEFAULT_GAIN (1.0f)
304 #define BANDPASS_MIN_GAINHF (0.0f)
305 #define BANDPASS_MAX_GAINHF (1.0f)
306 #define BANDPASS_DEFAULT_GAINHF (1.0f)
308 #define BANDPASS_MIN_GAINLF (0.0f)
309 #define BANDPASS_MAX_GAINLF (1.0f)
310 #define BANDPASS_DEFAULT_GAINLF (1.0f)
313 /* Effect parameter ranges and defaults. */
315 /* Standard reverb effect */
316 #define AL_REVERB_MIN_DENSITY (0.0f)
317 #define AL_REVERB_MAX_DENSITY (1.0f)
318 #define AL_REVERB_DEFAULT_DENSITY (1.0f)
320 #define AL_REVERB_MIN_DIFFUSION (0.0f)
321 #define AL_REVERB_MAX_DIFFUSION (1.0f)
322 #define AL_REVERB_DEFAULT_DIFFUSION (1.0f)
324 #define AL_REVERB_MIN_GAIN (0.0f)
325 #define AL_REVERB_MAX_GAIN (1.0f)
326 #define AL_REVERB_DEFAULT_GAIN (0.32f)
328 #define AL_REVERB_MIN_GAINHF (0.0f)
329 #define AL_REVERB_MAX_GAINHF (1.0f)
330 #define AL_REVERB_DEFAULT_GAINHF (0.89f)
332 #define AL_REVERB_MIN_DECAY_TIME (0.1f)
333 #define AL_REVERB_MAX_DECAY_TIME (20.0f)
334 #define AL_REVERB_DEFAULT_DECAY_TIME (1.49f)
336 #define AL_REVERB_MIN_DECAY_HFRATIO (0.1f)
337 #define AL_REVERB_MAX_DECAY_HFRATIO (2.0f)
338 #define AL_REVERB_DEFAULT_DECAY_HFRATIO (0.83f)
340 #define AL_REVERB_MIN_REFLECTIONS_GAIN (0.0f)
341 #define AL_REVERB_MAX_REFLECTIONS_GAIN (3.16f)
342 #define AL_REVERB_DEFAULT_REFLECTIONS_GAIN (0.05f)
344 #define AL_REVERB_MIN_REFLECTIONS_DELAY (0.0f)
345 #define AL_REVERB_MAX_REFLECTIONS_DELAY (0.3f)
346 #define AL_REVERB_DEFAULT_REFLECTIONS_DELAY (0.007f)
348 #define AL_REVERB_MIN_LATE_REVERB_GAIN (0.0f)
349 #define AL_REVERB_MAX_LATE_REVERB_GAIN (10.0f)
350 #define AL_REVERB_DEFAULT_LATE_REVERB_GAIN (1.26f)
352 #define AL_REVERB_MIN_LATE_REVERB_DELAY (0.0f)
353 #define AL_REVERB_MAX_LATE_REVERB_DELAY (0.1f)
354 #define AL_REVERB_DEFAULT_LATE_REVERB_DELAY (0.011f)
356 #define AL_REVERB_MIN_AIR_ABSORPTION_GAINHF (0.892f)
357 #define AL_REVERB_MAX_AIR_ABSORPTION_GAINHF (1.0f)
358 #define AL_REVERB_DEFAULT_AIR_ABSORPTION_GAINHF (0.994f)
360 #define AL_REVERB_MIN_ROOM_ROLLOFF_FACTOR (0.0f)
361 #define AL_REVERB_MAX_ROOM_ROLLOFF_FACTOR (10.0f)
362 #define AL_REVERB_DEFAULT_ROOM_ROLLOFF_FACTOR (0.0f)
364 #define AL_REVERB_MIN_DECAY_HFLIMIT AL_FALSE
365 #define AL_REVERB_MAX_DECAY_HFLIMIT AL_TRUE
366 #define AL_REVERB_DEFAULT_DECAY_HFLIMIT AL_TRUE
368 /* EAX reverb effect */
369 #define AL_EAXREVERB_MIN_DENSITY (0.0f)
370 #define AL_EAXREVERB_MAX_DENSITY (1.0f)
371 #define AL_EAXREVERB_DEFAULT_DENSITY (1.0f)
373 #define AL_EAXREVERB_MIN_DIFFUSION (0.0f)
374 #define AL_EAXREVERB_MAX_DIFFUSION (1.0f)
375 #define AL_EAXREVERB_DEFAULT_DIFFUSION (1.0f)
377 #define AL_EAXREVERB_MIN_GAIN (0.0f)
378 #define AL_EAXREVERB_MAX_GAIN (1.0f)
379 #define AL_EAXREVERB_DEFAULT_GAIN (0.32f)
381 #define AL_EAXREVERB_MIN_GAINHF (0.0f)
382 #define AL_EAXREVERB_MAX_GAINHF (1.0f)
383 #define AL_EAXREVERB_DEFAULT_GAINHF (0.89f)
385 #define AL_EAXREVERB_MIN_GAINLF (0.0f)
386 #define AL_EAXREVERB_MAX_GAINLF (1.0f)
387 #define AL_EAXREVERB_DEFAULT_GAINLF (1.0f)
389 #define AL_EAXREVERB_MIN_DECAY_TIME (0.1f)
390 #define AL_EAXREVERB_MAX_DECAY_TIME (20.0f)
391 #define AL_EAXREVERB_DEFAULT_DECAY_TIME (1.49f)
393 #define AL_EAXREVERB_MIN_DECAY_HFRATIO (0.1f)
394 #define AL_EAXREVERB_MAX_DECAY_HFRATIO (2.0f)
395 #define AL_EAXREVERB_DEFAULT_DECAY_HFRATIO (0.83f)
397 #define AL_EAXREVERB_MIN_DECAY_LFRATIO (0.1f)
398 #define AL_EAXREVERB_MAX_DECAY_LFRATIO (2.0f)
399 #define AL_EAXREVERB_DEFAULT_DECAY_LFRATIO (1.0f)
401 #define AL_EAXREVERB_MIN_REFLECTIONS_GAIN (0.0f)
402 #define AL_EAXREVERB_MAX_REFLECTIONS_GAIN (3.16f)
403 #define AL_EAXREVERB_DEFAULT_REFLECTIONS_GAIN (0.05f)
405 #define AL_EAXREVERB_MIN_REFLECTIONS_DELAY (0.0f)
406 #define AL_EAXREVERB_MAX_REFLECTIONS_DELAY (0.3f)
407 #define AL_EAXREVERB_DEFAULT_REFLECTIONS_DELAY (0.007f)
409 #define AL_EAXREVERB_DEFAULT_REFLECTIONS_PAN_XYZ (0.0f)
411 #define AL_EAXREVERB_MIN_LATE_REVERB_GAIN (0.0f)
412 #define AL_EAXREVERB_MAX_LATE_REVERB_GAIN (10.0f)
413 #define AL_EAXREVERB_DEFAULT_LATE_REVERB_GAIN (1.26f)
415 #define AL_EAXREVERB_MIN_LATE_REVERB_DELAY (0.0f)
416 #define AL_EAXREVERB_MAX_LATE_REVERB_DELAY (0.1f)
417 #define AL_EAXREVERB_DEFAULT_LATE_REVERB_DELAY (0.011f)
419 #define AL_EAXREVERB_DEFAULT_LATE_REVERB_PAN_XYZ (0.0f)
421 #define AL_EAXREVERB_MIN_ECHO_TIME (0.075f)
422 #define AL_EAXREVERB_MAX_ECHO_TIME (0.25f)
423 #define AL_EAXREVERB_DEFAULT_ECHO_TIME (0.25f)
425 #define AL_EAXREVERB_MIN_ECHO_DEPTH (0.0f)
426 #define AL_EAXREVERB_MAX_ECHO_DEPTH (1.0f)
427 #define AL_EAXREVERB_DEFAULT_ECHO_DEPTH (0.0f)
429 #define AL_EAXREVERB_MIN_MODULATION_TIME (0.04f)
430 #define AL_EAXREVERB_MAX_MODULATION_TIME (4.0f)
431 #define AL_EAXREVERB_DEFAULT_MODULATION_TIME (0.25f)
433 #define AL_EAXREVERB_MIN_MODULATION_DEPTH (0.0f)
434 #define AL_EAXREVERB_MAX_MODULATION_DEPTH (1.0f)
435 #define AL_EAXREVERB_DEFAULT_MODULATION_DEPTH (0.0f)
437 #define AL_EAXREVERB_MIN_AIR_ABSORPTION_GAINHF (0.892f)
438 #define AL_EAXREVERB_MAX_AIR_ABSORPTION_GAINHF (1.0f)
439 #define AL_EAXREVERB_DEFAULT_AIR_ABSORPTION_GAINHF (0.994f)
441 #define AL_EAXREVERB_MIN_HFREFERENCE (1000.0f)
442 #define AL_EAXREVERB_MAX_HFREFERENCE (20000.0f)
443 #define AL_EAXREVERB_DEFAULT_HFREFERENCE (5000.0f)
445 #define AL_EAXREVERB_MIN_LFREFERENCE (20.0f)
446 #define AL_EAXREVERB_MAX_LFREFERENCE (1000.0f)
447 #define AL_EAXREVERB_DEFAULT_LFREFERENCE (250.0f)
449 #define AL_EAXREVERB_MIN_ROOM_ROLLOFF_FACTOR (0.0f)
450 #define AL_EAXREVERB_MAX_ROOM_ROLLOFF_FACTOR (10.0f)
451 #define AL_EAXREVERB_DEFAULT_ROOM_ROLLOFF_FACTOR (0.0f)
453 #define AL_EAXREVERB_MIN_DECAY_HFLIMIT AL_FALSE
454 #define AL_EAXREVERB_MAX_DECAY_HFLIMIT AL_TRUE
455 #define AL_EAXREVERB_DEFAULT_DECAY_HFLIMIT AL_TRUE
457 /* Chorus effect */
458 #define AL_CHORUS_WAVEFORM_SINUSOID (0)
459 #define AL_CHORUS_WAVEFORM_TRIANGLE (1)
461 #define AL_CHORUS_MIN_WAVEFORM (0)
462 #define AL_CHORUS_MAX_WAVEFORM (1)
463 #define AL_CHORUS_DEFAULT_WAVEFORM (1)
465 #define AL_CHORUS_MIN_PHASE (-180)
466 #define AL_CHORUS_MAX_PHASE (180)
467 #define AL_CHORUS_DEFAULT_PHASE (90)
469 #define AL_CHORUS_MIN_RATE (0.0f)
470 #define AL_CHORUS_MAX_RATE (10.0f)
471 #define AL_CHORUS_DEFAULT_RATE (1.1f)
473 #define AL_CHORUS_MIN_DEPTH (0.0f)
474 #define AL_CHORUS_MAX_DEPTH (1.0f)
475 #define AL_CHORUS_DEFAULT_DEPTH (0.1f)
477 #define AL_CHORUS_MIN_FEEDBACK (-1.0f)
478 #define AL_CHORUS_MAX_FEEDBACK (1.0f)
479 #define AL_CHORUS_DEFAULT_FEEDBACK (0.25f)
481 #define AL_CHORUS_MIN_DELAY (0.0f)
482 #define AL_CHORUS_MAX_DELAY (0.016f)
483 #define AL_CHORUS_DEFAULT_DELAY (0.016f)
485 /* Distortion effect */
486 #define AL_DISTORTION_MIN_EDGE (0.0f)
487 #define AL_DISTORTION_MAX_EDGE (1.0f)
488 #define AL_DISTORTION_DEFAULT_EDGE (0.2f)
490 #define AL_DISTORTION_MIN_GAIN (0.01f)
491 #define AL_DISTORTION_MAX_GAIN (1.0f)
492 #define AL_DISTORTION_DEFAULT_GAIN (0.05f)
494 #define AL_DISTORTION_MIN_LOWPASS_CUTOFF (80.0f)
495 #define AL_DISTORTION_MAX_LOWPASS_CUTOFF (24000.0f)
496 #define AL_DISTORTION_DEFAULT_LOWPASS_CUTOFF (8000.0f)
498 #define AL_DISTORTION_MIN_EQCENTER (80.0f)
499 #define AL_DISTORTION_MAX_EQCENTER (24000.0f)
500 #define AL_DISTORTION_DEFAULT_EQCENTER (3600.0f)
502 #define AL_DISTORTION_MIN_EQBANDWIDTH (80.0f)
503 #define AL_DISTORTION_MAX_EQBANDWIDTH (24000.0f)
504 #define AL_DISTORTION_DEFAULT_EQBANDWIDTH (3600.0f)
506 /* Echo effect */
507 #define AL_ECHO_MIN_DELAY (0.0f)
508 #define AL_ECHO_MAX_DELAY (0.207f)
509 #define AL_ECHO_DEFAULT_DELAY (0.1f)
511 #define AL_ECHO_MIN_LRDELAY (0.0f)
512 #define AL_ECHO_MAX_LRDELAY (0.404f)
513 #define AL_ECHO_DEFAULT_LRDELAY (0.1f)
515 #define AL_ECHO_MIN_DAMPING (0.0f)
516 #define AL_ECHO_MAX_DAMPING (0.99f)
517 #define AL_ECHO_DEFAULT_DAMPING (0.5f)
519 #define AL_ECHO_MIN_FEEDBACK (0.0f)
520 #define AL_ECHO_MAX_FEEDBACK (1.0f)
521 #define AL_ECHO_DEFAULT_FEEDBACK (0.5f)
523 #define AL_ECHO_MIN_SPREAD (-1.0f)
524 #define AL_ECHO_MAX_SPREAD (1.0f)
525 #define AL_ECHO_DEFAULT_SPREAD (-1.0f)
527 /* Flanger effect */
528 #define AL_FLANGER_WAVEFORM_SINUSOID (0)
529 #define AL_FLANGER_WAVEFORM_TRIANGLE (1)
531 #define AL_FLANGER_MIN_WAVEFORM (0)
532 #define AL_FLANGER_MAX_WAVEFORM (1)
533 #define AL_FLANGER_DEFAULT_WAVEFORM (1)
535 #define AL_FLANGER_MIN_PHASE (-180)
536 #define AL_FLANGER_MAX_PHASE (180)
537 #define AL_FLANGER_DEFAULT_PHASE (0)
539 #define AL_FLANGER_MIN_RATE (0.0f)
540 #define AL_FLANGER_MAX_RATE (10.0f)
541 #define AL_FLANGER_DEFAULT_RATE (0.27f)
543 #define AL_FLANGER_MIN_DEPTH (0.0f)
544 #define AL_FLANGER_MAX_DEPTH (1.0f)
545 #define AL_FLANGER_DEFAULT_DEPTH (1.0f)
547 #define AL_FLANGER_MIN_FEEDBACK (-1.0f)
548 #define AL_FLANGER_MAX_FEEDBACK (1.0f)
549 #define AL_FLANGER_DEFAULT_FEEDBACK (-0.5f)
551 #define AL_FLANGER_MIN_DELAY (0.0f)
552 #define AL_FLANGER_MAX_DELAY (0.004f)
553 #define AL_FLANGER_DEFAULT_DELAY (0.002f)
555 /* Frequency shifter effect */
556 #define AL_FREQUENCY_SHIFTER_MIN_FREQUENCY (0.0f)
557 #define AL_FREQUENCY_SHIFTER_MAX_FREQUENCY (24000.0f)
558 #define AL_FREQUENCY_SHIFTER_DEFAULT_FREQUENCY (0.0f)
560 #define AL_FREQUENCY_SHIFTER_MIN_LEFT_DIRECTION (0)
561 #define AL_FREQUENCY_SHIFTER_MAX_LEFT_DIRECTION (2)
562 #define AL_FREQUENCY_SHIFTER_DEFAULT_LEFT_DIRECTION (0)
564 #define AL_FREQUENCY_SHIFTER_DIRECTION_DOWN (0)
565 #define AL_FREQUENCY_SHIFTER_DIRECTION_UP (1)
566 #define AL_FREQUENCY_SHIFTER_DIRECTION_OFF (2)
568 #define AL_FREQUENCY_SHIFTER_MIN_RIGHT_DIRECTION (0)
569 #define AL_FREQUENCY_SHIFTER_MAX_RIGHT_DIRECTION (2)
570 #define AL_FREQUENCY_SHIFTER_DEFAULT_RIGHT_DIRECTION (0)
572 /* Vocal morpher effect */
573 #define AL_VOCAL_MORPHER_MIN_PHONEMEA (0)
574 #define AL_VOCAL_MORPHER_MAX_PHONEMEA (29)
575 #define AL_VOCAL_MORPHER_DEFAULT_PHONEMEA (0)
577 #define AL_VOCAL_MORPHER_MIN_PHONEMEA_COARSE_TUNING (-24)
578 #define AL_VOCAL_MORPHER_MAX_PHONEMEA_COARSE_TUNING (24)
579 #define AL_VOCAL_MORPHER_DEFAULT_PHONEMEA_COARSE_TUNING (0)
581 #define AL_VOCAL_MORPHER_MIN_PHONEMEB (0)
582 #define AL_VOCAL_MORPHER_MAX_PHONEMEB (29)
583 #define AL_VOCAL_MORPHER_DEFAULT_PHONEMEB (10)
585 #define AL_VOCAL_MORPHER_MIN_PHONEMEB_COARSE_TUNING (-24)
586 #define AL_VOCAL_MORPHER_MAX_PHONEMEB_COARSE_TUNING (24)
587 #define AL_VOCAL_MORPHER_DEFAULT_PHONEMEB_COARSE_TUNING (0)
589 #define AL_VOCAL_MORPHER_PHONEME_A (0)
590 #define AL_VOCAL_MORPHER_PHONEME_E (1)
591 #define AL_VOCAL_MORPHER_PHONEME_I (2)
592 #define AL_VOCAL_MORPHER_PHONEME_O (3)
593 #define AL_VOCAL_MORPHER_PHONEME_U (4)
594 #define AL_VOCAL_MORPHER_PHONEME_AA (5)
595 #define AL_VOCAL_MORPHER_PHONEME_AE (6)
596 #define AL_VOCAL_MORPHER_PHONEME_AH (7)
597 #define AL_VOCAL_MORPHER_PHONEME_AO (8)
598 #define AL_VOCAL_MORPHER_PHONEME_EH (9)
599 #define AL_VOCAL_MORPHER_PHONEME_ER (10)
600 #define AL_VOCAL_MORPHER_PHONEME_IH (11)
601 #define AL_VOCAL_MORPHER_PHONEME_IY (12)
602 #define AL_VOCAL_MORPHER_PHONEME_UH (13)
603 #define AL_VOCAL_MORPHER_PHONEME_UW (14)
604 #define AL_VOCAL_MORPHER_PHONEME_B (15)
605 #define AL_VOCAL_MORPHER_PHONEME_D (16)
606 #define AL_VOCAL_MORPHER_PHONEME_F (17)
607 #define AL_VOCAL_MORPHER_PHONEME_G (18)
608 #define AL_VOCAL_MORPHER_PHONEME_J (19)
609 #define AL_VOCAL_MORPHER_PHONEME_K (20)
610 #define AL_VOCAL_MORPHER_PHONEME_L (21)
611 #define AL_VOCAL_MORPHER_PHONEME_M (22)
612 #define AL_VOCAL_MORPHER_PHONEME_N (23)
613 #define AL_VOCAL_MORPHER_PHONEME_P (24)
614 #define AL_VOCAL_MORPHER_PHONEME_R (25)
615 #define AL_VOCAL_MORPHER_PHONEME_S (26)
616 #define AL_VOCAL_MORPHER_PHONEME_T (27)
617 #define AL_VOCAL_MORPHER_PHONEME_V (28)
618 #define AL_VOCAL_MORPHER_PHONEME_Z (29)
620 #define AL_VOCAL_MORPHER_WAVEFORM_SINUSOID (0)
621 #define AL_VOCAL_MORPHER_WAVEFORM_TRIANGLE (1)
622 #define AL_VOCAL_MORPHER_WAVEFORM_SAWTOOTH (2)
624 #define AL_VOCAL_MORPHER_MIN_WAVEFORM (0)
625 #define AL_VOCAL_MORPHER_MAX_WAVEFORM (2)
626 #define AL_VOCAL_MORPHER_DEFAULT_WAVEFORM (0)
628 #define AL_VOCAL_MORPHER_MIN_RATE (0.0f)
629 #define AL_VOCAL_MORPHER_MAX_RATE (10.0f)
630 #define AL_VOCAL_MORPHER_DEFAULT_RATE (1.41f)
632 /* Pitch shifter effect */
633 #define AL_PITCH_SHIFTER_MIN_COARSE_TUNE (-12)
634 #define AL_PITCH_SHIFTER_MAX_COARSE_TUNE (12)
635 #define AL_PITCH_SHIFTER_DEFAULT_COARSE_TUNE (12)
637 #define AL_PITCH_SHIFTER_MIN_FINE_TUNE (-50)
638 #define AL_PITCH_SHIFTER_MAX_FINE_TUNE (50)
639 #define AL_PITCH_SHIFTER_DEFAULT_FINE_TUNE (0)
641 /* Ring modulator effect */
642 #define AL_RING_MODULATOR_MIN_FREQUENCY (0.0f)
643 #define AL_RING_MODULATOR_MAX_FREQUENCY (8000.0f)
644 #define AL_RING_MODULATOR_DEFAULT_FREQUENCY (440.0f)
646 #define AL_RING_MODULATOR_MIN_HIGHPASS_CUTOFF (0.0f)
647 #define AL_RING_MODULATOR_MAX_HIGHPASS_CUTOFF (24000.0f)
648 #define AL_RING_MODULATOR_DEFAULT_HIGHPASS_CUTOFF (800.0f)
650 #define AL_RING_MODULATOR_SINUSOID (0)
651 #define AL_RING_MODULATOR_SAWTOOTH (1)
652 #define AL_RING_MODULATOR_SQUARE (2)
654 #define AL_RING_MODULATOR_MIN_WAVEFORM (0)
655 #define AL_RING_MODULATOR_MAX_WAVEFORM (2)
656 #define AL_RING_MODULATOR_DEFAULT_WAVEFORM (0)
658 /* Autowah effect */
659 #define AL_AUTOWAH_MIN_ATTACK_TIME (0.0001f)
660 #define AL_AUTOWAH_MAX_ATTACK_TIME (1.0f)
661 #define AL_AUTOWAH_DEFAULT_ATTACK_TIME (0.06f)
663 #define AL_AUTOWAH_MIN_RELEASE_TIME (0.0001f)
664 #define AL_AUTOWAH_MAX_RELEASE_TIME (1.0f)
665 #define AL_AUTOWAH_DEFAULT_RELEASE_TIME (0.06f)
667 #define AL_AUTOWAH_MIN_RESONANCE (2.0f)
668 #define AL_AUTOWAH_MAX_RESONANCE (1000.0f)
669 #define AL_AUTOWAH_DEFAULT_RESONANCE (1000.0f)
671 #define AL_AUTOWAH_MIN_PEAK_GAIN (0.00003f)
672 #define AL_AUTOWAH_MAX_PEAK_GAIN (31621.0f)
673 #define AL_AUTOWAH_DEFAULT_PEAK_GAIN (11.22f)
675 /* Compressor effect */
676 #define AL_COMPRESSOR_MIN_ONOFF (0)
677 #define AL_COMPRESSOR_MAX_ONOFF (1)
678 #define AL_COMPRESSOR_DEFAULT_ONOFF (1)
680 /* Equalizer effect */
681 #define AL_EQUALIZER_MIN_LOW_GAIN (0.126f)
682 #define AL_EQUALIZER_MAX_LOW_GAIN (7.943f)
683 #define AL_EQUALIZER_DEFAULT_LOW_GAIN (1.0f)
685 #define AL_EQUALIZER_MIN_LOW_CUTOFF (50.0f)
686 #define AL_EQUALIZER_MAX_LOW_CUTOFF (800.0f)
687 #define AL_EQUALIZER_DEFAULT_LOW_CUTOFF (200.0f)
689 #define AL_EQUALIZER_MIN_MID1_GAIN (0.126f)
690 #define AL_EQUALIZER_MAX_MID1_GAIN (7.943f)
691 #define AL_EQUALIZER_DEFAULT_MID1_GAIN (1.0f)
693 #define AL_EQUALIZER_MIN_MID1_CENTER (200.0f)
694 #define AL_EQUALIZER_MAX_MID1_CENTER (3000.0f)
695 #define AL_EQUALIZER_DEFAULT_MID1_CENTER (500.0f)
697 #define AL_EQUALIZER_MIN_MID1_WIDTH (0.01f)
698 #define AL_EQUALIZER_MAX_MID1_WIDTH (1.0f)
699 #define AL_EQUALIZER_DEFAULT_MID1_WIDTH (1.0f)
701 #define AL_EQUALIZER_MIN_MID2_GAIN (0.126f)
702 #define AL_EQUALIZER_MAX_MID2_GAIN (7.943f)
703 #define AL_EQUALIZER_DEFAULT_MID2_GAIN (1.0f)
705 #define AL_EQUALIZER_MIN_MID2_CENTER (1000.0f)
706 #define AL_EQUALIZER_MAX_MID2_CENTER (8000.0f)
707 #define AL_EQUALIZER_DEFAULT_MID2_CENTER (3000.0f)
709 #define AL_EQUALIZER_MIN_MID2_WIDTH (0.01f)
710 #define AL_EQUALIZER_MAX_MID2_WIDTH (1.0f)
711 #define AL_EQUALIZER_DEFAULT_MID2_WIDTH (1.0f)
713 #define AL_EQUALIZER_MIN_HIGH_GAIN (0.126f)
714 #define AL_EQUALIZER_MAX_HIGH_GAIN (7.943f)
715 #define AL_EQUALIZER_DEFAULT_HIGH_GAIN (1.0f)
717 #define AL_EQUALIZER_MIN_HIGH_CUTOFF (4000.0f)
718 #define AL_EQUALIZER_MAX_HIGH_CUTOFF (16000.0f)
719 #define AL_EQUALIZER_DEFAULT_HIGH_CUTOFF (6000.0f)
722 /* Source parameter value ranges and defaults. */
723 #define AL_MIN_AIR_ABSORPTION_FACTOR (0.0f)
724 #define AL_MAX_AIR_ABSORPTION_FACTOR (10.0f)
725 #define AL_DEFAULT_AIR_ABSORPTION_FACTOR (0.0f)
727 #define AL_MIN_ROOM_ROLLOFF_FACTOR (0.0f)
728 #define AL_MAX_ROOM_ROLLOFF_FACTOR (10.0f)
729 #define AL_DEFAULT_ROOM_ROLLOFF_FACTOR (0.0f)
731 #define AL_MIN_CONE_OUTER_GAINHF (0.0f)
732 #define AL_MAX_CONE_OUTER_GAINHF (1.0f)
733 #define AL_DEFAULT_CONE_OUTER_GAINHF (1.0f)
735 #define AL_MIN_DIRECT_FILTER_GAINHF_AUTO AL_FALSE
736 #define AL_MAX_DIRECT_FILTER_GAINHF_AUTO AL_TRUE
737 #define AL_DEFAULT_DIRECT_FILTER_GAINHF_AUTO AL_TRUE
739 #define AL_MIN_AUXILIARY_SEND_FILTER_GAIN_AUTO AL_FALSE
740 #define AL_MAX_AUXILIARY_SEND_FILTER_GAIN_AUTO AL_TRUE
741 #define AL_DEFAULT_AUXILIARY_SEND_FILTER_GAIN_AUTO AL_TRUE
743 #define AL_MIN_AUXILIARY_SEND_FILTER_GAINHF_AUTO AL_FALSE
744 #define AL_MAX_AUXILIARY_SEND_FILTER_GAINHF_AUTO AL_TRUE
745 #define AL_DEFAULT_AUXILIARY_SEND_FILTER_GAINHF_AUTO AL_TRUE
748 /* Listener parameter value ranges and defaults. */
749 #define AL_MIN_METERS_PER_UNIT FLT_MIN
750 #define AL_MAX_METERS_PER_UNIT FLT_MAX
751 #define AL_DEFAULT_METERS_PER_UNIT (1.0f)
754 #ifdef __cplusplus
755 } /* extern "C" */
756 #endif
758 #endif /* AL_EFX_H */