This repository has been archived by the owner on Feb 11, 2021. It is now read-only.
/
SDL_audio.c
997 lines (865 loc) · 26.8 KB
1
2
/*
SDL - Simple DirectMedia Layer
3
Copyright (C) 1997-2006 Sam Lantinga
4
5
This library is free software; you can redistribute it and/or
6
modify it under the terms of the GNU Lesser General Public
7
License as published by the Free Software Foundation; either
8
version 2.1 of the License, or (at your option) any later version.
9
10
11
12
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13
Lesser General Public License for more details.
14
15
16
17
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
18
19
Sam Lantinga
20
slouken@libsdl.org
21
*/
22
#include "SDL_config.h"
23
24
25
26
27
28
29
30
/* Allow access to a raw mixing buffer */
#include "SDL.h"
#include "SDL_audio_c.h"
#include "SDL_audiomem.h"
#include "SDL_sysaudio.h"
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
#define _THIS SDL_AudioDevice *this
static SDL_AudioDriver current_audio;
static SDL_AudioDevice *open_devices[16];
/* !!! FIXME: These are wordy and unlocalized... */
#define DEFAULT_OUTPUT_DEVNAME "System audio output device"
#define DEFAULT_INPUT_DEVNAME "System audio capture device"
/*
* Not all of these will be compiled and linked in, but it's convenient
* to have a complete list here and saves yet-another block of #ifdefs...
* Please see bootstrap[], below, for the actual #ifdef mess.
*/
extern AudioBootStrap BSD_AUDIO_bootstrap;
extern AudioBootStrap DSP_bootstrap;
extern AudioBootStrap DMA_bootstrap;
extern AudioBootStrap ALSA_bootstrap;
50
extern AudioBootStrap PULSEAUDIO_bootstrap;
51
52
53
54
55
56
57
extern AudioBootStrap QNXNTOAUDIO_bootstrap;
extern AudioBootStrap SUNAUDIO_bootstrap;
extern AudioBootStrap DMEDIA_bootstrap;
extern AudioBootStrap ARTS_bootstrap;
extern AudioBootStrap ESD_bootstrap;
extern AudioBootStrap NAS_bootstrap;
extern AudioBootStrap DSOUND_bootstrap;
58
extern AudioBootStrap WINWAVEOUT_bootstrap;
59
60
61
62
63
64
65
66
67
68
69
70
71
72
extern AudioBootStrap PAUDIO_bootstrap;
extern AudioBootStrap BEOSAUDIO_bootstrap;
extern AudioBootStrap COREAUDIO_bootstrap;
extern AudioBootStrap SNDMGR_bootstrap;
extern AudioBootStrap MINTAUDIO_GSXB_bootstrap;
extern AudioBootStrap MINTAUDIO_MCSN_bootstrap;
extern AudioBootStrap MINTAUDIO_STFA_bootstrap;
extern AudioBootStrap MINTAUDIO_XBIOS_bootstrap;
extern AudioBootStrap MINTAUDIO_DMA8_bootstrap;
extern AudioBootStrap DISKAUD_bootstrap;
extern AudioBootStrap DUMMYAUD_bootstrap;
extern AudioBootStrap DCAUD_bootstrap;
extern AudioBootStrap MMEAUDIO_bootstrap;
extern AudioBootStrap DART_bootstrap;
73
extern AudioBootStrap NDSAUD_bootstrap;
74
75
76
77
/* Available audio drivers */
static AudioBootStrap *bootstrap[] = {
78
#if SDL_AUDIO_DRIVER_BSD
79
&BSD_AUDIO_bootstrap,
80
#endif
81
#if SDL_AUDIO_DRIVER_OSS
82
83
&DSP_bootstrap,
&DMA_bootstrap,
84
#endif
85
#if SDL_AUDIO_DRIVER_ALSA
86
&ALSA_bootstrap,
87
#endif
88
#if SDL_AUDIO_DRIVER_PULSEAUDIO
89
&PULSEAUDIO_bootstrap,
90
#endif
91
#if SDL_AUDIO_DRIVER_QNXNTO
92
&QNXNTOAUDIO_bootstrap,
93
#endif
94
#if SDL_AUDIO_DRIVER_SUNAUDIO
95
&SUNAUDIO_bootstrap,
96
#endif
97
#if SDL_AUDIO_DRIVER_DMEDIA
98
&DMEDIA_bootstrap,
99
#endif
100
#if SDL_AUDIO_DRIVER_ARTS
101
&ARTS_bootstrap,
102
#endif
103
#if SDL_AUDIO_DRIVER_ESD
104
&ESD_bootstrap,
105
#endif
106
#if SDL_AUDIO_DRIVER_NAS
107
&NAS_bootstrap,
108
#endif
109
#if SDL_AUDIO_DRIVER_DSOUND
110
&DSOUND_bootstrap,
111
#endif
112
113
#if SDL_AUDIO_DRIVER_WINWAVEOUT
&WINWAVEOUT_bootstrap,
114
#endif
115
116
#if SDL_AUDIO_DRIVER_PAUDIO
&PAUDIO_bootstrap,
117
#endif
118
119
#if SDL_AUDIO_DRIVER_BEOSAUDIO
&BEOSAUDIO_bootstrap,
120
#endif
121
#if SDL_AUDIO_DRIVER_COREAUDIO
122
&COREAUDIO_bootstrap,
123
#endif
124
#if SDL_AUDIO_DRIVER_SNDMGR
125
&SNDMGR_bootstrap,
126
#endif
127
#if SDL_AUDIO_DRIVER_MINT
128
129
130
131
132
&MINTAUDIO_GSXB_bootstrap,
&MINTAUDIO_MCSN_bootstrap,
&MINTAUDIO_STFA_bootstrap,
&MINTAUDIO_XBIOS_bootstrap,
&MINTAUDIO_DMA8_bootstrap,
133
#endif
134
#if SDL_AUDIO_DRIVER_DISK
135
&DISKAUD_bootstrap,
136
#endif
137
#if SDL_AUDIO_DRIVER_DUMMY
138
&DUMMYAUD_bootstrap,
139
#endif
140
#if SDL_AUDIO_DRIVER_DC
141
&DCAUD_bootstrap,
142
#endif
143
#if SDL_AUDIO_DRIVER_MMEAUDIO
144
&MMEAUDIO_bootstrap,
145
146
#endif
#if SDL_AUDIO_DRIVER_DART
147
&DART_bootstrap,
148
149
150
#endif
#if SDL_AUDIO_DRIVER_NDS
&NDSAUD_bootstrap,
151
#endif
152
NULL
153
154
};
155
156
static SDL_AudioDevice *
get_audio_device(SDL_AudioDeviceID id)
157
158
{
id--;
159
if ((id >= SDL_arraysize(open_devices)) || (open_devices[id] == NULL)) {
160
161
162
163
164
165
166
167
168
SDL_SetError("Invalid audio device ID");
return NULL;
}
return open_devices[id];
}
/* stubs for audio drivers that don't need a specific entry point... */
169
170
171
172
173
static int
SDL_AudioDetectDevices_Default(int iscapture)
{
return -1;
}
174
175
176
177
178
static void
SDL_AudioThreadInit_Default(_THIS)
{ /* no-op. */
}
179
180
181
182
183
static void
SDL_AudioWaitDevice_Default(_THIS)
{ /* no-op. */
}
184
185
186
187
188
static void
SDL_AudioPlayDevice_Default(_THIS)
{ /* no-op. */
}
189
190
191
192
193
194
static Uint8 *
SDL_AudioGetDeviceBuf_Default(_THIS)
{
return NULL;
}
195
196
197
198
199
static void
SDL_AudioWaitDone_Default(_THIS)
{ /* no-op. */
}
200
201
202
203
204
static void
SDL_AudioCloseDevice_Default(_THIS)
{ /* no-op. */
}
205
206
207
208
209
static void
SDL_AudioDeinitialize_Default(void)
{ /* no-op. */
}
210
211
212
213
214
215
216
static int
SDL_AudioOpenDevice_Default(_THIS, const char *devname, int iscapture)
{
return 0;
}
217
218
static const char *
SDL_AudioGetDeviceName_Default(int index, int iscapture)
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
{
SDL_SetError("No such device");
return NULL;
}
static void
SDL_AudioLockDevice_Default(SDL_AudioDevice * device)
{
if (device->thread && (SDL_ThreadID() == device->threadid)) {
return;
}
SDL_mutexP(device->mixer_lock);
}
static void
SDL_AudioUnlockDevice_Default(SDL_AudioDevice * device)
{
if (device->thread && (SDL_ThreadID() == device->threadid)) {
return;
}
SDL_mutexV(device->mixer_lock);
}
243
244
static void
finalize_audio_entry_points(void)
245
246
247
248
249
250
{
/*
* Fill in stub functions for unused driver entry points. This lets us
* blindly call them without having to check for validity first.
*/
251
#define FILL_STUB(x) \
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
if (current_audio.impl.x == NULL) { \
current_audio.impl.x = SDL_Audio##x##_Default; \
}
FILL_STUB(DetectDevices);
FILL_STUB(GetDeviceName);
FILL_STUB(OpenDevice);
FILL_STUB(ThreadInit);
FILL_STUB(WaitDevice);
FILL_STUB(PlayDevice);
FILL_STUB(GetDeviceBuf);
FILL_STUB(WaitDone);
FILL_STUB(CloseDevice);
FILL_STUB(LockDevice);
FILL_STUB(UnlockDevice);
FILL_STUB(Deinitialize);
267
#undef FILL_STUB
268
}
269
270
271
/* The general mixing thread function */
272
int SDLCALL
273
SDL_RunAudio(void *devicep)
274
{
275
SDL_AudioDevice *device = (SDL_AudioDevice *) devicep;
276
277
278
279
280
Uint8 *stream;
int stream_len;
void *udata;
void (SDLCALL * fill) (void *userdata, Uint8 * stream, int len);
int silence;
281
282
/* Perform any thread setup */
283
284
device->threadid = SDL_ThreadID();
current_audio.impl.ThreadInit(device);
285
286
/* Set up the mixing function */
287
288
fill = device->spec.callback;
udata = device->spec.userdata;
289
290
291
if (device->convert.needed) {
if (device->convert.src_format == AUDIO_U8) {
292
293
294
295
silence = 0x80;
} else {
silence = 0;
}
296
stream_len = device->convert.len;
297
} else {
298
299
silence = device->spec.silence;
stream_len = device->spec.size;
300
}
301
302
/* Loop, filling the audio buffers */
303
while (device->enabled) {
304
305
/* Fill the current buffer with sound */
306
307
308
if (device->convert.needed) {
if (device->convert.buf) {
stream = device->convert.buf;
309
310
311
312
} else {
continue;
}
} else {
313
stream = current_audio.impl.GetDeviceBuf(device);
314
if (stream == NULL) {
315
stream = device->fake_stream;
316
}
317
}
318
319
320
if (!device->paused) {
SDL_mutexP(device->mixer_lock);
321
(*fill) (udata, stream, stream_len);
322
SDL_mutexV(device->mixer_lock);
323
}
324
325
/* Convert the audio if necessary */
326
327
328
if (device->convert.needed) {
SDL_ConvertAudio(&device->convert);
stream = current_audio.impl.GetDeviceBuf(device);
329
if (stream == NULL) {
330
stream = device->fake_stream;
331
}
332
SDL_memcpy(stream, device->convert.buf, device->convert.len_cvt);
333
334
335
}
/* Ready current buffer for play and change current buffer */
336
337
if (stream != device->fake_stream) {
current_audio.impl.PlayDevice(device);
338
339
340
}
/* Wait for an audio buffer to become available */
341
342
if (stream == device->fake_stream) {
SDL_Delay((device->spec.samples * 1000) / device->spec.freq);
343
} else {
344
current_audio.impl.WaitDevice(device);
345
346
347
348
}
}
/* Wait for the audio to drain.. */
349
current_audio.impl.WaitDone(device);
350
351
return (0);
352
353
}
354
355
static SDL_AudioFormat
356
SDL_ParseAudioFormat(const char *string)
357
{
358
#define CHECK_FMT_STRING(x) if (SDL_strcmp(string, #x) == 0) return AUDIO_##x
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
CHECK_FMT_STRING(U8);
CHECK_FMT_STRING(S8);
CHECK_FMT_STRING(U16LSB);
CHECK_FMT_STRING(S16LSB);
CHECK_FMT_STRING(U16MSB);
CHECK_FMT_STRING(S16MSB);
CHECK_FMT_STRING(U16SYS);
CHECK_FMT_STRING(S16SYS);
CHECK_FMT_STRING(U16);
CHECK_FMT_STRING(S16);
CHECK_FMT_STRING(S32LSB);
CHECK_FMT_STRING(S32MSB);
CHECK_FMT_STRING(S32SYS);
CHECK_FMT_STRING(S32);
CHECK_FMT_STRING(F32LSB);
CHECK_FMT_STRING(F32MSB);
CHECK_FMT_STRING(F32SYS);
CHECK_FMT_STRING(F32);
377
#undef CHECK_FMT_STRING
378
return 0;
379
380
}
381
382
int
SDL_GetNumAudioDrivers(void)
383
{
384
385
return (SDL_arraysize(bootstrap) - 1);
}
386
387
388
389
390
391
392
393
394
395
396
397
398
const char *
SDL_GetAudioDriver(int index)
{
if (index >= 0 && index < SDL_GetNumAudioDrivers()) {
return (bootstrap[index]->name);
}
return (NULL);
}
int
SDL_AudioInit(const char *driver_name)
{
399
400
401
int i = 0;
int initialized = 0;
int tried_to_init = 0;
402
403
if (SDL_WasInit(SDL_INIT_AUDIO)) {
404
SDL_AudioQuit(); /* shutdown driver if already running. */
405
406
}
407
408
SDL_memset(¤t_audio, '\0', sizeof(current_audio));
SDL_memset(open_devices, '\0', sizeof(open_devices));
409
410
/* Select the proper audio driver */
411
412
413
if (driver_name == NULL) {
driver_name = SDL_getenv("SDL_AUDIODRIVER");
}
414
415
416
417
for (i = 0; (!initialized) && (bootstrap[i]); ++i) {
/* make sure we should even try this driver before doing so... */
const AudioBootStrap *backend = bootstrap[i];
418
419
if (((driver_name) && (SDL_strcasecmp(backend->name, driver_name))) ||
((!driver_name) && (backend->demand_only))) {
420
continue;
421
}
422
423
tried_to_init = 1;
424
SDL_memset(¤t_audio, 0, sizeof(current_audio));
425
426
427
current_audio.name = backend->name;
current_audio.desc = backend->desc;
initialized = backend->init(¤t_audio.impl);
428
}
429
430
431
432
if (!initialized) {
/* specific drivers will set the error message if they fail... */
if (!tried_to_init) {
433
434
435
436
437
438
if (driver_name) {
SDL_SetError("%s not available", driver_name);
} else {
SDL_SetError("No available audio device");
}
}
439
440
441
SDL_memset(¤t_audio, 0, sizeof(current_audio));
return (-1); /* No driver was available, so fail. */
442
}
443
444
445
finalize_audio_entry_points();
446
return (0);
447
448
}
449
450
451
452
453
/*
* Get the current audio driver name
*/
const char *
SDL_GetCurrentAudioDriver()
454
{
455
return current_audio.name;
456
457
}
458
459
int
460
SDL_GetNumAudioDevices(int iscapture)
461
{
462
463
464
465
466
467
if (!SDL_WasInit(SDL_INIT_AUDIO)) {
return -1;
}
if ((iscapture) && (!current_audio.impl.HasCaptureSupport)) {
return 0;
}
468
469
470
if ((iscapture) && (current_audio.impl.OnlyHasDefaultInputDevice)) {
return 1;
471
472
}
473
474
if ((!iscapture) && (current_audio.impl.OnlyHasDefaultOutputDevice)) {
return 1;
475
476
}
477
478
479
480
481
482
483
484
485
486
return current_audio.impl.DetectDevices(iscapture);
}
const char *
SDL_GetAudioDeviceName(int index, int iscapture)
{
if (!SDL_WasInit(SDL_INIT_AUDIO)) {
SDL_SetError("Audio subsystem is not initialized");
return NULL;
487
}
488
489
490
491
if ((iscapture) && (!current_audio.impl.HasCaptureSupport)) {
SDL_SetError("No capture support");
return NULL;
492
}
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
if (index < 0) {
SDL_SetError("No such device");
return NULL;
}
if ((iscapture) && (current_audio.impl.OnlyHasDefaultInputDevice)) {
return DEFAULT_INPUT_DEVNAME;
}
if ((!iscapture) && (current_audio.impl.OnlyHasDefaultOutputDevice)) {
return DEFAULT_OUTPUT_DEVNAME;
}
return current_audio.impl.GetDeviceName(index, iscapture);
}
static void
512
close_audio_device(SDL_AudioDevice * device)
513
514
515
516
517
518
519
{
device->enabled = 0;
if (device->thread != NULL) {
SDL_WaitThread(device->thread, NULL);
}
if (device->mixer_lock != NULL) {
SDL_DestroyMutex(device->mixer_lock);
520
}
521
522
if (device->fake_stream != NULL) {
SDL_FreeAudioMem(device->fake_stream);
523
}
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
if (device->convert.needed) {
SDL_FreeAudioMem(device->convert.buf);
}
if (device->opened) {
current_audio.impl.CloseDevice(device);
device->opened = 0;
}
SDL_FreeAudioMem(device);
}
/*
* Sanity check desired AudioSpec for SDL_OpenAudio() in (orig).
* Fills in a sanitized copy in (prepared).
* Returns non-zero if okay, zero on fatal parameters in (orig).
*/
static int
541
prepare_audiospec(const SDL_AudioSpec * orig, SDL_AudioSpec * prepared)
542
{
543
SDL_memcpy(prepared, orig, sizeof(SDL_AudioSpec));
544
545
546
547
548
549
550
551
if (orig->callback == NULL) {
SDL_SetError("SDL_OpenAudio() passed a NULL callback");
return 0;
}
if (orig->freq == 0) {
const char *env = SDL_getenv("SDL_AUDIO_FREQUENCY");
552
553
if ((!env) || ((prepared->freq = SDL_atoi(env)) == 0)) {
prepared->freq = 22050; /* a reasonable default */
554
555
}
}
556
557
558
559
if (orig->format == 0) {
const char *env = SDL_getenv("SDL_AUDIO_FORMAT");
if ((!env) || ((prepared->format = SDL_ParseAudioFormat(env)) == 0)) {
560
prepared->format = AUDIO_S16; /* a reasonable default */
561
562
563
564
}
}
switch (orig->channels) {
565
566
case 0:{
const char *env = SDL_getenv("SDL_AUDIO_CHANNELS");
567
if ((!env) || ((prepared->channels = (Uint8) SDL_atoi(env)) == 0)) {
568
569
570
prepared->channels = 2; /* a reasonable default */
}
break;
571
}
572
573
574
575
576
577
case 1: /* Mono */
case 2: /* Stereo */
case 4: /* surround */
case 6: /* surround with center and lfe */
break;
default:
578
579
SDL_SetError("Unsupported number of audio channels.");
return 0;
580
}
581
582
583
if (orig->samples == 0) {
const char *env = SDL_getenv("SDL_AUDIO_SAMPLES");
584
if ((!env) || ((prepared->samples = (Uint16) SDL_atoi(env)) == 0)) {
585
586
587
588
589
590
591
592
/* Pick a default of ~46 ms at desired frequency */
/* !!! FIXME: remove this when the non-Po2 resampling is in. */
const int samples = (prepared->freq / 1000) * 46;
int power2 = 1;
while (power2 < samples) {
power2 *= 2;
}
prepared->samples = power2;
593
594
}
}
595
596
597
598
599
600
601
602
603
604
/* Calculate the silence and size of the audio specification */
SDL_CalculateAudioSpec(prepared);
return 1;
}
static SDL_AudioDeviceID
open_audio_device(const char *devname, int iscapture,
605
606
const SDL_AudioSpec * _desired, SDL_AudioSpec * obtained,
int min_id)
607
608
609
610
611
612
613
614
615
{
SDL_AudioDeviceID id = 0;
SDL_AudioSpec desired;
SDL_AudioDevice *device;
int i = 0;
if (!SDL_WasInit(SDL_INIT_AUDIO)) {
SDL_SetError("Audio subsystem is not initialized");
return 0;
616
}
617
618
619
620
if ((iscapture) && (!current_audio.impl.HasCaptureSupport)) {
SDL_SetError("No capture support");
return 0;
621
}
622
623
624
625
if (!prepare_audiospec(_desired, &desired)) {
return 0;
}
626
627
628
629
630
/* If app doesn't care about a specific device, let the user override. */
if (devname == NULL) {
devname = SDL_getenv("SDL_AUDIO_DEVICE_NAME");
}
631
632
633
634
635
636
637
638
639
640
/*
* Catch device names at the high level for the simple case...
* This lets us have a basic "device enumeration" for systems that
* don't have multiple devices, but makes sure the device name is
* always NULL when it hits the low level.
*
* Also make sure that the simple case prevents multiple simultaneous
* opens of the default system device.
*/
641
642
643
644
645
646
647
if ((iscapture) && (current_audio.impl.OnlyHasDefaultInputDevice)) {
if ((devname) && (SDL_strcmp(devname, DEFAULT_INPUT_DEVNAME) != 0)) {
SDL_SetError("No such device");
return 0;
}
devname = NULL;
648
649
650
651
652
653
654
for (i = 0; i < SDL_arraysize(open_devices); i++) {
if ((open_devices[i]) && (open_devices[i]->iscapture)) {
SDL_SetError("Audio device already open");
return 0;
}
}
655
656
}
657
658
659
660
661
662
if ((!iscapture) && (current_audio.impl.OnlyHasDefaultOutputDevice)) {
if ((devname) && (SDL_strcmp(devname, DEFAULT_OUTPUT_DEVNAME) != 0)) {
SDL_SetError("No such device");
return 0;
}
devname = NULL;
663
664
665
666
667
668
669
670
for (i = 0; i < SDL_arraysize(open_devices); i++) {
if ((open_devices[i]) && (!open_devices[i]->iscapture)) {
SDL_SetError("Audio device already open");
return 0;
}
}
}
671
672
device = (SDL_AudioDevice *) SDL_AllocAudioMem(sizeof(SDL_AudioDevice));
673
674
675
if (device == NULL) {
SDL_OutOfMemory();
return 0;
676
}
677
678
SDL_memset(device, '\0', sizeof(SDL_AudioDevice));
SDL_memcpy(&device->spec, &desired, sizeof(SDL_AudioSpec));
679
680
681
device->enabled = 1;
device->paused = 1;
device->iscapture = iscapture;
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
/* Create a semaphore for locking the sound buffers */
if (!current_audio.impl.SkipMixerLock) {
device->mixer_lock = SDL_CreateMutex();
if (device->mixer_lock == NULL) {
close_audio_device(device);
SDL_SetError("Couldn't create mixer lock");
return 0;
}
}
if (!current_audio.impl.OpenDevice(device, devname, iscapture)) {
close_audio_device(device);
return 0;
}
device->opened = 1;
698
699
/* If the audio driver changes the buffer size, accept it */
700
701
702
if (device->spec.samples != desired.samples) {
desired.samples = device->spec.samples;
SDL_CalculateAudioSpec(&device->spec);
703
704
705
}
/* Allocate a fake audio memory buffer */
706
707
708
device->fake_stream = SDL_AllocAudioMem(device->spec.size);
if (device->fake_stream == NULL) {
close_audio_device(device);
709
SDL_OutOfMemory();
710
return 0;
711
712
713
714
}
/* See if we need to do any conversion */
if (obtained != NULL) {
715
716
717
718
SDL_memcpy(obtained, &device->spec, sizeof(SDL_AudioSpec));
} else if (desired.freq != device->spec.freq ||
desired.format != device->spec.format ||
desired.channels != device->spec.channels) {
719
/* Build an audio conversion block */
720
721
722
723
724
725
726
if (SDL_BuildAudioCVT(&device->convert,
desired.format, desired.channels,
desired.freq,
device->spec.format, device->spec.channels,
device->spec.freq) < 0) {
close_audio_device(device);
return 0;
727
}
728
if (device->convert.needed) {
729
730
device->convert.len = (int) (((double) desired.size) /
device->convert.len_ratio);
731
732
733
734
735
736
device->convert.buf =
(Uint8 *) SDL_AllocAudioMem(device->convert.len *
device->convert.len_mult);
if (device->convert.buf == NULL) {
close_audio_device(device);
737
SDL_OutOfMemory();
738
return 0;
739
740
741
}
}
}
742
743
/* Find an available device ID and store the structure... */
744
for (id = min_id - 1; id < SDL_arraysize(open_devices); id++) {
745
746
747
748
749
750
751
752
753
754
755
756
if (open_devices[id] == NULL) {
open_devices[id] = device;
break;
}
}
if (id == SDL_arraysize(open_devices)) {
SDL_SetError("Too many open audio devices");
close_audio_device(device);
return 0;
}
757
/* Start the audio thread if necessary */
758
if (!current_audio.impl.ProvidesOwnCallbackThread) {
759
/* Start the audio thread */
760
/* !!! FIXME: this is nasty. */
761
#if (defined(__WIN32__) && !defined(_WIN32_WCE)) && !defined(HAVE_LIBC)
762
#undef SDL_CreateThread
763
device->thread = SDL_CreateThread(SDL_RunAudio, device, NULL, NULL);
764
#else
765
device->thread = SDL_CreateThread(SDL_RunAudio, device);
766
#endif
767
if (device->thread == NULL) {
768
SDL_CloseAudioDevice(id + 1);
769
SDL_SetError("Couldn't create audio thread");
770
771
772
773
return 0;
}
}
774
return id + 1;
775
776
777
778
779
780
781
782
783
784
785
}
int
SDL_OpenAudio(const SDL_AudioSpec * desired, SDL_AudioSpec * obtained)
{
SDL_AudioDeviceID id = 0;
/* Start up the audio driver, if necessary. This is legacy behaviour! */
if (!SDL_WasInit(SDL_INIT_AUDIO)) {
if (SDL_InitSubSystem(SDL_INIT_AUDIO) < 0) {
786
787
return (-1);
}
788
}
789
790
791
792
793
/* SDL_OpenAudio() is legacy and can only act on Device ID #1. */
if (open_devices[0] != NULL) {
SDL_SetError("Audio device is already opened");
return (-1);
794
}
795
796
id = open_audio_device(NULL, 0, desired, obtained, 1);
797
if (id > 1) { /* this should never happen in theory... */
798
SDL_CloseAudioDevice(id);
799
SDL_SetError("Internal error"); /* MUST be Device ID #1! */
800
801
return (-1);
}
802
803
return ((id == 0) ? -1 : 0);
804
805
}
806
807
SDL_AudioDeviceID
SDL_OpenAudioDevice(const char *device, int iscapture,
808
const SDL_AudioSpec * desired, SDL_AudioSpec * obtained)
809
{
810
811
return open_audio_device(device, iscapture, desired, obtained, 2);
}
812
813
814
815
816
817
818
819
SDL_audiostatus
SDL_GetAudioDeviceStatus(SDL_AudioDeviceID devid)
{
SDL_AudioDevice *device = get_audio_device(devid);
SDL_audiostatus status = SDL_AUDIO_STOPPED;
if (device && device->enabled) {
if (device->paused) {
820
821
822
823
824
825
status = SDL_AUDIO_PAUSED;
} else {
status = SDL_AUDIO_PLAYING;
}
}
return (status);
826
827
}
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
SDL_audiostatus
SDL_GetAudioStatus(void)
{
return SDL_GetAudioDeviceStatus(1);
}
void
SDL_PauseAudioDevice(SDL_AudioDeviceID devid, int pause_on)
{
SDL_AudioDevice *device = get_audio_device(devid);
if (device) {
device->paused = pause_on;
}
}
844
845
void
SDL_PauseAudio(int pause_on)
846
{
847
848
849
SDL_PauseAudioDevice(1, pause_on);
}
850
851
852
853
854
855
856
857
void
SDL_LockAudioDevice(SDL_AudioDeviceID devid)
{
/* Obtain a lock on the mixing buffers */
SDL_AudioDevice *device = get_audio_device(devid);
if (device) {
current_audio.impl.LockDevice(device);
858
}
859
860
}
861
862
void
SDL_LockAudio(void)
863
{
864
865
SDL_LockAudioDevice(1);
}
866
867
868
869
void
SDL_UnlockAudioDevice(SDL_AudioDeviceID devid)
{
870
/* Obtain a lock on the mixing buffers */
871
872
873
SDL_AudioDevice *device = get_audio_device(devid);
if (device) {
current_audio.impl.UnlockDevice(device);
874
}
875
876
}
877
878
void
SDL_UnlockAudio(void)
879
{
880
881
SDL_UnlockAudioDevice(1);
}
882
883
884
885
886
887
888
void
SDL_CloseAudioDevice(SDL_AudioDeviceID devid)
{
SDL_AudioDevice *device = get_audio_device(devid);
if (device) {
close_audio_device(device);
889
open_devices[devid - 1] = NULL;
890
}
891
892
}
893
894
void
SDL_CloseAudio(void)
895
{
896
SDL_CloseAudioDevice(1);
897
898
}
899
900
void
SDL_AudioQuit(void)
901
{
902
903
904
SDL_AudioDeviceID i;
for (i = 0; i < SDL_arraysize(open_devices); i++) {
SDL_CloseAudioDevice(i);
905
}
906
907
908
/* Free the driver data */
current_audio.impl.Deinitialize();
909
910
SDL_memset(¤t_audio, '\0', sizeof(current_audio));
SDL_memset(open_devices, '\0', sizeof(open_devices));
911
912
}
913
#define NUM_FORMATS 10
914
915
static int format_idx;
static int format_idx_sub;
916
static SDL_AudioFormat format_list[NUM_FORMATS][NUM_FORMATS] = {
917
{AUDIO_U8, AUDIO_S8, AUDIO_S16LSB, AUDIO_S16MSB, AUDIO_U16LSB,
918
AUDIO_U16MSB, AUDIO_S32LSB, AUDIO_S32MSB, AUDIO_F32LSB, AUDIO_F32MSB},
919
{AUDIO_S8, AUDIO_U8, AUDIO_S16LSB, AUDIO_S16MSB, AUDIO_U16LSB,
920
921
922
923
924
925
926
927
928
AUDIO_U16MSB, AUDIO_S32LSB, AUDIO_S32MSB, AUDIO_F32LSB, AUDIO_F32MSB},
{AUDIO_S16LSB, AUDIO_S16MSB, AUDIO_U16LSB, AUDIO_U16MSB, AUDIO_S32LSB,
AUDIO_S32MSB, AUDIO_F32LSB, AUDIO_F32MSB, AUDIO_U8, AUDIO_S8},
{AUDIO_S16MSB, AUDIO_S16LSB, AUDIO_U16MSB, AUDIO_U16LSB, AUDIO_S32MSB,
AUDIO_S32LSB, AUDIO_F32MSB, AUDIO_F32LSB, AUDIO_U8, AUDIO_S8},
{AUDIO_U16LSB, AUDIO_U16MSB, AUDIO_S16LSB, AUDIO_S16MSB, AUDIO_S32LSB,
AUDIO_S32MSB, AUDIO_F32LSB, AUDIO_F32MSB, AUDIO_U8, AUDIO_S8},
{AUDIO_U16MSB, AUDIO_U16LSB, AUDIO_S16MSB, AUDIO_S16LSB, AUDIO_S32MSB,
AUDIO_S32LSB, AUDIO_F32MSB, AUDIO_F32LSB, AUDIO_U8, AUDIO_S8},
929
930
931
932
933
934
935
936
{AUDIO_S32LSB, AUDIO_S32MSB, AUDIO_F32LSB, AUDIO_F32MSB, AUDIO_S16LSB,
AUDIO_S16MSB, AUDIO_U16LSB, AUDIO_U16MSB, AUDIO_U8, AUDIO_S8},
{AUDIO_S32MSB, AUDIO_S32LSB, AUDIO_F32MSB, AUDIO_F32LSB, AUDIO_S16MSB,
AUDIO_S16LSB, AUDIO_U16MSB, AUDIO_U16LSB, AUDIO_U8, AUDIO_S8},
{AUDIO_F32LSB, AUDIO_F32MSB, AUDIO_S32LSB, AUDIO_S32MSB, AUDIO_S16LSB,
AUDIO_S16MSB, AUDIO_U16LSB, AUDIO_U16MSB, AUDIO_U8, AUDIO_S8},
{AUDIO_F32MSB, AUDIO_F32LSB, AUDIO_S32MSB, AUDIO_S32LSB, AUDIO_S16MSB,
AUDIO_S16LSB, AUDIO_U16MSB, AUDIO_U16LSB, AUDIO_U8, AUDIO_S8},
937
938
};
939
940
SDL_AudioFormat
SDL_FirstAudioFormat(SDL_AudioFormat format)
941
{
942
943
944
945
946
947
948
for (format_idx = 0; format_idx < NUM_FORMATS; ++format_idx) {
if (format_list[format_idx][0] == format) {
break;
}
}
format_idx_sub = 0;
return (SDL_NextAudioFormat());
949
950
}
951
SDL_AudioFormat
952
SDL_NextAudioFormat(void)
953
{
954
955
956
957
if ((format_idx == NUM_FORMATS) || (format_idx_sub == NUM_FORMATS)) {
return (0);
}
return (format_list[format_idx][format_idx_sub++]);
958
959
}
960
961
void
SDL_CalculateAudioSpec(SDL_AudioSpec * spec)
962
{
963
964
965
966
967
968
969
970
switch (spec->format) {
case AUDIO_U8:
spec->silence = 0x80;
break;
default:
spec->silence = 0x00;
break;
}
971
spec->size = SDL_AUDIO_BITSIZE(spec->format) / 8;
972
973
spec->size *= spec->channels;
spec->size *= spec->samples;
974
}
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
/*
* Moved here from SDL_mixer.c, since it relies on internals of an opened
* audio device (and is deprecated, by the way!).
*/
void
SDL_MixAudio(Uint8 * dst, const Uint8 * src, Uint32 len, int volume)
{
/* Mix the user-level audio format */
SDL_AudioDevice *device = get_audio_device(1);
if (device != NULL) {
SDL_AudioFormat format;
if (device->convert.needed) {
format = device->convert.src_format;
} else {
format = device->spec.format;
}
SDL_MixAudioFormat(dst, src, format, len, volume);
}
}
997
/* vi: set ts=4 sw=4 expandtab: */