src/audio/SDL_audio.c
author Ryan C. Gordon
Mon, 16 Mar 2015 02:11:39 -0400
changeset 9393 ed79a66e57e5
parent 9392 92e23eff9b89
child 9394 bb28e5281770
permissions -rw-r--r--
Initial work on audio device hotplug support.

This fills in the core pieces and fully implements it for Mac OS X.

Most other platforms, at the moment, will report a disconnected device if
it fails to write audio, but don't notice if the system's device list changed
at all.
slouken@0
     1
/*
slouken@5535
     2
  Simple DirectMedia Layer
slouken@8149
     3
  Copyright (C) 1997-2014 Sam Lantinga <slouken@libsdl.org>
slouken@0
     4
slouken@5535
     5
  This software is provided 'as-is', without any express or implied
slouken@5535
     6
  warranty.  In no event will the authors be held liable for any damages
slouken@5535
     7
  arising from the use of this software.
slouken@0
     8
slouken@5535
     9
  Permission is granted to anyone to use this software for any purpose,
slouken@5535
    10
  including commercial applications, and to alter it and redistribute it
slouken@5535
    11
  freely, subject to the following restrictions:
slouken@0
    12
slouken@5535
    13
  1. The origin of this software must not be misrepresented; you must not
slouken@5535
    14
     claim that you wrote the original software. If you use this software
slouken@5535
    15
     in a product, an acknowledgment in the product documentation would be
slouken@5535
    16
     appreciated but is not required.
slouken@5535
    17
  2. Altered source versions must be plainly marked as such, and must not be
slouken@5535
    18
     misrepresented as being the original software.
slouken@5535
    19
  3. This notice may not be removed or altered from any source distribution.
slouken@0
    20
*/
icculus@8093
    21
#include "../SDL_internal.h"
slouken@0
    22
slouken@0
    23
/* Allow access to a raw mixing buffer */
slouken@0
    24
slouken@0
    25
#include "SDL.h"
slouken@2984
    26
#include "SDL_audio.h"
slouken@0
    27
#include "SDL_audio_c.h"
slouken@0
    28
#include "SDL_audiomem.h"
slouken@0
    29
#include "SDL_sysaudio.h"
slouken@0
    30
aschiffler@4865
    31
#define _THIS SDL_AudioDevice *_this
icculus@2049
    32
icculus@2049
    33
static SDL_AudioDriver current_audio;
icculus@2049
    34
static SDL_AudioDevice *open_devices[16];
icculus@2049
    35
icculus@2049
    36
/* !!! FIXME: These are wordy and unlocalized... */
icculus@2049
    37
#define DEFAULT_OUTPUT_DEVNAME "System audio output device"
icculus@2049
    38
#define DEFAULT_INPUT_DEVNAME "System audio capture device"
icculus@2049
    39
icculus@2049
    40
icculus@2049
    41
/*
icculus@2049
    42
 * Not all of these will be compiled and linked in, but it's convenient
icculus@2049
    43
 *  to have a complete list here and saves yet-another block of #ifdefs...
icculus@2049
    44
 *  Please see bootstrap[], below, for the actual #ifdef mess.
icculus@2049
    45
 */
icculus@2049
    46
extern AudioBootStrap BSD_AUDIO_bootstrap;
icculus@2049
    47
extern AudioBootStrap DSP_bootstrap;
icculus@2049
    48
extern AudioBootStrap ALSA_bootstrap;
icculus@2271
    49
extern AudioBootStrap PULSEAUDIO_bootstrap;
slouken@3099
    50
extern AudioBootStrap QSAAUDIO_bootstrap;
icculus@2049
    51
extern AudioBootStrap SUNAUDIO_bootstrap;
icculus@2049
    52
extern AudioBootStrap ARTS_bootstrap;
icculus@2049
    53
extern AudioBootStrap ESD_bootstrap;
gabomdq@8833
    54
extern AudioBootStrap NACLAUD_bootstrap;
icculus@2049
    55
extern AudioBootStrap NAS_bootstrap;
icculus@5592
    56
extern AudioBootStrap XAUDIO2_bootstrap;
icculus@2049
    57
extern AudioBootStrap DSOUND_bootstrap;
icculus@5588
    58
extern AudioBootStrap WINMM_bootstrap;
icculus@2049
    59
extern AudioBootStrap PAUDIO_bootstrap;
icculus@7981
    60
extern AudioBootStrap HAIKUAUDIO_bootstrap;
icculus@2049
    61
extern AudioBootStrap COREAUDIO_bootstrap;
icculus@2049
    62
extern AudioBootStrap SNDMGR_bootstrap;
icculus@2049
    63
extern AudioBootStrap DISKAUD_bootstrap;
icculus@2049
    64
extern AudioBootStrap DUMMYAUD_bootstrap;
icculus@2049
    65
extern AudioBootStrap DCAUD_bootstrap;
icculus@2049
    66
extern AudioBootStrap DART_bootstrap;
slouken@2735
    67
extern AudioBootStrap NDSAUD_bootstrap;
slouken@2947
    68
extern AudioBootStrap FUSIONSOUND_bootstrap;
paul@4718
    69
extern AudioBootStrap ANDROIDAUD_bootstrap;
kimonline@7009
    70
extern AudioBootStrap PSPAUD_bootstrap;
icculus@7367
    71
extern AudioBootStrap SNDIO_bootstrap;
icculus@9278
    72
extern AudioBootStrap EmscriptenAudio_bootstrap;
icculus@1190
    73
gabomdq@8833
    74
slouken@0
    75
/* Available audio drivers */
slouken@3162
    76
static const AudioBootStrap *const bootstrap[] = {
icculus@2939
    77
#if SDL_AUDIO_DRIVER_PULSEAUDIO
icculus@2939
    78
    &PULSEAUDIO_bootstrap,
slouken@0
    79
#endif
slouken@1361
    80
#if SDL_AUDIO_DRIVER_ALSA
slouken@1895
    81
    &ALSA_bootstrap,
slouken@0
    82
#endif
icculus@7367
    83
#if SDL_AUDIO_DRIVER_SNDIO
icculus@7367
    84
    &SNDIO_bootstrap,
icculus@7367
    85
#endif
slouken@4548
    86
#if SDL_AUDIO_DRIVER_BSD
slouken@4548
    87
    &BSD_AUDIO_bootstrap,
slouken@4548
    88
#endif
icculus@2939
    89
#if SDL_AUDIO_DRIVER_OSS
icculus@2939
    90
    &DSP_bootstrap,
icculus@2271
    91
#endif
slouken@3099
    92
#if SDL_AUDIO_DRIVER_QSA
slouken@3099
    93
    &QSAAUDIO_bootstrap,
slouken@663
    94
#endif
slouken@1361
    95
#if SDL_AUDIO_DRIVER_SUNAUDIO
slouken@1895
    96
    &SUNAUDIO_bootstrap,
slouken@148
    97
#endif
slouken@1361
    98
#if SDL_AUDIO_DRIVER_ARTS
slouken@1895
    99
    &ARTS_bootstrap,
slouken@0
   100
#endif
slouken@1361
   101
#if SDL_AUDIO_DRIVER_ESD
slouken@1895
   102
    &ESD_bootstrap,
slouken@0
   103
#endif
gabomdq@8833
   104
#if SDL_AUDIO_DRIVER_NACL
gabomdq@8833
   105
   &NACLAUD_bootstrap,
gabomdq@8833
   106
#endif
slouken@1361
   107
#if SDL_AUDIO_DRIVER_NAS
slouken@1895
   108
    &NAS_bootstrap,
slouken@0
   109
#endif
icculus@5592
   110
#if SDL_AUDIO_DRIVER_XAUDIO2
icculus@5592
   111
    &XAUDIO2_bootstrap,
icculus@5592
   112
#endif
slouken@1361
   113
#if SDL_AUDIO_DRIVER_DSOUND
slouken@1895
   114
    &DSOUND_bootstrap,
slouken@0
   115
#endif
icculus@5588
   116
#if SDL_AUDIO_DRIVER_WINMM
icculus@5588
   117
    &WINMM_bootstrap,
slouken@0
   118
#endif
icculus@2049
   119
#if SDL_AUDIO_DRIVER_PAUDIO
icculus@2049
   120
    &PAUDIO_bootstrap,
slouken@1361
   121
#endif
icculus@7981
   122
#if SDL_AUDIO_DRIVER_HAIKU
icculus@7981
   123
    &HAIKUAUDIO_bootstrap,
slouken@0
   124
#endif
slouken@1361
   125
#if SDL_AUDIO_DRIVER_COREAUDIO
slouken@1895
   126
    &COREAUDIO_bootstrap,
slouken@935
   127
#endif
slouken@1361
   128
#if SDL_AUDIO_DRIVER_DISK
slouken@1895
   129
    &DISKAUD_bootstrap,
slouken@68
   130
#endif
icculus@1532
   131
#if SDL_AUDIO_DRIVER_DUMMY
slouken@1895
   132
    &DUMMYAUD_bootstrap,
icculus@1532
   133
#endif
slouken@2947
   134
#if SDL_AUDIO_DRIVER_FUSIONSOUND
slouken@2947
   135
    &FUSIONSOUND_bootstrap,
slouken@2947
   136
#endif
paul@4718
   137
#if SDL_AUDIO_DRIVER_ANDROID
paul@4718
   138
    &ANDROIDAUD_bootstrap,
paul@4718
   139
#endif
kimonline@7009
   140
#if SDL_AUDIO_DRIVER_PSP
kimonline@7009
   141
    &PSPAUD_bootstrap,
kimonline@7009
   142
#endif
icculus@9278
   143
#if SDL_AUDIO_DRIVER_EMSCRIPTEN
icculus@9278
   144
    &EmscriptenAudio_bootstrap,
icculus@9278
   145
#endif
slouken@1895
   146
    NULL
slouken@0
   147
};
icculus@2049
   148
slouken@2060
   149
static SDL_AudioDevice *
slouken@2060
   150
get_audio_device(SDL_AudioDeviceID id)
icculus@2049
   151
{
icculus@2049
   152
    id--;
slouken@2060
   153
    if ((id >= SDL_arraysize(open_devices)) || (open_devices[id] == NULL)) {
icculus@2049
   154
        SDL_SetError("Invalid audio device ID");
icculus@2049
   155
        return NULL;
icculus@2049
   156
    }
icculus@2049
   157
icculus@2049
   158
    return open_devices[id];
icculus@2049
   159
}
icculus@2049
   160
icculus@2049
   161
icculus@2049
   162
/* stubs for audio drivers that don't need a specific entry point... */
icculus@5593
   163
static void
icculus@5593
   164
SDL_AudioDetectDevices_Default(int iscapture, SDL_AddAudioDevice addfn)
icculus@5593
   165
{                               /* no-op. */
slouken@2060
   166
}
slouken@2735
   167
slouken@2060
   168
static void
slouken@2060
   169
SDL_AudioThreadInit_Default(_THIS)
slouken@2060
   170
{                               /* no-op. */
slouken@2060
   171
}
slouken@2735
   172
slouken@2060
   173
static void
slouken@2060
   174
SDL_AudioWaitDevice_Default(_THIS)
slouken@2060
   175
{                               /* no-op. */
slouken@2060
   176
}
slouken@2735
   177
slouken@2060
   178
static void
slouken@2060
   179
SDL_AudioPlayDevice_Default(_THIS)
slouken@2060
   180
{                               /* no-op. */
slouken@2060
   181
}
slouken@2735
   182
icculus@9031
   183
static int
icculus@9031
   184
SDL_AudioGetPendingBytes_Default(_THIS)
icculus@9031
   185
{
icculus@9031
   186
    return 0;
icculus@9031
   187
}
icculus@9031
   188
slouken@2060
   189
static Uint8 *
slouken@2060
   190
SDL_AudioGetDeviceBuf_Default(_THIS)
slouken@2060
   191
{
slouken@2060
   192
    return NULL;
slouken@2060
   193
}
slouken@2735
   194
slouken@2060
   195
static void
slouken@2060
   196
