Add reverb parameters
[openal-soft.git] / OpenAL32 / alExtension.c
blob5664efce8e2c8d663da6e1cf10486c90faa70c3e
1 /**
2 * OpenAL cross platform audio library
3 * Copyright (C) 1999-2007 by authors.
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Library General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Library General Public License for more details.
14 * You should have received a copy of the GNU Library General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
18 * Or go to http://www.gnu.org/copyleft/lgpl.html
21 #include <stdlib.h>
22 #include <string.h>
23 #include <ctype.h>
24 #include "alExtension.h"
25 #include "alError.h"
26 #include "alMain.h"
27 #include "alFilter.h"
28 #include "alEffect.h"
29 #include "alAuxEffectSlot.h"
30 #include "alSource.h"
31 #include "AL/al.h"
32 #include "AL/alc.h"
34 static ALfunction function[]= {
35 { "alEnable", (ALvoid *) alEnable },
36 { "alDisable", (ALvoid *) alDisable },
37 { "alIsEnabled", (ALvoid *) alIsEnabled },
38 { "alGetString", (ALvoid *) alGetString },
39 { "alGetBooleanv", (ALvoid *) alGetBooleanv },
40 { "alGetIntegerv", (ALvoid *) alGetIntegerv },
41 { "alGetFloatv", (ALvoid *) alGetFloatv },
42 { "alGetDoublev", (ALvoid *) alGetDoublev },
43 { "alGetBoolean", (ALvoid *) alGetBoolean },
44 { "alGetInteger", (ALvoid *) alGetInteger },
45 { "alGetFloat", (ALvoid *) alGetFloat },
46 { "alGetDouble", (ALvoid *) alGetDouble },
47 { "alGetError", (ALvoid *) alGetError },
48 { "alIsExtensionPresent", (ALvoid *) alIsExtensionPresent },
49 { "alGetProcAddress", (ALvoid *) alGetProcAddress },
50 { "alGetEnumValue", (ALvoid *) alGetEnumValue },
51 { "alListenerf", (ALvoid *) alListenerf },
52 { "alListener3f", (ALvoid *) alListener3f },
53 { "alListenerfv", (ALvoid *) alListenerfv },
54 { "alListeneri", (ALvoid *) alListeneri },
55 { "alListener3i", (ALvoid *) alListener3i },
56 { "alListeneriv", (ALvoid *) alListeneriv },
57 { "alGetListenerf", (ALvoid *) alGetListenerf },
58 { "alGetListener3f", (ALvoid *) alGetListener3f },
59 { "alGetListenerfv", (ALvoid *) alGetListenerfv },
60 { "alGetListeneri", (ALvoid *) alGetListeneri },
61 { "alGetListener3i", (ALvoid *) alGetListener3i },
62 { "alGetListeneriv", (ALvoid *) alGetListeneriv },
63 { "alGenSources", (ALvoid *) alGenSources },
64 { "alDeleteSources", (ALvoid *) alDeleteSources },
65 { "alIsSource", (ALvoid *) alIsSource },
66 { "alSourcef", (ALvoid *) alSourcef },
67 { "alSource3f", (ALvoid *) alSource3f },
68 { "alSourcefv", (ALvoid *) alSourcefv },
69 { "alSourcei", (ALvoid *) alSourcei },
70 { "alSource3i", (ALvoid *) alSource3i },
71 { "alSourceiv", (ALvoid *) alSourceiv },
72 { "alGetSourcef", (ALvoid *) alGetSourcef },
73 { "alGetSource3f", (ALvoid *) alGetSource3f },
74 { "alGetSourcefv", (ALvoid *) alGetSourcefv },
75 { "alGetSourcei", (ALvoid *) alGetSourcei },
76 { "alGetSource3i", (ALvoid *) alGetSource3i },
77 { "alGetSourceiv", (ALvoid *) alGetSourceiv },
78 { "alSourcePlayv", (ALvoid *) alSourcePlayv },
79 { "alSourceStopv", (ALvoid *) alSourceStopv },
80 { "alSourceRewindv", (ALvoid *) alSourceRewindv },
81 { "alSourcePausev", (ALvoid *) alSourcePausev },
82 { "alSourcePlay", (ALvoid *) alSourcePlay },
83 { "alSourceStop", (ALvoid *) alSourceStop },
84 { "alSourceRewind", (ALvoid *) alSourceRewind },
85 { "alSourcePause", (ALvoid *) alSourcePause },
86 { "alSourceQueueBuffers", (ALvoid *) alSourceQueueBuffers },
87 { "alSourceUnqueueBuffers", (ALvoid *) alSourceUnqueueBuffers },
88 { "alGenBuffers", (ALvoid *) alGenBuffers },
89 { "alDeleteBuffers", (ALvoid *) alDeleteBuffers },
90 { "alIsBuffer", (ALvoid *) alIsBuffer },
91 { "alBufferData", (ALvoid *) alBufferData },
92 { "alBufferf", (ALvoid *) alBufferf },
93 { "alBuffer3f", (ALvoid *) alBuffer3f },
94 { "alBufferfv", (ALvoid *) alBufferfv },
95 { "alBufferi", (ALvoid *) alBufferi },
96 { "alBuffer3i", (ALvoid *) alBuffer3i },
97 { "alBufferiv", (ALvoid *) alBufferiv },
98 { "alGetBufferf", (ALvoid *) alGetBufferf },
99 { "alGetBuffer3f", (ALvoid *) alGetBuffer3f },
100 { "alGetBufferfv", (ALvoid *) alGetBufferfv },
101 { "alGetBufferi", (ALvoid *) alGetBufferi },
102 { "alGetBuffer3i", (ALvoid *) alGetBuffer3i },
103 { "alGetBufferiv", (ALvoid *) alGetBufferiv },
104 { "alDopplerFactor", (ALvoid *) alDopplerFactor },
105 { "alDopplerVelocity", (ALvoid *) alDopplerVelocity },
106 { "alSpeedOfSound", (ALvoid *) alSpeedOfSound },
107 { "alDistanceModel", (ALvoid *) alDistanceModel },
109 { "alGenFilters", (ALvoid *) alGenFilters },
110 { "alDeleteFilters", (ALvoid *) alDeleteFilters },
111 { "alIsFilter", (ALvoid *) alIsFilter },
112 { "alFilteri", (ALvoid *) alFilteri },
113 { "alFilteriv", (ALvoid *) alFilteriv },
114 { "alFilterf", (ALvoid *) alFilterf },
115 { "alFilterfv", (ALvoid *) alFilterfv },
116 { "alGetFilteri", (ALvoid *) alGetFilteri },
117 { "alGetFilteriv", (ALvoid *) alGetFilteriv },
118 { "alGetFilterf", (ALvoid *) alGetFilterf },
119 { "alGetFilterfv", (ALvoid *) alGetFilterfv },
121 { "alGenEffects", (ALvoid *) alGenEffects },
122 { "alDeleteEffects", (ALvoid *) alDeleteEffects },
123 { "alIsEffect", (ALvoid *) alIsEffect },
124 { "alEffecti", (ALvoid *) alEffecti },
125 { "alEffectiv", (ALvoid *) alEffectiv },
126 { "alEffectf", (ALvoid *) alEffectf },
127 { "alEffectfv", (ALvoid *) alEffectfv },
128 { "alGetEffecti", (ALvoid *) alGetEffecti },
129 { "alGetEffectiv", (ALvoid *) alGetEffectiv },
130 { "alGetEffectf", (ALvoid *) alGetEffectf },
131 { "alGetEffectfv", (ALvoid *) alGetEffectfv },
133 { "alGenAuxiliaryEffectSlots", (ALvoid *) alGenAuxiliaryEffectSlots },
134 { "alDeleteAuxiliaryEffectSlots",(ALvoid *) alDeleteAuxiliaryEffectSlots},
135 { "alIsAuxiliaryEffectSlot", (ALvoid *) alIsAuxiliaryEffectSlot },
136 { "alAuxiliaryEffectSloti", (ALvoid *) alAuxiliaryEffectSloti },
137 { "alAuxiliaryEffectSlotiv", (ALvoid *) alAuxiliaryEffectSlotiv },
138 { "alAuxiliaryEffectSlotf", (ALvoid *) alAuxiliaryEffectSlotf },
139 { "alAuxiliaryEffectSlotfv", (ALvoid *) alAuxiliaryEffectSlotfv },
140 { "alGetAuxiliaryEffectSloti", (ALvoid *) alGetAuxiliaryEffectSloti },
141 { "alGetAuxiliaryEffectSlotiv", (ALvoid *) alGetAuxiliaryEffectSlotiv},
142 { "alGetAuxiliaryEffectSlotf", (ALvoid *) alGetAuxiliaryEffectSlotf },
143 { "alGetAuxiliaryEffectSlotfv", (ALvoid *) alGetAuxiliaryEffectSlotfv},
145 { NULL, (ALvoid *) NULL } };
147 static ALenums enumeration[]={
148 // Types
149 { (ALchar *)"AL_INVALID", AL_INVALID },
150 { (ALchar *)"AL_NONE", AL_NONE },
151 { (ALchar *)"AL_FALSE", AL_FALSE },
152 { (ALchar *)"AL_TRUE", AL_TRUE },
154 // Source and Listener Properties
155 { (ALchar *)"AL_SOURCE_RELATIVE", AL_SOURCE_RELATIVE },
156 { (ALchar *)"AL_CONE_INNER_ANGLE", AL_CONE_INNER_ANGLE },
157 { (ALchar *)"AL_CONE_OUTER_ANGLE", AL_CONE_OUTER_ANGLE },
158 { (ALchar *)"AL_PITCH", AL_PITCH },
159 { (ALchar *)"AL_POSITION", AL_POSITION },
160 { (ALchar *)"AL_DIRECTION", AL_DIRECTION },
161 { (ALchar *)"AL_VELOCITY", AL_VELOCITY },
162 { (ALchar *)"AL_LOOPING", AL_LOOPING },
163 { (ALchar *)"AL_BUFFER", AL_BUFFER },
164 { (ALchar *)"AL_GAIN", AL_GAIN },
165 { (ALchar *)"AL_MIN_GAIN", AL_MIN_GAIN },
166 { (ALchar *)"AL_MAX_GAIN", AL_MAX_GAIN },
167 { (ALchar *)"AL_ORIENTATION", AL_ORIENTATION },
168 { (ALchar *)"AL_REFERENCE_DISTANCE", AL_REFERENCE_DISTANCE },
169 { (ALchar *)"AL_ROLLOFF_FACTOR", AL_ROLLOFF_FACTOR },
170 { (ALchar *)"AL_CONE_OUTER_GAIN", AL_CONE_OUTER_GAIN },
171 { (ALchar *)"AL_MAX_DISTANCE", AL_MAX_DISTANCE },
172 { (ALchar *)"AL_SEC_OFFSET", AL_SEC_OFFSET },
173 { (ALchar *)"AL_SAMPLE_OFFSET", AL_SAMPLE_OFFSET },
174 { (ALchar *)"AL_BYTE_OFFSET", AL_BYTE_OFFSET },
175 { (ALchar *)"AL_SOURCE_TYPE", AL_SOURCE_TYPE },
176 { (ALchar *)"AL_STATIC", AL_STATIC },
177 { (ALchar *)"AL_STREAMING", AL_STREAMING },
178 { (ALchar *)"AL_UNDETERMINED", AL_UNDETERMINED },
179 { (ALchar *)"AL_METERS_PER_UNIT", AL_METERS_PER_UNIT },
181 // Source EFX Properties
182 { (ALchar *)"AL_DIRECT_FILTER", AL_DIRECT_FILTER },
183 { (ALchar *)"AL_AUXILIARY_SEND_FILTER", AL_AUXILIARY_SEND_FILTER },
184 { (ALchar *)"AL_AIR_ABSORPTION_FACTOR", AL_AIR_ABSORPTION_FACTOR },
185 { (ALchar *)"AL_ROOM_ROLLOFF_FACTOR", AL_ROOM_ROLLOFF_FACTOR },
186 { (ALchar *)"AL_CONE_OUTER_GAINHF", AL_CONE_OUTER_GAINHF },
187 { (ALchar *)"AL_DIRECT_FILTER_GAINHF_AUTO", AL_DIRECT_FILTER_GAINHF_AUTO },
188 { (ALchar *)"AL_AUXILIARY_SEND_FILTER_GAIN_AUTO", AL_AUXILIARY_SEND_FILTER_GAIN_AUTO },
189 { (ALchar *)"AL_AUXILIARY_SEND_FILTER_GAINHF_AUTO", AL_AUXILIARY_SEND_FILTER_GAINHF_AUTO},
192 // Source State information
193 { (ALchar *)"AL_SOURCE_STATE", AL_SOURCE_STATE },
194 { (ALchar *)"AL_INITIAL", AL_INITIAL },
195 { (ALchar *)"AL_PLAYING", AL_PLAYING },
196 { (ALchar *)"AL_PAUSED", AL_PAUSED },
197 { (ALchar *)"AL_STOPPED", AL_STOPPED },
199 // Queue information
200 { (ALchar *)"AL_BUFFERS_QUEUED", AL_BUFFERS_QUEUED },
201 { (ALchar *)"AL_BUFFERS_PROCESSED", AL_BUFFERS_PROCESSED },
203 // Buffer Formats
204 { (ALchar *)"AL_FORMAT_MONO8", AL_FORMAT_MONO8 },
205 { (ALchar *)"AL_FORMAT_MONO16", AL_FORMAT_MONO16 },
206 { (ALchar *)"AL_FORMAT_MONO_FLOAT32", AL_FORMAT_MONO_FLOAT32 },
207 { (ALchar *)"AL_FORMAT_STEREO8", AL_FORMAT_STEREO8 },
208 { (ALchar *)"AL_FORMAT_STEREO16", AL_FORMAT_STEREO16 },
209 { (ALchar *)"AL_FORMAT_STEREO_FLOAT32", AL_FORMAT_STEREO_FLOAT32 },
210 { (ALchar *)"AL_FORMAT_MONO_IMA4", AL_FORMAT_MONO_IMA4 },
211 { (ALchar *)"AL_FORMAT_STEREO_IMA4", AL_FORMAT_STEREO_IMA4 },
212 { (ALchar *)"AL_FORMAT_QUAD8_LOKI", AL_FORMAT_QUAD8_LOKI },
213 { (ALchar *)"AL_FORMAT_QUAD16_LOKI", AL_FORMAT_QUAD16_LOKI },
214 { (ALchar *)"AL_FORMAT_QUAD8", AL_FORMAT_QUAD8 },
215 { (ALchar *)"AL_FORMAT_QUAD16", AL_FORMAT_QUAD16 },
216 { (ALchar *)"AL_FORMAT_QUAD32", AL_FORMAT_QUAD32 },
217 { (ALchar *)"AL_FORMAT_51CHN8", AL_FORMAT_51CHN8 },
218 { (ALchar *)"AL_FORMAT_51CHN16", AL_FORMAT_51CHN16 },
219 { (ALchar *)"AL_FORMAT_51CHN32", AL_FORMAT_51CHN32 },
220 { (ALchar *)"AL_FORMAT_61CHN8", AL_FORMAT_61CHN8 },
221 { (ALchar *)"AL_FORMAT_61CHN16", AL_FORMAT_61CHN16 },
222 { (ALchar *)"AL_FORMAT_61CHN32", AL_FORMAT_61CHN32 },
223 { (ALchar *)"AL_FORMAT_71CHN8", AL_FORMAT_71CHN8 },
224 { (ALchar *)"AL_FORMAT_71CHN16", AL_FORMAT_71CHN16 },
225 { (ALchar *)"AL_FORMAT_71CHN32", AL_FORMAT_71CHN32 },
226 { (ALchar *)"AL_FORMAT_REAR8", AL_FORMAT_REAR8 },
227 { (ALchar *)"AL_FORMAT_REAR16", AL_FORMAT_REAR16 },
228 { (ALchar *)"AL_FORMAT_REAR32", AL_FORMAT_REAR32 },
230 // Buffer attributes
231 { (ALchar *)"AL_FREQUENCY", AL_FREQUENCY },
232 { (ALchar *)"AL_BITS", AL_BITS },
233 { (ALchar *)"AL_CHANNELS", AL_CHANNELS },
234 { (ALchar *)"AL_SIZE", AL_SIZE },
236 // Buffer States (not supported yet)
237 { (ALchar *)"AL_UNUSED", AL_UNUSED },
238 { (ALchar *)"AL_PENDING", AL_PENDING },
239 { (ALchar *)"AL_PROCESSED", AL_PROCESSED },
241 // AL Error Messages
242 { (ALchar *)"AL_NO_ERROR", AL_NO_ERROR },
243 { (ALchar *)"AL_INVALID_NAME", AL_INVALID_NAME },
244 { (ALchar *)"AL_INVALID_ENUM", AL_INVALID_ENUM },
245 { (ALchar *)"AL_INVALID_VALUE", AL_INVALID_VALUE },
246 { (ALchar *)"AL_INVALID_OPERATION", AL_INVALID_OPERATION },
247 { (ALchar *)"AL_OUT_OF_MEMORY", AL_OUT_OF_MEMORY },
249 // Context strings
250 { (ALchar *)"AL_VENDOR", AL_VENDOR },
251 { (ALchar *)"AL_VERSION", AL_VERSION },
252 { (ALchar *)"AL_RENDERER", AL_RENDERER },
253 { (ALchar *)"AL_EXTENSIONS", AL_EXTENSIONS },
255 // Global states
256 { (ALchar *)"AL_DOPPLER_FACTOR", AL_DOPPLER_FACTOR },
257 { (ALchar *)"AL_DOPPLER_VELOCITY", AL_DOPPLER_VELOCITY },
258 { (ALchar *)"AL_DISTANCE_MODEL", AL_DISTANCE_MODEL },
259 { (ALchar *)"AL_SPEED_OF_SOUND", AL_SPEED_OF_SOUND },
261 // Distance Models
262 { (ALchar *)"AL_INVERSE_DISTANCE", AL_INVERSE_DISTANCE },
263 { (ALchar *)"AL_INVERSE_DISTANCE_CLAMPED", AL_INVERSE_DISTANCE_CLAMPED },
264 { (ALchar *)"AL_LINEAR_DISTANCE", AL_LINEAR_DISTANCE },
265 { (ALchar *)"AL_LINEAR_DISTANCE_CLAMPED", AL_LINEAR_DISTANCE_CLAMPED },
266 { (ALchar *)"AL_EXPONENT_DISTANCE", AL_EXPONENT_DISTANCE },
267 { (ALchar *)"AL_EXPONENT_DISTANCE_CLAMPED", AL_EXPONENT_DISTANCE_CLAMPED },
269 // Filter types
270 { (ALchar *)"AL_FILTER_TYPE", AL_FILTER_TYPE },
271 { (ALchar *)"AL_FILTER_NULL", AL_FILTER_NULL },
272 { (ALchar *)"AL_FILTER_LOWPASS", AL_FILTER_LOWPASS },
273 { (ALchar *)"AL_FILTER_HIGHPASS", AL_FILTER_HIGHPASS },
274 { (ALchar *)"AL_FILTER_BANDPASS", AL_FILTER_BANDPASS },
276 // Filter params
277 { (ALchar *)"AL_LOWPASS_GAIN", AL_LOWPASS_GAIN },
278 { (ALchar *)"AL_LOWPASS_GAINHF", AL_LOWPASS_GAINHF },
280 // Effect types
281 { (ALchar *)"AL_EFFECT_TYPE", AL_EFFECT_TYPE },
282 { (ALchar *)"AL_EFFECT_NULL", AL_EFFECT_NULL },
283 { (ALchar *)"AL_EFFECT_REVERB", AL_EFFECT_REVERB },
284 { (ALchar *)"AL_EFFECT_CHORUS", AL_EFFECT_CHORUS },
285 { (ALchar *)"AL_EFFECT_DISTORTION", AL_EFFECT_DISTORTION },
286 { (ALchar *)"AL_EFFECT_ECHO", AL_EFFECT_ECHO },
287 { (ALchar *)"AL_EFFECT_FLANGER", AL_EFFECT_FLANGER },
288 { (ALchar *)"AL_EFFECT_FREQUENCY_SHIFTER", AL_EFFECT_FREQUENCY_SHIFTER },
289 { (ALchar *)"AL_EFFECT_VOCAL_MORPHER", AL_EFFECT_VOCAL_MORPHER },
290 { (ALchar *)"AL_EFFECT_PITCH_SHIFTER", AL_EFFECT_PITCH_SHIFTER },
291 { (ALchar *)"AL_EFFECT_RING_MODULATOR", AL_EFFECT_RING_MODULATOR },
292 { (ALchar *)"AL_EFFECT_AUTOWAH", AL_EFFECT_AUTOWAH },
293 { (ALchar *)"AL_EFFECT_COMPRESSOR", AL_EFFECT_COMPRESSOR },
294 { (ALchar *)"AL_EFFECT_EQUALIZER", AL_EFFECT_EQUALIZER },
296 // Reverb params
297 { (ALchar *)"AL_REVERB_DENSITY", AL_REVERB_DENSITY },
298 { (ALchar *)"AL_REVERB_DIFFUSION", AL_REVERB_DIFFUSION },
299 { (ALchar *)"AL_REVERB_GAIN", AL_REVERB_GAIN },
300 { (ALchar *)"AL_REVERB_GAINHF", AL_REVERB_GAINHF },
301 { (ALchar *)"AL_REVERB_DECAY_TIME", AL_REVERB_DECAY_TIME },
302 { (ALchar *)"AL_REVERB_DECAY_HFRATIO", AL_REVERB_DECAY_HFRATIO },
303 { (ALchar *)"AL_REVERB_REFLECTIONS_GAIN", AL_REVERB_REFLECTIONS_GAIN },
304 { (ALchar *)"AL_REVERB_REFLECTIONS_DELAY", AL_REVERB_REFLECTIONS_DELAY },
305 { (ALchar *)"AL_REVERB_LATE_REVERB_GAIN", AL_REVERB_LATE_REVERB_GAIN },
306 { (ALchar *)"AL_REVERB_LATE_REVERB_DELAY", AL_REVERB_LATE_REVERB_DELAY },
307 { (ALchar *)"AL_REVERB_AIR_ABSORPTION_GAINHF", AL_REVERB_AIR_ABSORPTION_GAINHF },
308 { (ALchar *)"AL_REVERB_ROOM_ROLLOFF_FACTOR", AL_REVERB_ROOM_ROLLOFF_FACTOR },
309 { (ALchar *)"AL_REVERB_DECAY_HFLIMIT", AL_REVERB_DECAY_HFLIMIT },
312 // Default
313 { (ALchar *)NULL, (ALenum)0 }
318 ALAPI ALboolean ALAPIENTRY alIsExtensionPresent(const ALchar *extName)
320 ALboolean bIsSupported = AL_FALSE;
321 ALCcontext *pContext;
322 const char *ptr;
323 size_t len;
325 if (!extName)
327 alSetError(AL_INVALID_VALUE);
328 return AL_FALSE;
331 pContext = alcGetCurrentContext();
332 if(!pContext)
334 alSetError(AL_INVALID_OPERATION);
335 return AL_FALSE;
338 SuspendContext(pContext);
340 len = strlen(extName);
341 ptr = pContext->ExtensionList;
342 while(ptr && *ptr)
344 if(strncasecmp(ptr, extName, len) == 0 &&
345 (ptr[len] == '\0' || isspace(ptr[len])))
347 bIsSupported = AL_TRUE;
348 break;
350 if((ptr=strchr(ptr, ' ')) != NULL)
352 do {
353 ++ptr;
354 } while(isspace(*ptr));
358 ProcessContext(pContext);
360 return bIsSupported;
364 ALAPI ALvoid * ALAPIENTRY alGetProcAddress(const ALchar *funcName)
366 ALsizei i = 0;
368 while(function[i].funcName &&
369 strcmp((char*)function[i].funcName, (char*)funcName) != 0)
370 i++;
372 return function[i].address;
375 /* NOTE: This function must be able to run without a context! */
376 ALAPI ALenum ALAPIENTRY alGetEnumValue(const ALchar *enumName)
378 ALsizei i = 0;
380 while(enumeration[i].enumName &&
381 strcmp(enumeration[i].enumName, enumName) != 0)
382 i++;
384 return enumeration[i].value;