This repository has been archived by the owner on Feb 11, 2021. It is now read-only.
/
SDL_coreaudio.c
604 lines (500 loc) · 18.9 KB
1
2
/*
SDL - Simple DirectMedia Layer
3
Copyright (C) 1997-2009 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
20
21
Sam Lantinga
slouken@libsdl.org
*/
22
#include "SDL_config.h"
23
24
#include <CoreAudio/CoreAudio.h>
25
#include <CoreServices/CoreServices.h>
26
#include <AudioUnit/AudioUnit.h>
27
#if MAC_OS_X_VERSION_MAX_ALLOWED <= 1050
28
29
#include <AudioUnit/AUNTComponent.h>
#endif
30
31
#include "SDL_audio.h"
32
33
#include "../SDL_audio_c.h"
#include "../SDL_sysaudio.h"
34
35
#include "SDL_coreaudio.h"
36
#define DEBUG_COREAUDIO 0
37
38
39
40
41
42
typedef struct COREAUDIO_DeviceList
{
AudioDeviceID id;
const char *name;
} COREAUDIO_DeviceList;
43
44
45
46
47
static COREAUDIO_DeviceList *inputDevices = NULL;
static int inputDeviceCount = 0;
static COREAUDIO_DeviceList *outputDevices = NULL;
static int outputDeviceCount = 0;
48
49
static void
50
free_device_list(COREAUDIO_DeviceList ** devices, int *devCount)
51
{
52
53
54
55
56
57
58
59
if (*devices) {
int i = *devCount;
while (i--)
SDL_free((void *) (*devices)[i].name);
SDL_free(*devices);
*devices = NULL;
}
*devCount = 0;
60
61
}
62
63
static void
64
65
build_device_list(int iscapture, COREAUDIO_DeviceList ** devices,
int *devCount)
66
{
67
68
69
70
71
72
73
74
75
76
Boolean outWritable = 0;
OSStatus result = noErr;
UInt32 size = 0;
AudioDeviceID *devs = NULL;
UInt32 i = 0;
UInt32 max = 0;
free_device_list(devices, devCount);
result = AudioHardwareGetPropertyInfo(kAudioHardwarePropertyDevices,
77
&size, &outWritable);
78
79
80
81
82
83
84
85
if (result != kAudioHardwareNoError)
return;
devs = (AudioDeviceID *) alloca(size);
if (devs == NULL)
return;
86
87
max = size / sizeof(AudioDeviceID);
*devices = (COREAUDIO_DeviceList *) SDL_malloc(max * sizeof(**devices));
88
89
90
91
if (*devices == NULL)
return;
result = AudioHardwareGetProperty(kAudioHardwarePropertyDevices,
92
&size, devs);
93
94
95
96
97
98
99
100
101
102
103
104
if (result != kAudioHardwareNoError)
return;
for (i = 0; i < max; i++) {
CFStringRef cfstr = NULL;
char *ptr = NULL;
AudioDeviceID dev = devs[i];
AudioBufferList *buflist = NULL;
int usable = 0;
CFIndex len = 0;
result = AudioDeviceGetPropertyInfo(dev, 0, iscapture,
105
106
kAudioDevicePropertyStreamConfiguration,
&size, &outWritable);
107
108
109
110
111
112
113
114
if (result != noErr)
continue;
buflist = (AudioBufferList *) SDL_malloc(size);
if (buflist == NULL)
continue;
result = AudioDeviceGetProperty(dev, 0, iscapture,
115
116
kAudioDevicePropertyStreamConfiguration,
&size, buflist);
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
if (result == noErr) {
UInt32 j;
for (j = 0; j < buflist->mNumberBuffers; j++) {
if (buflist->mBuffers[j].mNumberChannels > 0) {
usable = 1;
break;
}
}
}
SDL_free(buflist);
if (!usable)
continue;
133
size = sizeof(CFStringRef);
134
result = AudioDeviceGetProperty(dev, 0, iscapture,
135
kAudioDevicePropertyDeviceNameCFString,
136
137
138
139
140
141
142
143
144
&size, &cfstr);
if (result != kAudioHardwareNoError)
continue;
len = CFStringGetMaximumSizeForEncoding(CFStringGetLength(cfstr),
kCFStringEncodingUTF8);
ptr = (char *) SDL_malloc(len + 1);
145
146
147
usable = ((ptr != NULL) &&
(CFStringGetCString
(cfstr, ptr, len + 1, kCFStringEncodingUTF8)));
148
149
150
151
152
153
CFRelease(cfstr);
if (usable) {
len = strlen(ptr);
/* Some devices have whitespace at the end...trim it. */
154
while ((len > 0) && (ptr[len - 1] == ' ')) {
155
156
157
158
159
160
161
162
163
164
len--;
}
usable = (len > 0);
}
if (!usable) {
SDL_free(ptr);
} else {
ptr[len] = '\0';
165
#if DEBUG_COREAUDIO
166
printf("COREAUDIO: Found %s device #%d: '%s' (devid %d)\n",
167
168
169
((iscapture) ? "capture" : "output"),
(int) *devCount, ptr, (int) dev);
#endif
170
171
172
173
174
175
(*devices)[*devCount].id = dev;
(*devices)[*devCount].name = ptr;
(*devCount)++;
}
}
176
177
}
178
179
static inline void
build_device_lists(void)
180
{
181
182
183
build_device_list(0, &outputDevices, &outputDeviceCount);
build_device_list(1, &inputDevices, &inputDeviceCount);
}
184
185
186
187
188
189
190
191
192
193
194
static inline void
free_device_lists(void)
{
free_device_list(&outputDevices, &outputDeviceCount);
free_device_list(&inputDevices, &inputDeviceCount);
}
static int
195
find_device_id(const char *devname, int iscapture, AudioDeviceID * id)
196
197
198
199
200
201
202
{
int i = ((iscapture) ? inputDeviceCount : outputDeviceCount);
COREAUDIO_DeviceList *devs = ((iscapture) ? inputDevices : outputDevices);
while (i--) {
if (SDL_strcmp(devname, devs->name) == 0) {
*id = devs->id;
return 1;
203
}
204
devs++;
205
206
}
207
208
209
210
211
212
213
214
215
216
217
218
219
220
return 0;
}
static int
COREAUDIO_DetectDevices(int iscapture)
{
if (iscapture) {
build_device_list(1, &inputDevices, &inputDeviceCount);
return inputDeviceCount;
} else {
build_device_list(0, &outputDevices, &outputDeviceCount);
return outputDeviceCount;
}
221
222
return 0; /* shouldn't ever hit this. */
223
}
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
static const char *
COREAUDIO_GetDeviceName(int index, int iscapture)
{
if ((iscapture) && (index < inputDeviceCount)) {
return inputDevices[index].name;
} else if ((!iscapture) && (index < outputDeviceCount)) {
return outputDevices[index].name;
}
SDL_SetError("No such device");
return NULL;
}
static void
COREAUDIO_Deinitialize(void)
{
free_device_lists();
244
245
246
247
}
/* The CoreAudio callback */
248
static OSStatus
249
outputCallback(void *inRefCon,
250
251
252
AudioUnitRenderActionFlags * ioActionFlags,
const AudioTimeStamp * inTimeStamp,
UInt32 inBusNumber, UInt32 inNumberFrames,
253
AudioBufferList * ioData)
254
{
255
SDL_AudioDevice *this = (SDL_AudioDevice *) inRefCon;
256
AudioBuffer *abuf;
257
258
UInt32 remaining, len;
void *ptr;
259
UInt32 i;
260
261
262
263
264
265
/* Is there ever more than one buffer, and what do you do with it? */
if (ioDataList->mNumberBuffers != 1) {
return noErr;
}
266
/* Only do anything if audio is enabled and not paused */
267
if (!this->enabled || this->paused) {
268
269
270
271
for (i = 0; i < ioData->mNumberBuffers; i++) {
abuf = &ioData->mBuffers[i];
SDL_memset(abuf->mData, this->spec.silence, abuf->mDataByteSize);
}
272
273
return 0;
}
274
275
276
277
/* No SDL conversion should be needed here, ever, since we accept
any input format in OpenAudio, and leave the conversion to CoreAudio.
*/
278
/*
279
280
assert(!this->convert.needed);
assert(this->spec.channels == ioData->mNumberChannels);
281
*/
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
for (i = 0; i < ioData->mNumberBuffers; i++) {
abuf = &ioData->mBuffers[i];
remaining = abuf->mDataByteSize;
ptr = abuf->mData;
while (remaining > 0) {
if (bufferOffset >= bufferSize) {
/* Generate the data */
SDL_memset(buffer, this->spec.silence, bufferSize);
SDL_mutexP(this->mixer_lock);
(*this->spec.callback)(this->spec.userdata,
buffer, bufferSize);
SDL_mutexV(this->mixer_lock);
bufferOffset = 0;
}
297
298
299
300
301
302
303
304
305
len = bufferSize - bufferOffset;
if (len > remaining)
len = remaining;
SDL_memcpy(ptr, (char *)buffer + bufferOffset, len);
ptr = (char *)ptr + len;
remaining -= len;
bufferOffset += len;
}
306
}
307
308
309
310
return 0;
}
311
312
static OSStatus
inputCallback(void *inRefCon,
313
AudioUnitRenderActionFlags * ioActionFlags,
314
315
const AudioTimeStamp * inTimeStamp,
UInt32 inBusNumber, UInt32 inNumberFrames,
316
AudioBufferList * ioData)
317
{
318
319
320
//err = AudioUnitRender(afr->fAudioUnit, ioActionFlags, inTimeStamp, inBusNumber, inNumberFrames, afr->fAudioBuffer);
// !!! FIXME: write me!
return noErr;
321
322
323
}
324
325
static void
COREAUDIO_CloseDevice(_THIS)
326
{
327
if (this->hidden != NULL) {
328
329
330
331
332
333
if (this->hidden->audioUnitOpened) {
OSStatus result = noErr;
AURenderCallbackStruct callback;
const AudioUnitElement output_bus = 0;
const AudioUnitElement input_bus = 1;
const int iscapture = this->iscapture;
334
335
336
337
338
const AudioUnitElement bus =
((iscapture) ? input_bus : output_bus);
const AudioUnitScope scope =
((iscapture) ? kAudioUnitScope_Output :
kAudioUnitScope_Input);
339
340
341
342
343
/* stop processing the audio unit */
result = AudioOutputUnitStop(this->hidden->audioUnit);
/* Remove the input callback */
344
SDL_memset(&callback, '\0', sizeof(AURenderCallbackStruct));
345
346
347
result = AudioUnitSetProperty(this->hidden->audioUnit,
kAudioUnitProperty_SetRenderCallback,
scope, bus, &callback,
348
sizeof(callback));
349
350
351
352
CloseComponent(this->hidden->audioUnit);
this->hidden->audioUnitOpened = 0;
}
353
354
355
356
SDL_free(this->hidden->buffer);
SDL_free(this->hidden);
this->hidden = NULL;
}
357
358
359
}
360
361
362
363
364
#define CHECK_RESULT(msg) \
if (result != noErr) { \
COREAUDIO_CloseDevice(this); \
SDL_SetError("CoreAudio error (%s): %d", msg, (int) result); \
return 0; \
365
366
}
367
368
369
370
371
372
373
374
375
376
static int
find_device_by_name(_THIS, const char *devname, int iscapture)
{
AudioDeviceID devid = 0;
OSStatus result = noErr;
UInt32 size = 0;
UInt32 alive = 0;
pid_t pid = 0;
if (devname == NULL) {
377
size = sizeof(AudioDeviceID);
378
const AudioHardwarePropertyID propid =
379
380
((iscapture) ? kAudioHardwarePropertyDefaultInputDevice :
kAudioHardwarePropertyDefaultOutputDevice);
381
382
383
384
385
386
387
388
result = AudioHardwareGetProperty(propid, &size, &devid);
CHECK_RESULT("AudioHardwareGetProperty (default device)");
} else {
if (!find_device_id(devname, iscapture, &devid)) {
SDL_SetError("CoreAudio: No such audio device.");
return 0;
}
389
390
}
391
size = sizeof(alive);
392
393
394
result = AudioDeviceGetProperty(devid, 0, iscapture,
kAudioDevicePropertyDeviceIsAlive,
&size, &alive);
395
396
CHECK_RESULT
("AudioDeviceGetProperty (kAudioDevicePropertyDeviceIsAlive)");
397
398
399
400
if (!alive) {
SDL_SetError("CoreAudio: requested device exists, but isn't alive.");
return 0;
401
}
402
403
size = sizeof(pid);
404
405
result = AudioDeviceGetProperty(devid, 0, iscapture,
kAudioDevicePropertyHogMode, &size, &pid);
406
407
408
409
410
/* some devices don't support this property, so errors are fine here. */
if ((result == noErr) && (pid != -1)) {
SDL_SetError("CoreAudio: requested device is being hogged.");
return 0;
411
412
}
413
414
415
416
this->hidden->deviceID = devid;
return 1;
}
417
418
419
static int
prepare_audiounit(_THIS, const char *devname, int iscapture,
420
const AudioStreamBasicDescription * strdesc)
421
422
{
OSStatus result = noErr;
423
AURenderCallbackStruct callback;
424
ComponentDescription desc;
425
426
427
428
429
430
Component comp = NULL;
UInt32 enableIO = 0;
const AudioUnitElement output_bus = 0;
const AudioUnitElement input_bus = 1;
const AudioUnitElement bus = ((iscapture) ? input_bus : output_bus);
const AudioUnitScope scope = ((iscapture) ? kAudioUnitScope_Output :
431
kAudioUnitScope_Input);
432
433
434
435
436
437
438
439
if (!find_device_by_name(this, devname, iscapture)) {
SDL_SetError("Couldn't find requested CoreAudio device");
return 0;
}
SDL_memset(&desc, '\0', sizeof(ComponentDescription));
desc.componentType = kAudioUnitType_Output;
440
desc.componentSubType = kAudioUnitSubType_DefaultOutput;
441
442
443
444
445
446
447
448
449
450
451
452
desc.componentManufacturer = kAudioUnitManufacturer_Apple;
comp = FindNextComponent(NULL, &desc);
if (comp == NULL) {
SDL_SetError("Couldn't find requested CoreAudio component");
return 0;
}
/* Open & initialize the audio unit */
result = OpenAComponent(comp, &this->hidden->audioUnit);
CHECK_RESULT("OpenAComponent");
453
454
this->hidden->audioUnitOpened = 1;
455
456
457
458
459
// !!! FIXME: this is wrong?
enableIO = ((iscapture) ? 1 : 0);
result = AudioUnitSetProperty(this->hidden->audioUnit,
kAudioOutputUnitProperty_EnableIO,
kAudioUnitScope_Input, input_bus,
460
&enableIO, sizeof(enableIO));
461
462
463
464
465
466
467
CHECK_RESULT("AudioUnitSetProperty (kAudioUnitProperty_EnableIO input)");
// !!! FIXME: this is wrong?
enableIO = ((iscapture) ? 0 : 1);
result = AudioUnitSetProperty(this->hidden->audioUnit,
kAudioOutputUnitProperty_EnableIO,
kAudioUnitScope_Output, output_bus,
468
&enableIO, sizeof(enableIO));
469
470
471
472
473
474
CHECK_RESULT("AudioUnitSetProperty (kAudioUnitProperty_EnableIO output)");
result = AudioUnitSetProperty(this->hidden->audioUnit,
kAudioOutputUnitProperty_CurrentDevice,
kAudioUnitScope_Global, 0,
&this->hidden->deviceID,
475
476
477
sizeof(AudioDeviceID));
CHECK_RESULT
("AudioUnitSetProperty (kAudioOutputUnitProperty_CurrentDevice)");
478
479
480
481
/* Set the data format of the audio unit. */
result = AudioUnitSetProperty(this->hidden->audioUnit,
kAudioUnitProperty_StreamFormat,
482
scope, bus, strdesc, sizeof(*strdesc));
483
484
485
CHECK_RESULT("AudioUnitSetProperty (kAudioUnitProperty_StreamFormat)");
/* Set the audio callback */
486
SDL_memset(&callback, '\0', sizeof(AURenderCallbackStruct));
487
488
489
490
callback.inputProc = ((iscapture) ? inputCallback : outputCallback);
callback.inputProcRefCon = this;
result = AudioUnitSetProperty(this->hidden->audioUnit,
kAudioUnitProperty_SetRenderCallback,
491
492
scope, bus, &callback, sizeof(callback));
CHECK_RESULT
493
("AudioUnitSetProperty (kAudioUnitProperty_SetRenderCallback)");
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
/* Calculate the final parameters for this audio specification */
SDL_CalculateAudioSpec(&this->spec);
/* Allocate a sample buffer */
this->hidden->bufferOffset = this->hidden->bufferSize = this->spec.size;
this->hidden->buffer = SDL_malloc(this->hidden->bufferSize);
result = AudioUnitInitialize(this->hidden->audioUnit);
CHECK_RESULT("AudioUnitInitialize");
/* Finally, start processing of the audio unit */
result = AudioOutputUnitStart(this->hidden->audioUnit);
CHECK_RESULT("AudioOutputUnitStart");
/* We're running! */
return 1;
}
static int
COREAUDIO_OpenDevice(_THIS, const char *devname, int iscapture)
{
517
AudioStreamBasicDescription strdesc;
518
SDL_AudioFormat test_format = SDL_FirstAudioFormat(this->spec.format);
519
int valid_datatype = 0;
520
521
522
/* Initialize all variables that we clean on shutdown */
this->hidden = (struct SDL_PrivateAudioData *)
523
SDL_malloc((sizeof *this->hidden));
524
525
526
527
528
529
if (this->hidden == NULL) {
SDL_OutOfMemory();
return (0);
}
SDL_memset(this->hidden, 0, (sizeof *this->hidden));
530
/* Setup a AudioStreamBasicDescription with the requested format */
531
SDL_memset(&strdesc, '\0', sizeof(AudioStreamBasicDescription));
532
533
strdesc.mFormatID = kAudioFormatLinearPCM;
strdesc.mFormatFlags = kLinearPCMFormatFlagIsPacked;
534
535
strdesc.mChannelsPerFrame = this->spec.channels;
strdesc.mSampleRate = this->spec.freq;
536
strdesc.mFramesPerPacket = 1;
537
538
while ((!valid_datatype) && (test_format)) {
539
this->spec.format = test_format;
540
541
/* Just a list of valid SDL formats, so people don't pass junk here. */
switch (test_format) {
542
543
544
545
546
547
548
549
550
551
552
case AUDIO_U8:
case AUDIO_S8:
case AUDIO_U16LSB:
case AUDIO_S16LSB:
case AUDIO_U16MSB:
case AUDIO_S16MSB:
case AUDIO_S32LSB:
case AUDIO_S32MSB:
case AUDIO_F32LSB:
case AUDIO_F32MSB:
valid_datatype = 1;
553
554
strdesc.mBitsPerChannel = SDL_AUDIO_BITSIZE(this->spec.format);
if (SDL_AUDIO_ISBIGENDIAN(this->spec.format))
555
556
strdesc.mFormatFlags |= kLinearPCMFormatFlagIsBigEndian;
557
if (SDL_AUDIO_ISFLOAT(this->spec.format))
558
strdesc.mFormatFlags |= kLinearPCMFormatFlagIsFloat;
559
else if (SDL_AUDIO_ISSIGNED(this->spec.format))
560
561
strdesc.mFormatFlags |= kLinearPCMFormatFlagIsSignedInteger;
break;
562
563
}
}
564
565
if (!valid_datatype) { /* shouldn't happen, but just in case... */
566
COREAUDIO_CloseDevice(this);
567
SDL_SetError("Unsupported audio format");
568
return 0;
569
}
570
571
572
573
574
strdesc.mBytesPerFrame =
strdesc.mBitsPerChannel * strdesc.mChannelsPerFrame / 8;
strdesc.mBytesPerPacket =
strdesc.mBytesPerFrame * strdesc.mFramesPerPacket;
575
576
if (!prepare_audiounit(this, devname, iscapture, &strdesc)) {
577
COREAUDIO_CloseDevice(this);
578
return 0; /* prepare_audiounit() will call SDL_SetError()... */
579
}
580
581
return 1; /* good to go. */
582
}
583
584
static int
585
COREAUDIO_Init(SDL_AudioDriverImpl * impl)
586
587
588
589
590
591
592
593
{
/* Set the function pointers */
impl->DetectDevices = COREAUDIO_DetectDevices;
impl->GetDeviceName = COREAUDIO_GetDeviceName;
impl->OpenDevice = COREAUDIO_OpenDevice;
impl->CloseDevice = COREAUDIO_CloseDevice;
impl->Deinitialize = COREAUDIO_Deinitialize;
impl->ProvidesOwnCallbackThread = 1;
594
595
build_device_lists(); /* do an initial check for devices... */
596
597
return (outputDeviceCount > 0) ? 2 : 1;
598
}
599
600
601
602
603
AudioBootStrap COREAUDIO_bootstrap = {
"coreaudio", "Mac OS X CoreAudio", COREAUDIO_Init, 0
};
604
/* vi: set ts=4 sw=4 expandtab: */