SDL_AudioWaitDone_Default(_THIS)
slouken@2060
   197
{                               /* no-op. */
slouken@2060
   198
}
slouken@2735
   199
slouken@2060
   200
static void
slouken@2060
   201
SDL_AudioCloseDevice_Default(_THIS)
slouken@2060
   202
{                               /* no-op. */
slouken@2060
   203
}
slouken@2735
   204
slouken@2060
   205
static void
slouken@2060
   206
SDL_AudioDeinitialize_Default(void)
slouken@2060
   207
{                               /* no-op. */
slouken@2060
   208
}
icculus@2049
   209
icculus@2049
   210
static int
icculus@2049
   211
SDL_AudioOpenDevice_Default(_THIS, const char *devname, int iscapture)
icculus@2049
   212
{
icculus@7038
   213
    return -1;
icculus@2049
   214
}
icculus@2049
   215
icculus@9010
   216
static SDL_INLINE SDL_bool
icculus@9010
   217
is_in_audio_device_thread(SDL_AudioDevice * device)
icculus@9010
   218
{
icculus@9010
   219
    /* The device thread locks the same mutex, but not through the public API.
icculus@9010
   220
       This check is in case the application, in the audio callback,
icculus@9010
   221
       tries to lock the thread that we've already locked from the
icculus@9010
   222
       device thread...just in case we only have non-recursive mutexes. */
icculus@9010
   223
    if (device->thread && (SDL_ThreadID() == device->threadid)) {
icculus@9010
   224
        return SDL_TRUE;
icculus@9010
   225
    }
icculus@9010
   226
icculus@9010
   227
    return SDL_FALSE;
icculus@9010
   228
}
icculus@9010
   229
icculus@2049
   230
static void
icculus@2049
   231
SDL_AudioLockDevice_Default(SDL_AudioDevice * device)
icculus@2049
   232
{
icculus@9010
   233
    if (!is_in_audio_device_thread(device)) {
icculus@9010
   234
        SDL_LockMutex(device->mixer_lock);
icculus@2049
   235
    }
icculus@2049
   236
}
icculus@2049
   237
icculus@2049
   238
static void
icculus@2049
   239
SDL_AudioUnlockDevice_Default(SDL_AudioDevice * device)
icculus@2049
   240
{
icculus@9010
   241
    if (!is_in_audio_device_thread(device)) {
icculus@9010
   242
        SDL_UnlockMutex(device->mixer_lock);
icculus@2049
   243
    }
icculus@2049
   244
}
icculus@2049
   245
slouken@0
   246
slouken@2060
   247
static void
slouken@2060
   248
finalize_audio_entry_points(void)
icculus@2049
   249
{
icculus@2049
   250
    /*
icculus@2049
   251
     * Fill in stub functions for unused driver entry points. This lets us
icculus@2049
   252
     *  blindly call them without having to check for validity first.
icculus@2049
   253
     */
icculus@2049
   254
slouken@2060
   255
#define FILL_STUB(x) \
icculus@2049
   256
        if (current_audio.impl.x == NULL) { \
icculus@2049
   257
            current_audio.impl.x = SDL_Audio##x##_Default; \
icculus@2049
   258
        }
icculus@2049
   259
    FILL_STUB(DetectDevices);
icculus@2049
   260
    FILL_STUB(OpenDevice);
icculus@2049
   261
    FILL_STUB(ThreadInit);
icculus@2049
   262
    FILL_STUB(WaitDevice);
icculus@2049
   263
    FILL_STUB(PlayDevice);
icculus@9031
   264
    FILL_STUB(GetPendingBytes);
icculus@2049
   265
    FILL_STUB(GetDeviceBuf);
icculus@2049
   266
    FILL_STUB(WaitDone);
icculus@2049
   267
    FILL_STUB(CloseDevice);
icculus@2049
   268
    FILL_STUB(LockDevice);
icculus@2049
   269
    FILL_STUB(UnlockDevice);
icculus@2049
   270
    FILL_STUB(Deinitialize);
slouken@2060
   271
#undef FILL_STUB
icculus@2049
   272
}
icculus@2049
   273
icculus@8660
   274
#if 0  /* !!! FIXME: rewrite/remove this streamer code. */
slouken@2716
   275
/* Streaming functions (for when the input and output buffer sizes are different) */
slouken@2716
   276
/* Write [length] bytes from buf into the streamer */
slouken@4472
   277
static void
slouken@2716
   278
SDL_StreamWrite(SDL_AudioStreamer * stream, Uint8 * buf, int length)
slouken@2716
   279
{
slouken@2716
   280
    int i;
slouken@2716
   281
slouken@2716
   282
    for (i = 0; i < length; ++i) {
slouken@2716
   283
        stream->buffer[stream->write_pos] = buf[i];
slouken@2716
   284
        ++stream->write_pos;
slouken@2716
   285
    }
slouken@2716
   286
}
slouken@2716
   287
slouken@2716
   288
/* Read [length] bytes out of the streamer into buf */
slouken@4472
   289
static void
slouken@2716
   290
SDL_StreamRead(SDL_AudioStreamer * stream, Uint8 * buf, int length)
slouken@2716
   291
{
slouken@2716
   292
    int i;
slouken@2716
   293
slouken@2716
   294
    for (i = 0; i < length; ++i) {
slouken@2716
   295
        buf[i] = stream->buffer[stream->read_pos];
slouken@2716
   296
        ++stream->read_pos;
slouken@2716
   297
    }
slouken@2716
   298
}
slouken@2716
   299
slouken@4472
   300
static int
slouken@2716
   301
SDL_StreamLength(SDL_AudioStreamer * stream)
slouken@2716
   302
{
slouken@2716
   303
    return (stream->write_pos - stream->read_pos) % stream->max_len;
slouken@2716
   304
}
slouken@2716
   305
slouken@2716
   306
/* Initialize the stream by allocating the buffer and setting the read/write heads to the beginning */
slouken@4507
   307
#if 0
slouken@4472
   308
static int
slouken@2716
   309
SDL_StreamInit(SDL_AudioStreamer * stream, int max_len, Uint8 silence)
slouken@2716
   310
{
slouken@2716
   311
    /* First try to allocate the buffer */
slouken@2728
   312
    stream->buffer = (Uint8 *) SDL_malloc(max_len);
slouken@2716
   313
    if (stream->buffer == NULL) {
slouken@2716
   314
        return -1;
slouken@2716
   315
    }
slouken@2716
   316
slouken@2716
   317
    stream->max_len = max_len;
slouken@2716
   318
    stream->read_pos = 0;
slouken@2716
   319
    stream->write_pos = 0;
slouken@2716
   320
slouken@2716
   321
    /* Zero out the buffer */
slouken@2728
   322
    SDL_memset(stream->buffer, silence, max_len);
slouken@2728
   323
slouken@2728
   324
    return 0;
slouken@2716
   325
}
slouken@4507
   326
#endif
slouken@2716
   327
slouken@2716
   328
/* Deinitialize the stream simply by freeing the buffer */
slouken@4472
   329
static void
slouken@2716
   330
SDL_StreamDeinit(SDL_AudioStreamer * stream)
slouken@2716
   331
{
slouken@7719
   332
    SDL_free(stream->buffer);
slouken@2716
   333
}
icculus@8660
   334
#endif
slouken@2716
   335
icculus@9393
   336
/* device hotplug support... */
icculus@9393
   337
icculus@9393
   338
/* this function expects its caller to hold current_audio.detection_lock */
icculus@9393
   339
static int
icculus@9393
   340
add_audio_device(const char *_name, char ***_devices, int *_devCount)
icculus@9393
   341
{
icculus@9393
   342
    char *name = SDL_strdup(_name);
icculus@9393
   343
    int retval = -1;
icculus@9393
   344
icculus@9393
   345
    if (name != NULL) {
icculus@9393
   346
        char **devices = *_devices;
icculus@9393
   347
        int devCount = *_devCount;
icculus@9393
   348
        void *ptr = SDL_realloc(devices, (devCount+1) * sizeof(char*));
icculus@9393
   349
        if (ptr == NULL) {
icculus@9393
   350
            SDL_free(name);
icculus@9393
   351
        } else {
icculus@9393
   352
            retval = devCount;
icculus@9393
   353
            devices = (char **) ptr;
icculus@9393
   354
            devices[devCount++] = name;
icculus@9393
   355
            *_devices = devices;
icculus@9393
   356
            *_devCount = devCount;
icculus@9393
   357
        }
icculus@9393
   358
    }
icculus@9393
   359
icculus@9393
   360
    return retval;
icculus@9393
   361
}
icculus@9393
   362
icculus@9393
   363
static int
icculus@9393
   364
add_capture_device(const char *name)
icculus@9393
   365
{
icculus@9393
   366
    /* !!! FIXME: add this later. SDL_assert(current_audio.impl.HasCaptureSupport);*/
icculus@9393
   367
    return add_audio_device(name, &current_audio.inputDevices, &current_audio.inputDeviceCount);
icculus@9393
   368
}
icculus@9393
   369
icculus@9393
   370
static int
icculus@9393
   371
add_output_device(const char *name)
icculus@9393
   372
{
icculus@9393
   373
    return add_audio_device(name, &current_audio.outputDevices, &current_audio.outputDeviceCount);
icculus@9393
   374
}
icculus@9393
   375
icculus@9393
   376
static void
icculus@9393
   377
free_device_list(char ***devices, int *devCount)
icculus@9393
   378
{
icculus@9393
   379
    int i = *devCount;
icculus@9393
   380
    if ((i > 0) && (*devices != NULL)) {
icculus@9393
   381
        while (i--) {
icculus@9393
   382
            SDL_free((*devices)[i]);
icculus@9393
   383
        }
icculus@9393
   384
    }
icculus@9393
   385
icculus@9393
   386
    SDL_free(*devices);
icculus@9393
   387
icculus@9393
   388
    *devices = NULL;
icculus@9393
   389
    *devCount = 0;
icculus@9393
   390
}
icculus@9393
   391
icculus@9393
   392
static void
icculus@9393
   393
perform_full_device_redetect(const int iscapture)
icculus@9393
   394
{
icculus@9393
   395
    SDL_LockMutex(current_audio.detection_lock);
icculus@9393
   396
icculus@9393
   397
    if (iscapture) {
icculus@9393
   398
        if (!current_audio.impl.OnlyHasDefaultOutputDevice) {
icculus@9393
   399
            free_device_list(&current_audio.outputDevices, &current_audio.outputDeviceCount);
icculus@9393
   400
            current_audio.impl.DetectDevices(SDL_FALSE, add_output_device);
icculus@9393
   401
        }
icculus@9393
   402
    } else {
icculus@9393
   403
        if ((current_audio.impl.HasCaptureSupport) && (!current_audio.impl.OnlyHasDefaultInputDevice)) {
icculus@9393
   404
            free_device_list(&current_audio.inputDevices, &current_audio.inputDeviceCount);
icculus@9393
   405
            current_audio.impl.DetectDevices(SDL_TRUE, add_capture_device);
icculus@9393
   406
        }
icculus@9393
   407
    }
icculus@9393
   408
icculus@9393
   409
    SDL_UnlockMutex(current_audio.detection_lock);
icculus@9393
   410
}
icculus@9393
   411
icculus@9393
   412
/* The audio backends call this when a new device is plugged in. */
icculus@9393
   413
void
icculus@9393
   414
SDL_AudioDeviceConnected(const int iscapture, const char *name)
icculus@9393
   415
{
icculus@9393
   416
    int device_index = -1;
icculus@9393
   417
icculus@9393
   418
    SDL_LockMutex(current_audio.detection_lock);
icculus@9393
   419
    if (iscapture) {
icculus@9393
   420
        device_index = add_capture_device(name);
icculus@9393
   421
    } else {
icculus@9393
   422
        device_index = add_output_device(name);
icculus@9393
   423
    }
icculus@9393
   424
    SDL_UnlockMutex(current_audio.detection_lock);
icculus@9393
   425
icculus@9393
   426
    if (device_index != -1) {
icculus@9393
   427
        /* Post the event, if desired */
icculus@9393
   428
        if (SDL_GetEventState(SDL_AUDIODEVICEADDED) == SDL_ENABLE) {
icculus@9393
   429
            SDL_Event event;
icculus@9393
   430
            event.adevice.type = SDL_AUDIODEVICEADDED;
icculus@9393
   431
            event.adevice.which = device_index;
icculus@9393
   432
            event.adevice.iscapture = iscapture;
icculus@9393
   433
            SDL_PushEvent(&event);
icculus@9393
   434
        }
icculus@9393
   435
    }
icculus@9393
   436
}
icculus@9393
   437
