Round up the device's default slot alignment
[openal-soft.git] / Alc / ALc.c
blob08013b879c697148115df5e2d302d020e13dec3f
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 "config.h"
23 #include <math.h>
24 #include <stdlib.h>
25 #include <stdio.h>
26 #include <memory.h>
27 #include <ctype.h>
28 #include <signal.h>
30 #include "alMain.h"
31 #include "alSource.h"
32 #include "AL/al.h"
33 #include "AL/alc.h"
34 #include "alThunk.h"
35 #include "alSource.h"
36 #include "alBuffer.h"
37 #include "alAuxEffectSlot.h"
38 #include "alError.h"
39 #include "bs2b.h"
40 #include "alu.h"
43 /************************************************
44 * Backends
45 ************************************************/
46 #define EmptyFuncs { NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL }
47 static struct BackendInfo BackendList[] = {
48 #ifdef HAVE_PULSEAUDIO
49 { "pulse", alc_pulse_init, alc_pulse_deinit, alc_pulse_probe, EmptyFuncs },
50 #endif
51 #ifdef HAVE_ALSA
52 { "alsa", alc_alsa_init, alc_alsa_deinit, alc_alsa_probe, EmptyFuncs },
53 #endif
54 #ifdef HAVE_COREAUDIO
55 { "core", alc_ca_init, alc_ca_deinit, alc_ca_probe, EmptyFuncs },
56 #endif
57 #ifdef HAVE_OSS
58 { "oss", alc_oss_init, alc_oss_deinit, alc_oss_probe, EmptyFuncs },
59 #endif
60 #ifdef HAVE_SOLARIS
61 { "solaris", alc_solaris_init, alc_solaris_deinit, alc_solaris_probe, EmptyFuncs },
62 #endif
63 #ifdef HAVE_SNDIO
64 { "sndio", alc_sndio_init, alc_sndio_deinit, alc_sndio_probe, EmptyFuncs },
65 #endif
66 #ifdef HAVE_MMDEVAPI
67 { "mmdevapi", alcMMDevApiInit, alcMMDevApiDeinit, alcMMDevApiProbe, EmptyFuncs },
68 #endif
69 #ifdef HAVE_DSOUND
70 { "dsound", alcDSoundInit, alcDSoundDeinit, alcDSoundProbe, EmptyFuncs },
71 #endif
72 #ifdef HAVE_WINMM
73 { "winmm", alcWinMMInit, alcWinMMDeinit, alcWinMMProbe, EmptyFuncs },
74 #endif
75 #ifdef HAVE_PORTAUDIO
76 { "port", alc_pa_init, alc_pa_deinit, alc_pa_probe, EmptyFuncs },
77 #endif
78 #ifdef HAVE_OPENSL
79 { "opensl", alc_opensl_init, alc_opensl_deinit, alc_opensl_probe, EmptyFuncs },
80 #endif
82 { "null", alc_null_init, alc_null_deinit, alc_null_probe, EmptyFuncs },
83 #ifdef HAVE_WAVE
84 { "wave", alc_wave_init, alc_wave_deinit, alc_wave_probe, EmptyFuncs },
85 #endif
87 { NULL, NULL, NULL, NULL, EmptyFuncs }
89 static struct BackendInfo BackendLoopback = {
90 "loopback", alc_loopback_init, alc_loopback_deinit, alc_loopback_probe, EmptyFuncs
92 #undef EmptyFuncs
94 static struct BackendInfo PlaybackBackend;
95 static struct BackendInfo CaptureBackend;
97 /************************************************
98 * Functions, enums, and errors
99 ************************************************/
100 typedef struct ALCfunction {
101 const ALCchar *funcName;
102 ALCvoid *address;
103 } ALCfunction;
105 typedef struct ALCenums {
106 const ALCchar *enumName;
107 ALCenum value;
108 } ALCenums;
110 #define DECL(x) { #x, (ALCvoid*)(x) }
111 static const ALCfunction alcFunctions[] = {
112 DECL(alcCreateContext),
113 DECL(alcMakeContextCurrent),
114 DECL(alcProcessContext),
115 DECL(alcSuspendContext),
116 DECL(alcDestroyContext),
117 DECL(alcGetCurrentContext),
118 DECL(alcGetContextsDevice),
119 DECL(alcOpenDevice),
120 DECL(alcCloseDevice),
121 DECL(alcGetError),
122 DECL(alcIsExtensionPresent),
123 DECL(alcGetProcAddress),
124 DECL(alcGetEnumValue),
125 DECL(alcGetString),
126 DECL(alcGetIntegerv),
127 DECL(alcCaptureOpenDevice),
128 DECL(alcCaptureCloseDevice),
129 DECL(alcCaptureStart),
130 DECL(alcCaptureStop),
131 DECL(alcCaptureSamples),
133 DECL(alcSetThreadContext),
134 DECL(alcGetThreadContext),
136 DECL(alcLoopbackOpenDeviceSOFT),
137 DECL(alcIsRenderFormatSupportedSOFT),
138 DECL(alcRenderSamplesSOFT),
140 DECL(alEnable),
141 DECL(alDisable),
142 DECL(alIsEnabled),
143 DECL(alGetString),
144 DECL(alGetBooleanv),
145 DECL(alGetIntegerv),
146 DECL(alGetFloatv),
147 DECL(alGetDoublev),
148 DECL(alGetBoolean),
149 DECL(alGetInteger),
150 DECL(alGetFloat),
151 DECL(alGetDouble),
152 DECL(alGetError),
153 DECL(alIsExtensionPresent),
154 DECL(alGetProcAddress),
155 DECL(alGetEnumValue),
156 DECL(alListenerf),
157 DECL(alListener3f),
158 DECL(alListenerfv),
159 DECL(alListeneri),
160 DECL(alListener3i),
161 DECL(alListeneriv),
162 DECL(alGetListenerf),
163 DECL(alGetListener3f),
164 DECL(alGetListenerfv),
165 DECL(alGetListeneri),
166 DECL(alGetListener3i),
167 DECL(alGetListeneriv),
168 DECL(alGenSources),
169 DECL(alDeleteSources),
170 DECL(alIsSource),
171 DECL(alSourcef),
172 DECL(alSource3f),
173 DECL(alSourcefv),
174 DECL(alSourcei),
175 DECL(alSource3i),
176 DECL(alSourceiv),
177 DECL(alGetSourcef),
178 DECL(alGetSource3f),
179 DECL(alGetSourcefv),
180 DECL(alGetSourcei),
181 DECL(alGetSource3i),
182 DECL(alGetSourceiv),
183 DECL(alSourcePlayv),
184 DECL(alSourceStopv),
185 DECL(alSourceRewindv),
186 DECL(alSourcePausev),
187 DECL(alSourcePlay),
188 DECL(alSourceStop),
189 DECL(alSourceRewind),
190 DECL(alSourcePause),
191 DECL(alSourceQueueBuffers),
192 DECL(alSourceUnqueueBuffers),
193 DECL(alGenBuffers),
194 DECL(alDeleteBuffers),
195 DECL(alIsBuffer),
196 DECL(alBufferData),
197 DECL(alBufferf),
198 DECL(alBuffer3f),
199 DECL(alBufferfv),
200 DECL(alBufferi),
201 DECL(alBuffer3i),
202 DECL(alBufferiv),
203 DECL(alGetBufferf),
204 DECL(alGetBuffer3f),
205 DECL(alGetBufferfv),
206 DECL(alGetBufferi),
207 DECL(alGetBuffer3i),
208 DECL(alGetBufferiv),
209 DECL(alDopplerFactor),
210 DECL(alDopplerVelocity),
211 DECL(alSpeedOfSound),
212 DECL(alDistanceModel),
214 DECL(alGenFilters),
215 DECL(alDeleteFilters),
216 DECL(alIsFilter),
217 DECL(alFilteri),
218 DECL(alFilteriv),
219 DECL(alFilterf),
220 DECL(alFilterfv),
221 DECL(alGetFilteri),
222 DECL(alGetFilteriv),
223 DECL(alGetFilterf),
224 DECL(alGetFilterfv),
225 DECL(alGenEffects),
226 DECL(alDeleteEffects),
227 DECL(alIsEffect),
228 DECL(alEffecti),
229 DECL(alEffectiv),
230 DECL(alEffectf),
231 DECL(alEffectfv),
232 DECL(alGetEffecti),
233 DECL(alGetEffectiv),
234 DECL(alGetEffectf),
235 DECL(alGetEffectfv),
236 DECL(alGenAuxiliaryEffectSlots),
237 DECL(alDeleteAuxiliaryEffectSlots),
238 DECL(alIsAuxiliaryEffectSlot),
239 DECL(alAuxiliaryEffectSloti),
240 DECL(alAuxiliaryEffectSlotiv),
241 DECL(alAuxiliaryEffectSlotf),
242 DECL(alAuxiliaryEffectSlotfv),
243 DECL(alGetAuxiliaryEffectSloti),
244 DECL(alGetAuxiliaryEffectSlotiv),
245 DECL(alGetAuxiliaryEffectSlotf),
246 DECL(alGetAuxiliaryEffectSlotfv),
248 DECL(alBufferSubDataSOFT),
250 DECL(alBufferSamplesSOFT),
251 DECL(alBufferSubSamplesSOFT),
252 DECL(alGetBufferSamplesSOFT),
253 DECL(alIsBufferFormatSupportedSOFT),
255 DECL(alDeferUpdatesSOFT),
256 DECL(alProcessUpdatesSOFT),
258 DECL(alGetSourcedSOFT),
259 DECL(alGetSource3dSOFT),
260 DECL(alGetSourcedvSOFT),
261 DECL(alGetSourcei64SOFT),
262 DECL(alGetSource3i64SOFT),
263 DECL(alGetSourcei64vSOFT),
265 { NULL, NULL }
267 #undef DECL
269 #define DECL(x) { #x, (x) }
270 static const ALCenums enumeration[] = {
271 DECL(ALC_INVALID),
272 DECL(ALC_FALSE),
273 DECL(ALC_TRUE),
275 DECL(ALC_MAJOR_VERSION),
276 DECL(ALC_MINOR_VERSION),
277 DECL(ALC_ATTRIBUTES_SIZE),
278 DECL(ALC_ALL_ATTRIBUTES),
279 DECL(ALC_DEFAULT_DEVICE_SPECIFIER),
280 DECL(ALC_DEVICE_SPECIFIER),
281 DECL(ALC_ALL_DEVICES_SPECIFIER),
282 DECL(ALC_DEFAULT_ALL_DEVICES_SPECIFIER),
283 DECL(ALC_EXTENSIONS),
284 DECL(ALC_FREQUENCY),
285 DECL(ALC_REFRESH),
286 DECL(ALC_SYNC),
287 DECL(ALC_MONO_SOURCES),
288 DECL(ALC_STEREO_SOURCES),
289 DECL(ALC_CAPTURE_DEVICE_SPECIFIER),
290 DECL(ALC_CAPTURE_DEFAULT_DEVICE_SPECIFIER),
291 DECL(ALC_CAPTURE_SAMPLES),
292 DECL(ALC_CONNECTED),
294 DECL(ALC_EFX_MAJOR_VERSION),
295 DECL(ALC_EFX_MINOR_VERSION),
296 DECL(ALC_MAX_AUXILIARY_SENDS),
298 DECL(ALC_FORMAT_CHANNELS_SOFT),
299 DECL(ALC_FORMAT_TYPE_SOFT),
301 DECL(ALC_MONO_SOFT),
302 DECL(ALC_STEREO_SOFT),
303 DECL(ALC_QUAD_SOFT),
304 DECL(ALC_5POINT1_SOFT),
305 DECL(ALC_6POINT1_SOFT),
306 DECL(ALC_7POINT1_SOFT),
308 DECL(ALC_BYTE_SOFT),
309 DECL(ALC_UNSIGNED_BYTE_SOFT),
310 DECL(ALC_SHORT_SOFT),
311 DECL(ALC_UNSIGNED_SHORT_SOFT),
312 DECL(ALC_INT_SOFT),
313 DECL(ALC_UNSIGNED_INT_SOFT),
314 DECL(ALC_FLOAT_SOFT),
316 DECL(ALC_NO_ERROR),
317 DECL(ALC_INVALID_DEVICE),
318 DECL(ALC_INVALID_CONTEXT),
319 DECL(ALC_INVALID_ENUM),
320 DECL(ALC_INVALID_VALUE),
321 DECL(ALC_OUT_OF_MEMORY),
324 DECL(AL_INVALID),
325 DECL(AL_NONE),
326 DECL(AL_FALSE),
327 DECL(AL_TRUE),
329 DECL(AL_SOURCE_RELATIVE),
330 DECL(AL_CONE_INNER_ANGLE),
331 DECL(AL_CONE_OUTER_ANGLE),
332 DECL(AL_PITCH),
333 DECL(AL_POSITION),
334 DECL(AL_DIRECTION),
335 DECL(AL_VELOCITY),
336 DECL(AL_LOOPING),
337 DECL(AL_BUFFER),
338 DECL(AL_GAIN),
339 DECL(AL_MIN_GAIN),
340 DECL(AL_MAX_GAIN),
341 DECL(AL_ORIENTATION),
342 DECL(AL_REFERENCE_DISTANCE),
343 DECL(AL_ROLLOFF_FACTOR),
344 DECL(AL_CONE_OUTER_GAIN),
345 DECL(AL_MAX_DISTANCE),
346 DECL(AL_SEC_OFFSET),
347 DECL(AL_SAMPLE_OFFSET),
348 DECL(AL_SAMPLE_RW_OFFSETS_SOFT),
349 DECL(AL_BYTE_OFFSET),
350 DECL(AL_BYTE_RW_OFFSETS_SOFT),
351 DECL(AL_SOURCE_TYPE),
352 DECL(AL_STATIC),
353 DECL(AL_STREAMING),
354 DECL(AL_UNDETERMINED),
355 DECL(AL_METERS_PER_UNIT),
356 DECL(AL_DIRECT_CHANNELS_SOFT),
358 DECL(AL_DIRECT_FILTER),
359 DECL(AL_AUXILIARY_SEND_FILTER),
360 DECL(AL_AIR_ABSORPTION_FACTOR),
361 DECL(AL_ROOM_ROLLOFF_FACTOR),
362 DECL(AL_CONE_OUTER_GAINHF),
363 DECL(AL_DIRECT_FILTER_GAINHF_AUTO),
364 DECL(AL_AUXILIARY_SEND_FILTER_GAIN_AUTO),
365 DECL(AL_AUXILIARY_SEND_FILTER_GAINHF_AUTO),
367 DECL(AL_SOURCE_STATE),
368 DECL(AL_INITIAL),
369 DECL(AL_PLAYING),
370 DECL(AL_PAUSED),
371 DECL(AL_STOPPED),
373 DECL(AL_BUFFERS_QUEUED),
374 DECL(AL_BUFFERS_PROCESSED),
376 DECL(AL_FORMAT_MONO8),
377 DECL(AL_FORMAT_MONO16),
378 DECL(AL_FORMAT_MONO_FLOAT32),
379 DECL(AL_FORMAT_MONO_DOUBLE_EXT),
380 DECL(AL_FORMAT_STEREO8),
381 DECL(AL_FORMAT_STEREO16),
382 DECL(AL_FORMAT_STEREO_FLOAT32),
383 DECL(AL_FORMAT_STEREO_DOUBLE_EXT),
384 DECL(AL_FORMAT_MONO_IMA4),
385 DECL(AL_FORMAT_STEREO_IMA4),
386 DECL(AL_FORMAT_QUAD8_LOKI),
387 DECL(AL_FORMAT_QUAD16_LOKI),
388 DECL(AL_FORMAT_QUAD8),
389 DECL(AL_FORMAT_QUAD16),
390 DECL(AL_FORMAT_QUAD32),
391 DECL(AL_FORMAT_51CHN8),
392 DECL(AL_FORMAT_51CHN16),
393 DECL(AL_FORMAT_51CHN32),
394 DECL(AL_FORMAT_61CHN8),
395 DECL(AL_FORMAT_61CHN16),
396 DECL(AL_FORMAT_61CHN32),
397 DECL(AL_FORMAT_71CHN8),
398 DECL(AL_FORMAT_71CHN16),
399 DECL(AL_FORMAT_71CHN32),
400 DECL(AL_FORMAT_REAR8),
401 DECL(AL_FORMAT_REAR16),
402 DECL(AL_FORMAT_REAR32),
403 DECL(AL_FORMAT_MONO_MULAW),
404 DECL(AL_FORMAT_MONO_MULAW_EXT),
405 DECL(AL_FORMAT_STEREO_MULAW),
406 DECL(AL_FORMAT_STEREO_MULAW_EXT),
407 DECL(AL_FORMAT_QUAD_MULAW),
408 DECL(AL_FORMAT_51CHN_MULAW),
409 DECL(AL_FORMAT_61CHN_MULAW),
410 DECL(AL_FORMAT_71CHN_MULAW),
411 DECL(AL_FORMAT_REAR_MULAW),
412 DECL(AL_FORMAT_MONO_ALAW_EXT),
413 DECL(AL_FORMAT_STEREO_ALAW_EXT),
415 DECL(AL_MONO8_SOFT),
416 DECL(AL_MONO16_SOFT),
417 DECL(AL_MONO32F_SOFT),
418 DECL(AL_STEREO8_SOFT),
419 DECL(AL_STEREO16_SOFT),
420 DECL(AL_STEREO32F_SOFT),
421 DECL(AL_QUAD8_SOFT),
422 DECL(AL_QUAD16_SOFT),
423 DECL(AL_QUAD32F_SOFT),
424 DECL(AL_REAR8_SOFT),
425 DECL(AL_REAR16_SOFT),
426 DECL(AL_REAR32F_SOFT),
427 DECL(AL_5POINT1_8_SOFT),
428 DECL(AL_5POINT1_16_SOFT),
429 DECL(AL_5POINT1_32F_SOFT),
430 DECL(AL_6POINT1_8_SOFT),
431 DECL(AL_6POINT1_16_SOFT),
432 DECL(AL_6POINT1_32F_SOFT),
433 DECL(AL_7POINT1_8_SOFT),
434 DECL(AL_7POINT1_16_SOFT),
435 DECL(AL_7POINT1_32F_SOFT),
437 DECL(AL_MONO_SOFT),
438 DECL(AL_STEREO_SOFT),
439 DECL(AL_QUAD_SOFT),
440 DECL(AL_REAR_SOFT),
441 DECL(AL_5POINT1_SOFT),
442 DECL(AL_6POINT1_SOFT),
443 DECL(AL_7POINT1_SOFT),
445 DECL(AL_BYTE_SOFT),
446 DECL(AL_UNSIGNED_BYTE_SOFT),
447 DECL(AL_SHORT_SOFT),
448 DECL(AL_UNSIGNED_SHORT_SOFT),
449 DECL(AL_INT_SOFT),
450 DECL(AL_UNSIGNED_INT_SOFT),
451 DECL(AL_FLOAT_SOFT),
452 DECL(AL_DOUBLE_SOFT),
453 DECL(AL_BYTE3_SOFT),
454 DECL(AL_UNSIGNED_BYTE3_SOFT),
456 DECL(AL_FREQUENCY),
457 DECL(AL_BITS),
458 DECL(AL_CHANNELS),
459 DECL(AL_SIZE),
460 DECL(AL_INTERNAL_FORMAT_SOFT),
461 DECL(AL_BYTE_LENGTH_SOFT),
462 DECL(AL_SAMPLE_LENGTH_SOFT),
463 DECL(AL_SEC_LENGTH_SOFT),
465 DECL(AL_UNUSED),
466 DECL(AL_PENDING),
467 DECL(AL_PROCESSED),
469 DECL(AL_NO_ERROR),
470 DECL(AL_INVALID_NAME),
471 DECL(AL_INVALID_ENUM),
472 DECL(AL_INVALID_VALUE),
473 DECL(AL_INVALID_OPERATION),
474 DECL(AL_OUT_OF_MEMORY),
476 DECL(AL_VENDOR),
477 DECL(AL_VERSION),
478 DECL(AL_RENDERER),
479 DECL(AL_EXTENSIONS),
481 DECL(AL_DOPPLER_FACTOR),
482 DECL(AL_DOPPLER_VELOCITY),
483 DECL(AL_DISTANCE_MODEL),
484 DECL(AL_SPEED_OF_SOUND),
485 DECL(AL_SOURCE_DISTANCE_MODEL),
486 DECL(AL_DEFERRED_UPDATES_SOFT),
488 DECL(AL_INVERSE_DISTANCE),
489 DECL(AL_INVERSE_DISTANCE_CLAMPED),
490 DECL(AL_LINEAR_DISTANCE),
491 DECL(AL_LINEAR_DISTANCE_CLAMPED),
492 DECL(AL_EXPONENT_DISTANCE),
493 DECL(AL_EXPONENT_DISTANCE_CLAMPED),
495 DECL(AL_FILTER_TYPE),
496 DECL(AL_FILTER_NULL),
497 DECL(AL_FILTER_LOWPASS),
498 #if 0
499 DECL(AL_FILTER_HIGHPASS),
500 DECL(AL_FILTER_BANDPASS),
501 #endif
503 DECL(AL_LOWPASS_GAIN),
504 DECL(AL_LOWPASS_GAINHF),
506 DECL(AL_EFFECT_TYPE),
507 DECL(AL_EFFECT_NULL),
508 DECL(AL_EFFECT_REVERB),
509 DECL(AL_EFFECT_EAXREVERB),
510 #if 0
511 DECL(AL_EFFECT_CHORUS),
512 DECL(AL_EFFECT_DISTORTION),
513 #endif
514 DECL(AL_EFFECT_ECHO),
515 #if 0
516 DECL(AL_EFFECT_FLANGER),
517 DECL(AL_EFFECT_FREQUENCY_SHIFTER),
518 DECL(AL_EFFECT_VOCAL_MORPHER),
519 DECL(AL_EFFECT_PITCH_SHIFTER),
520 #endif
521 DECL(AL_EFFECT_RING_MODULATOR),
522 #if 0
523 DECL(AL_EFFECT_AUTOWAH),
524 DECL(AL_EFFECT_COMPRESSOR),
525 DECL(AL_EFFECT_EQUALIZER),
526 #endif
527 DECL(AL_EFFECT_DEDICATED_LOW_FREQUENCY_EFFECT),
528 DECL(AL_EFFECT_DEDICATED_DIALOGUE),
530 DECL(AL_EAXREVERB_DENSITY),
531 DECL(AL_EAXREVERB_DIFFUSION),
532 DECL(AL_EAXREVERB_GAIN),
533 DECL(AL_EAXREVERB_GAINHF),
534 DECL(AL_EAXREVERB_GAINLF),
535 DECL(AL_EAXREVERB_DECAY_TIME),
536 DECL(AL_EAXREVERB_DECAY_HFRATIO),
537 DECL(AL_EAXREVERB_DECAY_LFRATIO),
538 DECL(AL_EAXREVERB_REFLECTIONS_GAIN),
539 DECL(AL_EAXREVERB_REFLECTIONS_DELAY),
540 DECL(AL_EAXREVERB_REFLECTIONS_PAN),
541 DECL(AL_EAXREVERB_LATE_REVERB_GAIN),
542 DECL(AL_EAXREVERB_LATE_REVERB_DELAY),
543 DECL(AL_EAXREVERB_LATE_REVERB_PAN),
544 DECL(AL_EAXREVERB_ECHO_TIME),
545 DECL(AL_EAXREVERB_ECHO_DEPTH),
546 DECL(AL_EAXREVERB_MODULATION_TIME),
547 DECL(AL_EAXREVERB_MODULATION_DEPTH),
548 DECL(AL_EAXREVERB_AIR_ABSORPTION_GAINHF),
549 DECL(AL_EAXREVERB_HFREFERENCE),
550 DECL(AL_EAXREVERB_LFREFERENCE),
551 DECL(AL_EAXREVERB_ROOM_ROLLOFF_FACTOR),
552 DECL(AL_EAXREVERB_DECAY_HFLIMIT),
554 DECL(AL_REVERB_DENSITY),
555 DECL(AL_REVERB_DIFFUSION),
556 DECL(AL_REVERB_GAIN),
557 DECL(AL_REVERB_GAINHF),
558 DECL(AL_REVERB_DECAY_TIME),
559 DECL(AL_REVERB_DECAY_HFRATIO),
560 DECL(AL_REVERB_REFLECTIONS_GAIN),
561 DECL(AL_REVERB_REFLECTIONS_DELAY),
562 DECL(AL_REVERB_LATE_REVERB_GAIN),
563 DECL(AL_REVERB_LATE_REVERB_DELAY),
564 DECL(AL_REVERB_AIR_ABSORPTION_GAINHF),
565 DECL(AL_REVERB_ROOM_ROLLOFF_FACTOR),
566 DECL(AL_REVERB_DECAY_HFLIMIT),
568 DECL(AL_ECHO_DELAY),
569 DECL(AL_ECHO_LRDELAY),
570 DECL(AL_ECHO_DAMPING),
571 DECL(AL_ECHO_FEEDBACK),
572 DECL(AL_ECHO_SPREAD),
574 DECL(AL_RING_MODULATOR_FREQUENCY),
575 DECL(AL_RING_MODULATOR_HIGHPASS_CUTOFF),
576 DECL(AL_RING_MODULATOR_WAVEFORM),
578 DECL(AL_DEDICATED_GAIN),
580 { NULL, (ALCenum)0 }
582 #undef DECL
584 static const ALCchar alcNoError[] = "No Error";
585 static const ALCchar alcErrInvalidDevice[] = "Invalid Device";
586 static const ALCchar alcErrInvalidContext[] = "Invalid Context";
587 static const ALCchar alcErrInvalidEnum[] = "Invalid Enum";
588 static const ALCchar alcErrInvalidValue[] = "Invalid Value";
589 static const ALCchar alcErrOutOfMemory[] = "Out of Memory";
592 /************************************************
593 * Global variables
594 ************************************************/
596 /* Enumerated device names */
597 static const ALCchar alcDefaultName[] = "OpenAL Soft\0";
598 static ALCchar *alcAllDevicesList;
599 static ALCchar *alcCaptureDeviceList;
600 /* Sizes only include the first ending null character, not the second */
601 static size_t alcAllDevicesListSize;
602 static size_t alcCaptureDeviceListSize;
604 /* Default is always the first in the list */
605 static ALCchar *alcDefaultAllDevicesSpecifier;
606 static ALCchar *alcCaptureDefaultDeviceSpecifier;
608 /* Default context extensions */
609 static const ALchar alExtList[] =
610 "AL_EXT_ALAW AL_EXT_DOUBLE AL_EXT_EXPONENT_DISTANCE AL_EXT_FLOAT32 "
611 "AL_EXT_IMA4 AL_EXT_LINEAR_DISTANCE AL_EXT_MCFORMATS AL_EXT_MULAW "
612 "AL_EXT_MULAW_MCFORMATS AL_EXT_OFFSET AL_EXT_source_distance_model "
613 "AL_LOKI_quadriphonic AL_SOFT_buffer_samples AL_SOFT_buffer_sub_data "
614 "AL_SOFTX_deferred_updates AL_SOFT_direct_channels AL_SOFT_loop_points";
616 static volatile ALCenum LastNullDeviceError = ALC_NO_ERROR;
618 /* Thread-local current context */
619 static pthread_key_t LocalContext;
620 /* Process-wide current context */
621 static ALCcontext *volatile GlobalContext = NULL;
623 /* Mixing thread piority level */
624 ALint RTPrioLevel;
626 FILE *LogFile;
627 #ifdef _DEBUG
628 enum LogLevel LogLevel = LogWarning;
629 #else
630 enum LogLevel LogLevel = LogError;
631 #endif
633 /* Flag to trap ALC device errors */
634 static ALCboolean TrapALCError = ALC_FALSE;
636 /* One-time configuration init control */
637 static pthread_once_t alc_config_once = PTHREAD_ONCE_INIT;
639 /* Default effect that applies to sources that don't have an effect on send 0 */
640 static ALeffect DefaultEffect;
643 /************************************************
644 * ALC information
645 ************************************************/
646 static const ALCchar alcNoDeviceExtList[] =
647 "ALC_ENUMERATE_ALL_EXT ALC_ENUMERATION_EXT ALC_EXT_CAPTURE "
648 "ALC_EXT_thread_local_context ALC_SOFT_loopback";
649 static const ALCchar alcExtensionList[] =
650 "ALC_ENUMERATE_ALL_EXT ALC_ENUMERATION_EXT ALC_EXT_CAPTURE "
651 "ALC_EXT_DEDICATED ALC_EXT_disconnect ALC_EXT_EFX "
652 "ALC_EXT_thread_local_context ALC_SOFT_loopback";
653 static const ALCint alcMajorVersion = 1;
654 static const ALCint alcMinorVersion = 1;
656 static const ALCint alcEFXMajorVersion = 1;
657 static const ALCint alcEFXMinorVersion = 0;
660 /************************************************
661 * Device lists
662 ************************************************/
663 static ALCdevice *volatile DeviceList = NULL;
665 static CRITICAL_SECTION ListLock;
667 static void LockLists(void)
669 EnterCriticalSection(&ListLock);
671 static void UnlockLists(void)
673 LeaveCriticalSection(&ListLock);
676 /************************************************
677 * Library initialization
678 ************************************************/
679 #if defined(_WIN32)
680 static void alc_init(void);
681 static void alc_deinit(void);
682 static void alc_deinit_safe(void);
684 UIntMap TlsDestructor;
686 #ifndef AL_LIBTYPE_STATIC
687 BOOL APIENTRY DllMain(HINSTANCE hModule,DWORD ul_reason_for_call,LPVOID lpReserved)
689 ALsizei i;
691 // Perform actions based on the reason for calling.
692 switch(ul_reason_for_call)
694 case DLL_PROCESS_ATTACH:
695 /* Pin the DLL so we won't get unloaded until the process terminates */
696 GetModuleHandleExW(GET_MODULE_HANDLE_EX_FLAG_PIN | GET_MODULE_HANDLE_EX_FLAG_FROM_ADDRESS,
697 (WCHAR*)hModule, &hModule);
698 InitUIntMap(&TlsDestructor, ~0);
699 alc_init();
700 break;
702 case DLL_THREAD_DETACH:
703 LockUIntMapRead(&TlsDestructor);
704 for(i = 0;i < TlsDestructor.size;i++)
706 void *ptr = pthread_getspecific(TlsDestructor.array[i].key);
707 void (*callback)(void*) = (void(*)(void*))TlsDestructor.array[i].value;
708 if(ptr && callback)
709 callback(ptr);
711 UnlockUIntMapRead(&TlsDestructor);
712 break;
714 case DLL_PROCESS_DETACH:
715 if(!lpReserved)
716 alc_deinit();
717 else
718 alc_deinit_safe();
719 ResetUIntMap(&TlsDestructor);
720 break;
722 return TRUE;
724 #elif defined(_MSC_VER)
725 #pragma section(".CRT$XCU",read)
726 static void alc_constructor(void);
727 static void alc_destructor(void);
728 __declspec(allocate(".CRT$XCU")) void (__cdecl* alc_constructor_)(void) = alc_constructor;
730 static void alc_constructor(void)
732 atexit(alc_destructor);
733 alc_init();
736 static void alc_destructor(void)
738 alc_deinit();
740 #elif defined(HAVE_GCC_DESTRUCTOR)
741 static void alc_init(void) __attribute__((constructor));
742 static void alc_deinit(void) __attribute__((destructor));
743 #else
744 #error "No static initialization available on this platform!"
745 #endif
747 #elif defined(HAVE_GCC_DESTRUCTOR)
749 static void alc_init(void) __attribute__((constructor));
750 static void alc_deinit(void) __attribute__((destructor));
752 #else
753 #error "No global initialization available on this platform!"
754 #endif
756 static void ReleaseThreadCtx(void *ptr);
757 static void alc_init(void)
759 const char *str;
761 LogFile = stderr;
763 str = getenv("__ALSOFT_HALF_ANGLE_CONES");
764 if(str && (strcasecmp(str, "true") == 0 || strtol(str, NULL, 0) == 1))
765 ConeScale *= 0.5f;
767 str = getenv("__ALSOFT_REVERSE_Z");
768 if(str && (strcasecmp(str, "true") == 0 || strtol(str, NULL, 0) == 1))
769 ZScale *= -1.0f;
771 pthread_key_create(&LocalContext, ReleaseThreadCtx);
772 InitializeCriticalSection(&ListLock);
773 ThunkInit();
776 static void alc_initconfig(void)
778 const char *devs, *str;
779 ALuint capfilter;
780 float valf;
781 int i, n;
783 str = getenv("ALSOFT_LOGLEVEL");
784 if(str)
786 long lvl = strtol(str, NULL, 0);
787 if(lvl >= NoLog && lvl <= LogRef)
788 LogLevel = lvl;
791 str = getenv("ALSOFT_LOGFILE");
792 if(str && str[0])
794 FILE *logfile = fopen(str, "wat");
795 if(logfile) LogFile = logfile;
796 else ERR("Failed to open log file '%s'\n", str);
799 ReadALConfig();
801 capfilter = 0;
802 #ifdef HAVE_SSE
803 capfilter |= CPU_CAP_SSE;
804 #endif
805 #ifdef HAVE_NEON
806 capfilter |= CPU_CAP_NEON;
807 #endif
808 if(ConfigValueStr(NULL, "disable-cpu-exts", &str))
810 if(strcasecmp(str, "all") == 0)
811 capfilter = 0;
812 else
814 size_t len;
815 const char *next = str;
817 i = 0;
818 do {
819 str = next;
820 next = strchr(str, ',');
822 while(isspace(str[0]))
823 str++;
824 if(!str[0] || str[0] == ',')
825 continue;
827 len = (next ? ((size_t)(next-str)) : strlen(str));
828 if(strncasecmp(str, "sse", len) == 0)
829 capfilter &= ~CPU_CAP_SSE;
830 else if(strncasecmp(str, "neon", len) == 0)
831 capfilter &= ~CPU_CAP_NEON;
832 else
833 WARN("Invalid CPU extension \"%s\"\n", str);
834 } while(next++);
837 FillCPUCaps(capfilter);
839 #ifdef _WIN32
840 RTPrioLevel = 1;
841 #else
842 RTPrioLevel = 0;
843 #endif
844 ConfigValueInt(NULL, "rt-prio", &RTPrioLevel);
846 if(ConfigValueStr(NULL, "resampler", &str))
848 if(strcasecmp(str, "point") == 0 || strcasecmp(str, "none") == 0)
849 DefaultResampler = PointResampler;
850 else if(strcasecmp(str, "linear") == 0)
851 DefaultResampler = LinearResampler;
852 else if(strcasecmp(str, "cubic") == 0)
853 DefaultResampler = CubicResampler;
854 else
856 char *end;
858 n = strtol(str, &end, 0);
859 if(*end == '\0' && (n == PointResampler || n == LinearResampler || n == CubicResampler))
860 DefaultResampler = n;
861 else
862 WARN("Invalid resampler: %s\n", str);
866 str = getenv("ALSOFT_TRAP_ERROR");
867 if(str && (strcasecmp(str, "true") == 0 || strtol(str, NULL, 0) == 1))
869 TrapALError = AL_TRUE;
870 TrapALCError = AL_TRUE;
872 else
874 str = getenv("ALSOFT_TRAP_AL_ERROR");
875 if(str && (strcasecmp(str, "true") == 0 || strtol(str, NULL, 0) == 1))
876 TrapALError = AL_TRUE;
877 TrapALError = GetConfigValueBool(NULL, "trap-al-error", TrapALError);
879 str = getenv("ALSOFT_TRAP_ALC_ERROR");
880 if(str && (strcasecmp(str, "true") == 0 || strtol(str, NULL, 0) == 1))
881 TrapALCError = ALC_TRUE;
882 TrapALCError = GetConfigValueBool(NULL, "trap-alc-error", TrapALCError);
885 if(ConfigValueFloat("reverb", "boost", &valf))
886 ReverbBoost *= powf(10.0f, valf / 20.0f);
888 EmulateEAXReverb = GetConfigValueBool("reverb", "emulate-eax", AL_FALSE);
890 if(((devs=getenv("ALSOFT_DRIVERS")) && devs[0]) ||
891 ConfigValueStr(NULL, "drivers", &devs))
893 int n;
894 size_t len;
895 const char *next = devs;
896 int endlist, delitem;
898 i = 0;
899 do {
900 devs = next;
901 next = strchr(devs, ',');
903 delitem = (devs[0] == '-');
904 if(devs[0] == '-') devs++;
906 if(!devs[0] || devs[0] == ',')
908 endlist = 0;
909 continue;
911 endlist = 1;
913 len = (next ? ((size_t)(next-devs)) : strlen(devs));
914 for(n = i;BackendList[n].Init;n++)
916 if(len == strlen(BackendList[n].name) &&
917 strncmp(BackendList[n].name, devs, len) == 0)
919 if(delitem)
921 do {
922 BackendList[n] = BackendList[n+1];
923 ++n;
924 } while(BackendList[n].Init);
926 else
928 struct BackendInfo Bkp = BackendList[n];
929 while(n > i)
931 BackendList[n] = BackendList[n-1];
932 --n;
934 BackendList[n] = Bkp;
936 i++;
938 break;
941 } while(next++);
943 if(endlist)
945 BackendList[i].name = NULL;
946 BackendList[i].Init = NULL;
947 BackendList[i].Deinit = NULL;
948 BackendList[i].Probe = NULL;
952 for(i = 0;BackendList[i].Init && (!PlaybackBackend.name || !CaptureBackend.name);i++)
954 if(!BackendList[i].Init(&BackendList[i].Funcs))
956 WARN("Failed to initialize backend \"%s\"\n", BackendList[i].name);
957 continue;
960 TRACE("Initialized backend \"%s\"\n", BackendList[i].name);
961 if(BackendList[i].Funcs.OpenPlayback && !PlaybackBackend.name)
963 PlaybackBackend = BackendList[i];
964 TRACE("Added \"%s\" for playback\n", PlaybackBackend.name);
966 if(BackendList[i].Funcs.OpenCapture && !CaptureBackend.name)
968 CaptureBackend = BackendList[i];
969 TRACE("Added \"%s\" for capture\n", CaptureBackend.name);
972 BackendLoopback.Init(&BackendLoopback.Funcs);
974 if(ConfigValueStr(NULL, "excludefx", &str))
976 size_t len;
977 const char *next = str;
979 do {
980 str = next;
981 next = strchr(str, ',');
983 if(!str[0] || next == str)
984 continue;
986 len = (next ? ((size_t)(next-str)) : strlen(str));
987 for(n = 0;EffectList[n].name;n++)
989 if(len == strlen(EffectList[n].name) &&
990 strncmp(EffectList[n].name, str, len) == 0)
991 DisabledEffects[EffectList[n].type] = AL_TRUE;
993 } while(next++);
996 InitEffect(&DefaultEffect);
997 str = getenv("ALSOFT_DEFAULT_REVERB");
998 if((str && str[0]) || ConfigValueStr(NULL, "default-reverb", &str))
999 LoadReverbPreset(str, &DefaultEffect);
1001 #define DO_INITCONFIG() pthread_once(&alc_config_once, alc_initconfig)
1004 /************************************************
1005 * Library deinitialization
1006 ************************************************/
1007 static void alc_cleanup(void)
1009 ALCdevice *dev;
1011 free(alcAllDevicesList); alcAllDevicesList = NULL;
1012 alcAllDevicesListSize = 0;
1013 free(alcCaptureDeviceList); alcCaptureDeviceList = NULL;
1014 alcCaptureDeviceListSize = 0;
1016 free(alcDefaultAllDevicesSpecifier);
1017 alcDefaultAllDevicesSpecifier = NULL;
1018 free(alcCaptureDefaultDeviceSpecifier);
1019 alcCaptureDefaultDeviceSpecifier = NULL;
1021 if((dev=ExchangePtr((XchgPtr*)&DeviceList, NULL)) != NULL)
1023 ALCuint num = 0;
1024 do {
1025 num++;
1026 } while((dev=dev->next) != NULL);
1027 ERR("%u device%s not closed\n", num, (num>1)?"s":"");
1031 static void alc_deinit_safe(void)
1033 alc_cleanup();
1035 FreeHrtfs();
1036 FreeALConfig();
1038 ThunkExit();
1039 DeleteCriticalSection(&ListLock);
1040 pthread_key_delete(LocalContext);
1042 if(LogFile != stderr)
1043 fclose(LogFile);
1044 LogFile = NULL;
1047 static void alc_deinit(void)
1049 int i;
1051 alc_cleanup();
1053 memset(&PlaybackBackend, 0, sizeof(PlaybackBackend));
1054 memset(&CaptureBackend, 0, sizeof(CaptureBackend));
1056 for(i = 0;BackendList[i].Deinit;i++)
1057 BackendList[i].Deinit();
1058 BackendLoopback.Deinit();
1060 alc_deinit_safe();
1064 /************************************************
1065 * Device enumeration
1066 ************************************************/
1067 static void ProbeList(ALCchar **list, size_t *listsize, enum DevProbe type)
1069 DO_INITCONFIG();
1071 LockLists();
1072 free(*list);
1073 *list = NULL;
1074 *listsize = 0;
1076 if(type == ALL_DEVICE_PROBE && PlaybackBackend.Probe)
1077 PlaybackBackend.Probe(type);
1078 else if(type == CAPTURE_DEVICE_PROBE && CaptureBackend.Probe)
1079 CaptureBackend.Probe(type);
1080 UnlockLists();
1083 static void ProbeAllDevicesList(void)
1084 { ProbeList(&alcAllDevicesList, &alcAllDevicesListSize, ALL_DEVICE_PROBE); }
1085 static void ProbeCaptureDeviceList(void)
1086 { ProbeList(&alcCaptureDeviceList, &alcCaptureDeviceListSize, CAPTURE_DEVICE_PROBE); }
1089 static void AppendList(const ALCchar *name, ALCchar **List, size_t *ListSize)
1091 size_t len = strlen(name);
1092 void *temp;
1094 if(len == 0)
1095 return;
1097 temp = realloc(*List, (*ListSize) + len + 2);
1098 if(!temp)
1100 ERR("Realloc failed to add %s!\n", name);
1101 return;
1103 *List = temp;
1105 memcpy((*List)+(*ListSize), name, len+1);
1106 *ListSize += len+1;
1107 (*List)[*ListSize] = 0;
1110 #define DECL_APPEND_LIST_FUNC(type) \
1111 void Append##type##List(const ALCchar *name) \
1112 { AppendList(name, &alc##type##List, &alc##type##ListSize); }
1114 DECL_APPEND_LIST_FUNC(AllDevices)
1115 DECL_APPEND_LIST_FUNC(CaptureDevice)
1117 #undef DECL_APPEND_LIST_FUNC
1120 /************************************************
1121 * Device format information
1122 ************************************************/
1123 const ALCchar *DevFmtTypeString(enum DevFmtType type)
1125 switch(type)
1127 case DevFmtByte: return "Signed Byte";
1128 case DevFmtUByte: return "Unsigned Byte";
1129 case DevFmtShort: return "Signed Short";
1130 case DevFmtUShort: return "Unsigned Short";
1131 case DevFmtInt: return "Signed Int";
1132 case DevFmtUInt: return "Unsigned Int";
1133 case DevFmtFloat: return "Float";
1135 return "(unknown type)";
1137 const ALCchar *DevFmtChannelsString(enum DevFmtChannels chans)
1139 switch(chans)
1141 case DevFmtMono: return "Mono";
1142 case DevFmtStereo: return "Stereo";
1143 case DevFmtQuad: return "Quadraphonic";
1144 case DevFmtX51: return "5.1 Surround";
1145 case DevFmtX51Side: return "5.1 Side";
1146 case DevFmtX61: return "6.1 Surround";
1147 case DevFmtX71: return "7.1 Surround";
1149 return "(unknown channels)";
1152 ALuint BytesFromDevFmt(enum DevFmtType type)
1154 switch(type)
1156 case DevFmtByte: return sizeof(ALbyte);
1157 case DevFmtUByte: return sizeof(ALubyte);
1158 case DevFmtShort: return sizeof(ALshort);
1159 case DevFmtUShort: return sizeof(ALushort);
1160 case DevFmtInt: return sizeof(ALint);
1161 case DevFmtUInt: return sizeof(ALuint);
1162 case DevFmtFloat: return sizeof(ALfloat);
1164 return 0;
1166 ALuint ChannelsFromDevFmt(enum DevFmtChannels chans)
1168 switch(chans)
1170 case DevFmtMono: return 1;
1171 case DevFmtStereo: return 2;
1172 case DevFmtQuad: return 4;
1173 case DevFmtX51: return 6;
1174 case DevFmtX51Side: return 6;
1175 case DevFmtX61: return 7;
1176 case DevFmtX71: return 8;
1178 return 0;
1181 static ALboolean DecomposeDevFormat(ALenum format, enum DevFmtChannels *chans,
1182 enum DevFmtType *type)
1184 static const struct {
1185 ALenum format;
1186 enum DevFmtChannels channels;
1187 enum DevFmtType type;
1188 } list[] = {
1189 { AL_FORMAT_MONO8, DevFmtMono, DevFmtUByte },
1190 { AL_FORMAT_MONO16, DevFmtMono, DevFmtShort },
1191 { AL_FORMAT_MONO_FLOAT32, DevFmtMono, DevFmtFloat },
1193 { AL_FORMAT_STEREO8, DevFmtStereo, DevFmtUByte },
1194 { AL_FORMAT_STEREO16, DevFmtStereo, DevFmtShort },
1195 { AL_FORMAT_STEREO_FLOAT32, DevFmtStereo, DevFmtFloat },
1197 { AL_FORMAT_QUAD8, DevFmtQuad, DevFmtUByte },
1198 { AL_FORMAT_QUAD16, DevFmtQuad, DevFmtShort },
1199 { AL_FORMAT_QUAD32, DevFmtQuad, DevFmtFloat },
1201 { AL_FORMAT_51CHN8, DevFmtX51, DevFmtUByte },
1202 { AL_FORMAT_51CHN16, DevFmtX51, DevFmtShort },
1203 { AL_FORMAT_51CHN32, DevFmtX51, DevFmtFloat },
1205 { AL_FORMAT_61CHN8, DevFmtX61, DevFmtUByte },
1206 { AL_FORMAT_61CHN16, DevFmtX61, DevFmtShort },
1207 { AL_FORMAT_61CHN32, DevFmtX61, DevFmtFloat },
1209 { AL_FORMAT_71CHN8, DevFmtX71, DevFmtUByte },
1210 { AL_FORMAT_71CHN16, DevFmtX71, DevFmtShort },
1211 { AL_FORMAT_71CHN32, DevFmtX71, DevFmtFloat },
1213 ALuint i;
1215 for(i = 0;i < COUNTOF(list);i++)
1217 if(list[i].format == format)
1219 *chans = list[i].channels;
1220 *type = list[i].type;
1221 return AL_TRUE;
1225 return AL_FALSE;
1228 static ALCboolean IsValidALCType(ALCenum type)
1230 switch(type)
1232 case ALC_BYTE_SOFT:
1233 case ALC_UNSIGNED_BYTE_SOFT:
1234 case ALC_SHORT_SOFT:
1235 case ALC_UNSIGNED_SHORT_SOFT:
1236 case ALC_INT_SOFT:
1237 case ALC_UNSIGNED_INT_SOFT:
1238 case ALC_FLOAT_SOFT:
1239 return ALC_TRUE;
1241 return ALC_FALSE;
1244 static ALCboolean IsValidALCChannels(ALCenum channels)
1246 switch(channels)
1248 case ALC_MONO_SOFT:
1249 case ALC_STEREO_SOFT:
1250 case ALC_QUAD_SOFT:
1251 case ALC_5POINT1_SOFT:
1252 case ALC_6POINT1_SOFT:
1253 case ALC_7POINT1_SOFT:
1254 return ALC_TRUE;
1256 return ALC_FALSE;
1260 /************************************************
1261 * Miscellaneous ALC helpers
1262 ************************************************/
1264 void ALCdevice_LockDefault(ALCdevice *device)
1266 EnterCriticalSection(&device->Mutex);
1268 void ALCdevice_UnlockDefault(ALCdevice *device)
1270 LeaveCriticalSection(&device->Mutex);
1272 ALint64 ALCdevice_GetLatencyDefault(ALCdevice *device)
1274 (void)device;
1275 return 0;
1278 /* SetDefaultWFXChannelOrder
1280 * Sets the default channel order used by WaveFormatEx.
1282 void SetDefaultWFXChannelOrder(ALCdevice *device)
1284 switch(device->FmtChans)
1286 case DevFmtMono: device->DevChannels[0] = FrontCenter; break;
1288 case DevFmtStereo: device->DevChannels[0] = FrontLeft;
1289 device->DevChannels[1] = FrontRight; break;
1291 case DevFmtQuad: device->DevChannels[0] = FrontLeft;
1292 device->DevChannels[1] = FrontRight;
1293 device->DevChannels[2] = BackLeft;
1294 device->DevChannels[3] = BackRight; break;
1296 case DevFmtX51: device->DevChannels[0] = FrontLeft;
1297 device->DevChannels[1] = FrontRight;
1298 device->DevChannels[2] = FrontCenter;
1299 device->DevChannels[3] = LFE;
1300 device->DevChannels[4] = BackLeft;
1301 device->DevChannels[5] = BackRight; break;
1303 case DevFmtX51Side: device->DevChannels[0] = FrontLeft;
1304 device->DevChannels[1] = FrontRight;
1305 device->DevChannels[2] = FrontCenter;
1306 device->DevChannels[3] = LFE;
1307 device->DevChannels[4] = SideLeft;
1308 device->DevChannels[5] = SideRight; break;
1310 case DevFmtX61: device->DevChannels[0] = FrontLeft;
1311 device->DevChannels[1] = FrontRight;
1312 device->DevChannels[2] = FrontCenter;
1313 device->DevChannels[3] = LFE;
1314 device->DevChannels[4] = BackCenter;
1315 device->DevChannels[5] = SideLeft;
1316 device->DevChannels[6] = SideRight; break;
1318 case DevFmtX71: device->DevChannels[0] = FrontLeft;
1319 device->DevChannels[1] = FrontRight;
1320 device->DevChannels[2] = FrontCenter;
1321 device->DevChannels[3] = LFE;
1322 device->DevChannels[4] = BackLeft;
1323 device->DevChannels[5] = BackRight;
1324 device->DevChannels[6] = SideLeft;
1325 device->DevChannels[7] = SideRight; break;
1329 /* SetDefaultChannelOrder
1331 * Sets the default channel order used by most non-WaveFormatEx-based APIs.
1333 void SetDefaultChannelOrder(ALCdevice *device)
1335 switch(device->FmtChans)
1337 case DevFmtX51: device->DevChannels[0] = FrontLeft;
1338 device->DevChannels[1] = FrontRight;
1339 device->DevChannels[2] = BackLeft;
1340 device->DevChannels[3] = BackRight;
1341 device->DevChannels[4] = FrontCenter;
1342 device->DevChannels[5] = LFE;
1343 return;
1345 case DevFmtX71: device->DevChannels[0] = FrontLeft;
1346 device->DevChannels[1] = FrontRight;
1347 device->DevChannels[2] = BackLeft;
1348 device->DevChannels[3] = BackRight;
1349 device->DevChannels[4] = FrontCenter;
1350 device->DevChannels[5] = LFE;
1351 device->DevChannels[6] = SideLeft;
1352 device->DevChannels[7] = SideRight;
1353 return;
1355 /* Same as WFX order */
1356 case DevFmtMono:
1357 case DevFmtStereo:
1358 case DevFmtQuad:
1359 case DevFmtX51Side:
1360 case DevFmtX61:
1361 break;
1363 SetDefaultWFXChannelOrder(device);
1367 /* alcSetError
1369 * Stores the latest ALC device error
1371 static void alcSetError(ALCdevice *device, ALCenum errorCode)
1373 if(TrapALCError)
1375 #ifdef _WIN32
1376 /* DebugBreak() will cause an exception if there is no debugger */
1377 if(IsDebuggerPresent())
1378 DebugBreak();
1379 #elif defined(SIGTRAP)
1380 raise(SIGTRAP);
1381 #endif
1384 if(device)
1385 device->LastError = errorCode;
1386 else
1387 LastNullDeviceError = errorCode;
1391 /* UpdateDeviceParams
1393 * Updates device parameters according to the attribute list (caller is
1394 * responsible for holding the list lock).
1396 static ALCenum UpdateDeviceParams(ALCdevice *device, const ALCint *attrList)
1398 ALCcontext *context;
1399 enum DevFmtChannels oldChans;
1400 enum DevFmtType oldType;
1401 ALCuint oldFreq;
1402 FPUCtl oldMode;
1403 ALuint i;
1405 // Check for attributes
1406 if(device->Type == Loopback)
1408 enum {
1409 GotFreq = 1<<0,
1410 GotChans = 1<<1,
1411 GotType = 1<<2,
1412 GotAll = GotFreq|GotChans|GotType
1414 ALCuint freq, numMono, numStereo, numSends;
1415 enum DevFmtChannels schans;
1416 enum DevFmtType stype;
1417 ALCuint attrIdx = 0;
1418 ALCint gotFmt = 0;
1420 if(!attrList)
1422 WARN("Missing attributes for loopback device\n");
1423 return ALC_INVALID_VALUE;
1426 numMono = device->NumMonoSources;
1427 numStereo = device->NumStereoSources;
1428 numSends = device->NumAuxSends;
1429 schans = device->FmtChans;
1430 stype = device->FmtType;
1431 freq = device->Frequency;
1433 while(attrList[attrIdx])
1435 if(attrList[attrIdx] == ALC_FORMAT_CHANNELS_SOFT)
1437 ALCint val = attrList[attrIdx + 1];
1438 if(!IsValidALCChannels(val) || !ChannelsFromDevFmt(val))
1439 return ALC_INVALID_VALUE;
1440 schans = val;
1441 gotFmt |= GotChans;
1444 if(attrList[attrIdx] == ALC_FORMAT_TYPE_SOFT)
1446 ALCint val = attrList[attrIdx + 1];
1447 if(!IsValidALCType(val) || !BytesFromDevFmt(val))
1448 return ALC_INVALID_VALUE;
1449 stype = val;
1450 gotFmt |= GotType;
1453 if(attrList[attrIdx] == ALC_FREQUENCY)
1455 freq = attrList[attrIdx + 1];
1456 if(freq < MIN_OUTPUT_RATE)
1457 return ALC_INVALID_VALUE;
1458 gotFmt |= GotFreq;
1461 if(attrList[attrIdx] == ALC_STEREO_SOURCES)
1463 numStereo = attrList[attrIdx + 1];
1464 if(numStereo > device->MaxNoOfSources)
1465 numStereo = device->MaxNoOfSources;
1467 numMono = device->MaxNoOfSources - numStereo;
1470 if(attrList[attrIdx] == ALC_MAX_AUXILIARY_SENDS)
1471 numSends = attrList[attrIdx + 1];
1473 attrIdx += 2;
1476 if(gotFmt != GotAll)
1478 WARN("Missing format for loopback device\n");
1479 return ALC_INVALID_VALUE;
1482 ConfigValueUInt(NULL, "sends", &numSends);
1483 numSends = minu(MAX_SENDS, numSends);
1485 if((device->Flags&DEVICE_RUNNING))
1486 ALCdevice_StopPlayback(device);
1487 device->Flags &= ~DEVICE_RUNNING;
1489 device->Frequency = freq;
1490 device->FmtChans = schans;
1491 device->FmtType = stype;
1492 device->NumMonoSources = numMono;
1493 device->NumStereoSources = numStereo;
1494 device->NumAuxSends = numSends;
1496 else if(attrList && attrList[0])
1498 ALCuint freq, numMono, numStereo, numSends;
1499 ALCuint attrIdx = 0;
1501 /* If a context is already running on the device, stop playback so the
1502 * device attributes can be updated. */
1503 if((device->Flags&DEVICE_RUNNING))
1504 ALCdevice_StopPlayback(device);
1505 device->Flags &= ~DEVICE_RUNNING;
1507 freq = device->Frequency;
1508 numMono = device->NumMonoSources;
1509 numStereo = device->NumStereoSources;
1510 numSends = device->NumAuxSends;
1512 while(attrList[attrIdx])
1514 if(attrList[attrIdx] == ALC_FREQUENCY)
1516 freq = attrList[attrIdx + 1];
1517 device->Flags |= DEVICE_FREQUENCY_REQUEST;
1520 if(attrList[attrIdx] == ALC_STEREO_SOURCES)
1522 numStereo = attrList[attrIdx + 1];
1523 if(numStereo > device->MaxNoOfSources)
1524 numStereo = device->MaxNoOfSources;
1526 numMono = device->MaxNoOfSources - numStereo;
1529 if(attrList[attrIdx] == ALC_MAX_AUXILIARY_SENDS)
1530 numSends = attrList[attrIdx + 1];
1532 attrIdx += 2;
1535 ConfigValueUInt(NULL, "frequency", &freq);
1536 freq = maxu(freq, MIN_OUTPUT_RATE);
1538 ConfigValueUInt(NULL, "sends", &numSends);
1539 numSends = minu(MAX_SENDS, numSends);
1541 device->UpdateSize = (ALuint64)device->UpdateSize * freq /
1542 device->Frequency;
1543 /* SSE does best with the update size being a multiple of 4 */
1544 if((CPUCapFlags&CPU_CAP_SSE))
1545 device->UpdateSize = (device->UpdateSize+3)&~3;
1547 device->Frequency = freq;
1548 device->NumMonoSources = numMono;
1549 device->NumStereoSources = numStereo;
1550 device->NumAuxSends = numSends;
1553 if((device->Flags&DEVICE_RUNNING))
1554 return ALC_NO_ERROR;
1556 oldFreq = device->Frequency;
1557 oldChans = device->FmtChans;
1558 oldType = device->FmtType;
1560 TRACE("Format pre-setup: %s%s, %s%s, %uhz%s, %u update size x%d\n",
1561 DevFmtChannelsString(device->FmtChans),
1562 (device->Flags&DEVICE_CHANNELS_REQUEST)?" (requested)":"",
1563 DevFmtTypeString(device->FmtType),
1564 (device->Flags&DEVICE_SAMPLE_TYPE_REQUEST)?" (requested)":"",
1565 device->Frequency,
1566 (device->Flags&DEVICE_FREQUENCY_REQUEST)?" (requested)":"",
1567 device->UpdateSize, device->NumUpdates);
1569 if(ALCdevice_ResetPlayback(device) == ALC_FALSE)
1570 return ALC_INVALID_DEVICE;
1572 if(device->FmtChans != oldChans && (device->Flags&DEVICE_CHANNELS_REQUEST))
1574 ERR("Failed to set %s, got %s instead\n", DevFmtChannelsString(oldChans),
1575 DevFmtChannelsString(device->FmtChans));
1576 device->Flags &= ~DEVICE_CHANNELS_REQUEST;
1578 if(device->FmtType != oldType && (device->Flags&DEVICE_SAMPLE_TYPE_REQUEST))
1580 ERR("Failed to set %s, got %s instead\n", DevFmtTypeString(oldType),
1581 DevFmtTypeString(device->FmtType));
1582 device->Flags &= ~DEVICE_SAMPLE_TYPE_REQUEST;
1584 if(device->Frequency != oldFreq && (device->Flags&DEVICE_FREQUENCY_REQUEST))
1586 ERR("Failed to set %uhz, got %uhz instead\n", oldFreq, device->Frequency);
1587 device->Flags &= ~DEVICE_FREQUENCY_REQUEST;
1590 TRACE("Format post-setup: %s, %s, %uhz, %u update size x%d\n",
1591 DevFmtChannelsString(device->FmtChans),
1592 DevFmtTypeString(device->FmtType), device->Frequency,
1593 device->UpdateSize, device->NumUpdates);
1595 aluInitPanning(device);
1597 for(i = 0;i < MaxChannels;i++)
1599 device->ClickRemoval[i] = 0.0f;
1600 device->PendingClicks[i] = 0.0f;
1603 device->Hrtf = NULL;
1604 if(device->Type != Loopback && GetConfigValueBool(NULL, "hrtf", AL_FALSE))
1605 device->Hrtf = GetHrtf(device);
1606 TRACE("HRTF %s\n", device->Hrtf?"enabled":"disabled");
1608 if(!device->Hrtf && device->Bs2bLevel > 0 && device->Bs2bLevel <= 6)
1610 if(!device->Bs2b)
1612 device->Bs2b = calloc(1, sizeof(*device->Bs2b));
1613 bs2b_clear(device->Bs2b);
1615 bs2b_set_srate(device->Bs2b, device->Frequency);
1616 bs2b_set_level(device->Bs2b, device->Bs2bLevel);
1617 TRACE("BS2B level %d\n", device->Bs2bLevel);
1619 else
1621 free(device->Bs2b);
1622 device->Bs2b = NULL;
1623 TRACE("BS2B disabled\n");
1626 device->Flags &= ~DEVICE_WIDE_STEREO;
1627 if(device->Type != Loopback && !device->Hrtf && GetConfigValueBool(NULL, "wide-stereo", AL_FALSE))
1628 device->Flags |= DEVICE_WIDE_STEREO;
1630 if(!device->Hrtf && (device->UpdateSize&3))
1632 if((CPUCapFlags&CPU_CAP_SSE))
1633 WARN("SSE performs best with multiple of 4 update sizes (%u)\n", device->UpdateSize);
1636 SetMixerFPUMode(&oldMode);
1637 ALCdevice_Lock(device);
1638 context = device->ContextList;
1639 while(context)
1641 ALsizei pos;
1643 context->UpdateSources = AL_FALSE;
1644 LockUIntMapRead(&context->EffectSlotMap);
1645 for(pos = 0;pos < context->EffectSlotMap.size;pos++)
1647 ALeffectslot *slot = context->EffectSlotMap.array[pos].value;
1649 if(ALeffectState_DeviceUpdate(slot->EffectState, device) == AL_FALSE)
1651 UnlockUIntMapRead(&context->EffectSlotMap);
1652 ALCdevice_Unlock(device);
1653 RestoreFPUMode(&oldMode);
1654 return ALC_INVALID_DEVICE;
1656 slot->NeedsUpdate = AL_FALSE;
1657 ALeffectState_Update(slot->EffectState, device, slot);
1659 UnlockUIntMapRead(&context->EffectSlotMap);
1661 LockUIntMapRead(&context->SourceMap);
1662 for(pos = 0;pos < context->SourceMap.size;pos++)
1664 ALsource *source = context->SourceMap.array[pos].value;
1665 ALuint s = device->NumAuxSends;
1666 while(s < MAX_SENDS)
1668 if(source->Send[s].Slot)
1669 DecrementRef(&source->Send[s].Slot->ref);
1670 source->Send[s].Slot = NULL;
1671 source->Send[s].Gain = 1.0f;
1672 source->Send[s].GainHF = 1.0f;
1673 s++;
1675 source->NeedsUpdate = AL_FALSE;
1676 ALsource_Update(source, context);
1678 UnlockUIntMapRead(&context->SourceMap);
1680 context = context->next;
1682 if(device->DefaultSlot)
1684 ALeffectslot *slot = device->DefaultSlot;
1686 if(ALeffectState_DeviceUpdate(slot->EffectState, device) == AL_FALSE)
1688 ALCdevice_Unlock(device);
1689 RestoreFPUMode(&oldMode);
1690 return ALC_INVALID_DEVICE;
1692 slot->NeedsUpdate = AL_FALSE;
1693 ALeffectState_Update(slot->EffectState, device, slot);
1695 ALCdevice_Unlock(device);
1696 RestoreFPUMode(&oldMode);
1698 if(ALCdevice_StartPlayback(device) == ALC_FALSE)
1699 return ALC_INVALID_DEVICE;
1700 device->Flags |= DEVICE_RUNNING;
1702 return ALC_NO_ERROR;
1705 /* FreeDevice
1707 * Frees the device structure, and destroys any objects the app failed to
1708 * delete. Called once there's no more references on the device.
1710 static ALCvoid FreeDevice(ALCdevice *device)
1712 TRACE("%p\n", device);
1714 if(device->Type != Capture)
1715 ALCdevice_ClosePlayback(device);
1716 else
1717 ALCdevice_CloseCapture(device);
1719 if(device->DefaultSlot)
1721 ALeffectState_Destroy(device->DefaultSlot->EffectState);
1722 device->DefaultSlot->EffectState = NULL;
1725 if(device->BufferMap.size > 0)
1727 WARN("(%p) Deleting %d Buffer(s)\n", device, device->BufferMap.size);
1728 ReleaseALBuffers(device);
1730 ResetUIntMap(&device->BufferMap);
1732 if(device->EffectMap.size > 0)
1734 WARN("(%p) Deleting %d Effect(s)\n", device, device->EffectMap.size);
1735 ReleaseALEffects(device);
1737 ResetUIntMap(&device->EffectMap);
1739 if(device->FilterMap.size > 0)
1741 WARN("(%p) Deleting %d Filter(s)\n", device, device->FilterMap.size);
1742 ReleaseALFilters(device);
1744 ResetUIntMap(&device->FilterMap);
1746 free(device->Bs2b);
1747 device->Bs2b = NULL;
1749 free(device->DeviceName);
1750 device->DeviceName = NULL;
1752 DeleteCriticalSection(&device->Mutex);
1754 al_free(device);
1758 void ALCdevice_IncRef(ALCdevice *device)
1760 RefCount ref;
1761 ref = IncrementRef(&device->ref);
1762 TRACEREF("%p increasing refcount to %u\n", device, ref);
1765 void ALCdevice_DecRef(ALCdevice *device)
1767 RefCount ref;
1768 ref = DecrementRef(&device->ref);
1769 TRACEREF("%p decreasing refcount to %u\n", device, ref);
1770 if(ref == 0) FreeDevice(device);
1773 /* VerifyDevice
1775 * Checks if the device handle is valid, and increments its ref count if so.
1777 static ALCdevice *VerifyDevice(ALCdevice *device)
1779 ALCdevice *tmpDevice;
1781 if(!device)
1782 return NULL;
1784 LockLists();
1785 tmpDevice = DeviceList;
1786 while(tmpDevice && tmpDevice != device)
1787 tmpDevice = tmpDevice->next;
1789 if(tmpDevice)
1790 ALCdevice_IncRef(tmpDevice);
1791 UnlockLists();
1792 return tmpDevice;
1796 /* InitContext
1798 * Initializes context fields
1800 static ALvoid InitContext(ALCcontext *Context)
1802 ALint i, j;
1804 //Initialise listener
1805 Context->Listener.Gain = 1.0f;
1806 Context->Listener.MetersPerUnit = 1.0f;
1807 Context->Listener.Position[0] = 0.0f;
1808 Context->Listener.Position[1] = 0.0f;
1809 Context->Listener.Position[2] = 0.0f;
1810 Context->Listener.Velocity[0] = 0.0f;
1811 Context->Listener.Velocity[1] = 0.0f;
1812 Context->Listener.Velocity[2] = 0.0f;
1813 Context->Listener.Forward[0] = 0.0f;
1814 Context->Listener.Forward[1] = 0.0f;
1815 Context->Listener.Forward[2] = -1.0f;
1816 Context->Listener.Up[0] = 0.0f;
1817 Context->Listener.Up[1] = 1.0f;
1818 Context->Listener.Up[2] = 0.0f;
1819 for(i = 0;i < 4;i++)
1821 for(j = 0;j < 4;j++)
1822 Context->Listener.Matrix[i][j] = ((i==j) ? 1.0f : 0.0f);
1825 //Validate Context
1826 Context->LastError = AL_NO_ERROR;
1827 Context->UpdateSources = AL_FALSE;
1828 Context->ActiveSourceCount = 0;
1829 InitUIntMap(&Context->SourceMap, Context->Device->MaxNoOfSources);
1830 InitUIntMap(&Context->EffectSlotMap, Context->Device->AuxiliaryEffectSlotMax);
1832 //Set globals
1833 Context->DistanceModel = AL_INVERSE_DISTANCE_CLAMPED;
1834 Context->SourceDistanceModel = AL_FALSE;
1835 Context->DopplerFactor = 1.0f;
1836 Context->DopplerVelocity = 1.0f;
1837 Context->SpeedOfSound = SPEEDOFSOUNDMETRESPERSEC;
1838 Context->DeferUpdates = AL_FALSE;
1840 Context->ExtensionList = alExtList;
1844 /* FreeContext
1846 * Cleans up the context, and destroys any remaining objects the app failed to
1847 * delete. Called once there's no more references on the context.
1849 static ALCvoid FreeContext(ALCcontext *context)
1851 TRACE("%p\n", context);
1853 if(context->SourceMap.size > 0)
1855 ERR("(%p) Deleting %d Source(s)\n", context, context->SourceMap.size);
1856 ReleaseALSources(context);
1858 ResetUIntMap(&context->SourceMap);
1860 if(context->EffectSlotMap.size > 0)
1862 ERR("(%p) Deleting %d AuxiliaryEffectSlot(s)\n", context, context->EffectSlotMap.size);
1863 ReleaseALAuxiliaryEffectSlots(context);
1865 ResetUIntMap(&context->EffectSlotMap);
1867 context->ActiveSourceCount = 0;
1868 free(context->ActiveSources);
1869 context->ActiveSources = NULL;
1870 context->MaxActiveSources = 0;
1872 context->ActiveEffectSlotCount = 0;
1873 free(context->ActiveEffectSlots);
1874 context->ActiveEffectSlots = NULL;
1875 context->MaxActiveEffectSlots = 0;
1877 ALCdevice_DecRef(context->Device);
1878 context->Device = NULL;
1880 //Invalidate context
1881 memset(context, 0, sizeof(ALCcontext));
1882 free(context);
1885 /* ReleaseContext
1887 * Removes the context reference from the given device and removes it from
1888 * being current on the running thread or globally.
1890 static void ReleaseContext(ALCcontext *context, ALCdevice *device)
1892 ALCcontext *volatile*tmp_ctx;
1894 if(pthread_getspecific(LocalContext) == context)
1896 WARN("%p released while current on thread\n", context);
1897 pthread_setspecific(LocalContext, NULL);
1898 ALCcontext_DecRef(context);
1901 if(CompExchangePtr((XchgPtr*)&GlobalContext, context, NULL))
1902 ALCcontext_DecRef(context);
1904 ALCdevice_Lock(device);
1905 tmp_ctx = &device->ContextList;
1906 while(*tmp_ctx)
1908 if(CompExchangePtr((XchgPtr*)tmp_ctx, context, context->next))
1909 break;
1910 tmp_ctx = &(*tmp_ctx)->next;
1912 ALCdevice_Unlock(device);
1914 ALCcontext_DecRef(context);
1917 void ALCcontext_IncRef(ALCcontext *context)
1919 RefCount ref;
1920 ref = IncrementRef(&context->ref);
1921 TRACEREF("%p increasing refcount to %u\n", context, ref);
1924 void ALCcontext_DecRef(ALCcontext *context)
1926 RefCount ref;
1927 ref = DecrementRef(&context->ref);
1928 TRACEREF("%p decreasing refcount to %u\n", context, ref);
1929 if(ref == 0) FreeContext(context);
1932 static void ReleaseThreadCtx(void *ptr)
1934 WARN("%p current for thread being destroyed\n", ptr);
1935 ALCcontext_DecRef(ptr);
1938 /* VerifyContext
1940 * Checks that the given context is valid, and increments its reference count.
1942 static ALCcontext *VerifyContext(ALCcontext *context)
1944 ALCdevice *dev;
1946 LockLists();
1947 dev = DeviceList;
1948 while(dev)
1950 ALCcontext *tmp_ctx = dev->ContextList;
1951 while(tmp_ctx)
1953 if(tmp_ctx == context)
1955 ALCcontext_IncRef(tmp_ctx);
1956 UnlockLists();
1957 return tmp_ctx;
1959 tmp_ctx = tmp_ctx->next;
1961 dev = dev->next;
1963 UnlockLists();
1965 return NULL;
1969 /* GetContextRef
1971 * Returns the currently active context for this thread, and adds a reference
1972 * without locking it.
1974 ALCcontext *GetContextRef(void)
1976 ALCcontext *context;
1978 context = pthread_getspecific(LocalContext);
1979 if(context)
1980 ALCcontext_IncRef(context);
1981 else
1983 LockLists();
1984 context = GlobalContext;
1985 if(context)
1986 ALCcontext_IncRef(context);
1987 UnlockLists();
1990 return context;
1994 /************************************************
1995 * Standard ALC functions
1996 ************************************************/
1998 /* alcGetError
2000 * Return last ALC generated error code for the given device
2002 ALC_API ALCenum ALC_APIENTRY alcGetError(ALCdevice *device)
2004 ALCenum errorCode;
2006 if(VerifyDevice(device))
2008 errorCode = ExchangeInt(&device->LastError, ALC_NO_ERROR);
2009 ALCdevice_DecRef(device);
2011 else
2012 errorCode = ExchangeInt(&LastNullDeviceError, ALC_NO_ERROR);
2014 return errorCode;
2018 /* alcSuspendContext
2020 * Not functional
2022 ALC_API ALCvoid ALC_APIENTRY alcSuspendContext(ALCcontext *Context)
2024 (void)Context;
2027 /* alcProcessContext
2029 * Not functional
2031 ALC_API ALCvoid ALC_APIENTRY alcProcessContext(ALCcontext *Context)
2033 (void)Context;
2037 /* alcGetString
2039 * Returns information about the device, and error strings
2041 ALC_API const ALCchar* ALC_APIENTRY alcGetString(ALCdevice *Device, ALCenum param)
2043 const ALCchar *value = NULL;
2045 switch(param)
2047 case ALC_NO_ERROR:
2048 value = alcNoError;
2049 break;
2051 case ALC_INVALID_ENUM:
2052 value = alcErrInvalidEnum;
2053 break;
2055 case ALC_INVALID_VALUE:
2056 value = alcErrInvalidValue;
2057 break;
2059 case ALC_INVALID_DEVICE:
2060 value = alcErrInvalidDevice;
2061 break;
2063 case ALC_INVALID_CONTEXT:
2064 value = alcErrInvalidContext;
2065 break;
2067 case ALC_OUT_OF_MEMORY:
2068 value = alcErrOutOfMemory;
2069 break;
2071 case ALC_DEVICE_SPECIFIER:
2072 value = alcDefaultName;
2073 break;
2075 case ALC_ALL_DEVICES_SPECIFIER:
2076 if(VerifyDevice(Device))
2078 value = Device->DeviceName;
2079 ALCdevice_DecRef(Device);
2081 else
2083 ProbeAllDevicesList();
2084 value = alcAllDevicesList;
2086 break;
2088 case ALC_CAPTURE_DEVICE_SPECIFIER:
2089 if(VerifyDevice(Device))
2091 value = Device->DeviceName;
2092 ALCdevice_DecRef(Device);
2094 else
2096 ProbeCaptureDeviceList();
2097 value = alcCaptureDeviceList;
2099 break;
2101 /* Default devices are always first in the list */
2102 case ALC_DEFAULT_DEVICE_SPECIFIER:
2103 value = alcDefaultName;
2104 break;
2106 case ALC_DEFAULT_ALL_DEVICES_SPECIFIER:
2107 if(!alcAllDevicesList)
2108 ProbeAllDevicesList();
2110 Device = VerifyDevice(Device);
2112 free(alcDefaultAllDevicesSpecifier);
2113 alcDefaultAllDevicesSpecifier = strdup(alcAllDevicesList ?
2114 alcAllDevicesList : "");
2115 if(!alcDefaultAllDevicesSpecifier)
2116 alcSetError(Device, ALC_OUT_OF_MEMORY);
2118 value = alcDefaultAllDevicesSpecifier;
2119 if(Device) ALCdevice_DecRef(Device);
2120 break;
2122 case ALC_CAPTURE_DEFAULT_DEVICE_SPECIFIER:
2123 if(!alcCaptureDeviceList)
2124 ProbeCaptureDeviceList();
2126 Device = VerifyDevice(Device);
2128 free(alcCaptureDefaultDeviceSpecifier);
2129 alcCaptureDefaultDeviceSpecifier = strdup(alcCaptureDeviceList ?
2130 alcCaptureDeviceList : "");
2131 if(!alcCaptureDefaultDeviceSpecifier)
2132 alcSetError(Device, ALC_OUT_OF_MEMORY);
2134 value = alcCaptureDefaultDeviceSpecifier;
2135 if(Device) ALCdevice_DecRef(Device);
2136 break;
2138 case ALC_EXTENSIONS:
2139 if(!VerifyDevice(Device))
2140 value = alcNoDeviceExtList;
2141 else
2143 value = alcExtensionList;
2144 ALCdevice_DecRef(Device);
2146 break;
2148 default:
2149 Device = VerifyDevice(Device);
2150 alcSetError(Device, ALC_INVALID_ENUM);
2151 if(Device) ALCdevice_DecRef(Device);
2152 break;
2155 return value;
2159 /* alcGetIntegerv
2161 * Returns information about the device and the version of OpenAL
2163 ALC_API ALCvoid ALC_APIENTRY alcGetIntegerv(ALCdevice *device,ALCenum param,ALsizei size,ALCint *data)
2165 device = VerifyDevice(device);
2167 if(size == 0 || data == NULL)
2169 alcSetError(device, ALC_INVALID_VALUE);
2170 if(device) ALCdevice_DecRef(device);
2171 return;
2174 if(!device)
2176 switch(param)
2178 case ALC_MAJOR_VERSION:
2179 *data = alcMajorVersion;
2180 break;
2181 case ALC_MINOR_VERSION:
2182 *data = alcMinorVersion;
2183 break;
2185 case ALC_ATTRIBUTES_SIZE:
2186 case ALC_ALL_ATTRIBUTES:
2187 case ALC_FREQUENCY:
2188 case ALC_REFRESH:
2189 case ALC_SYNC:
2190 case ALC_MONO_SOURCES:
2191 case ALC_STEREO_SOURCES:
2192 case ALC_CAPTURE_SAMPLES:
2193 case ALC_FORMAT_CHANNELS_SOFT:
2194 case ALC_FORMAT_TYPE_SOFT:
2195 alcSetError(NULL, ALC_INVALID_DEVICE);
2196 break;
2198 default:
2199 alcSetError(NULL, ALC_INVALID_ENUM);
2200 break;
2203 else if(device->Type == Capture)
2205 switch(param)
2207 case ALC_CAPTURE_SAMPLES:
2208 LockLists();
2209 /* Re-validate the device since it may have been closed */
2210 ALCdevice_DecRef(device);
2211 if((device=VerifyDevice(device)) != NULL)
2212 *data = ALCdevice_AvailableSamples(device);
2213 else
2214 alcSetError(NULL, ALC_INVALID_DEVICE);
2215 UnlockLists();
2216 break;
2218 case ALC_CONNECTED:
2219 *data = device->Connected;
2220 break;
2222 default:
2223 alcSetError(device, ALC_INVALID_ENUM);
2224 break;
2227 else /* render device */
2229 switch(param)
2231 case ALC_MAJOR_VERSION:
2232 *data = alcMajorVersion;
2233 break;
2235 case ALC_MINOR_VERSION:
2236 *data = alcMinorVersion;
2237 break;
2239 case ALC_EFX_MAJOR_VERSION:
2240 *data = alcEFXMajorVersion;
2241 break;
2243 case ALC_EFX_MINOR_VERSION:
2244 *data = alcEFXMinorVersion;
2245 break;
2247 case ALC_ATTRIBUTES_SIZE:
2248 *data = 13;
2249 break;
2251 case ALC_ALL_ATTRIBUTES:
2252 if(size < 13)
2253 alcSetError(device, ALC_INVALID_VALUE);
2254 else
2256 int i = 0;
2258 data[i++] = ALC_FREQUENCY;
2259 data[i++] = device->Frequency;
2261 if(device->Type != Loopback)
2263 data[i++] = ALC_REFRESH;
2264 data[i++] = device->Frequency / device->UpdateSize;
2266 data[i++] = ALC_SYNC;
2267 data[i++] = ALC_FALSE;
2269 else
2271 data[i++] = ALC_FORMAT_CHANNELS_SOFT;
2272 data[i++] = device->FmtChans;
2274 data[i++] = ALC_FORMAT_TYPE_SOFT;
2275 data[i++] = device->FmtType;
2278 data[i++] = ALC_MONO_SOURCES;
2279 data[i++] = device->NumMonoSources;
2281 data[i++] = ALC_STEREO_SOURCES;
2282 data[i++] = device->NumStereoSources;
2284 data[i++] = ALC_MAX_AUXILIARY_SENDS;
2285 data[i++] = device->NumAuxSends;
2287 data[i++] = 0;
2289 break;
2291 case ALC_FREQUENCY:
2292 *data = device->Frequency;
2293 break;
2295 case ALC_REFRESH:
2296 if(device->Type == Loopback)
2297 alcSetError(device, ALC_INVALID_DEVICE);
2298 else
2299 *data = device->Frequency / device->UpdateSize;
2300 break;
2302 case ALC_SYNC:
2303 if(device->Type == Loopback)
2304 alcSetError(device, ALC_INVALID_DEVICE);
2305 else
2306 *data = ALC_FALSE;
2307 break;
2309 case ALC_FORMAT_CHANNELS_SOFT:
2310 if(device->Type != Loopback)
2311 alcSetError(device, ALC_INVALID_DEVICE);
2312 else
2313 *data = device->FmtChans;
2314 break;
2316 case ALC_FORMAT_TYPE_SOFT:
2317 if(device->Type != Loopback)
2318 alcSetError(device, ALC_INVALID_DEVICE);
2319 else
2320 *data = device->FmtType;
2321 break;
2323 case ALC_MONO_SOURCES:
2324 *data = device->NumMonoSources;
2325 break;
2327 case ALC_STEREO_SOURCES:
2328 *data = device->NumStereoSources;
2329 break;
2331 case ALC_MAX_AUXILIARY_SENDS:
2332 *data = device->NumAuxSends;
2333 break;
2335 case ALC_CONNECTED:
2336 *data = device->Connected;
2337 break;
2339 default:
2340 alcSetError(device, ALC_INVALID_ENUM);
2341 break;
2344 if(device)
2345 ALCdevice_DecRef(device);
2349 /* alcIsExtensionPresent
2351 * Determines if there is support for a particular extension
2353 ALC_API ALCboolean ALC_APIENTRY alcIsExtensionPresent(ALCdevice *device, const ALCchar *extName)
2355 ALCboolean bResult = ALC_FALSE;
2357 device = VerifyDevice(device);
2359 if(!extName)
2360 alcSetError(device, ALC_INVALID_VALUE);
2361 else
2363 size_t len = strlen(extName);
2364 const char *ptr = (device ? alcExtensionList : alcNoDeviceExtList);
2365 while(ptr && *ptr)
2367 if(strncasecmp(ptr, extName, len) == 0 &&
2368 (ptr[len] == '\0' || isspace(ptr[len])))
2370 bResult = ALC_TRUE;
2371 break;
2373 if((ptr=strchr(ptr, ' ')) != NULL)
2375 do {
2376 ++ptr;
2377 } while(isspace(*ptr));
2381 if(device)
2382 ALCdevice_DecRef(device);
2383 return bResult;
2387 /* alcGetProcAddress
2389 * Retrieves the function address for a particular extension function
2391 ALC_API ALCvoid* ALC_APIENTRY alcGetProcAddress(ALCdevice *device, const ALCchar *funcName)
2393 ALCvoid *ptr = NULL;
2395 if(!funcName)
2397 device = VerifyDevice(device);
2398 alcSetError(device, ALC_INVALID_VALUE);
2399 if(device) ALCdevice_DecRef(device);
2401 else
2403 ALsizei i = 0;
2404 while(alcFunctions[i].funcName && strcmp(alcFunctions[i].funcName, funcName) != 0)
2405 i++;
2406 ptr = alcFunctions[i].address;
2409 return ptr;
2413 /* alcGetEnumValue
2415 * Get the value for a particular ALC enumeration name
2417 ALC_API ALCenum ALC_APIENTRY alcGetEnumValue(ALCdevice *device, const ALCchar *enumName)
2419 ALCenum val = 0;
2421 if(!enumName)
2423 device = VerifyDevice(device);
2424 alcSetError(device, ALC_INVALID_VALUE);
2425 if(device) ALCdevice_DecRef(device);
2427 else
2429 ALsizei i = 0;
2430 while(enumeration[i].enumName && strcmp(enumeration[i].enumName, enumName) != 0)
2431 i++;
2432 val = enumeration[i].value;
2435 return val;
2439 /* alcCreateContext
2441 * Create and attach a context to the given device.
2443 ALC_API ALCcontext* ALC_APIENTRY alcCreateContext(ALCdevice *device, const ALCint *attrList)
2445 ALCcontext *ALContext;
2446 ALCenum err;
2448 LockLists();
2449 if(!(device=VerifyDevice(device)) || device->Type == Capture || !device->Connected)
2451 UnlockLists();
2452 alcSetError(device, ALC_INVALID_DEVICE);
2453 if(device) ALCdevice_DecRef(device);
2454 return NULL;
2457 device->LastError = ALC_NO_ERROR;
2459 if((err=UpdateDeviceParams(device, attrList)) != ALC_NO_ERROR)
2461 UnlockLists();
2462 alcSetError(device, err);
2463 if(err == ALC_INVALID_DEVICE)
2464 aluHandleDisconnect(device);
2465 ALCdevice_DecRef(device);
2466 return NULL;
2469 ALContext = calloc(1, sizeof(ALCcontext));
2470 if(ALContext)
2472 ALContext->ref = 1;
2474 ALContext->MaxActiveSources = 256;
2475 ALContext->ActiveSources = malloc(sizeof(ALContext->ActiveSources[0]) *
2476 ALContext->MaxActiveSources);
2478 if(!ALContext || !ALContext->ActiveSources)
2480 if(!device->ContextList)
2482 ALCdevice_StopPlayback(device);
2483 device->Flags &= ~DEVICE_RUNNING;
2485 UnlockLists();
2487 free(ALContext);
2488 ALContext = NULL;
2490 alcSetError(device, ALC_OUT_OF_MEMORY);
2491 ALCdevice_DecRef(device);
2492 return NULL;
2495 ALContext->Device = device;
2496 ALCdevice_IncRef(device);
2497 InitContext(ALContext);
2499 do {
2500 ALContext->next = device->ContextList;
2501 } while(!CompExchangePtr((XchgPtr*)&device->ContextList, ALContext->next, ALContext));
2502 UnlockLists();
2504 ALCdevice_DecRef(device);
2506 TRACE("Created context %p\n", ALContext);
2507 return ALContext;
2510 /* alcDestroyContext
2512 * Remove a context from its device
2514 ALC_API ALCvoid ALC_APIENTRY alcDestroyContext(ALCcontext *context)
2516 ALCdevice *Device;
2518 LockLists();
2519 /* alcGetContextsDevice sets an error for invalid contexts */
2520 Device = alcGetContextsDevice(context);
2521 if(Device)
2523 ReleaseContext(context, Device);
2524 if(!Device->ContextList)
2526 ALCdevice_StopPlayback(Device);
2527 Device->Flags &= ~DEVICE_RUNNING;
2530 UnlockLists();
2534 /* alcGetCurrentContext
2536 * Returns the currently active context on the calling thread
2538 ALC_API ALCcontext* ALC_APIENTRY alcGetCurrentContext(void)
2540 ALCcontext *Context;
2542 Context = pthread_getspecific(LocalContext);
2543 if(!Context) Context = GlobalContext;
2545 return Context;
2548 /* alcGetThreadContext
2550 * Returns the currently active thread-local context
2552 ALC_API ALCcontext* ALC_APIENTRY alcGetThreadContext(void)
2554 ALCcontext *Context;
2555 Context = pthread_getspecific(LocalContext);
2556 return Context;
2560 /* alcMakeContextCurrent
2562 * Makes the given context the active process-wide context, and removes the
2563 * thread-local context for the calling thread.
2565 ALC_API ALCboolean ALC_APIENTRY alcMakeContextCurrent(ALCcontext *context)
2567 /* context must be valid or NULL */
2568 if(context && !(context=VerifyContext(context)))
2570 alcSetError(NULL, ALC_INVALID_CONTEXT);
2571 return ALC_FALSE;
2573 /* context's reference count is already incremented */
2574 context = ExchangePtr((XchgPtr*)&GlobalContext, context);
2575 if(context) ALCcontext_DecRef(context);
2577 if((context=pthread_getspecific(LocalContext)) != NULL)
2579 pthread_setspecific(LocalContext, NULL);
2580 ALCcontext_DecRef(context);
2583 return ALC_TRUE;
2586 /* alcSetThreadContext
2588 * Makes the given context the active context for the current thread
2590 ALC_API ALCboolean ALC_APIENTRY alcSetThreadContext(ALCcontext *context)
2592 ALCcontext *old;
2594 /* context must be valid or NULL */
2595 if(context && !(context=VerifyContext(context)))
2597 alcSetError(NULL, ALC_INVALID_CONTEXT);
2598 return ALC_FALSE;
2600 /* context's reference count is already incremented */
2601 old = pthread_getspecific(LocalContext);
2602 pthread_setspecific(LocalContext, context);
2603 if(old) ALCcontext_DecRef(old);
2605 return ALC_TRUE;
2609 /* alcGetContextsDevice
2611 * Returns the device that a particular context is attached to
2613 ALC_API ALCdevice* ALC_APIENTRY alcGetContextsDevice(ALCcontext *Context)
2615 ALCdevice *Device;
2617 if(!(Context=VerifyContext(Context)))
2619 alcSetError(NULL, ALC_INVALID_CONTEXT);
2620 return NULL;
2622 Device = Context->Device;
2623 ALCcontext_DecRef(Context);
2625 return Device;
2629 /* alcOpenDevice
2631 * Opens the named device.
2633 ALC_API ALCdevice* ALC_APIENTRY alcOpenDevice(const ALCchar *deviceName)
2635 const ALCchar *fmt;
2636 ALCdevice *device;
2637 ALCenum err;
2639 DO_INITCONFIG();
2641 if(!PlaybackBackend.name)
2643 alcSetError(NULL, ALC_INVALID_VALUE);
2644 return NULL;
2647 if(deviceName && (!deviceName[0] || strcasecmp(deviceName, alcDefaultName) == 0 || strcasecmp(deviceName, "openal-soft") == 0))
2648 deviceName = NULL;
2650 device = al_calloc(16, sizeof(ALCdevice)+15+sizeof(ALeffectslot));
2651 if(!device)
2653 alcSetError(NULL, ALC_OUT_OF_MEMORY);
2654 return NULL;
2657 //Validate device
2658 device->Funcs = &PlaybackBackend.Funcs;
2659 device->ref = 1;
2660 device->Connected = ALC_TRUE;
2661 device->Type = Playback;
2662 InitializeCriticalSection(&device->Mutex);
2663 device->LastError = ALC_NO_ERROR;
2665 device->Flags = 0;
2666 device->Bs2b = NULL;
2667 device->Bs2bLevel = 0;
2668 device->DeviceName = NULL;
2670 device->ContextList = NULL;
2672 device->MaxNoOfSources = 256;
2673 device->AuxiliaryEffectSlotMax = 4;
2674 device->NumAuxSends = MAX_SENDS;
2676 InitUIntMap(&device->BufferMap, ~0);
2677 InitUIntMap(&device->EffectMap, ~0);
2678 InitUIntMap(&device->FilterMap, ~0);
2680 //Set output format
2681 device->FmtChans = DevFmtChannelsDefault;
2682 device->FmtType = DevFmtTypeDefault;
2683 device->Frequency = DEFAULT_OUTPUT_RATE;
2684 device->NumUpdates = 4;
2685 device->UpdateSize = 1024;
2687 if(ConfigValueStr(NULL, "channels", &fmt))
2689 static const struct {
2690 const char name[16];
2691 enum DevFmtChannels chans;
2692 } chanlist[] = {
2693 { "mono", DevFmtMono },
2694 { "stereo", DevFmtStereo },
2695 { "quad", DevFmtQuad },
2696 { "surround51", DevFmtX51 },
2697 { "surround61", DevFmtX61 },
2698 { "surround71", DevFmtX71 },
2700 size_t i;
2702 for(i = 0;i < COUNTOF(chanlist);i++)
2704 if(strcasecmp(chanlist[i].name, fmt) == 0)
2706 device->FmtChans = chanlist[i].chans;
2707 device->Flags |= DEVICE_CHANNELS_REQUEST;
2708 break;
2711 if(i == COUNTOF(chanlist))
2712 ERR("Unsupported channels: %s\n", fmt);
2714 if(ConfigValueStr(NULL, "sample-type", &fmt))
2716 static const struct {
2717 const char name[16];
2718 enum DevFmtType type;
2719 } typelist[] = {
2720 { "int8", DevFmtByte },
2721 { "uint8", DevFmtUByte },
2722 { "int16", DevFmtShort },
2723 { "uint16", DevFmtUShort },
2724 { "int32", DevFmtInt },
2725 { "uint32", DevFmtUInt },
2726 { "float32", DevFmtFloat },
2728 size_t i;
2730 for(i = 0;i < COUNTOF(typelist);i++)
2732 if(strcasecmp(typelist[i].name, fmt) == 0)
2734 device->FmtType = typelist[i].type;
2735 device->Flags |= DEVICE_SAMPLE_TYPE_REQUEST;
2736 break;
2739 if(i == COUNTOF(typelist))
2740 ERR("Unsupported sample-type: %s\n", fmt);
2742 #define DEVICE_FORMAT_REQUEST (DEVICE_CHANNELS_REQUEST|DEVICE_SAMPLE_TYPE_REQUEST)
2743 if((device->Flags&DEVICE_FORMAT_REQUEST) != DEVICE_FORMAT_REQUEST &&
2744 ConfigValueStr(NULL, "format", &fmt))
2746 static const struct {
2747 const char name[32];
2748 enum DevFmtChannels channels;
2749 enum DevFmtType type;
2750 } formats[] = {
2751 { "AL_FORMAT_MONO32", DevFmtMono, DevFmtFloat },
2752 { "AL_FORMAT_STEREO32", DevFmtStereo, DevFmtFloat },
2753 { "AL_FORMAT_QUAD32", DevFmtQuad, DevFmtFloat },
2754 { "AL_FORMAT_51CHN32", DevFmtX51, DevFmtFloat },
2755 { "AL_FORMAT_61CHN32", DevFmtX61, DevFmtFloat },
2756 { "AL_FORMAT_71CHN32", DevFmtX71, DevFmtFloat },
2758 { "AL_FORMAT_MONO16", DevFmtMono, DevFmtShort },
2759 { "AL_FORMAT_STEREO16", DevFmtStereo, DevFmtShort },
2760 { "AL_FORMAT_QUAD16", DevFmtQuad, DevFmtShort },
2761 { "AL_FORMAT_51CHN16", DevFmtX51, DevFmtShort },
2762 { "AL_FORMAT_61CHN16", DevFmtX61, DevFmtShort },
2763 { "AL_FORMAT_71CHN16", DevFmtX71, DevFmtShort },
2765 { "AL_FORMAT_MONO8", DevFmtMono, DevFmtByte },
2766 { "AL_FORMAT_STEREO8", DevFmtStereo, DevFmtByte },
2767 { "AL_FORMAT_QUAD8", DevFmtQuad, DevFmtByte },
2768 { "AL_FORMAT_51CHN8", DevFmtX51, DevFmtByte },
2769 { "AL_FORMAT_61CHN8", DevFmtX61, DevFmtByte },
2770 { "AL_FORMAT_71CHN8", DevFmtX71, DevFmtByte }
2772 size_t i;
2774 ERR("Option 'format' is deprecated, please use 'channels' and 'sample-type'\n");
2775 for(i = 0;i < COUNTOF(formats);i++)
2777 if(strcasecmp(fmt, formats[i].name) == 0)
2779 if(!(device->Flags&DEVICE_CHANNELS_REQUEST))
2780 device->FmtChans = formats[i].channels;
2781 if(!(device->Flags&DEVICE_SAMPLE_TYPE_REQUEST))
2782 device->FmtType = formats[i].type;
2783 device->Flags |= DEVICE_FORMAT_REQUEST;
2784 break;
2787 if(i == COUNTOF(formats))
2788 ERR("Unsupported format: %s\n", fmt);
2790 #undef DEVICE_FORMAT_REQUEST
2792 if(ConfigValueUInt(NULL, "frequency", &device->Frequency))
2794 device->Flags |= DEVICE_FREQUENCY_REQUEST;
2795 if(device->Frequency < MIN_OUTPUT_RATE)
2796 ERR("%uhz request clamped to %uhz minimum\n", device->Frequency, MIN_OUTPUT_RATE);
2797 device->Frequency = maxu(device->Frequency, MIN_OUTPUT_RATE);
2800 ConfigValueUInt(NULL, "periods", &device->NumUpdates);
2801 device->NumUpdates = clampu(device->NumUpdates, 2, 16);
2803 ConfigValueUInt(NULL, "period_size", &device->UpdateSize);
2804 device->UpdateSize = clampu(device->UpdateSize, 64, 8192);
2805 if((CPUCapFlags&CPU_CAP_SSE))
2806 device->UpdateSize = (device->UpdateSize+3)&~3;
2808 ConfigValueUInt(NULL, "sources", &device->MaxNoOfSources);
2809 if(device->MaxNoOfSources == 0) device->MaxNoOfSources = 256;
2811 ConfigValueUInt(NULL, "slots", &device->AuxiliaryEffectSlotMax);
2812 if(device->AuxiliaryEffectSlotMax == 0) device->AuxiliaryEffectSlotMax = 4;
2814 ConfigValueUInt(NULL, "sends", &device->NumAuxSends);
2815 if(device->NumAuxSends > MAX_SENDS) device->NumAuxSends = MAX_SENDS;
2817 ConfigValueInt(NULL, "cf_level", &device->Bs2bLevel);
2819 device->NumStereoSources = 1;
2820 device->NumMonoSources = device->MaxNoOfSources - device->NumStereoSources;
2822 // Find a playback device to open
2823 LockLists();
2824 if((err=ALCdevice_OpenPlayback(device, deviceName)) != ALC_NO_ERROR)
2826 UnlockLists();
2827 DeleteCriticalSection(&device->Mutex);
2828 al_free(device);
2829 alcSetError(NULL, err);
2830 return NULL;
2832 UnlockLists();
2834 if(DefaultEffect.type != AL_EFFECT_NULL)
2836 device->DefaultSlot = (ALeffectslot*)(((ALintptrEXT)(device+1)+15)&~15);
2837 if(InitEffectSlot(device->DefaultSlot) != AL_NO_ERROR)
2839 device->DefaultSlot = NULL;
2840 ERR("Failed to initialize the default effect slot\n");
2842 else if(InitializeEffect(device, device->DefaultSlot, &DefaultEffect) != AL_NO_ERROR)
2844 ALeffectState_Destroy(device->DefaultSlot->EffectState);
2845 device->DefaultSlot = NULL;
2846 ERR("Failed to initialize the default effect\n");
2850 do {
2851 device->next = DeviceList;
2852 } while(!CompExchangePtr((XchgPtr*)&DeviceList, device->next, device));
2854 TRACE("Created device %p, \"%s\"\n", device, device->DeviceName);
2855 return device;
2858 /* alcCloseDevice
2860 * Closes the given device.
2862 ALC_API ALCboolean ALC_APIENTRY alcCloseDevice(ALCdevice *Device)
2864 ALCdevice *volatile*list;
2865 ALCcontext *ctx;
2867 LockLists();
2868 list = &DeviceList;
2869 while(*list && *list != Device)
2870 list = &(*list)->next;
2872 if(!*list || (*list)->Type == Capture)
2874 alcSetError(*list, ALC_INVALID_DEVICE);
2875 UnlockLists();
2876 return ALC_FALSE;
2879 *list = (*list)->next;
2880 UnlockLists();
2882 while((ctx=Device->ContextList) != NULL)
2884 WARN("Releasing context %p\n", ctx);
2885 ReleaseContext(ctx, Device);
2887 if((Device->Flags&DEVICE_RUNNING))
2888 ALCdevice_StopPlayback(Device);
2889 Device->Flags &= ~DEVICE_RUNNING;
2891 ALCdevice_DecRef(Device);
2893 return ALC_TRUE;
2897 /************************************************
2898 * ALC capture functions
2899 ************************************************/
2900 ALC_API ALCdevice* ALC_APIENTRY alcCaptureOpenDevice(const ALCchar *deviceName, ALCuint frequency, ALCenum format, ALCsizei samples)
2902 ALCdevice *device = NULL;
2903 ALCenum err;
2905 DO_INITCONFIG();
2907 if(!CaptureBackend.name)
2909 alcSetError(NULL, ALC_INVALID_VALUE);
2910 return NULL;
2913 if(samples <= 0)
2915 alcSetError(NULL, ALC_INVALID_VALUE);
2916 return NULL;
2919 if(deviceName && (!deviceName[0] || strcasecmp(deviceName, alcDefaultName) == 0 || strcasecmp(deviceName, "openal-soft") == 0))
2920 deviceName = NULL;
2922 device = al_calloc(16, sizeof(ALCdevice));
2923 if(!device)
2925 alcSetError(NULL, ALC_OUT_OF_MEMORY);
2926 return NULL;
2929 //Validate device
2930 device->Funcs = &CaptureBackend.Funcs;
2931 device->ref = 1;
2932 device->Connected = ALC_TRUE;
2933 device->Type = Capture;
2934 InitializeCriticalSection(&device->Mutex);
2936 InitUIntMap(&device->BufferMap, ~0);
2937 InitUIntMap(&device->EffectMap, ~0);
2938 InitUIntMap(&device->FilterMap, ~0);
2940 device->DeviceName = NULL;
2942 device->Flags |= DEVICE_FREQUENCY_REQUEST;
2943 device->Frequency = frequency;
2945 device->Flags |= DEVICE_CHANNELS_REQUEST | DEVICE_SAMPLE_TYPE_REQUEST;
2946 if(DecomposeDevFormat(format, &device->FmtChans, &device->FmtType) == AL_FALSE)
2948 DeleteCriticalSection(&device->Mutex);
2949 al_free(device);
2950 alcSetError(NULL, ALC_INVALID_ENUM);
2951 return NULL;
2954 device->UpdateSize = samples;
2955 device->NumUpdates = 1;
2957 LockLists();
2958 if((err=ALCdevice_OpenCapture(device, deviceName)) != ALC_NO_ERROR)
2960 UnlockLists();
2961 DeleteCriticalSection(&device->Mutex);
2962 al_free(device);
2963 alcSetError(NULL, err);
2964 return NULL;
2966 UnlockLists();
2968 do {
2969 device->next = DeviceList;
2970 } while(!CompExchangePtr((XchgPtr*)&DeviceList, device->next, device));
2972 TRACE("Created device %p\n", device);
2973 return device;
2976 ALC_API ALCboolean ALC_APIENTRY alcCaptureCloseDevice(ALCdevice *Device)
2978 ALCdevice *volatile*list;
2980 LockLists();
2981 list = &DeviceList;
2982 while(*list && *list != Device)
2983 list = &(*list)->next;
2985 if(!*list || (*list)->Type != Capture)
2987 alcSetError(*list, ALC_INVALID_DEVICE);
2988 UnlockLists();
2989 return ALC_FALSE;
2992 *list = (*list)->next;
2993 UnlockLists();
2995 ALCdevice_DecRef(Device);
2997 return ALC_TRUE;
3000 ALC_API void ALC_APIENTRY alcCaptureStart(ALCdevice *device)
3002 LockLists();
3003 if(!(device=VerifyDevice(device)) || device->Type != Capture)
3005 UnlockLists();
3006 alcSetError(device, ALC_INVALID_DEVICE);
3007 if(device) ALCdevice_DecRef(device);
3008 return;
3010 if(device->Connected)
3012 if(!(device->Flags&DEVICE_RUNNING))
3013 ALCdevice_StartCapture(device);
3014 device->Flags |= DEVICE_RUNNING;
3016 UnlockLists();
3018 ALCdevice_DecRef(device);
3021 ALC_API void ALC_APIENTRY alcCaptureStop(ALCdevice *device)
3023 LockLists();
3024 if(!(device=VerifyDevice(device)) || device->Type != Capture)
3026 UnlockLists();
3027 alcSetError(device, ALC_INVALID_DEVICE);
3028 if(device) ALCdevice_DecRef(device);
3029 return;
3031 if((device->Flags&DEVICE_RUNNING))
3032 ALCdevice_StopCapture(device);
3033 device->Flags &= ~DEVICE_RUNNING;
3034 UnlockLists();
3036 ALCdevice_DecRef(device);
3039 ALC_API void ALC_APIENTRY alcCaptureSamples(ALCdevice *device, ALCvoid *buffer, ALCsizei samples)
3041 ALCenum err = ALC_INVALID_DEVICE;
3042 LockLists();
3043 if((device=VerifyDevice(device)) != NULL && device->Type == Capture)
3045 err = ALC_INVALID_VALUE;
3046 if(samples >= 0 && ALCdevice_AvailableSamples(device) >= (ALCuint)samples)
3047 err = ALCdevice_CaptureSamples(device, buffer, samples);
3049 UnlockLists();
3050 if(err != ALC_NO_ERROR)
3051 alcSetError(device, err);
3052 if(device) ALCdevice_DecRef(device);
3056 /************************************************
3057 * ALC loopback functions
3058 ************************************************/
3060 /* alcLoopbackOpenDeviceSOFT
3062 * Open a loopback device, for manual rendering.
3064 ALC_API ALCdevice* ALC_APIENTRY alcLoopbackOpenDeviceSOFT(const ALCchar *deviceName)
3066 ALCdevice *device;
3068 DO_INITCONFIG();
3070 /* Make sure the device name, if specified, is us. */
3071 if(deviceName && strcmp(deviceName, alcDefaultName) != 0)
3073 alcSetError(NULL, ALC_INVALID_VALUE);
3074 return NULL;
3077 device = al_calloc(16, sizeof(ALCdevice));
3078 if(!device)
3080 alcSetError(NULL, ALC_OUT_OF_MEMORY);
3081 return NULL;
3084 //Validate device
3085 device->Funcs = &BackendLoopback.Funcs;
3086 device->ref = 1;
3087 device->Connected = ALC_TRUE;
3088 device->Type = Loopback;
3089 InitializeCriticalSection(&device->Mutex);
3090 device->LastError = ALC_NO_ERROR;
3092 device->Flags = 0;
3093 device->Bs2b = NULL;
3094 device->Bs2bLevel = 0;
3095 device->DeviceName = NULL;
3097 device->ContextList = NULL;
3099 device->MaxNoOfSources = 256;
3100 device->AuxiliaryEffectSlotMax = 4;
3101 device->NumAuxSends = MAX_SENDS;
3103 InitUIntMap(&device->BufferMap, ~0);
3104 InitUIntMap(&device->EffectMap, ~0);
3105 InitUIntMap(&device->FilterMap, ~0);
3107 //Set output format
3108 device->NumUpdates = 0;
3109 device->UpdateSize = 0;
3111 device->Frequency = DEFAULT_OUTPUT_RATE;
3112 device->FmtChans = DevFmtChannelsDefault;
3113 device->FmtType = DevFmtTypeDefault;
3115 ConfigValueUInt(NULL, "sources", &device->MaxNoOfSources);
3116 if(device->MaxNoOfSources == 0) device->MaxNoOfSources = 256;
3118 ConfigValueUInt(NULL, "slots", &device->AuxiliaryEffectSlotMax);
3119 if(device->AuxiliaryEffectSlotMax == 0) device->AuxiliaryEffectSlotMax = 4;
3121 ConfigValueUInt(NULL, "sends", &device->NumAuxSends);
3122 if(device->NumAuxSends > MAX_SENDS) device->NumAuxSends = MAX_SENDS;
3124 device->NumStereoSources = 1;
3125 device->NumMonoSources = device->MaxNoOfSources - device->NumStereoSources;
3127 // Open the "backend"
3128 ALCdevice_OpenPlayback(device, "Loopback");
3129 do {
3130 device->next = DeviceList;
3131 } while(!CompExchangePtr((XchgPtr*)&DeviceList, device->next, device));
3133 TRACE("Created device %p\n", device);
3134 return device;
3137 /* alcIsRenderFormatSupportedSOFT
3139 * Determines if the loopback device supports the given format for rendering.
3141 ALC_API ALCboolean ALC_APIENTRY alcIsRenderFormatSupportedSOFT(ALCdevice *device, ALCsizei freq, ALCenum channels, ALCenum type)
3143 ALCboolean ret = ALC_FALSE;
3145 if(!(device=VerifyDevice(device)) || device->Type != Loopback)
3146 alcSetError(device, ALC_INVALID_DEVICE);
3147 else if(freq <= 0)
3148 alcSetError(device, ALC_INVALID_VALUE);
3149 else
3151 if(IsValidALCType(type) && BytesFromDevFmt(type) > 0 &&
3152 IsValidALCChannels(channels) && ChannelsFromDevFmt(channels) > 0 &&
3153 freq >= MIN_OUTPUT_RATE)
3154 ret = ALC_TRUE;
3156 if(device) ALCdevice_DecRef(device);
3158 return ret;
3161 /* alcRenderSamplesSOFT
3163 * Renders some samples into a buffer, using the format last set by the
3164 * attributes given to alcCreateContext.
3166 ALC_API void ALC_APIENTRY alcRenderSamplesSOFT(ALCdevice *device, ALCvoid *buffer, ALCsizei samples)
3168 if(!(device=VerifyDevice(device)) || device->Type != Loopback)
3169 alcSetError(device, ALC_INVALID_DEVICE);
3170 else if(samples < 0 || (samples > 0 && buffer == NULL))
3171 alcSetError(device, ALC_INVALID_VALUE);
3172 else
3173 aluMixData(device, buffer, samples);
3174 if(device) ALCdevice_DecRef(device);