icculus@9393
   438
/* The audio backends call this when a device is unplugged. */
icculus@9393
   439
void
icculus@9393
   440
SDL_AudioDeviceDisconnected(const int iscapture, SDL_AudioDevice *device)
icculus@9393
   441
{
icculus@9393
   442
    /* device==NULL means an unopened device was lost; do the redetect only. */
icculus@9393
   443
    if (device != NULL) {
icculus@9393
   444
        SDL_assert(get_audio_device(device->id) == device);
icculus@9393
   445
        SDL_assert(device->enabled);  /* called more than once?! */
icculus@9393
   446
icculus@9393
   447
        /* Ends the audio callback and mark the device as STOPPED, but the
icculus@9393
   448
           app still needs to close the device to free resources. */
icculus@9393
   449
        current_audio.impl.LockDevice(device);
icculus@9393
   450
        device->enabled = 0;
icculus@9393
   451
        current_audio.impl.UnlockDevice(device);
icculus@9393
   452
icculus@9393
   453
        /* Post the event, if desired */
icculus@9393
   454
        if (SDL_GetEventState(SDL_AUDIODEVICEREMOVED) == SDL_ENABLE) {
icculus@9393
   455
            SDL_Event event;
icculus@9393
   456
            event.adevice.type = SDL_AUDIODEVICEREMOVED;
icculus@9393
   457
            event.adevice.which = device->id;
icculus@9393
   458
            event.adevice.iscapture = device->iscapture ? 1 : 0;
icculus@9393
   459
            SDL_PushEvent(&event);
icculus@9393
   460
        }
icculus@9393
   461
    }
icculus@9393
   462
icculus@9393
   463
    /* we don't really know which name (if any) was associated with this
icculus@9393
   464
       device in the device list, so drop the entire list and rebuild it.
icculus@9393
   465
       (we should probably change the API in 2.1 to make this more clear?) */
icculus@9393
   466
    if (iscapture) {
icculus@9393
   467
        current_audio.need_capture_device_redetect = SDL_TRUE;
icculus@9393
   468
    } else {
icculus@9393
   469
        current_audio.need_output_device_redetect = SDL_TRUE;
icculus@9393
   470
    }
icculus@9393
   471
}
icculus@9393
   472
icculus@9393
   473
icculus@9012
   474
icculus@9012
   475
/* buffer queueing support... */
icculus@9012
   476
icculus@9012
   477
/* this expects that you managed thread safety elsewhere. */
icculus@9012
   478
static void
icculus@9012
   479
free_audio_queue(SDL_AudioBufferQueue *buffer)
icculus@9012
   480
{
icculus@9012
   481
    while (buffer) {
icculus@9012
   482
        SDL_AudioBufferQueue *next = buffer->next;
icculus@9012
   483
        SDL_free(buffer);
icculus@9012
   484
        buffer = next;
icculus@9012
   485
    }
icculus@9012
   486
}
icculus@9012
   487
icculus@9012
   488
static void SDLCALL
icculus@9012
   489
SDL_BufferQueueDrainCallback(void *userdata, Uint8 *stream, int _len)
icculus@9012
   490
{
icculus@9012
   491
    /* this function always holds the mixer lock before being called. */
icculus@9012
   492
    Uint32 len = (Uint32) _len;
icculus@9012
   493
    SDL_AudioDevice *device = (SDL_AudioDevice *) userdata;
icculus@9012
   494
    SDL_AudioBufferQueue *buffer;
icculus@9012
   495
icculus@9012
   496
    SDL_assert(device != NULL);  /* this shouldn't ever happen, right?! */
icculus@9012
   497
    SDL_assert(_len >= 0);  /* this shouldn't ever happen, right?! */
icculus@9012
   498
icculus@9012
   499
    while ((len > 0) && ((buffer = device->buffer_queue_head) != NULL)) {
icculus@9012
   500
        const Uint32 avail = buffer->datalen - buffer->startpos;
icculus@9012
   501
        const Uint32 cpy = SDL_min(len, avail);
icculus@9012
   502
        SDL_assert(device->queued_bytes >= avail);
icculus@9012
   503
icculus@9012
   504
        SDL_memcpy(stream, buffer->data + buffer->startpos, cpy);
icculus@9012
   505
        buffer->startpos += cpy;
icculus@9012
   506
        stream += cpy;
icculus@9012
   507
        device->queued_bytes -= cpy;
icculus@9012
   508
        len -= cpy;
icculus@9012
   509
icculus@9012
   510
        if (buffer->startpos == buffer->datalen) {  /* packet is done, put it in the pool. */
icculus@9012
   511
            device->buffer_queue_head = buffer->next;
icculus@9012
   512
            SDL_assert((buffer->next != NULL) || (buffer == device->buffer_queue_tail));
icculus@9012
   513
            buffer->next = device->buffer_queue_pool;
icculus@9012
   514
            device->buffer_queue_pool = buffer;
icculus@9012
   515
        }
icculus@9012
   516
    }
icculus@9012
   517
icculus@9012
   518
    SDL_assert((device->buffer_queue_head != NULL) == (device->queued_bytes != 0));
icculus@9012
   519
icculus@9012
   520
    if (len > 0) {  /* fill any remaining space in the stream with silence. */
icculus@9012
   521
        SDL_assert(device->buffer_queue_head == NULL);
icculus@9012
   522
        SDL_memset(stream, device->spec.silence, len);
icculus@9012
   523
    }
icculus@9012
   524
icculus@9012
   525
    if (device->buffer_queue_head == NULL) {
icculus@9012
   526
        device->buffer_queue_tail = NULL;  /* in case we drained the queue entirely. */
icculus@9012
   527
    }
icculus@9012
   528
}
icculus@9012
   529
icculus@9012
   530
int
icculus@9012
   531
SDL_QueueAudio(SDL_AudioDeviceID devid, const void *_data, Uint32 len)
icculus@9012
   532
{
icculus@9012
   533
    SDL_AudioDevice *device = get_audio_device(devid);
icculus@9012
   534
    const Uint8 *data = (const Uint8 *) _data;
icculus@9012
   535
    SDL_AudioBufferQueue *orighead;
icculus@9012
   536
    SDL_AudioBufferQueue *origtail;
icculus@9012
   537
    Uint32 origlen;
icculus@9012
   538
    Uint32 datalen;
icculus@9012
   539
icculus@9012
   540
    if (!device) {
icculus@9012
   541
        return -1;  /* get_audio_device() will have set the error state */
icculus@9012
   542
    }
icculus@9012
   543
icculus@9012
   544
    if (device->spec.callback != SDL_BufferQueueDrainCallback) {
icculus@9012
   545
        return SDL_SetError("Audio device has a callback, queueing not allowed");
icculus@9012
   546
    }
icculus@9012
   547
icculus@9012
   548
    current_audio.impl.LockDevice(device);
icculus@9012
   549
icculus@9012
   550
    orighead = device->buffer_queue_head;
icculus@9012
   551
    origtail = device->buffer_queue_tail;
icculus@9012
   552
    origlen = origtail ? origtail->datalen : 0;
icculus@9012
   553
icculus@9012
   554
    while (len > 0) {
icculus@9012
   555
        SDL_AudioBufferQueue *packet = device->buffer_queue_tail;
icculus@9012
   556
        SDL_assert(!packet || (packet->datalen <= SDL_AUDIOBUFFERQUEUE_PACKETLEN));
icculus@9012
   557
        if (!packet || (packet->datalen >= SDL_AUDIOBUFFERQUEUE_PACKETLEN)) {
icculus@9012
   558
            /* tail packet missing or completely full; we need a new packet. */
icculus@9012
   559
            packet = device->buffer_queue_pool;
icculus@9012
   560
            if (packet != NULL) {
icculus@9012
   561
                /* we have one available in the pool. */
icculus@9012
   562
                device->buffer_queue_pool = packet->next;
icculus@9012
   563
            } else {
icculus@9012
   564
                /* Have to allocate a new one! */
icculus@9012
   565
                packet = (SDL_AudioBufferQueue *) SDL_malloc(sizeof (SDL_AudioBufferQueue));
icculus@9012
   566
                if (packet == NULL) {
icculus@9012
   567
                    /* uhoh, reset so we've queued nothing new, free what we can. */
icculus@9012
   568
                    if (!origtail) {
icculus@9012
   569
                        packet = device->buffer_queue_head;  /* whole queue. */
icculus@9012
   570
                    } else {
icculus@9012
   571
                        packet = origtail->next;  /* what we added to existing queue. */
icculus@9012
   572
                        origtail->next = NULL;
icculus@9012
   573
                        origtail->datalen = origlen;
icculus@9012
   574
                    }
icculus@9012
   575
                    device->buffer_queue_head = orighead;
icculus@9012
   576
                    device->buffer_queue_tail = origtail;
icculus@9012
   577
                    device->buffer_queue_pool = NULL;
icculus@9012
   578
icculus@9012
   579
                    current_audio.impl.UnlockDevice(device);
icculus@9012
   580
icculus@9012
   581
                    free_audio_queue(packet);  /* give back what we can. */
icculus@9012
   582
icculus@9012
   583
                    return SDL_OutOfMemory();
icculus@9012
   584
                }
icculus@9012
   585
            }
icculus@9012
   586
            packet->datalen = 0;
icculus@9012
   587
            packet->startpos = 0;
icculus@9012
   588
            packet->next = NULL;
icculus@9012
   589
icculus@9012
   590
            SDL_assert((device->buffer_queue_head != NULL) == (device->queued_bytes != 0));
icculus@9012
   591
            if (device->buffer_queue_tail == NULL) {
icculus@9012
   592
                device->buffer_queue_head = packet;
icculus@9012
   593
            } else {
icculus@9012
   594
                device->buffer_queue_tail->next = packet;
icculus@9012
   595
            }
icculus@9012
   596
            device->buffer_queue_tail = packet;
icculus@9012
   597
        }
icculus@9012
   598
icculus@9012
   599
        datalen = SDL_min(len, SDL_AUDIOBUFFERQUEUE_PACKETLEN - packet->datalen);
icculus@9012
   600
        SDL_memcpy(packet->data + packet->datalen, data, datalen);
icculus@9012
   601
        data += datalen;
icculus@9012
   602
        len -= datalen;
icculus@9012
   603
        packet->datalen += datalen;
icculus@9012
   604
        device->queued_bytes += datalen;
icculus@9012
   605
    }
icculus@9012
   606
icculus@9012
   607
    current_audio.impl.UnlockDevice(device);
icculus@9012
   608
icculus@9012
   609
    return 0;
icculus@9012
   610
}
icculus@9012
   611
icculus@9012
   612
Uint32
icculus@9012
   613
SDL_GetQueuedAudioSize(SDL_AudioDeviceID devid)
icculus@9012
   614
{
icculus@9012
   615
    Uint32 retval = 0;
icculus@9012
   616
    SDL_AudioDevice *device = get_audio_device(devid);
icculus@9032
   617
icculus@9032
   618
    /* Nothing to do unless we're set up for queueing. */
icculus@9032
   619
    if (device && (device->spec.callback == SDL_BufferQueueDrainCallback)) {
icculus@9012
   620
        current_audio.impl.LockDevice(device);
icculus@9031
   621
        retval = device->queued_bytes + current_audio.impl.GetPendingBytes(device);
icculus@9012
   622
        current_audio.impl.UnlockDevice(device);
icculus@9012
   623
    }
icculus@9012
   624
icculus@9012
   625
    return retval;
icculus@9012
   626
}
icculus@9012
   627
icculus@9012
   628
void
icculus@9012
   629
SDL_ClearQueuedAudio(SDL_AudioDeviceID devid)
icculus@9012
   630
{
icculus@9012
   631
    SDL_AudioDevice *device = get_audio_device(devid);
icculus@9012
   632
    SDL_AudioBufferQueue *buffer = NULL;
icculus@9012
   633
    if (!device) {
icculus@9012
   634
        return;  /* nothing to do. */
icculus@9012
   635
    }
icculus@9012
   636
icculus@9012
   637
    /* Blank out the device and release the mutex. Free it afterwards. */
icculus@9012
   638
    current_audio.impl.LockDevice(device);
icculus@9012
   639
    buffer = device->buffer_queue_head;
icculus@9012
   640
    device->buffer_queue_tail = NULL;
icculus@9012
   641
    device->buffer_queue_head = NULL;
icculus@9012
   642
    device->queued_bytes = 0;
icculus@9012
   643
    current_audio.impl.UnlockDevice(device);
icculus@9012
   644
icculus@9012
   645
    free_audio_queue(buffer);
icculus@9012
   646
}
icculus@9012
   647
icculus@9012
   648
dimitris@8761
   649
#if defined(__ANDROID__)
paul@4722
   650
#include <android/log.h>
aschiffler@4865
   651
#endif
paul@4722
   652
slouken@0
   653
/* The general mixing thread function */
slouken@1895
   654
int SDLCALL
icculus@2049
   655
SDL_RunAudio(void *devicep)
slouken@0
   656
{
icculus@2049
   657
    SDL_AudioDevice *device = (SDL_AudioDevice *) devicep;
slouken@1895
   658
    Uint8 *stream;
slouken@1895
   659
    int stream_len;
slouken@1895
   660
    void *udata;
slouken@1895
   661
    void (SDLCALL * fill) (void *userdata, Uint8 * stream, int len);
slouken@3336
   662
    Uint32 delay;
icculus@8660
   663
icculus@8660
   664
#if 0  /* !!! FIXME: rewrite/remove this streamer code. */
airlangga@5526
   665
    /* For streaming when the buffer sizes don't match up */
airlangga@5526
   666
    Uint8 *istream;
airlangga@5526
   667
    int istream_len = 0;
icculus@8660
   668
#endif
slouken@2716
   669
slouken@5509
   670
    /* The audio mixing is always a high priority thread */
slouken@5509
   671
    SDL_SetThreadPriority(SDL_THREAD_PRIORITY_HIGH);
slouken@5509
   672
slouken@1895
   673
    /* Perform any thread setup */
icculus@2049
   674
    device->threadid = SDL_ThreadID();
icculus@2049
   675
    current_audio.impl.ThreadInit(device);
slouken@0
   676
slouken@1895
   677
    /* Set up the mixing function */
icculus@2049
   678
    fill = device->spec.callback;
icculus@2049
   679
    udata = device->spec.userdata;
slouken@21
   680
slouken@2716
   681
    /* By default do not stream */
slouken@2716
   682
    device->use_streamer = 0;
slouken@2716
   683
icculus@2049
   684
    if (device->convert.needed) {
slouken@3040
   685
#if 0                           /* !!! FIXME: I took len_div out of the structure. Use rate_incr instead? */
slouken@2716
   686
        /* If the result of the conversion alters the length, i.e. resampling is being used, use the streamer */
slouken@2716
   687
        if (device->convert.len_mult != 1 || device->convert.len_div != 1) {
slouken@2716
   688
            /* The streamer's maximum length should be twice whichever is larger: spec.size or len_cvt */
slouken@2716
   689
            stream_max_len = 2 * device->spec.size;
slouken@2716
   690
            if (device->convert.len_mult > device->convert.len_div) {
slouken@2716
   691
                stream_max_len *= device->convert.len_mult;
slouken@2716
   692
                stream_max_len /= device->convert.len_div;
slouken@2716
   693
            }
slouken@2716
   694
            if (SDL_StreamInit(&device->streamer, stream_max_len, silence) <
slouken@2716
   695
                0)
slouken@2716
   696
                return -1;
slouken@2716
   697
            device->use_streamer = 1;
slouken@2716
   698
slouken@2716
   699
            /* istream_len should be the length of what we grab from the callback and feed to conversion,
slouken@2716
   700
               so that we get close to spec_size. I.e. we want device.spec_size = istream_len * u / d
slouken@2716
   701
             */
slouken@2716
   702
            istream_len =
slouken@2716
   703
                device->spec.size * device->convert.len_div /
slouken@2716
   704
                device->convert.len_mult;
slouken@2716
   705
        }
icculus@3021
   706
#endif
slouken@7518
   707
        stream_len = device->convert.len;
slouken@1895
   708
    } else {
icculus@2049
   709
        stream_len = device->spec.size;
slouken@1895
   710
    }
icculus@1561
   711
slouken@3336
   712
    /* Calculate the delay while paused */
slouken@3336
   713
    delay = ((device->spec.samples * 1000) / device->spec.freq);
slouken@3336
   714
slouken@2716
   715
    /* Determine if the streamer is necessary here */
icculus@8658
   716
#if 0  /* !!! FIXME: rewrite/remove this streamer code. */
slouken@2716
   717
    if (device->use_streamer == 1) {
slouken@3336
   718
        /* This code is almost the same as the old code. The difference is, instead of reading
slouken@2716
   719
           directly from the callback into "stream", then converting and sending the audio off,
slouken@2716
   720
           we go: callback -> "istream" -> (conversion) -> streamer -> stream -> device.
slouken@2716
   721
           However, reading and writing with streamer are done separately:
slouken@2716
   722
           - We only call the callback and write to the streamer when the streamer does not
slouken@2716
   723
           contain enough samples to output to the device.
slouken@2716
   724
           - We only read from the streamer and tell the device to play when the streamer
slouken@2716
   725
           does have enough samples to output.
slouken@2716
   726
           This allows us to perform resampling in the conversion step, where the output of the
slouken@2716
   727
           resampling process can be any number. We will have to see what a good size for the
slouken@2716
   728
           stream's maximum length is, but I suspect 2*max(len_cvt, stream_len) is a good figure.
slouken@2716
   729
         */
slouken@2716
   730
        while (device->enabled) {
slouken@3336
   731
slouken@3336
   732
            if (device->paused) {
slouken@3336
   733
                SDL_Delay(delay);
slouken@3336
   734
                continue;
slouken@3336
   735
            }
slouken@3336
   736
slouken@2716
   737
            /* Only read in audio if the streamer doesn't have enough already (if it does not have enough samples to output) */
slouken@2716
   738
            if (SDL_StreamLength(&device->streamer) < stream_len) {
slouken@2716
   739
                /* Set up istream */
slouken@2716
   740
                if (device->convert.needed) {
slouken@2716
   741
                    if (device->convert.buf) {
slouken@2716
   742
                        istream = device->convert.buf;
slouken@2716
   743
                    } else {
slouken@2716
   744
                        continue;
slouken@2716
   745
                    }
slouken@2716
   746
                } else {
slouken@3336
   747
/* FIXME: Ryan, this is probably wrong.  I imagine we don't want to get
slouken@3336
   748
 * a device buffer both here and below in the stream output.
slouken@3336
   749
 */
slouken@2716
   750
                    istream = current_audio.impl.GetDeviceBuf(device);
slouken@2716
   751
                    if (istream == NULL) {
slouken@2716
   752
                        istream = device->fake_stream;
slouken@2716
   753
                    }
slouken@2716
   754
                }
slouken@0
   755
slouken@2716
   756
                /* Read from the callback into the _input_ stream */
icculus@9391
   757
                // !!! FIXME: this should be LockDevice.
slouken@6977
   758
                SDL_LockMutex(device->mixer_lock);
slouken@3336
   759
                (*fill) (udata, istream, istream_len);
slouken@6977
   760
                SDL_UnlockMutex(device->mixer_lock);
slouken@2716
   761
slouken@2716
   762
                /* Convert the audio if necessary and write to the streamer */
slouken@2716
   763
                if (device->convert.needed) {
slouken@2716
   764
                    SDL_ConvertAudio(&device->convert);
slouken@2716
   765
                    if (istream == NULL) {
slouken@2716
   766
                        istream = device->fake_stream;
slouken@2716
   767
                    }
gabomdq@7678
   768
                    /* SDL_memcpy(istream, device->convert.buf, device->convert.len_cvt); */
slouken@2716
   769
                    SDL_StreamWrite(&device->streamer, device->convert.buf,
slouken@2716
   770
                                    device->convert.len_cvt);
slouken@2716
   771
                } else {
slouken@2716
   772
                    SDL_StreamWrite(&device->streamer, istream, istream_len);
slouken@2716
   773
                }
slouken@1895
   774
            }
slouken@2716
   775
slouken@2716
   776
            /* Only output audio if the streamer has enough to output */
slouken@2716
   777
            if (SDL_StreamLength(&device->streamer) >= stream_len) {
slouken@2716
   778
                /* Set up the output stream */
slouken@2716
   779
                if (device->convert.needed) {
slouken@2716
   780
                    if (device->convert.buf) {
slouken@2716
   781
                        stream = device->convert.buf;
slouken@2716
   782
                    } else {
slouken@2716
   783
                        continue;
slouken@2716
   784
                    }
slouken@2716
   785
                } else {
slouken@2716
   786
                    stream = current_audio.impl.GetDeviceBuf(device);
slouken@2716
   787
                    if (stream == NULL) {
slouken@2716
   788
                        stream = device->fake_stream;
slouken@2716
   789
                    }
slouken@2716
   790
                }
slouken@2716
   791
slouken@2716
   792
                /* Now read from the streamer */
slouken@2716
   793
                SDL_StreamRead(&device->streamer, stream, stream_len);
slouken@2716
   794
slouken@2716
   795
                /* Ready current buffer for play and change current buffer */
slouken@3336
   796
                if (stream != device->fake_stream) {
slouken@2716
   797
                    current_audio.impl.PlayDevice(device);
slouken@3096
   798
                    /* Wait for an audio buffer to become available */
slouken@3096
   799
                    current_audio.impl.WaitDevice(device);
slouken@2716
   800
                } else {
slouken@3336
   801
                    SDL_Delay(delay);
slouken@2716
   802
                }
slouken@1895
   803
            }
slouken@0
   804
slouken@1895
   805
        }
icculus@8660
   806
    } else
icculus@8658
   807
#endif
icculus@8660
   808
    {
slouken@2716
   809
        /* Otherwise, do not use the streamer. This is the old code. */
icculus@7406
   810
        const int silence = (int) device->spec.silence;
slouken@0
   811
slouken@2716
   812
        /* Loop, filling the audio buffers */
slouken@2716
   813
        while (device->enabled) {
slouken@2716
   814
slouken@2716
   815
            /* Fill the current buffer with sound */
slouken@2716
   816
            if (device->convert.needed) {
slouken@2716
   817
                if (device->convert.buf) {
slouken@2716
   818
                    stream = device->convert.buf;
slouken@2716
   819
                } else {
slouken@2716
   820
                    continue;
slouken@2716
   821
                }
slouken@2716
   822
            } else {
slouken@2716
   823
                stream = current_audio.impl.GetDeviceBuf(device);
slouken@2716
   824
                if (stream == NULL) {
slouken@2716
   825
                    stream = device->fake_stream;
slouken@2716
   826
                }
slouken@1895
   827
            }
slouken@0
   828
icculus@9391
   829
            /* !!! FIXME: this should be LockDevice. */
icculus@7447
   830
            SDL_LockMutex(device->mixer_lock);
icculus@9393
   831
icculus@9393
   832
            /* Check again, in case device was removed while a lock was held. */
icculus@9393
   833
            if (!device->enabled) {
icculus@9393
   834
                SDL_UnlockMutex(device->mixer_lock);
icculus@9393
   835
                break;
icculus@9393
   836
            }
icculus@9393
   837
icculus@7406
   838
            if (device->paused) {
icculus@7406
   839
                SDL_memset(stream, silence, stream_len);
icculus@7406
   840
            } else {
icculus@7406
   841
                (*fill) (udata, stream, stream_len);
icculus@7406
   842
            }
icculus@7447
   843
            SDL_UnlockMutex(device->mixer_lock);
slouken@1562
   844
slouken@2716
   845
            /* Convert the audio if necessary */
slouken@2716
   846
            if (device->convert.needed) {
slouken@2716
   847
                SDL_ConvertAudio(&device->convert);
slouken@2716
   848
                stream = current_audio.impl.GetDeviceBuf(device);
slouken@2716
   849
                if (stream == NULL) {
slouken@2716
   850
                    stream = device->fake_stream;
slouken@2716
   851
                }
slouken@2716
   852
                SDL_memcpy(stream, device->convert.buf,
slouken@2716
   853
                           device->convert.len_cvt);
slouken@2716
   854
            }
slouken@2716
   855
slouken@2716
   856
            /* Ready current buffer for play and change current buffer */
slouken@3336
   857
            if (stream != device->fake_stream) {
slouken@2716
   858
                current_audio.impl.PlayDevice(device);
slouken@3096
   859
                /* Wait for an audio buffer to become available */
slouken@3096
   860
                current_audio.impl.WaitDevice(device);
slouken@2716
   861
            } else {
slouken@3336
   862
                SDL_Delay(delay);
slouken@2716
   863
            }
slouken@1895
   864
        }
slouken@1895
   865
    }
slouken@1562
   866
slouken@1895
   867
    /* Wait for the audio to drain.. */
icculus@2049
   868
    current_audio.impl.WaitDone(device);
slouken@21
   869
slouken@2716
   870
    /* If necessary, deinit the streamer */
icculus@8658
   871
#if 0  /* !!! FIXME: rewrite/remove this streamer code. */
slouken@2716
   872
    if (device->use_streamer == 1)
slouken@2716
   873
        SDL_StreamDeinit(&device->streamer);
icculus@8658
   874
#endif
slouken@2716
   875
icculus@9382
   876
    return 0;
slouken@0
   877
}
slouken@0
   878
slouken@322
   879
icculus@1982
   880
static SDL_AudioFormat
slouken@1895
   881
SDL_ParseAudioFormat(const char *string)
slouken@1794
   882
{
icculus@2076
   883
#define CHECK_FMT_STRING(x) if (SDL_strcmp(string, #x) == 0) return AUDIO_##x
icculus@2049
   884
    CHECK_FMT_STRING(U8);
icculus@2049
   885
    CHECK_FMT_STRING(S8);
icculus@2049
   886
    CHECK_FMT_STRING(U16LSB);
icculus@2049
   887
    CHECK_FMT_STRING(S16LSB);
icculus@2049
   888
    CHECK_FMT_STRING(U16MSB);
icculus@2049
   889
    CHECK_FMT_STRING(S16MSB);
icculus@2049
   890
    CHECK_FMT_STRING(U16SYS);
icculus@2049
   891
    CHECK_FMT_STRING(S16SYS);
icculus@2049
   892
    CHECK_FMT_STRING(U16);
icculus@2049
   893
    CHECK_FMT_STRING(S16);
icculus@2049
   894
    CHECK_FMT_STRING(S32LSB);
icculus@2049
   895
    CHECK_FMT_STRING(S32MSB);
icculus@2049
   896
    CHECK_FMT_STRING(S32SYS);
icculus@2049
   897
    CHECK_FMT_STRING(S32);
icculus@2049
   898
    CHECK_FMT_STRING(F32LSB);
icculus@2049
   899
    CHECK_FMT_STRING(F32MSB);
icculus@2049
   900
    CHECK_FMT_STRING(F32SYS);
icculus@2049
   901
    CHECK_FMT_STRING(F32);
slouken@2060
   902
#undef CHECK_FMT_STRING
icculus@2049
   903
    return 0;
slouken@1895
   904
}
slouken@1895
   905
slouken@1895
   906
int
slouken@1895
   907
SDL_GetNumAudioDrivers(void)
slouken@1895
   908
{
icculus@9382
   909
    return SDL_arraysize(bootstrap) - 1;
slouken@1895
   910
}
slouken@1895
   911
slouken@1895
   912
const char *
slouken@1895
   913
SDL_GetAudioDriver(int index)
slouken@1895
   914
{
slouken@1895
   915
    if (index >= 0 && index < SDL_GetNumAudioDrivers()) {
icculus@9382
   916
        return bootstrap[index]->name;
slouken@1895
   917
    }
icculus@9382
   918
    return NULL;
slouken@1794
   919
}
slouken@1794
   920
slouken@1895
   921
int
slouken@1895
   922
SDL_AudioInit(const char *driver_name)
slouken@0
   923
{
icculus@2049
   924
    int i = 0;
icculus@2049
   925
    int initialized = 0;
icculus@2049
   926
    int tried_to_init = 0;
slouken@0
   927
icculus@2049
   928
    if (SDL_WasInit(SDL_INIT_AUDIO)) {
slouken@2060
   929
        SDL_AudioQuit();        /* shutdown driver if already running. */
slouken@1895
   930
    }
slouken@0
   931
icculus@9392
   932
    SDL_zero(current_audio);
icculus@9392
   933
    SDL_zero(open_devices);
icculus@2049
   934
slouken@1895
   935
    /* Select the proper audio driver */
slouken@1909
   936
    if (driver_name == NULL) {
slouken@1909
   937
        driver_name = SDL_getenv("SDL_AUDIODRIVER");
slouken@1909
   938
    }
icculus@2049
   939
icculus@2049
   940
    for (i = 0; (!initialized) && (bootstrap[i]); ++i) {
icculus@2049
   941
        /* make sure we should even try this driver before doing so... */
icculus@2049
   942
        const AudioBootStrap *backend = bootstrap[i];
slouken@6900
   943
        if ((driver_name && (SDL_strncasecmp(backend->name, driver_name, SDL_strlen(driver_name)) != 0)) ||
slouken@6900
   944
            (!driver_name && backend->demand_only)) {
icculus@2049
   945
            continue;
icculus@2049
   946
        }
slouken@0
   947
icculus@2049
   948
        tried_to_init = 1;
icculus@9392
   949
        SDL_zero(current_audio);
icculus@2049
   950
        current_audio.name = backend->name;
icculus@2049
   951
        current_audio.desc = backend->desc;
icculus@3699
   952
        initialized = backend->init(&current_audio.impl);
slouken@1895
   953
    }
icculus@2049
   954
icculus@2049
   955
    if (!initialized) {
icculus@2049
   956
        /* specific drivers will set the error message if they fail... */
icculus@2049
   957
        if (!tried_to_init) {
slouken@1895
   958
            if (driver_name) {
icculus@3699
   959
                SDL_SetError("Audio target '%s' not available", driver_name);
slouken@1895
   960
            } else {
slouken@1895
   961
                SDL_SetError("No available audio device");
slouken@1895
   962
            }
slouken@1895
   963
        }
icculus@2049
   964
icculus@9392
   965
        SDL_zero(current_audio);
icculus@9382
   966
        return -1;            /* No driver was available, so fail. */
slouken@1895
   967
    }
icculus@2049
   968
icculus@9393
   969
    current_audio.detection_lock = SDL_CreateMutex();
icculus@9393
   970
icculus@2049
   971
    finalize_audio_entry_points();
icculus@2049
   972
icculus@9393
   973
    /* Make sure we have a list of devices available at startup. */
icculus@9393
   974
    perform_full_device_redetect(SDL_TRUE);
icculus@9393
   975
    perform_full_device_redetect(SDL_FALSE);
icculus@9393
   976
icculus@9393
   977
    /* Post an add event for each initial device, if desired */
icculus@9393
   978
    if (SDL_GetEventState(SDL_AUDIODEVICEADDED) == SDL_ENABLE) {
icculus@9393
   979
        SDL_Event event;
icculus@9393
   980
icculus@9393
   981
        SDL_zero(event);
icculus@9393
   982
        event.adevice.type = SDL_AUDIODEVICEADDED;
icculus@9393
   983
icculus@9393
   984
        event.adevice.iscapture = 0;
icculus@9393
   985
        for (i = 0; i < current_audio.outputDeviceCount; i++) {
icculus@9393
   986
            event.adevice.which = i;
icculus@9393
   987
            SDL_PushEvent(&event);
icculus@9393
   988
        }
icculus@9393
   989
icculus@9393
   990
        event.adevice.iscapture = 1;
icculus@9393
   991
        for (i = 0; i < current_audio.inputDeviceCount; i++) {
icculus@9393
   992
            event.adevice.which = i;
icculus@9393
   993
            SDL_PushEvent(&event);
icculus@9393
   994
        }
icculus@9393
   995
    }
icculus@9393
   996
icculus@9382
   997
    return 0;
slouken@0
   998
}
slouken@0
   999
slouken@1895
  1000
/*
slouken@1895
  1001
 * Get the current audio driver name
slouken@1895
  1002
 */
slouken@1895
  1003
const char *
slouken@1895
  1004
SDL_GetCurrentAudioDriver()
slouken@0
  1005
{
icculus@2049
  1006
    return current_audio.name;
slouken@0
  1007
}
slouken@0
  1008
slouken@1895
  1009
int
icculus@2049
  1010
SDL_GetNumAudioDevices(int iscapture)
slouken@0
  1011
{
icculus@5593
  1012
    int retval = 0;
icculus@5593
  1013
icculus@2049
  1014
    if (!SDL_WasInit(SDL_INIT_AUDIO)) {
icculus@2049
  1015
        return -1;
icculus@2049
  1016
    }
icculus@5593
  1017
icculus@2049
  1018
    if ((iscapture) && (!current_audio.impl.HasCaptureSupport)) {
icculus@2049
  1019
        return 0;
icculus@2049
  1020
    }
icculus@2049
  1021
icculus@2049
  1022
    if ((iscapture) && (current_audio.impl.OnlyHasDefaultInputDevice)) {
icculus@2049
  1023
        return 1;
icculus@2049
  1024
    }
icculus@2049
  1025
icculus@2049
  1026
    if ((!iscapture) && (current_audio.impl.OnlyHasDefaultOutputDevice)) {
icculus@2049
  1027
        return 1;
icculus@2049
  1028
    }
icculus@2049
  1029
icculus@9393
  1030
    if (current_audio.need_capture_device_redetect) {
icculus@9393
  1031
        current_audio.need_capture_device_redetect = SDL_FALSE;
icculus@9393
  1032
        perform_full_device_redetect(SDL_TRUE);
icculus@5593
  1033
    }
icculus@5593
  1034
icculus@9393
  1035
    if (current_audio.need_output_device_redetect) {
icculus@9393
  1036
        current_audio.need_output_device_redetect = SDL_FALSE;
icculus@9393
  1037
        perform_full_device_redetect(SDL_FALSE);
icculus@9393
  1038
    }
icculus@9393
  1039
icculus@9393
  1040
    SDL_LockMutex(current_audio.detection_lock);
icculus@9393
  1041
    retval = iscapture ? current_audio.inputDeviceCount : current_audio.outputDeviceCount;
icculus@9393
  1042
    SDL_UnlockMutex(current_audio.detection_lock);
icculus@9393
  1043
icculus@5593
  1044
    return retval;
icculus@2049
  1045
}
icculus@2049
  1046
slouken@0
  1047
icculus@2049
  1048
const char *
icculus@2049
  1049
SDL_GetAudioDeviceName(int index, int iscapture)
icculus@2049
  1050
{
icculus@9393
  1051
    const char *retval = NULL;
icculus@9393
  1052
icculus@2049
  1053
    if (!SDL_WasInit(SDL_INIT_AUDIO)) {
icculus@2049
  1054
        SDL_SetError("Audio subsystem is not initialized");
icculus@2049
  1055
        return NULL;
icculus@2049
  1056
    }
icculus@2049
  1057
icculus@2049
  1058
    if ((iscapture) && (!current_audio.impl.HasCaptureSupport)) {
icculus@2049
  1059
        SDL_SetError("No capture support");
icculus@2049
  1060
        return NULL;
slouken@1895
  1061
    }
icculus@2049
  1062
icculus@2049
  1063
    if (index < 0) {
icculus@5593
  1064
        goto no_such_device;
icculus@2049
  1065
    }
slouken@0
  1066
icculus@2049
  1067
    if ((iscapture) && (current_audio.impl.OnlyHasDefaultInputDevice)) {
slouken@7904
  1068
        if (index > 0) {
slouken@7904
  1069
            goto no_such_device;
slouken@7904
  1070
        }
icculus@2049
  1071
        return DEFAULT_INPUT_DEVNAME;
icculus@2049
  1072
    }
icculus@2049
  1073
icculus@2049
  1074
    if ((!iscapture) && (current_audio.impl.OnlyHasDefaultOutputDevice)) {
slouken@7904
  1075
        if (index > 0) {
slouken@7904
  1076
            goto no_such_device;
slouken@7904
  1077
        }
icculus@2049
  1078
        return DEFAULT_OUTPUT_DEVNAME;
slouken@1895
  1079
    }
slouken@262
  1080
icculus@9393
  1081
    SDL_LockMutex(current_audio.detection_lock);
icculus@9393
  1082
    if (iscapture && (index < current_audio.inputDeviceCount)) {
icculus@9393
  1083
        retval = current_audio.inputDevices[index];
icculus@9393
  1084
    } else if (!iscapture && (index < current_audio.outputDeviceCount)) {
icculus@9393
  1085
        retval = current_audio.outputDevices[index];
icculus@9393
  1086
    }
icculus@9393
  1087
    SDL_UnlockMutex(current_audio.detection_lock);
icculus@9393
  1088
icculus@9393
  1089
    /* !!! FIXME: a device could be removed after being returned here, freeing retval's pointer. */
icculus@9393
  1090
icculus@9393
  1091
    if (retval != NULL) {
icculus@9393
  1092
        return retval;
icculus@5593
  1093
    }
icculus@5593
  1094
icculus@5593
  1095
no_such_device:
icculus@5593
  1096
    SDL_SetError("No such device");
icculus@5593
  1097
    return NULL;
icculus@2049
  1098
}
icculus@2049
  1099
icculus@2049
  1100
icculus@2049
  1101
static void
slouken@2060
  1102
close_audio_device(SDL_AudioDevice * device)
icculus@2049
  1103
{
icculus@2049
  1104
    device->enabled = 0;
icculus@2049
  1105
    if (device->thread != NULL) {
icculus@2049
  1106
        SDL_WaitThread(device->thread, NULL);
icculus@2049
  1107
    }
icculus@2049
  1108
    if (device->mixer_lock != NULL) {
icculus@2049
  1109
        SDL_DestroyMutex(device->mixer_lock);
icculus@2049
  1110
    }
slouken@7719
  1111
    SDL_FreeAudioMem(device->fake_stream);
icculus@2049
  1112
    if (device->convert.needed) {
icculus@2049
  1113
        SDL_FreeAudioMem(device->convert.buf);
icculus@2049
  1114
    }
icculus@2049
  1115
    if (device->opened) {
icculus@2049
  1116
        current_audio.impl.CloseDevice(device);
icculus@2049
  1117
        device->opened = 0;
icculus@2049
  1118
    }
icculus@9012
  1119
icculus@9012
  1120
    free_audio_queue(device->buffer_queue_head);
icculus@9012
  1121
    free_audio_queue(device->buffer_queue_pool);
icculus@9012
  1122
icculus@2049
  1123
    SDL_FreeAudioMem(device);
icculus@2049
  1124
}
icculus@2049
  1125
icculus@2049
  1126
icculus@2049
  1127
/*
icculus@2049
  1128
 * Sanity check desired AudioSpec for SDL_OpenAudio() in (orig).
icculus@2049
  1129
 *  Fills in a sanitized copy in (prepared).
icculus@2049
  1130
 *  Returns non-zero if okay, zero on fatal parameters in (orig).
icculus@2049
  1131
 */
icculus@2049
  1132
static int
slouken@2060
  1133
prepare_audiospec(const SDL_AudioSpec * orig, SDL_AudioSpec * prepared)
icculus@2049
  1134
{
slouken@2060
  1135
    SDL_memcpy(prepared, orig, sizeof(SDL_AudioSpec));
icculus@2049
  1136
icculus@2049
  1137
    if (orig->freq == 0) {
icculus@2049
  1138
        const char *env = SDL_getenv("SDL_AUDIO_FREQUENCY");
slouken@2060
  1139
        if ((!env) || ((prepared->freq = SDL_atoi(env)) == 0)) {
slouken@2060
  1140
            prepared->freq = 22050;     /* a reasonable default */
slouken@1895
  1141
        }
slouken@1895
  1142
    }
icculus@2049
  1143
icculus@2049
  1144
    if (orig->format == 0) {
icculus@2049
  1145
        const char *env = SDL_getenv("SDL_AUDIO_FORMAT");
icculus@2049
  1146
        if ((!env) || ((prepared->format = SDL_ParseAudioFormat(env)) == 0)) {
slouken@2060
  1147
            prepared->format = AUDIO_S16;       /* a reasonable default */
slouken@1895
  1148
        }
slouken@1895
  1149
    }
icculus@2049
  1150
icculus@2049
  1151
    switch (orig->channels) {
slouken@2060
  1152
    case 0:{
slouken@2060
  1153
            const char *env = SDL_getenv("SDL_AUDIO_CHANNELS");
slouken@2141
  1154
            if ((!env) || ((prepared->channels = (Uint8) SDL_atoi(env)) == 0)) {
slouken@2060
  1155
                prepared->channels = 2; /* a reasonable default */
slouken@2060
  1156
            }
slouken@2060
  1157
            break;
icculus@2049
  1158
        }
slouken@1895
  1159
    case 1:                    /* Mono */
slouken@1895
  1160
    case 2:                    /* Stereo */
slouken@1895
  1161
    case 4:                    /* surround */
slouken@1895
  1162
    case 6:                    /* surround with center and lfe */
slouken@1895
  1163
        break;
slouken@1895
  1164
    default:
icculus@2049
  1165
        SDL_SetError("Unsupported number of audio channels.");
icculus@2049
  1166
        return 0;
slouken@1895
  1167
    }
icculus@2049
  1168
icculus@2049
  1169
    if (orig->samples == 0) {
icculus@2049
  1170
        const char *env = SDL_getenv("SDL_AUDIO_SAMPLES");
slouken@2060
  1171
        if ((!env) || ((prepared->samples = (Uint16) SDL_atoi(env)) == 0)) {
icculus@2049
  1172
            /* Pick a default of ~46 ms at desired frequency */
icculus@2049
  1173
            /* !!! FIXME: remove this when the non-Po2 resampling is in. */
icculus@2049
  1174
            const int samples = (prepared->freq / 1000) * 46;
icculus@2049
  1175
            int power2 = 1;
icculus@2049
  1176
            while (power2 < samples) {
icculus@2049
  1177
                power2 *= 2;
icculus@2049
  1178
            }
icculus@2049
  1179
            prepared->samples = power2;
slouken@1895
  1180
        }
slouken@1895
  1181
    }
slouken@0
  1182
slouken@1895
  1183
    /* Calculate the silence and size of the audio specification */
icculus@2049
  1184
    SDL_CalculateAudioSpec(prepared);
slouken@21
  1185
icculus@2049
  1186
    return 1;
icculus@2049
  1187
}
slouken@1408
  1188
icculus@2049
  1189
static SDL_AudioDeviceID
icculus@2049
  1190
open_audio_device(const char *devname, int iscapture,
slouken@2866
  1191
                  const SDL_AudioSpec * desired, SDL_AudioSpec * obtained,
slouken@2866
  1192
                  int allowed_changes, int min_id)
icculus@2049
  1193
{
icculus@2049
  1194
    SDL_AudioDeviceID id = 0;
slouken@2866
  1195
    SDL_AudioSpec _obtained;
icculus@2049
  1196
    SDL_AudioDevice *device;
slouken@2866
  1197
    SDL_bool build_cvt;
icculus@2049
  1198
    int i = 0;
slouken@21
  1199
icculus@2049
  1200
    if (!SDL_WasInit(SDL_INIT_AUDIO)) {
icculus@2049
  1201
        SDL_SetError("Audio subsystem is not initialized");
icculus@2049
  1202
        return 0;
icculus@2049
  1203
    }
icculus@2049
  1204
icculus@2049
  1205
    if ((iscapture) && (!current_audio.impl.HasCaptureSupport)) {
icculus@2049
  1206
        SDL_SetError("No capture support");
icculus@2049
  1207
        return 0;
icculus@2049
  1208
    }
icculus@2049
  1209
icculus@9393
  1210
    /* Find an available device ID... */
icculus@9393
  1211
    for (id = min_id - 1; id < SDL_arraysize(open_devices); id++) {
icculus@9393
  1212
        if (open_devices[id] == NULL) {
icculus@9393
  1213
            break;
icculus@9393
  1214
        }
icculus@9393
  1215
    }
icculus@9393
  1216
icculus@9393
  1217
    if (id == SDL_arraysize(open_devices)) {
icculus@9393
  1218
        SDL_SetError("Too many open audio devices");
icculus@9393
  1219
        return 0;
icculus@9393
  1220
    }
icculus@9393
  1221
slouken@2866
  1222
    if (!obtained) {
slouken@2866
  1223
        obtained = &_obtained;
slouken@2866
  1224
    }
slouken@2866
  1225
    if (!prepare_audiospec(desired, obtained)) {
icculus@2049
  1226
        return 0;
icculus@2049
  1227
    }
icculus@2049
  1228
icculus@2049
  1229
    /* If app doesn't care about a specific device, let the user override. */
icculus@2049
  1230
    if (devname == NULL) {
icculus@2049
  1231
        devname = SDL_getenv("SDL_AUDIO_DEVICE_NAME");
slouken@1895
  1232
    }
slouken@21
  1233
icculus@2049
  1234
    /*
icculus@2049
  1235
     * Catch device names at the high level for the simple case...
icculus@2049
  1236
     * This lets us have a basic "device enumeration" for systems that
icculus@2049
  1237
     *  don't have multiple devices, but makes sure the device name is
icculus@2049
  1238
     *  always NULL when it hits the low level.
icculus@2049
  1239
     *
icculus@2049
  1240
     * Also make sure that the simple case prevents multiple simultaneous
icculus@2049
  1241
     *  opens of the default system device.
icculus@2049
  1242
     */
icculus@2049
  1243
icculus@2049
  1244
    if ((iscapture) && (current_audio.impl.OnlyHasDefaultInputDevice)) {
icculus@2049
  1245
        if ((devname) && (SDL_strcmp(devname, DEFAULT_INPUT_DEVNAME) != 0)) {
icculus@2049
  1246
            SDL_SetError("No such device");
icculus@2049
  1247
            return 0;
icculus@2049
  1248
        }
icculus@2049
  1249
        devname = NULL;
icculus@2049
  1250
icculus@2049
  1251
        for (i = 0; i < SDL_arraysize(open_devices); i++) {
icculus@2049
  1252
            if ((open_devices[i]) && (open_devices[i]->iscapture)) {
icculus@2049
  1253
                SDL_SetError("Audio device already open");
icculus@2049
  1254
                return 0;
icculus@2049
  1255
            }
icculus@2049
  1256
        }
icculus@2049
  1257
    }
icculus@2049
  1258
icculus@2049
  1259
    if ((!iscapture) && (current_audio.impl.OnlyHasDefaultOutputDevice)) {
icculus@2049
  1260
        if ((devname) && (SDL_strcmp(devname, DEFAULT_OUTPUT_DEVNAME) != 0)) {
icculus@2049
  1261
            SDL_SetError("No such device");
icculus@2049
  1262
            return 0;
icculus@2049
  1263
        }
icculus@2049
  1264
        devname = NULL;
icculus@2049
  1265
icculus@2049
  1266
        for (i = 0; i < SDL_arraysize(open_devices); i++) {
icculus@2049
  1267
            if ((open_devices[i]) && (!open_devices[i]->iscapture)) {
icculus@2049
  1268
                SDL_SetError("Audio device already open");
icculus@2049
  1269
                return 0;
icculus@2049
  1270
            }
icculus@2049
  1271
        }
icculus@2049
  1272
    }
icculus@2049
  1273
slouken@2060
  1274
    device = (SDL_AudioDevice *) SDL_AllocAudioMem(sizeof(SDL_AudioDevice));
icculus@2049
  1275
    if (device == NULL) {
icculus@2049
  1276
        SDL_OutOfMemory();
icculus@2049
  1277
        return 0;
icculus@2049
  1278
    }
icculus@9012
  1279
    SDL_zerop(device);
icculus@9393
  1280
    device->id = id + 1;
slouken@2866
  1281
    device->spec = *obtained;
icculus@2049
  1282
    device->enabled = 1;
icculus@2049
  1283
    device->paused = 1;
icculus@2049
  1284
    device->iscapture = iscapture;
icculus@2049
  1285
icculus@9391
  1286
    /* Create a mutex for locking the sound buffers */
icculus@2049
  1287
    if (!current_audio.impl.SkipMixerLock) {
icculus@2049
  1288
        device->mixer_lock = SDL_CreateMutex();
icculus@2049
  1289
        if (device->mixer_lock == NULL) {
icculus@2049
  1290
            close_audio_device(device);
icculus@2049
  1291
            SDL_SetError("Couldn't create mixer lock");
icculus@2049
  1292
            return 0;
icculus@2049
  1293
        }
icculus@2049
  1294
    }
icculus@2049
  1295
icculus@7038
  1296
    if (current_audio.impl.OpenDevice(device, devname, iscapture) < 0) {
icculus@2049
  1297
        close_audio_device(device);
icculus@2049
  1298
        return 0;
icculus@2049
  1299
    }
icculus@2049
  1300
    device->opened = 1;
slouken@0
  1301
slouken@1895
  1302
    /* Allocate a fake audio memory buffer */
aschiffler@4865
  1303
    device->fake_stream = (Uint8 *)SDL_AllocAudioMem(device->spec.size);
icculus@2049
  1304
    if (device->fake_stream == NULL) {
icculus@2049
  1305
        close_audio_device(device);
slouken@1895
  1306
        SDL_OutOfMemory();
icculus@2049
  1307
        return 0;
slouken@1895
  1308
    }
slouken@0
  1309
slouken@1895
  1310
    /* See if we need to do any conversion */
slouken@2866
  1311
    build_cvt = SDL_FALSE;
slouken@2866
  1312
    if (obtained->freq != device->spec.freq) {
slouken@2866
  1313
        if (allowed_changes & SDL_AUDIO_ALLOW_FREQUENCY_CHANGE) {
slouken@2866
  1314
            obtained->freq = device->spec.freq;
slouken@2866
  1315
        } else {
slouken@2866
  1316
            build_cvt = SDL_TRUE;
slouken@2866
  1317
        }
slouken@2866
  1318
    }
slouken@2866
  1319
    if (obtained->format != device->spec.format) {
slouken@2866
  1320
        if (allowed_changes & SDL_AUDIO_ALLOW_FORMAT_CHANGE) {
slouken@2866
  1321
            obtained->format = device->spec.format;
slouken@2866
  1322
        } else {
slouken@2866
  1323
            build_cvt = SDL_TRUE;
slouken@2866
  1324
        }
slouken@2866
  1325
    }
slouken@2866
  1326
    if (obtained->channels != device->spec.channels) {
slouken@2866
  1327
        if (allowed_changes & SDL_AUDIO_ALLOW_CHANNELS_CHANGE) {
slouken@2866
  1328
            obtained->channels = device->spec.channels;
slouken@2866
  1329
        } else {
slouken@2866
  1330
            build_cvt = SDL_TRUE;
slouken@2866
  1331
        }
slouken@2866
  1332
    }
slouken@7518
  1333
slouken@7518
  1334
    /* If the audio driver changes the buffer size, accept it.
slouken@7518
  1335
       This needs to be done after the format is modified above,
slouken@7518
  1336
       otherwise it might not have the correct buffer size.
slouken@7518
  1337
     */
slouken@7518
  1338
    if (device->spec.samples != obtained->samples) {
slouken@7518
  1339
        obtained->samples = device->spec.samples;
slouken@7518
  1340
        SDL_CalculateAudioSpec(obtained);
slouken@7518
  1341
    }
slouken@7518
  1342
slouken@2866
  1343
    if (build_cvt) {
slouken@1895
  1344
        /* Build an audio conversion block */
icculus@2049
  1345
        if (SDL_BuildAudioCVT(&device->convert,
slouken@2866
  1346
                              obtained->format, obtained->channels,
slouken@2866
  1347
                              obtained->freq,
icculus@2049
  1348
                              device->spec.format, device->spec.channels,
icculus@2049
  1349
                              device->spec.freq) < 0) {
icculus@2049
  1350
            close_audio_device(device);
icculus@2049
  1351
            return 0;
slouken@1895
  1352
        }
icculus@2049
  1353
        if (device->convert.needed) {
slouken@7518
  1354
            device->convert.len = (int) (((double) device->spec.size) /
slouken@2060
  1355
                                         device->convert.len_ratio);
icculus@2053
  1356
icculus@2049
  1357
            device->convert.buf =
icculus@2049
  1358
                (Uint8 *) SDL_AllocAudioMem(device->convert.len *
icculus@2049
  1359
                                            device->convert.len_mult);
icculus@2049
  1360
            if (device->convert.buf == NULL) {
icculus@2049
  1361
                close_audio_device(device);
slouken@1895
  1362
                SDL_OutOfMemory();
icculus@2049
  1363
                return 0;
slouken@1895
  1364
            }
slouken@1895
  1365
        }
slouken@1895
  1366
    }
icculus@2049
  1367
icculus@9012
  1368
    if (device->spec.callback == NULL) {  /* use buffer queueing? */
icculus@9012
  1369
        /* pool a few packets to start. Enough for two callbacks. */
icculus@9012
  1370
        const int packetlen = SDL_AUDIOBUFFERQUEUE_PACKETLEN;
icculus@9012
  1371
        const int wantbytes = ((device->convert.needed) ? device->convert.len : device->spec.size) * 2;
icculus@9012
  1372
        const int wantpackets = (wantbytes / packetlen) + ((wantbytes % packetlen) ? packetlen : 0);
icculus@9012
  1373
        for (i = 0; i < wantpackets; i++) {
icculus@9012
  1374
            SDL_AudioBufferQueue *packet = (SDL_AudioBufferQueue *) SDL_malloc(sizeof (SDL_AudioBufferQueue));
icculus@9012
  1375
            if (packet) { /* don't care if this fails, we'll deal later. */
icculus@9012
  1376
                packet->datalen = 0;
icculus@9012
  1377
                packet->startpos = 0;
icculus@9012
  1378
                packet->next = device->buffer_queue_pool;
icculus@9012
  1379
                device->buffer_queue_pool = packet;
icculus@9012
  1380
            }
icculus@9012
  1381
        }
icculus@9012
  1382
icculus@9012
  1383
        device->spec.callback = SDL_BufferQueueDrainCallback;
icculus@9012
  1384
        device->spec.userdata = device;
icculus@9012
  1385
    }
icculus@9012
  1386
icculus@9393
  1387
    /* add it to our list of open devices. */
icculus@9393
  1388
    open_devices[id] = device;
icculus@2049
  1389
slouken@1895
  1390
    /* Start the audio thread if necessary */
icculus@2049
  1391
    if (!current_audio.impl.ProvidesOwnCallbackThread) {
slouken@1895
  1392
        /* Start the audio thread */
icculus@5969
  1393
        char name[64];
icculus@9393
  1394
        SDL_snprintf(name, sizeof (name), "SDLAudioDev%d", (int) device->id);
icculus@2049
  1395
/* !!! FIXME: this is nasty. */
icculus@6430
  1396
#if defined(__WIN32__) && !defined(HAVE_LIBC)
slouken@1330
  1397
#undef SDL_CreateThread
icculus@8094
  1398
#if SDL_DYNAMIC_API
icculus@8094
  1399
        device->thread = SDL_CreateThread_REAL(SDL_RunAudio, name, device, NULL, NULL);
icculus@8094
  1400
#else
icculus@5969
  1401
        device->thread = SDL_CreateThread(SDL_RunAudio, name, device, NULL, NULL);
icculus@8094
  1402
#endif
slouken@1330
  1403
#else
icculus@5969
  1404
        device->thread = SDL_CreateThread(SDL_RunAudio, name, device);
slouken@1330
  1405
#endif
icculus@2049
  1406
        if (device->thread == NULL) {
icculus@9393
  1407
            SDL_CloseAudioDevice(device->id);
slouken@1895
  1408
            SDL_SetError("Couldn't create audio thread");
icculus@2049
  1409
            return 0;
icculus@2049
  1410
        }
icculus@2049
  1411
    }
icculus@2049
  1412
icculus@9393
  1413
    return device->id;
icculus@2049
  1414
}
icculus@2049
  1415
icculus@2049
  1416
icculus@2049
  1417
int
slouken@2866
  1418
SDL_OpenAudio(SDL_AudioSpec * desired, SDL_AudioSpec * obtained)
icculus@2049
  1419
{
icculus@2049
  1420
    SDL_AudioDeviceID id = 0;
icculus@2049
  1421
icculus@2049
  1422
    /* Start up the audio driver, if necessary. This is legacy behaviour! */
icculus@2049
  1423
    if (!SDL_WasInit(SDL_INIT_AUDIO)) {
icculus@2049
  1424
        if (SDL_InitSubSystem(SDL_INIT_AUDIO) < 0) {
icculus@9382
  1425
            return -1;
slouken@1895
  1426
        }
icculus@2049
  1427
    }
slouken@0
  1428
icculus@2049
  1429
    /* SDL_OpenAudio() is legacy and can only act on Device ID #1. */
icculus@2049
  1430
    if (open_devices[0] != NULL) {
icculus@2049
  1431
        SDL_SetError("Audio device is already opened");
icculus@9382
  1432
        return -1;
slouken@1895
  1433
    }
icculus@2049
  1434
slouken@2866
  1435
    if (obtained) {
slouken@2866
  1436
        id = open_audio_device(NULL, 0, desired, obtained,
slouken@2866
  1437
                               SDL_AUDIO_ALLOW_ANY_CHANGE, 1);
slouken@2866
  1438
    } else {
slouken@8919
  1439
        id = open_audio_device(NULL, 0, desired, NULL, 0, 1);
slouken@2866
  1440
    }
slouken@21
  1441
icculus@5964
  1442
    SDL_assert((id == 0) || (id == 1));
icculus@9382
  1443
    return (id == 0) ? -1 : 0;
icculus@2049
  1444
}
slouken@21
  1445
icculus@2049
  1446
SDL_AudioDeviceID
icculus@2049
  1447
SDL_OpenAudioDevice(const char *device, int iscapture,
slouken@2866
  1448
                    const SDL_AudioSpec * desired, SDL_AudioSpec * obtained,
slouken@2866
  1449
                    int allowed_changes)
icculus@2049
  1450
{
slouken@2866
  1451
    return open_audio_device(device, iscapture, desired, obtained,
slouken@2866
  1452
                             allowed_changes, 2);
slouken@1895
  1453
}
slouken@1895
  1454
slouken@3537
  1455
SDL_AudioStatus
icculus@2049
  1456
SDL_GetAudioDeviceStatus(SDL_AudioDeviceID devid)
slouken@1895
  1457
{
icculus@2049
  1458
    SDL_AudioDevice *device = get_audio_device(devid);
slouken@3537
  1459
    SDL_AudioStatus status = SDL_AUDIO_STOPPED;
icculus@2049
  1460
    if (device && device->enabled) {
icculus@2049
  1461
        if (device->paused) {
slouken@1895
  1462
            status = SDL_AUDIO_PAUSED;
slouken@1895
  1463
        } else {
slouken@1895
  1464
            status = SDL_AUDIO_PLAYING;
slouken@1895
  1465
        }
slouken@1895
  1466
    }
icculus@9382
  1467
    return status;
slouken@0
  1468
}
slouken@0
  1469
icculus@2049
  1470
slouken@3537
  1471
SDL_AudioStatus
icculus@2049
  1472
SDL_GetAudioStatus(void)
icculus@2049
  1473
{
icculus@2049
  1474
    return SDL_GetAudioDeviceStatus(1);
icculus@2049
  1475
}
icculus@2049
  1476
icculus@2049
  1477
void
icculus@2049
  1478
SDL_PauseAudioDevice(SDL_AudioDeviceID devid, int pause_on)
icculus@2049
  1479
{
icculus@2049
  1480
    SDL_AudioDevice *device = get_audio_device(devid);
gabomdq@9148
  1481
    if (device) {
gabomdq@9148
  1482
        current_audio.impl.LockDevice(device);
icculus@2049
  1483
        device->paused = pause_on;
gabomdq@9148
  1484
        current_audio.impl.UnlockDevice(device);
icculus@2049
  1485
    }
icculus@2049
  1486
}
icculus@2049
  1487
slouken@1895
  1488
void
slouken@1895
  1489
SDL_PauseAudio(int pause_on)
slouken@0
  1490
{
gabomdq@9148
  1491
    SDL_PauseAudioDevice(1, pause_on);
icculus@2049
  1492
}
icculus@2049
  1493
slouken@0
  1494
icculus@2049
  1495
void
icculus@2049
  1496
SDL_LockAudioDevice(SDL_AudioDeviceID devid)
icculus@2049
  1497
{
icculus@2049
  1498
    /* Obtain a lock on the mixing buffers */
icculus@2049
  1499
    SDL_AudioDevice *device = get_audio_device(devid);
icculus@2049
  1500
    if (device) {
icculus@2049
  1501
        current_audio.impl.LockDevice(device);
slouken@1895
  1502
    }
slouken@0
  1503
}
slouken@0
  1504
slouken@1895
  1505
void
slouken@1895
  1506
SDL_LockAudio(void)
slouken@0
  1507
{
icculus@2049
  1508
    SDL_LockAudioDevice(1);
icculus@2049
  1509
}
slouken@0
  1510
icculus@2049
  1511
void
icculus@2049
  1512
SDL_UnlockAudioDevice(SDL_AudioDeviceID devid)
icculus@2049
  1513
{
slouken@1895
  1514
    /* Obtain a lock on the mixing buffers */
icculus@2049
  1515
    SDL_AudioDevice *device = get_audio_device(devid);
icculus@2049
  1516
    if (device) {
icculus@2049
  1517
        current_audio.impl.UnlockDevice(device);
slouken@1895
  1518
    }
slouken@0
  1519
}
slouken@0
  1520
slouken@1895
  1521
void
slouken@1895
  1522
SDL_UnlockAudio(void)
slouken@0
  1523
{
icculus@2049
  1524
    SDL_UnlockAudioDevice(1);
icculus@2049
  1525
}
slouken@0
  1526
icculus@2049
  1527
void
icculus@2049
  1528
SDL_CloseAudioDevice(SDL_AudioDeviceID devid)
icculus@2049
  1529
{
icculus@2049
  1530
    SDL_AudioDevice *device = get_audio_device(devid);
icculus@2049
  1531
    if (device) {
icculus@2049
  1532
        close_audio_device(device);
slouken@2060
  1533
        open_devices[devid - 1] = NULL;
slouken@1895
  1534
    }
slouken@0
  1535
}
slouken@0
  1536
slouken@1895
  1537
void
slouken@1895
  1538
SDL_CloseAudio(void)
slouken@0
  1539
{
icculus@2049
  1540
    SDL_CloseAudioDevice(1);
slouken@0
  1541
}
slouken@0
  1542
slouken@1895
  1543
void
slouken@1895
  1544
SDL_AudioQuit(void)
slouken@0
  1545
{
icculus@7348
  1546
    SDL_AudioDeviceID i;
icculus@7348
  1547
icculus@7345
  1548
    if (!current_audio.name) {  /* not initialized?! */
icculus@7345
  1549
        return;
icculus@7345
  1550
    }
icculus@7345
  1551
icculus@2049
  1552
    for (i = 0; i < SDL_arraysize(open_devices); i++) {
icculus@7342
  1553
        if (open_devices[i] != NULL) {
icculus@7446
  1554
            SDL_CloseAudioDevice(i+1);
icculus@7342
  1555
        }
icculus@2049
  1556
    }
slouken@0
  1557
icculus@2049
  1558
    /* Free the driver data */
icculus@2049
  1559
    current_audio.impl.Deinitialize();
icculus@9393
  1560
icculus@5593
  1561
    free_device_list(&current_audio.outputDevices,
icculus@5593
  1562
                     &current_audio.outputDeviceCount);
icculus@5593
  1563
    free_device_list(&current_audio.inputDevices,
icculus@5593
  1564
                     &current_audio.inputDeviceCount);
icculus@9393
  1565
icculus@9393
  1566
    SDL_DestroyMutex(current_audio.detection_lock);
icculus@9393
  1567
icculus@9393
  1568
    SDL_zero(current_audio);
icculus@9393
  1569
    SDL_zero(open_devices);
slouken@0
  1570
}
slouken@0
  1571
icculus@1982
  1572
#define NUM_FORMATS 10
slouken@0
  1573
static int format_idx;
slouken@0
  1574
static int format_idx_sub;
icculus@1982
  1575
static SDL_AudioFormat format_list[NUM_FORMATS][NUM_FORMATS] = {
slouken@1895
  1576
    {AUDIO_U8, AUDIO_S8, AUDIO_S16LSB, AUDIO_S16MSB, AUDIO_U16LSB,
icculus@1982
  1577
     AUDIO_U16MSB, AUDIO_S32LSB, AUDIO_S32MSB, AUDIO_F32LSB, AUDIO_F32MSB},
slouken@1895
  1578
    {AUDIO_S8, AUDIO_U8, AUDIO_S16LSB, AUDIO_S16MSB, AUDIO_U16LSB,
icculus@1982
  1579
     AUDIO_U16MSB, AUDIO_S32LSB, AUDIO_S32MSB, AUDIO_F32LSB, AUDIO_F32MSB},
icculus@1982
  1580
    {AUDIO_S16LSB, AUDIO_S16MSB, AUDIO_U16LSB, AUDIO_U16MSB, AUDIO_S32LSB,
icculus@1982
  1581
     AUDIO_S32MSB, AUDIO_F32LSB, AUDIO_F32MSB, AUDIO_U8, AUDIO_S8},
icculus@1982
  1582
    {AUDIO_S16MSB, AUDIO_S16LSB, AUDIO_U16MSB, AUDIO_U16LSB, AUDIO_S32MSB,
icculus@1982
  1583
     AUDIO_S32LSB, AUDIO_F32MSB, AUDIO_F32LSB, AUDIO_U8, AUDIO_S8},
icculus@1982
  1584
    {AUDIO_U16LSB, AUDIO_U16MSB, AUDIO_S16LSB, AUDIO_S16MSB, AUDIO_S32LSB,
icculus@1982
  1585
     AUDIO_S32MSB, AUDIO_F32LSB, AUDIO_F32MSB, AUDIO_U8, AUDIO_S8},
icculus@1982
  1586
    {AUDIO_U16MSB, AUDIO_U16LSB, AUDIO_S16MSB, AUDIO_S16LSB, AUDIO_S32MSB,
icculus@1982
  1587
     AUDIO_S32LSB, AUDIO_F32MSB, AUDIO_F32LSB, AUDIO_U8, AUDIO_S8},
icculus@1993
  1588
    {AUDIO_S32LSB, AUDIO_S32MSB, AUDIO_F32LSB, AUDIO_F32MSB, AUDIO_S16LSB,
icculus@1993
  1589
     AUDIO_S16MSB, AUDIO_U16LSB, AUDIO_U16MSB, AUDIO_U8, AUDIO_S8},
icculus@1993
  1590
    {AUDIO_S32MSB, AUDIO_S32LSB, AUDIO_F32MSB, AUDIO_F32LSB, AUDIO_S16MSB,
icculus@1993
  1591
     AUDIO_S16LSB, AUDIO_U16MSB, AUDIO_U16LSB, AUDIO_U8, AUDIO_S8},
icculus@1993
  1592
    {AUDIO_F32LSB, AUDIO_F32MSB, AUDIO_S32LSB, AUDIO_S32MSB, AUDIO_S16LSB,
icculus@1993
  1593
     AUDIO_S16MSB, AUDIO_U16LSB, AUDIO_U16MSB, AUDIO_U8, AUDIO_S8},
icculus@1993
  1594
    {AUDIO_F32MSB, AUDIO_F32LSB, AUDIO_S32MSB, AUDIO_S32LSB, AUDIO_S16MSB,
icculus@1993
  1595
     AUDIO_S16LSB, AUDIO_U16MSB, AUDIO_U16LSB, AUDIO_U8, AUDIO_S8},
slouken@0
  1596
};
slouken@0
  1597
icculus@1982
  1598
SDL_AudioFormat
icculus@1982
  1599
SDL_FirstAudioFormat(SDL_AudioFormat format)
slouken@0
  1600
{
slouken@1895
  1601
    for (format_idx = 0; format_idx < NUM_FORMATS; ++format_idx) {
slouken@1895
  1602
        if (format_list[format_idx][0] == format) {
slouken@1895
  1603
            break;
slouken@1895
  1604
        }
slouken@1895
  1605
    }
slouken@1895
  1606
    format_idx_sub = 0;
icculus@9382
  1607
    return SDL_NextAudioFormat();
slouken@0
  1608
}
slouken@0
  1609
icculus@1982
  1610
SDL_AudioFormat
slouken@1895
  1611
SDL_NextAudioFormat(void)
slouken@0
  1612
{
slouken@1895
  1613
    if ((format_idx == NUM_FORMATS) || (format_idx_sub == NUM_FORMATS)) {
icculus@9382
  1614
        return 0;
slouken@1895
  1615
    }
icculus@9382
  1616
    return format_list[format_idx][format_idx_sub++];
slouken@0
  1617
}
slouken@0
  1618
slouken@1895
  1619
void
slouken@1895
  1620
SDL_CalculateAudioSpec(SDL_AudioSpec * spec)
slouken@0
  1621
{
slouken@1895
  1622
    switch (spec->format) {
slouken@1895
  1623
    case AUDIO_U8:
slouken@1895
  1624
        spec->silence = 0x80;
slouken@1895
  1625
        break;
slouken@1895
  1626
    default:
slouken@1895
  1627
        spec->silence = 0x00;
slouken@1895
  1628
        break;
slouken@1895
  1629
    }
icculus@2049
  1630
    spec->size = SDL_AUDIO_BITSIZE(spec->format) / 8;
slouken@1895
  1631
    spec->size *= spec->channels;
slouken@1895
  1632
    spec->size *= spec->samples;
slouken@0
  1633
}
slouken@1895
  1634
icculus@2049
  1635
icculus@2049
  1636
/*
icculus@2049
  1637
 * Moved here from SDL_mixer.c, since it relies on internals of an opened
icculus@2049
  1638
 *  audio device (and is deprecated, by the way!).
icculus@2049
  1639
 */
icculus@2049
  1640
void
icculus@2049
  1641
SDL_MixAudio(Uint8 * dst, const Uint8 * src, Uint32 len, int volume)
icculus@2049
  1642
{
icculus@2049
  1643
    /* Mix the user-level audio format */
icculus@2049
  1644
    SDL_AudioDevice *device = get_audio_device(1);
icculus@2049
  1645
    if (device != NULL) {
icculus@2049
  1646
        SDL_AudioFormat format;
icculus@2049
  1647
        if (device->convert.needed) {
icculus@2049
  1648
            format = device->convert.src_format;
icculus@2049
  1649
        } else {
icculus@2049
  1650
            format = device->spec.format;
icculus@2049
  1651
        }
icculus@2049
  1652
        SDL_MixAudioFormat(dst, src, format, len, volume);
icculus@2049
  1653
    }
icculus@2049
  1654
}
icculus@2049
  1655
slouken@1895
  1656
/* vi: set ts=4 sw=4 expandtab: */