src/audio/SDL_audio.c
author Dimitris Zenios
Mon, 05 May 2014 22:21:26 +0300
changeset 8761 bce4122e6e87
parent 8660 6bd1f8bad873
child 8833 ae720d61d14d
permissions -rw-r--r--
__ANDROID__ is the correct macro to check for an android system.ANDROID is only defined in NDK build system (.mk) and not in the standalone NDK.
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;
icculus@2049
    54
extern AudioBootStrap NAS_bootstrap;
icculus@5592
    55
extern AudioBootStrap XAUDIO2_bootstrap;
icculus@2049
    56
extern AudioBootStrap DSOUND_bootstrap;
icculus@5588
    57
extern AudioBootStrap WINMM_bootstrap;
icculus@2049
    58
extern AudioBootStrap PAUDIO_bootstrap;
icculus@7981
    59
extern AudioBootStrap HAIKUAUDIO_bootstrap;
icculus@2049
    60
extern AudioBootStrap COREAUDIO_bootstrap;
icculus@2049
    61
extern AudioBootStrap SNDMGR_bootstrap;
icculus@2049
    62
extern AudioBootStrap DISKAUD_bootstrap;
icculus@2049
    63
extern AudioBootStrap DUMMYAUD_bootstrap;
icculus@2049
    64
extern AudioBootStrap DCAUD_bootstrap;
icculus@2049
    65
extern AudioBootStrap DART_bootstrap;
slouken@2735
    66
extern AudioBootStrap NDSAUD_bootstrap;
slouken@2947
    67
extern AudioBootStrap FUSIONSOUND_bootstrap;
paul@4718
    68
extern AudioBootStrap ANDROIDAUD_bootstrap;
kimonline@7009
    69
extern AudioBootStrap PSPAUD_bootstrap;
icculus@7367
    70
extern AudioBootStrap SNDIO_bootstrap;
icculus@1190
    71
slouken@0
    72
/* Available audio drivers */
slouken@3162
    73
static const AudioBootStrap *const bootstrap[] = {
icculus@2939
    74
#if SDL_AUDIO_DRIVER_PULSEAUDIO
icculus@2939
    75
    &PULSEAUDIO_bootstrap,
slouken@0
    76
#endif
slouken@1361
    77
#if SDL_AUDIO_DRIVER_ALSA
slouken@1895
    78
    &ALSA_bootstrap,
slouken@0
    79
#endif
icculus@7367
    80
#if SDL_AUDIO_DRIVER_SNDIO
icculus@7367
    81
    &SNDIO_bootstrap,
icculus@7367
    82
#endif
slouken@4548
    83
#if SDL_AUDIO_DRIVER_BSD
slouken@4548
    84
    &BSD_AUDIO_bootstrap,
slouken@4548
    85
#endif
icculus@2939
    86
#if SDL_AUDIO_DRIVER_OSS
icculus@2939
    87
    &DSP_bootstrap,
icculus@2271
    88
#endif
slouken@3099
    89
#if SDL_AUDIO_DRIVER_QSA
slouken@3099
    90
    &QSAAUDIO_bootstrap,
slouken@663
    91
#endif
slouken@1361
    92
#if SDL_AUDIO_DRIVER_SUNAUDIO
slouken@1895
    93
    &SUNAUDIO_bootstrap,
slouken@148
    94
#endif
slouken@1361
    95
#if SDL_AUDIO_DRIVER_ARTS
slouken@1895
    96
    &ARTS_bootstrap,
slouken@0
    97
#endif
slouken@1361
    98
#if SDL_AUDIO_DRIVER_ESD
slouken@1895
    99
    &ESD_bootstrap,
slouken@0
   100
#endif
slouken@1361
   101
#if SDL_AUDIO_DRIVER_NAS
slouken@1895
   102
    &NAS_bootstrap,
slouken@0
   103
#endif
icculus@5592
   104
#if SDL_AUDIO_DRIVER_XAUDIO2
icculus@5592
   105
    &XAUDIO2_bootstrap,
icculus@5592
   106
#endif
slouken@1361
   107
#if SDL_AUDIO_DRIVER_DSOUND
slouken@1895
   108
    &DSOUND_bootstrap,
slouken@0
   109
#endif
icculus@5588
   110
#if SDL_AUDIO_DRIVER_WINMM
icculus@5588
   111
    &WINMM_bootstrap,
slouken@0
   112
#endif
icculus@2049
   113
#if SDL_AUDIO_DRIVER_PAUDIO
icculus@2049
   114
    &PAUDIO_bootstrap,
slouken@1361
   115
#endif
icculus@7981
   116
#if SDL_AUDIO_DRIVER_HAIKU
icculus@7981
   117
    &HAIKUAUDIO_bootstrap,
slouken@0
   118
#endif
slouken@1361
   119
#if SDL_AUDIO_DRIVER_COREAUDIO
slouken@1895
   120
    &COREAUDIO_bootstrap,
slouken@935
   121
#endif
slouken@1361
   122
#if SDL_AUDIO_DRIVER_DISK
slouken@1895
   123
    &DISKAUD_bootstrap,
slouken@68
   124
#endif
icculus@1532
   125
#if SDL_AUDIO_DRIVER_DUMMY
slouken@1895
   126
    &DUMMYAUD_bootstrap,
icculus@1532
   127
#endif
slouken@2947
   128
#if SDL_AUDIO_DRIVER_FUSIONSOUND
slouken@2947
   129
    &FUSIONSOUND_bootstrap,
slouken@2947
   130
#endif
paul@4718
   131
#if SDL_AUDIO_DRIVER_ANDROID
paul@4718
   132
    &ANDROIDAUD_bootstrap,
paul@4718
   133
#endif
kimonline@7009
   134
#if SDL_AUDIO_DRIVER_PSP
kimonline@7009
   135
    &PSPAUD_bootstrap,
kimonline@7009
   136
#endif
slouken@1895
   137
    NULL
slouken@0
   138
};
icculus@2049
   139
slouken@2060
   140
static SDL_AudioDevice *
slouken@2060
   141
get_audio_device(SDL_AudioDeviceID id)
icculus@2049
   142
{
icculus@2049
   143
    id--;
slouken@2060
   144
    if ((id >= SDL_arraysize(open_devices)) || (open_devices[id] == NULL)) {
icculus@2049
   145
        SDL_SetError("Invalid audio device ID");
icculus@2049
   146
        return NULL;
icculus@2049
   147
    }
icculus@2049
   148
icculus@2049
   149
    return open_devices[id];
icculus@2049
   150
}
icculus@2049
   151
icculus@2049
   152
icculus@2049
   153
/* stubs for audio drivers that don't need a specific entry point... */
icculus@5593
   154
static void
icculus@5593
   155
SDL_AudioDetectDevices_Default(int iscapture, SDL_AddAudioDevice addfn)
icculus@5593
   156
{                               /* no-op. */
slouken@2060
   157
}
slouken@2735
   158
slouken@2060
   159
static void
slouken@2060
   160
SDL_AudioThreadInit_Default(_THIS)
slouken@2060
   161
{                               /* no-op. */
slouken@2060
   162
}
slouken@2735
   163
slouken@2060
   164
static void
slouken@2060
   165
SDL_AudioWaitDevice_Default(_THIS)
slouken@2060
   166
{                               /* no-op. */
slouken@2060
   167
}
slouken@2735
   168
slouken@2060
   169
static void
slouken@2060
   170
SDL_AudioPlayDevice_Default(_THIS)
slouken@2060
   171
{                               /* no-op. */
slouken@2060
   172
}
slouken@2735
   173
slouken@2060
   174
static Uint8 *
slouken@2060
   175
SDL_AudioGetDeviceBuf_Default(_THIS)
slouken@2060
   176
{
slouken@2060
   177
    return NULL;
slouken@2060
   178
}
slouken@2735
   179
slouken@2060
   180
static void
slouken@2060
   181
SDL_AudioWaitDone_Default(_THIS)
slouken@2060
   182
{                               /* no-op. */
slouken@2060
   183
}
slouken@2735
   184
slouken@2060
   185
static void
slouken@2060
   186
SDL_AudioCloseDevice_Default(_THIS)
slouken@2060
   187
{                               /* no-op. */
slouken@2060
   188
}
slouken@2735
   189
slouken@2060
   190
static void
slouken@2060
   191
SDL_AudioDeinitialize_Default(void)
slouken@2060
   192
{                               /* no-op. */
slouken@2060
   193
}
icculus@2049
   194
icculus@2049
   195
static int
icculus@2049
   196
SDL_AudioOpenDevice_Default(_THIS, const char *devname, int iscapture)
icculus@2049
   197
{
icculus@7038
   198
    return -1;
icculus@2049
   199
}
icculus@2049
   200
icculus@2049
   201
static void
icculus@2049
   202
SDL_AudioLockDevice_Default(SDL_AudioDevice * device)
icculus@2049
   203
{
icculus@2049
   204
    if (device->thread && (SDL_ThreadID() == device->threadid)) {
icculus@2049
   205
        return;
icculus@2049
   206
    }
slouken@6977
   207
    SDL_LockMutex(device->mixer_lock);
icculus@2049
   208
}
icculus@2049
   209
icculus@2049
   210
static void
icculus@2049
   211
SDL_AudioUnlockDevice_Default(SDL_AudioDevice * device)
icculus@2049
   212
{
icculus@2049
   213
    if (device->thread && (SDL_ThreadID() == device->threadid)) {
icculus@2049
   214
        return;
icculus@2049
   215
    }
slouken@6977
   216
    SDL_UnlockMutex(device->mixer_lock);
icculus@2049
   217
}
icculus@2049
   218
slouken@0
   219
slouken@2060
   220
static void
slouken@2060
   221
finalize_audio_entry_points(void)
icculus@2049
   222
{
icculus@2049
   223
    /*
icculus@2049
   224
     * Fill in stub functions for unused driver entry points. This lets us
icculus@2049
   225
     *  blindly call them without having to check for validity first.
icculus@2049
   226
     */
icculus@2049
   227
slouken@2060
   228
#define FILL_STUB(x) \
icculus@2049
   229
        if (current_audio.impl.x == NULL) { \
icculus@2049
   230
            current_audio.impl.x = SDL_Audio##x##_Default; \
icculus@2049
   231
        }
icculus@2049
   232
    FILL_STUB(DetectDevices);
icculus@2049
   233
    FILL_STUB(OpenDevice);
icculus@2049
   234
    FILL_STUB(ThreadInit);
icculus@2049
   235
    FILL_STUB(WaitDevice);
icculus@2049
   236
    FILL_STUB(PlayDevice);
icculus@2049
   237
    FILL_STUB(GetDeviceBuf);
icculus@2049
   238
    FILL_STUB(WaitDone);
icculus@2049
   239
    FILL_STUB(CloseDevice);
icculus@2049
   240
    FILL_STUB(LockDevice);
icculus@2049
   241
    FILL_STUB(UnlockDevice);
icculus@2049
   242
    FILL_STUB(Deinitialize);
slouken@2060
   243
#undef FILL_STUB
icculus@2049
   244
}
icculus@2049
   245
icculus@8660
   246
#if 0  /* !!! FIXME: rewrite/remove this streamer code. */
slouken@2716
   247
/* Streaming functions (for when the input and output buffer sizes are different) */
slouken@2716
   248
/* Write [length] bytes from buf into the streamer */
slouken@4472
   249
static void
slouken@2716
   250
SDL_StreamWrite(SDL_AudioStreamer * stream, Uint8 * buf, int length)
slouken@2716
   251
{
slouken@2716
   252
    int i;
slouken@2716
   253
slouken@2716
   254
    for (i = 0; i < length; ++i) {
slouken@2716
   255
        stream->buffer[stream->write_pos] = buf[i];
slouken@2716
   256
        ++stream->write_pos;
slouken@2716
   257
    }
slouken@2716
   258
}
slouken@2716
   259
slouken@2716
   260
/* Read [length] bytes out of the streamer into buf */
slouken@4472
   261
static void
slouken@2716
   262
SDL_StreamRead(SDL_AudioStreamer * stream, Uint8 * buf, int length)
slouken@2716
   263
{
slouken@2716
   264
    int i;
slouken@2716
   265
slouken@2716
   266
    for (i = 0; i < length; ++i) {
slouken@2716
   267
        buf[i] = stream->buffer[stream->read_pos];
slouken@2716
   268
        ++stream->read_pos;
slouken@2716
   269
    }
slouken@2716
   270
}
slouken@2716
   271
slouken@4472
   272
static int
slouken@2716
   273
SDL_StreamLength(SDL_AudioStreamer * stream)
slouken@2716
   274
{
slouken@2716
   275
    return (stream->write_pos - stream->read_pos) % stream->max_len;
slouken@2716
   276
}
slouken@2716
   277
slouken@2716
   278
/* Initialize the stream by allocating the buffer and setting the read/write heads to the beginning */
slouken@4507
   279
#if 0
slouken@4472
   280
static int
slouken@2716
   281
SDL_StreamInit(SDL_AudioStreamer * stream, int max_len, Uint8 silence)
slouken@2716
   282
{
slouken@2716
   283
    /* First try to allocate the buffer */
slouken@2728
   284
    stream->buffer = (Uint8 *) SDL_malloc(max_len);
slouken@2716
   285
    if (stream->buffer == NULL) {
slouken@2716
   286
        return -1;
slouken@2716
   287
    }
slouken@2716
   288
slouken@2716
   289
    stream->max_len = max_len;
slouken@2716
   290
    stream->read_pos = 0;
slouken@2716
   291
    stream->write_pos = 0;
slouken@2716
   292
slouken@2716
   293
    /* Zero out the buffer */
slouken@2728
   294
    SDL_memset(stream->buffer, silence, max_len);
slouken@2728
   295
slouken@2728
   296
    return 0;
slouken@2716
   297
}
slouken@4507
   298
#endif
slouken@2716
   299
slouken@2716
   300
/* Deinitialize the stream simply by freeing the buffer */
slouken@4472
   301
static void
slouken@2716
   302
SDL_StreamDeinit(SDL_AudioStreamer * stream)
slouken@2716
   303
{
slouken@7719
   304
    SDL_free(stream->buffer);
slouken@2716
   305
}
icculus@8660
   306
#endif
slouken@2716
   307
dimitris@8761
   308
#if defined(__ANDROID__)
paul@4722
   309
#include <android/log.h>
aschiffler@4865
   310
#endif
paul@4722
   311
slouken@0
   312
/* The general mixing thread function */
slouken@1895
   313
int SDLCALL
icculus@2049
   314
SDL_RunAudio(void *devicep)
slouken@0
   315
{
icculus@2049
   316
    SDL_AudioDevice *device = (SDL_AudioDevice *) devicep;
slouken@1895
   317
    Uint8 *stream;
slouken@1895
   318
    int stream_len;
slouken@1895
   319
    void *udata;
slouken@1895
   320
    void (SDLCALL * fill) (void *userdata, Uint8 * stream, int len);
slouken@3336
   321
    Uint32 delay;
icculus@8660
   322
icculus@8660
   323
#if 0  /* !!! FIXME: rewrite/remove this streamer code. */
airlangga@5526
   324
    /* For streaming when the buffer sizes don't match up */
airlangga@5526
   325
    Uint8 *istream;
airlangga@5526
   326
    int istream_len = 0;
icculus@8660
   327
#endif
slouken@2716
   328
slouken@5509
   329
    /* The audio mixing is always a high priority thread */
slouken@5509
   330
    SDL_SetThreadPriority(SDL_THREAD_PRIORITY_HIGH);
slouken@5509
   331
slouken@1895
   332
    /* Perform any thread setup */
icculus@2049
   333
    device->threadid = SDL_ThreadID();
icculus@2049
   334
    current_audio.impl.ThreadInit(device);
slouken@0
   335
slouken@1895
   336
    /* Set up the mixing function */
icculus@2049
   337
    fill = device->spec.callback;
icculus@2049
   338
    udata = device->spec.userdata;
slouken@21
   339
slouken@2716
   340
    /* By default do not stream */
slouken@2716
   341
    device->use_streamer = 0;
slouken@2716
   342
icculus@2049
   343
    if (device->convert.needed) {
slouken@3040
   344
#if 0                           /* !!! FIXME: I took len_div out of the structure. Use rate_incr instead? */
slouken@2716
   345
        /* If the result of the conversion alters the length, i.e. resampling is being used, use the streamer */
slouken@2716
   346
        if (device->convert.len_mult != 1 || device->convert.len_div != 1) {
slouken@2716
   347
            /* The streamer's maximum length should be twice whichever is larger: spec.size or len_cvt */
slouken@2716
   348
            stream_max_len = 2 * device->spec.size;
slouken@2716
   349
            if (device->convert.len_mult > device->convert.len_div) {
slouken@2716
   350
                stream_max_len *= device->convert.len_mult;
slouken@2716
   351
                stream_max_len /= device->convert.len_div;
slouken@2716
   352
            }
slouken@2716
   353
            if (SDL_StreamInit(&device->streamer, stream_max_len, silence) <
slouken@2716
   354
                0)
slouken@2716
   355
                return -1;
slouken@2716
   356
            device->use_streamer = 1;
slouken@2716
   357
slouken@2716
   358
            /* istream_len should be the length of what we grab from the callback and feed to conversion,
slouken@2716
   359
               so that we get close to spec_size. I.e. we want device.spec_size = istream_len * u / d
slouken@2716
   360
             */
slouken@2716
   361
            istream_len =
slouken@2716
   362
                device->spec.size * device->convert.len_div /
slouken@2716
   363
                device->convert.len_mult;
slouken@2716
   364
        }
icculus@3021
   365
#endif
slouken@7518
   366
        stream_len = device->convert.len;
slouken@1895
   367
    } else {
icculus@2049
   368
        stream_len = device->spec.size;
slouken@1895
   369
    }
icculus@1561
   370
slouken@3336
   371
    /* Calculate the delay while paused */
slouken@3336
   372
    delay = ((device->spec.samples * 1000) / device->spec.freq);
slouken@3336
   373
slouken@2716
   374
    /* Determine if the streamer is necessary here */
icculus@8658
   375
#if 0  /* !!! FIXME: rewrite/remove this streamer code. */
slouken@2716
   376
    if (device->use_streamer == 1) {
slouken@3336
   377
        /* This code is almost the same as the old code. The difference is, instead of reading
slouken@2716
   378
           directly from the callback into "stream", then converting and sending the audio off,
slouken@2716
   379
           we go: callback -> "istream" -> (conversion) -> streamer -> stream -> device.
slouken@2716
   380
           However, reading and writing with streamer are done separately:
slouken@2716
   381
           - We only call the callback and write to the streamer when the streamer does not
slouken@2716
   382
           contain enough samples to output to the device.
slouken@2716
   383
           - We only read from the streamer and tell the device to play when the streamer
slouken@2716
   384
           does have enough samples to output.
slouken@2716
   385
           This allows us to perform resampling in the conversion step, where the output of the
slouken@2716
   386
           resampling process can be any number. We will have to see what a good size for the
slouken@2716
   387
           stream's maximum length is, but I suspect 2*max(len_cvt, stream_len) is a good figure.
slouken@2716
   388
         */
slouken@2716
   389
        while (device->enabled) {
slouken@3336
   390
slouken@3336
   391
            if (device->paused) {
slouken@3336
   392
                SDL_Delay(delay);
slouken@3336
   393
                continue;
slouken@3336
   394
            }
slouken@3336
   395
slouken@2716
   396
            /* Only read in audio if the streamer doesn't have enough already (if it does not have enough samples to output) */
slouken@2716
   397
            if (SDL_StreamLength(&device->streamer) < stream_len) {
slouken@2716
   398
                /* Set up istream */
slouken@2716
   399
                if (device->convert.needed) {
slouken@2716
   400
                    if (device->convert.buf) {
slouken@2716
   401
                        istream = device->convert.buf;
slouken@2716
   402
                    } else {
slouken@2716
   403
                        continue;
slouken@2716
   404
                    }
slouken@2716
   405
                } else {
slouken@3336
   406
/* FIXME: Ryan, this is probably wrong.  I imagine we don't want to get
slouken@3336
   407
 * a device buffer both here and below in the stream output.
slouken@3336
   408
 */
slouken@2716
   409
                    istream = current_audio.impl.GetDeviceBuf(device);
slouken@2716
   410
                    if (istream == NULL) {
slouken@2716
   411
                        istream = device->fake_stream;
slouken@2716
   412
                    }
slouken@2716
   413
                }
slouken@0
   414
slouken@2716
   415
                /* Read from the callback into the _input_ stream */
slouken@6977
   416
                SDL_LockMutex(device->mixer_lock);
slouken@3336
   417
                (*fill) (udata, istream, istream_len);
slouken@6977
   418
                SDL_UnlockMutex(device->mixer_lock);
slouken@2716
   419
slouken@2716
   420
                /* Convert the audio if necessary and write to the streamer */
slouken@2716
   421
                if (device->convert.needed) {
slouken@2716
   422
                    SDL_ConvertAudio(&device->convert);
slouken@2716
   423
                    if (istream == NULL) {
slouken@2716
   424
                        istream = device->fake_stream;
slouken@2716
   425
                    }
gabomdq@7678
   426
                    /* SDL_memcpy(istream, device->convert.buf, device->convert.len_cvt); */
slouken@2716
   427
                    SDL_StreamWrite(&device->streamer, device->convert.buf,
slouken@2716
   428
                                    device->convert.len_cvt);
slouken@2716
   429
                } else {
slouken@2716
   430
                    SDL_StreamWrite(&device->streamer, istream, istream_len);
slouken@2716
   431
                }
slouken@1895
   432
            }
slouken@2716
   433
slouken@2716
   434
            /* Only output audio if the streamer has enough to output */
slouken@2716
   435
            if (SDL_StreamLength(&device->streamer) >= stream_len) {
slouken@2716
   436
                /* Set up the output stream */
slouken@2716
   437
                if (device->convert.needed) {
slouken@2716
   438
                    if (device->convert.buf) {
slouken@2716
   439
                        stream = device->convert.buf;
slouken@2716
   440
                    } else {
slouken@2716
   441
                        continue;
slouken@2716
   442
                    }
slouken@2716
   443
                } else {
slouken@2716
   444
                    stream = current_audio.impl.GetDeviceBuf(device);
slouken@2716
   445
                    if (stream == NULL) {
slouken@2716
   446
                        stream = device->fake_stream;
slouken@2716
   447
                    }
slouken@2716
   448
                }
slouken@2716
   449
slouken@2716
   450
                /* Now read from the streamer */
slouken@2716
   451
                SDL_StreamRead(&device->streamer, stream, stream_len);
slouken@2716
   452
slouken@2716
   453
                /* Ready current buffer for play and change current buffer */
slouken@3336
   454
                if (stream != device->fake_stream) {
slouken@2716
   455
                    current_audio.impl.PlayDevice(device);
slouken@3096
   456
                    /* Wait for an audio buffer to become available */
slouken@3096
   457
                    current_audio.impl.WaitDevice(device);
slouken@2716
   458
                } else {
slouken@3336
   459
                    SDL_Delay(delay);
slouken@2716
   460
                }
slouken@1895
   461
            }
slouken@0
   462
slouken@1895
   463
        }
icculus@8660
   464
    } else
icculus@8658
   465
#endif
icculus@8660
   466
    {
slouken@2716
   467
        /* Otherwise, do not use the streamer. This is the old code. */
icculus@7406
   468
        const int silence = (int) device->spec.silence;
slouken@0
   469
slouken@2716
   470
        /* Loop, filling the audio buffers */
slouken@2716
   471
        while (device->enabled) {
slouken@2716
   472
slouken@2716
   473
            /* Fill the current buffer with sound */
slouken@2716
   474
            if (device->convert.needed) {
slouken@2716
   475
                if (device->convert.buf) {
slouken@2716
   476
                    stream = device->convert.buf;
slouken@2716
   477
                } else {
slouken@2716
   478
                    continue;
slouken@2716
   479
                }
slouken@2716
   480
            } else {
slouken@2716
   481
                stream = current_audio.impl.GetDeviceBuf(device);
slouken@2716
   482
                if (stream == NULL) {
slouken@2716
   483
                    stream = device->fake_stream;
slouken@2716
   484
                }
slouken@1895
   485
            }
slouken@0
   486
icculus@7447
   487
            SDL_LockMutex(device->mixer_lock);
icculus@7406
   488
            if (device->paused) {
icculus@7406
   489
                SDL_memset(stream, silence, stream_len);
icculus@7406
   490
            } else {
icculus@7406
   491
                (*fill) (udata, stream, stream_len);
icculus@7406
   492
            }
icculus@7447
   493
            SDL_UnlockMutex(device->mixer_lock);
slouken@1562
   494
slouken@2716
   495
            /* Convert the audio if necessary */
slouken@2716
   496
            if (device->convert.needed) {
slouken@2716
   497
                SDL_ConvertAudio(&device->convert);
slouken@2716
   498
                stream = current_audio.impl.GetDeviceBuf(device);
slouken@2716
   499
                if (stream == NULL) {
slouken@2716
   500
                    stream = device->fake_stream;
slouken@2716
   501
                }
slouken@2716
   502
                SDL_memcpy(stream, device->convert.buf,
slouken@2716
   503
                           device->convert.len_cvt);
slouken@2716
   504
            }
slouken@2716
   505
slouken@2716
   506
            /* Ready current buffer for play and change current buffer */
slouken@3336
   507
            if (stream != device->fake_stream) {
slouken@2716
   508
                current_audio.impl.PlayDevice(device);
slouken@3096
   509
                /* Wait for an audio buffer to become available */
slouken@3096
   510
                current_audio.impl.WaitDevice(device);
slouken@2716
   511
            } else {
slouken@3336
   512
                SDL_Delay(delay);
slouken@2716
   513
            }
slouken@1895
   514
        }
slouken@1895
   515
    }
slouken@1562
   516
slouken@1895
   517
    /* Wait for the audio to drain.. */
icculus@2049
   518
    current_audio.impl.WaitDone(device);
slouken@21
   519
slouken@2716
   520
    /* If necessary, deinit the streamer */
icculus@8658
   521
#if 0  /* !!! FIXME: rewrite/remove this streamer code. */
slouken@2716
   522
    if (device->use_streamer == 1)
slouken@2716
   523
        SDL_StreamDeinit(&device->streamer);
icculus@8658
   524
#endif
slouken@2716
   525
slouken@1895
   526
    return (0);
slouken@0
   527
}
slouken@0
   528
slouken@322
   529
icculus@1982
   530
static SDL_AudioFormat
slouken@1895
   531
SDL_ParseAudioFormat(const char *string)
slouken@1794
   532
{
icculus@2076
   533
#define CHECK_FMT_STRING(x) if (SDL_strcmp(string, #x) == 0) return AUDIO_##x
icculus@2049
   534
    CHECK_FMT_STRING(U8);
icculus@2049
   535
    CHECK_FMT_STRING(S8);
icculus@2049
   536
    CHECK_FMT_STRING(U16LSB);
icculus@2049
   537
    CHECK_FMT_STRING(S16LSB);
icculus@2049
   538
    CHECK_FMT_STRING(U16MSB);
icculus@2049
   539
    CHECK_FMT_STRING(S16MSB);
icculus@2049
   540
    CHECK_FMT_STRING(U16SYS);
icculus@2049
   541
    CHECK_FMT_STRING(S16SYS);
icculus@2049
   542
    CHECK_FMT_STRING(U16);
icculus@2049
   543
    CHECK_FMT_STRING(S16);
icculus@2049
   544
    CHECK_FMT_STRING(S32LSB);
icculus@2049
   545
    CHECK_FMT_STRING(S32MSB);
icculus@2049
   546
    CHECK_FMT_STRING(S32SYS);
icculus@2049
   547
    CHECK_FMT_STRING(S32);
icculus@2049
   548
    CHECK_FMT_STRING(F32LSB);
icculus@2049
   549
    CHECK_FMT_STRING(F32MSB);
icculus@2049
   550
    CHECK_FMT_STRING(F32SYS);
icculus@2049
   551
    CHECK_FMT_STRING(F32);
slouken@2060
   552
#undef CHECK_FMT_STRING
icculus@2049
   553
    return 0;
slouken@1895
   554
}
slouken@1895
   555
slouken@1895
   556
int
slouken@1895
   557
SDL_GetNumAudioDrivers(void)
slouken@1895
   558
{
slouken@1895
   559
    return (SDL_arraysize(bootstrap) - 1);
slouken@1895
   560
}
slouken@1895
   561
slouken@1895
   562
const char *
slouken@1895
   563
SDL_GetAudioDriver(int index)
slouken@1895
   564
{
slouken@1895
   565
    if (index >= 0 && index < SDL_GetNumAudioDrivers()) {
slouken@1895
   566
        return (bootstrap[index]->name);
slouken@1895
   567
    }
slouken@1895
   568
    return (NULL);
slouken@1794
   569
}
slouken@1794
   570
slouken@1895
   571
int
slouken@1895
   572
SDL_AudioInit(const char *driver_name)
slouken@0
   573
{
icculus@2049
   574
    int i = 0;
icculus@2049
   575
    int initialized = 0;
icculus@2049
   576
    int tried_to_init = 0;
slouken@0
   577
icculus@2049
   578
    if (SDL_WasInit(SDL_INIT_AUDIO)) {
slouken@2060
   579
        SDL_AudioQuit();        /* shutdown driver if already running. */
slouken@1895
   580
    }
slouken@0
   581
slouken@2060
   582
    SDL_memset(&current_audio, '\0', sizeof(current_audio));
slouken@2060
   583
    SDL_memset(open_devices, '\0', sizeof(open_devices));
icculus@2049
   584
slouken@1895
   585
    /* Select the proper audio driver */
slouken@1909
   586
    if (driver_name == NULL) {
slouken@1909
   587
        driver_name = SDL_getenv("SDL_AUDIODRIVER");
slouken@1909
   588
    }
icculus@2049
   589
icculus@2049
   590
    for (i = 0; (!initialized) && (bootstrap[i]); ++i) {
icculus@2049
   591
        /* make sure we should even try this driver before doing so... */
icculus@2049
   592
        const AudioBootStrap *backend = bootstrap[i];
slouken@6900
   593
        if ((driver_name && (SDL_strncasecmp(backend->name, driver_name, SDL_strlen(driver_name)) != 0)) ||
slouken@6900
   594
            (!driver_name && backend->demand_only)) {
icculus@2049
   595
            continue;
icculus@2049
   596
        }
slouken@0
   597
icculus@2049
   598
        tried_to_init = 1;
slouken@2060
   599
        SDL_memset(&current_audio, 0, sizeof(current_audio));
icculus@2049
   600
        current_audio.name = backend->name;
icculus@2049
   601
        current_audio.desc = backend->desc;
icculus@3699
   602
        initialized = backend->init(&current_audio.impl);
slouken@1895
   603
    }
icculus@2049
   604
icculus@2049
   605
    if (!initialized) {
icculus@2049
   606
        /* specific drivers will set the error message if they fail... */
icculus@2049
   607
        if (!tried_to_init) {
slouken@1895
   608
            if (driver_name) {
icculus@3699
   609
                SDL_SetError("Audio target '%s' not available", driver_name);
slouken@1895
   610
            } else {
slouken@1895
   611
                SDL_SetError("No available audio device");
slouken@1895
   612
            }
slouken@1895
   613
        }
icculus@2049
   614
slouken@2060
   615
        SDL_memset(&current_audio, 0, sizeof(current_audio));
slouken@2060
   616
        return (-1);            /* No driver was available, so fail. */
slouken@1895
   617
    }
icculus@2049
   618
icculus@2049
   619
    finalize_audio_entry_points();
icculus@2049
   620
slouken@1895
   621
    return (0);
slouken@0
   622
}
slouken@0
   623
slouken@1895
   624
/*
slouken@1895
   625
 * Get the current audio driver name
slouken@1895
   626
 */
slouken@1895
   627
const char *
slouken@1895
   628
SDL_GetCurrentAudioDriver()
slouken@0
   629
{
icculus@2049
   630
    return current_audio.name;
slouken@0
   631
}
slouken@0
   632
icculus@5593
   633
static void
icculus@5593
   634
free_device_list(char ***devices, int *devCount)
icculus@5593
   635
{
icculus@5593
   636
    int i = *devCount;
icculus@5593
   637
    if ((i > 0) && (*devices != NULL)) {
icculus@5593
   638
        while (i--) {
icculus@5593
   639
            SDL_free((*devices)[i]);
icculus@5593
   640
        }
icculus@5593
   641
    }
icculus@5593
   642
slouken@7719
   643
    SDL_free(*devices);
icculus@5593
   644
icculus@5593
   645
    *devices = NULL;
icculus@5593
   646
    *devCount = 0;
icculus@5593
   647
}
icculus@5593
   648
icculus@5593
   649
static
icculus@5593
   650
void SDL_AddCaptureAudioDevice(const char *_name)
icculus@5593
   651
{
icculus@5593
   652
    char *name = NULL;
icculus@5593
   653
    void *ptr = SDL_realloc(current_audio.inputDevices,
icculus@5593
   654
                          (current_audio.inputDeviceCount+1) * sizeof(char*));
icculus@5593
   655
    if (ptr == NULL) {
icculus@5593
   656
        return;  /* oh well. */
icculus@5593
   657
    }
icculus@5593
   658
icculus@5593
   659
    current_audio.inputDevices = (char **) ptr;
icculus@5593
   660
    name = SDL_strdup(_name);  /* if this returns NULL, that's okay. */
icculus@5593
   661
    current_audio.inputDevices[current_audio.inputDeviceCount++] = name;
icculus@5593
   662
}
icculus@5593
   663
icculus@5593
   664
static
icculus@5593
   665
void SDL_AddOutputAudioDevice(const char *_name)
icculus@5593
   666
{
icculus@5593
   667
    char *name = NULL;
icculus@5593
   668
    void *ptr = SDL_realloc(current_audio.outputDevices,
icculus@5593
   669
                          (current_audio.outputDeviceCount+1) * sizeof(char*));
icculus@5593
   670
    if (ptr == NULL) {
icculus@5593
   671
        return;  /* oh well. */
icculus@5593
   672
    }
icculus@5593
   673
icculus@5593
   674
    current_audio.outputDevices = (char **) ptr;
icculus@5593
   675
    name = SDL_strdup(_name);  /* if this returns NULL, that's okay. */
icculus@5593
   676
    current_audio.outputDevices[current_audio.outputDeviceCount++] = name;
icculus@5593
   677
}
icculus@5593
   678
icculus@2049
   679
slouken@1895
   680
int
icculus@2049
   681
SDL_GetNumAudioDevices(int iscapture)
slouken@0
   682
{
icculus@5593
   683
    int retval = 0;
icculus@5593
   684
icculus@2049
   685
    if (!SDL_WasInit(SDL_INIT_AUDIO)) {
icculus@2049
   686
        return -1;
icculus@2049
   687
    }
icculus@5593
   688
icculus@2049
   689
    if ((iscapture) && (!current_audio.impl.HasCaptureSupport)) {
icculus@2049
   690
        return 0;
icculus@2049
   691
    }
icculus@2049
   692
icculus@2049
   693
    if ((iscapture) && (current_audio.impl.OnlyHasDefaultInputDevice)) {
icculus@2049
   694
        return 1;
icculus@2049
   695
    }
icculus@2049
   696
icculus@2049
   697
    if ((!iscapture) && (current_audio.impl.OnlyHasDefaultOutputDevice)) {
icculus@2049
   698
        return 1;
icculus@2049
   699
    }
icculus@2049
   700
icculus@5593
   701
    if (iscapture) {
icculus@5593
   702
        free_device_list(&current_audio.inputDevices,
icculus@5593
   703
                         &current_audio.inputDeviceCount);
icculus@5593
   704
        current_audio.impl.DetectDevices(iscapture, SDL_AddCaptureAudioDevice);
icculus@5593
   705
        retval = current_audio.inputDeviceCount;
icculus@5593
   706
    } else {
icculus@5593
   707
        free_device_list(&current_audio.outputDevices,
icculus@5593
   708
                         &current_audio.outputDeviceCount);
icculus@5593
   709
        current_audio.impl.DetectDevices(iscapture, SDL_AddOutputAudioDevice);
icculus@5593
   710
        retval = current_audio.outputDeviceCount;
icculus@5593
   711
    }
icculus@5593
   712
icculus@5593
   713
    return retval;
icculus@2049
   714
}
icculus@2049
   715
slouken@0
   716
icculus@2049
   717
const char *
icculus@2049
   718
SDL_GetAudioDeviceName(int index, int iscapture)
icculus@2049
   719
{
icculus@2049
   720
    if (!SDL_WasInit(SDL_INIT_AUDIO)) {
icculus@2049
   721
        SDL_SetError("Audio subsystem is not initialized");
icculus@2049
   722
        return NULL;
icculus@2049
   723
    }
icculus@2049
   724
icculus@2049
   725
    if ((iscapture) && (!current_audio.impl.HasCaptureSupport)) {
icculus@2049
   726
        SDL_SetError("No capture support");
icculus@2049
   727
        return NULL;
slouken@1895
   728
    }
icculus@2049
   729
icculus@2049
   730
    if (index < 0) {
icculus@5593
   731
        goto no_such_device;
icculus@2049
   732
    }
slouken@0
   733
icculus@2049
   734
    if ((iscapture) && (current_audio.impl.OnlyHasDefaultInputDevice)) {
slouken@7904
   735
        if (index > 0) {
slouken@7904
   736
            goto no_such_device;
slouken@7904
   737
        }
icculus@2049
   738
        return DEFAULT_INPUT_DEVNAME;
icculus@2049
   739
    }
icculus@2049
   740
icculus@2049
   741
    if ((!iscapture) && (current_audio.impl.OnlyHasDefaultOutputDevice)) {
slouken@7904
   742
        if (index > 0) {
slouken@7904
   743
            goto no_such_device;
slouken@7904
   744
        }
icculus@2049
   745
        return DEFAULT_OUTPUT_DEVNAME;
slouken@1895
   746
    }
slouken@262
   747
icculus@5593
   748
    if (iscapture) {
icculus@5593
   749
        if (index >= current_audio.inputDeviceCount) {
icculus@5593
   750
            goto no_such_device;
icculus@5593
   751
        }
icculus@5593
   752
        return current_audio.inputDevices[index];
icculus@5593
   753
    } else {
icculus@5593
   754
        if (index >= current_audio.outputDeviceCount) {
icculus@5593
   755
            goto no_such_device;
icculus@5593
   756
        }
icculus@5593
   757
        return current_audio.outputDevices[index];
icculus@5593
   758
    }
icculus@5593
   759
icculus@5593
   760
no_such_device:
icculus@5593
   761
    SDL_SetError("No such device");
icculus@5593
   762
    return NULL;
icculus@2049
   763
}
icculus@2049
   764
icculus@2049
   765
icculus@2049
   766
static void
slouken@2060
   767
close_audio_device(SDL_AudioDevice * device)
icculus@2049
   768
{
icculus@2049
   769
    device->enabled = 0;
icculus@2049
   770
    if (device->thread != NULL) {
icculus@2049
   771
        SDL_WaitThread(device->thread, NULL);
icculus@2049
   772
    }
icculus@2049
   773
    if (device->mixer_lock != NULL) {
icculus@2049
   774
        SDL_DestroyMutex(device->mixer_lock);
icculus@2049
   775
    }
slouken@7719
   776
    SDL_FreeAudioMem(device->fake_stream);
icculus@2049
   777
    if (device->convert.needed) {
icculus@2049
   778
        SDL_FreeAudioMem(device->convert.buf);
icculus@2049
   779
    }
icculus@2049
   780
    if (device->opened) {
icculus@2049
   781
        current_audio.impl.CloseDevice(device);
icculus@2049
   782
        device->opened = 0;
icculus@2049
   783
    }
icculus@2049
   784
    SDL_FreeAudioMem(device);
icculus@2049
   785
}
icculus@2049
   786
icculus@2049
   787
icculus@2049
   788
/*
icculus@2049
   789
 * Sanity check desired AudioSpec for SDL_OpenAudio() in (orig).
icculus@2049
   790
 *  Fills in a sanitized copy in (prepared).
icculus@2049
   791
 *  Returns non-zero if okay, zero on fatal parameters in (orig).
icculus@2049
   792
 */
icculus@2049
   793
static int
slouken@2060
   794
prepare_audiospec(const SDL_AudioSpec * orig, SDL_AudioSpec * prepared)
icculus@2049
   795
{
slouken@2060
   796
    SDL_memcpy(prepared, orig, sizeof(SDL_AudioSpec));
icculus@2049
   797
icculus@2049
   798
    if (orig->callback == NULL) {
icculus@2049
   799
        SDL_SetError("SDL_OpenAudio() passed a NULL callback");
icculus@2049
   800
        return 0;
icculus@2049
   801
    }
icculus@2049
   802
icculus@2049
   803
    if (orig->freq == 0) {
icculus@2049
   804
        const char *env = SDL_getenv("SDL_AUDIO_FREQUENCY");
slouken@2060
   805
        if ((!env) || ((prepared->freq = SDL_atoi(env)) == 0)) {
slouken@2060
   806
            prepared->freq = 22050;     /* a reasonable default */
slouken@1895
   807
        }
slouken@1895
   808
    }
icculus@2049
   809
icculus@2049
   810
    if (orig->format == 0) {
icculus@2049
   811
        const char *env = SDL_getenv("SDL_AUDIO_FORMAT");
icculus@2049
   812
        if ((!env) || ((prepared->format = SDL_ParseAudioFormat(env)) == 0)) {
slouken@2060
   813
            prepared->format = AUDIO_S16;       /* a reasonable default */
slouken@1895
   814
        }
slouken@1895
   815
    }
icculus@2049
   816
icculus@2049
   817
    switch (orig->channels) {
slouken@2060
   818
    case 0:{
slouken@2060
   819
            const char *env = SDL_getenv("SDL_AUDIO_CHANNELS");
slouken@2141
   820
            if ((!env) || ((prepared->channels = (Uint8) SDL_atoi(env)) == 0)) {
slouken@2060
   821
                prepared->channels = 2; /* a reasonable default */
slouken@2060
   822
            }
slouken@2060
   823
            break;
icculus@2049
   824
        }
slouken@1895
   825
    case 1:                    /* Mono */
slouken@1895
   826
    case 2:                    /* Stereo */
slouken@1895
   827
    case 4:                    /* surround */
slouken@1895
   828
    case 6:                    /* surround with center and lfe */
slouken@1895
   829
        break;
slouken@1895
   830
    default:
icculus@2049
   831
        SDL_SetError("Unsupported number of audio channels.");
icculus@2049
   832
        return 0;
slouken@1895
   833
    }
icculus@2049
   834
icculus@2049
   835
    if (orig->samples == 0) {
icculus@2049
   836
        const char *env = SDL_getenv("SDL_AUDIO_SAMPLES");
slouken@2060
   837
        if ((!env) || ((prepared->samples = (Uint16) SDL_atoi(env)) == 0)) {
icculus@2049
   838
            /* Pick a default of ~46 ms at desired frequency */
icculus@2049
   839
            /* !!! FIXME: remove this when the non-Po2 resampling is in. */
icculus@2049
   840
            const int samples = (prepared->freq / 1000) * 46;
icculus@2049
   841
            int power2 = 1;
icculus@2049
   842
            while (power2 < samples) {
icculus@2049
   843
                power2 *= 2;
icculus@2049
   844
            }
icculus@2049
   845
            prepared->samples = power2;
slouken@1895
   846
        }
slouken@1895
   847
    }
slouken@0
   848
slouken@1895
   849
    /* Calculate the silence and size of the audio specification */
icculus@2049
   850
    SDL_CalculateAudioSpec(prepared);
slouken@21
   851
icculus@2049
   852
    return 1;
icculus@2049
   853
}
slouken@1408
   854
slouken@21
   855
icculus@2049
   856
static SDL_AudioDeviceID
icculus@2049
   857
open_audio_device(const char *devname, int iscapture,
slouken@2866
   858
                  const SDL_AudioSpec * desired, SDL_AudioSpec * obtained,
slouken@2866
   859
                  int allowed_changes, int min_id)
icculus@2049
   860
{
icculus@2049
   861
    SDL_AudioDeviceID id = 0;
slouken@2866
   862
    SDL_AudioSpec _obtained;
icculus@2049
   863
    SDL_AudioDevice *device;
slouken@2866
   864
    SDL_bool build_cvt;
icculus@2049
   865
    int i = 0;
slouken@21
   866
icculus@2049
   867
    if (!SDL_WasInit(SDL_INIT_AUDIO)) {
icculus@2049
   868
        SDL_SetError("Audio subsystem is not initialized");
icculus@2049
   869
        return 0;
icculus@2049
   870
    }
icculus@2049
   871
icculus@2049
   872
    if ((iscapture) && (!current_audio.impl.HasCaptureSupport)) {
icculus@2049
   873
        SDL_SetError("No capture support");
icculus@2049
   874
        return 0;
icculus@2049
   875
    }
icculus@2049
   876
slouken@2866
   877
    if (!obtained) {
slouken@2866
   878
        obtained = &_obtained;
slouken@2866
   879
    }
slouken@2866
   880
    if (!prepare_audiospec(desired, obtained)) {
icculus@2049
   881
        return 0;
icculus@2049
   882
    }
icculus@2049
   883
icculus@2049
   884
    /* If app doesn't care about a specific device, let the user override. */
icculus@2049
   885
    if (devname == NULL) {
icculus@2049
   886
        devname = SDL_getenv("SDL_AUDIO_DEVICE_NAME");
slouken@1895
   887
    }
slouken@21
   888
icculus@2049
   889
    /*
icculus@2049
   890
     * Catch device names at the high level for the simple case...
icculus@2049
   891
     * This lets us have a basic "device enumeration" for systems that
icculus@2049
   892
     *  don't have multiple devices, but makes sure the device name is
icculus@2049
   893
     *  always NULL when it hits the low level.
icculus@2049
   894
     *
icculus@2049
   895
     * Also make sure that the simple case prevents multiple simultaneous
icculus@2049
   896
     *  opens of the default system device.
icculus@2049
   897
     */
icculus@2049
   898
icculus@2049
   899
    if ((iscapture) && (current_audio.impl.OnlyHasDefaultInputDevice)) {
icculus@2049
   900
        if ((devname) && (SDL_strcmp(devname, DEFAULT_INPUT_DEVNAME) != 0)) {
icculus@2049
   901
            SDL_SetError("No such device");
icculus@2049
   902
            return 0;
icculus@2049
   903
        }
icculus@2049
   904
        devname = NULL;
icculus@2049
   905
icculus@2049
   906
        for (i = 0; i < SDL_arraysize(open_devices); i++) {
icculus@2049
   907
            if ((open_devices[i]) && (open_devices[i]->iscapture)) {
icculus@2049
   908
                SDL_SetError("Audio device already open");
icculus@2049
   909
                return 0;
icculus@2049
   910
            }
icculus@2049
   911
        }
icculus@2049
   912
    }
icculus@2049
   913
icculus@2049
   914
    if ((!iscapture) && (current_audio.impl.OnlyHasDefaultOutputDevice)) {
icculus@2049
   915
        if ((devname) && (SDL_strcmp(devname, DEFAULT_OUTPUT_DEVNAME) != 0)) {
icculus@2049
   916
            SDL_SetError("No such device");
icculus@2049
   917
            return 0;
icculus@2049
   918
        }
icculus@2049
   919
        devname = NULL;
icculus@2049
   920
icculus@2049
   921
        for (i = 0; i < SDL_arraysize(open_devices); i++) {
icculus@2049
   922
            if ((open_devices[i]) && (!open_devices[i]->iscapture)) {
icculus@2049
   923
                SDL_SetError("Audio device already open");
icculus@2049
   924
                return 0;
icculus@2049
   925
            }
icculus@2049
   926
        }
icculus@2049
   927
    }
icculus@2049
   928
slouken@2060
   929
    device = (SDL_AudioDevice *) SDL_AllocAudioMem(sizeof(SDL_AudioDevice));
icculus@2049
   930
    if (device == NULL) {
icculus@2049
   931
        SDL_OutOfMemory();
icculus@2049
   932
        return 0;
icculus@2049
   933
    }
slouken@2060
   934
    SDL_memset(device, '\0', sizeof(SDL_AudioDevice));
slouken@2866
   935
    device->spec = *obtained;
icculus@2049
   936
    device->enabled = 1;
icculus@2049
   937
    device->paused = 1;
icculus@2049
   938
    device->iscapture = iscapture;
icculus@2049
   939
icculus@2049
   940
    /* Create a semaphore for locking the sound buffers */
icculus@2049
   941
    if (!current_audio.impl.SkipMixerLock) {
icculus@2049
   942
        device->mixer_lock = SDL_CreateMutex();
icculus@2049
   943
        if (device->mixer_lock == NULL) {
icculus@2049
   944
            close_audio_device(device);
icculus@2049
   945
            SDL_SetError("Couldn't create mixer lock");
icculus@2049
   946
            return 0;
icculus@2049
   947
        }
icculus@2049
   948
    }
icculus@2049
   949
icculus@5593
   950
    /* force a device detection if we haven't done one yet. */
icculus@5593
   951
    if ( ((iscapture) && (current_audio.inputDevices == NULL)) ||
icculus@5593
   952
         ((!iscapture) && (current_audio.outputDevices == NULL)) )
icculus@5593
   953
        SDL_GetNumAudioDevices(iscapture);
icculus@5593
   954
icculus@7038
   955
    if (current_audio.impl.OpenDevice(device, devname, iscapture) < 0) {
icculus@2049
   956
        close_audio_device(device);
icculus@2049
   957
        return 0;
icculus@2049
   958
    }
icculus@2049
   959
    device->opened = 1;
slouken@0
   960
slouken@1895
   961
    /* Allocate a fake audio memory buffer */
aschiffler@4865
   962
    device->fake_stream = (Uint8 *)SDL_AllocAudioMem(device->spec.size);
icculus@2049
   963
    if (device->fake_stream == NULL) {
icculus@2049
   964
        close_audio_device(device);
slouken@1895
   965
        SDL_OutOfMemory();
icculus@2049
   966
        return 0;
slouken@1895
   967
    }
slouken@0
   968
slouken@1895
   969
    /* See if we need to do any conversion */
slouken@2866
   970
    build_cvt = SDL_FALSE;
slouken@2866
   971
    if (obtained->freq != device->spec.freq) {
slouken@2866
   972
        if (allowed_changes & SDL_AUDIO_ALLOW_FREQUENCY_CHANGE) {
slouken@2866
   973
            obtained->freq = device->spec.freq;
slouken@2866
   974
        } else {
slouken@2866
   975
            build_cvt = SDL_TRUE;
slouken@2866
   976
        }
slouken@2866
   977
    }
slouken@2866
   978
    if (obtained->format != device->spec.format) {
slouken@2866
   979
        if (allowed_changes & SDL_AUDIO_ALLOW_FORMAT_CHANGE) {
slouken@2866
   980
            obtained->format = device->spec.format;
slouken@2866
   981
        } else {
slouken@2866
   982
            build_cvt = SDL_TRUE;
slouken@2866
   983
        }
slouken@2866
   984
    }
slouken@2866
   985
    if (obtained->channels != device->spec.channels) {
slouken@2866
   986
        if (allowed_changes & SDL_AUDIO_ALLOW_CHANNELS_CHANGE) {
slouken@2866
   987
            obtained->channels = device->spec.channels;
slouken@2866
   988
        } else {
slouken@2866
   989
            build_cvt = SDL_TRUE;
slouken@2866
   990
        }
slouken@2866
   991
    }
slouken@7518
   992
slouken@7518
   993
    /* If the audio driver changes the buffer size, accept it.
slouken@7518
   994
       This needs to be done after the format is modified above,
slouken@7518
   995
       otherwise it might not have the correct buffer size.
slouken@7518
   996
     */
slouken@7518
   997
    if (device->spec.samples != obtained->samples) {
slouken@7518
   998
        obtained->samples = device->spec.samples;
slouken@7518
   999
        SDL_CalculateAudioSpec(obtained);
slouken@7518
  1000
    }
slouken@7518
  1001
slouken@2866
  1002
    if (build_cvt) {
slouken@1895
  1003
        /* Build an audio conversion block */
icculus@2049
  1004
        if (SDL_BuildAudioCVT(&device->convert,
slouken@2866
  1005
                              obtained->format, obtained->channels,
slouken@2866
  1006
                              obtained->freq,
icculus@2049
  1007
                              device->spec.format, device->spec.channels,
icculus@2049
  1008
                              device->spec.freq) < 0) {
icculus@2049
  1009
            close_audio_device(device);
icculus@2049
  1010
            return 0;
slouken@1895
  1011
        }
icculus@2049
  1012
        if (device->convert.needed) {
slouken@7518
  1013
            device->convert.len = (int) (((double) device->spec.size) /
slouken@2060
  1014
                                         device->convert.len_ratio);
icculus@2053
  1015
icculus@2049
  1016
            device->convert.buf =
icculus@2049
  1017
                (Uint8 *) SDL_AllocAudioMem(device->convert.len *
icculus@2049
  1018
                                            device->convert.len_mult);
icculus@2049
  1019
            if (device->convert.buf == NULL) {
icculus@2049
  1020
                close_audio_device(device);
slouken@1895
  1021
                SDL_OutOfMemory();
icculus@2049
  1022
                return 0;
slouken@1895
  1023
            }
slouken@1895
  1024
        }
slouken@1895
  1025
    }
icculus@2049
  1026
icculus@2049
  1027
    /* Find an available device ID and store the structure... */
slouken@2060
  1028
    for (id = min_id - 1; id < SDL_arraysize(open_devices); id++) {
icculus@2049
  1029
        if (open_devices[id] == NULL) {
icculus@2049
  1030
            open_devices[id] = device;
icculus@2049
  1031
            break;
icculus@2049
  1032
        }
icculus@2049
  1033
    }
icculus@2049
  1034
icculus@2049
  1035
    if (id == SDL_arraysize(open_devices)) {
icculus@2049
  1036
        SDL_SetError("Too many open audio devices");
icculus@2049
  1037
        close_audio_device(device);
icculus@2049
  1038
        return 0;
icculus@2049
  1039
    }
icculus@2049
  1040
slouken@1895
  1041
    /* Start the audio thread if necessary */
icculus@2049
  1042
    if (!current_audio.impl.ProvidesOwnCallbackThread) {
slouken@1895
  1043
        /* Start the audio thread */
icculus@5969
  1044
        char name[64];
icculus@5969
  1045
        SDL_snprintf(name, sizeof (name), "SDLAudioDev%d", (int) (id + 1));
icculus@2049
  1046
/* !!! FIXME: this is nasty. */
icculus@6430
  1047
#if defined(__WIN32__) && !defined(HAVE_LIBC)
slouken@1330
  1048
#undef SDL_CreateThread
icculus@8094
  1049
#if SDL_DYNAMIC_API
icculus@8094
  1050
        device->thread = SDL_CreateThread_REAL(SDL_RunAudio, name, device, NULL, NULL);
icculus@8094
  1051
#else
icculus@5969
  1052
        device->thread = SDL_CreateThread(SDL_RunAudio, name, device, NULL, NULL);
icculus@8094
  1053
#endif
slouken@1330
  1054
#else
icculus@5969
  1055
        device->thread = SDL_CreateThread(SDL_RunAudio, name, device);
slouken@1330
  1056
#endif
icculus@2049
  1057
        if (device->thread == NULL) {
slouken@2060
  1058
            SDL_CloseAudioDevice(id + 1);
slouken@1895
  1059
            SDL_SetError("Couldn't create audio thread");
icculus@2049
  1060
            return 0;
icculus@2049
  1061
        }
icculus@2049
  1062
    }
icculus@2049
  1063
slouken@2060
  1064
    return id + 1;
icculus@2049
  1065
}
icculus@2049
  1066
icculus@2049
  1067
icculus@2049
  1068
int
slouken@2866
  1069
SDL_OpenAudio(SDL_AudioSpec * desired, SDL_AudioSpec * obtained)
icculus@2049
  1070
{
icculus@2049
  1071
    SDL_AudioDeviceID id = 0;
icculus@2049
  1072
icculus@2049
  1073
    /* Start up the audio driver, if necessary. This is legacy behaviour! */
icculus@2049
  1074
    if (!SDL_WasInit(SDL_INIT_AUDIO)) {
icculus@2049
  1075
        if (SDL_InitSubSystem(SDL_INIT_AUDIO) < 0) {
slouken@1895
  1076
            return (-1);
slouken@1895
  1077
        }
icculus@2049
  1078
    }
slouken@0
  1079
icculus@2049
  1080
    /* SDL_OpenAudio() is legacy and can only act on Device ID #1. */
icculus@2049
  1081
    if (open_devices[0] != NULL) {
icculus@2049
  1082
        SDL_SetError("Audio device is already opened");
icculus@2049
  1083
        return (-1);
slouken@1895
  1084
    }
icculus@2049
  1085
slouken@2866
  1086
    if (obtained) {
slouken@2866
  1087
        id = open_audio_device(NULL, 0, desired, obtained,
slouken@2866
  1088
                               SDL_AUDIO_ALLOW_ANY_CHANGE, 1);
slouken@2866
  1089
    } else {
slouken@2866
  1090
        id = open_audio_device(NULL, 0, desired, desired, 0, 1);
slouken@2866
  1091
    }
slouken@21
  1092
icculus@5964
  1093
    SDL_assert((id == 0) || (id == 1));
icculus@2049
  1094
    return ((id == 0) ? -1 : 0);
icculus@2049
  1095
}
slouken@21
  1096
icculus@2049
  1097
SDL_AudioDeviceID
icculus@2049
  1098
SDL_OpenAudioDevice(const char *device, int iscapture,
slouken@2866
  1099
                    const SDL_AudioSpec * desired, SDL_AudioSpec * obtained,
slouken@2866
  1100
                    int allowed_changes)
icculus@2049
  1101
{
slouken@2866
  1102
    return open_audio_device(device, iscapture, desired, obtained,
slouken@2866
  1103
                             allowed_changes, 2);
slouken@1895
  1104
}
slouken@1895
  1105
slouken@3537
  1106
SDL_AudioStatus
icculus@2049
  1107
SDL_GetAudioDeviceStatus(SDL_AudioDeviceID devid)
slouken@1895
  1108
{
icculus@2049
  1109
    SDL_AudioDevice *device = get_audio_device(devid);
slouken@3537
  1110
    SDL_AudioStatus status = SDL_AUDIO_STOPPED;
icculus@2049
  1111
    if (device && device->enabled) {
icculus@2049
  1112
        if (device->paused) {
slouken@1895
  1113
            status = SDL_AUDIO_PAUSED;
slouken@1895
  1114
        } else {
slouken@1895
  1115
            status = SDL_AUDIO_PLAYING;
slouken@1895
  1116
        }
slouken@1895
  1117
    }
slouken@1895
  1118
    return (status);
slouken@0
  1119
}
slouken@0
  1120
icculus@2049
  1121
slouken@3537
  1122
SDL_AudioStatus
icculus@2049
  1123
SDL_GetAudioStatus(void)
icculus@2049
  1124
{
icculus@2049
  1125
    return SDL_GetAudioDeviceStatus(1);
icculus@2049
  1126
}
icculus@2049
  1127
icculus@2049
  1128
void
icculus@2049
  1129
SDL_PauseAudioDevice(SDL_AudioDeviceID devid, int pause_on)
icculus@2049
  1130
{
icculus@2049
  1131
    SDL_AudioDevice *device = get_audio_device(devid);
icculus@2049
  1132
    if (device) {
icculus@7447
  1133
        current_audio.impl.LockDevice(device);
icculus@2049
  1134
        device->paused = pause_on;
icculus@7447
  1135
        current_audio.impl.UnlockDevice(device);
icculus@2049
  1136
    }
icculus@2049
  1137
}
icculus@2049
  1138
slouken@1895
  1139
void
slouken@1895
  1140
SDL_PauseAudio(int pause_on)
slouken@0
  1141
{
icculus@2049
  1142
    SDL_PauseAudioDevice(1, pause_on);
icculus@2049
  1143
}
icculus@2049
  1144
slouken@0
  1145
icculus@2049
  1146
void
icculus@2049
  1147
SDL_LockAudioDevice(SDL_AudioDeviceID devid)
icculus@2049
  1148
{
icculus@2049
  1149
    /* Obtain a lock on the mixing buffers */
icculus@2049
  1150
    SDL_AudioDevice *device = get_audio_device(devid);
icculus@2049
  1151
    if (device) {
icculus@2049
  1152
        current_audio.impl.LockDevice(device);
slouken@1895
  1153
    }
slouken@0
  1154
}
slouken@0
  1155
slouken@1895
  1156
void
slouken@1895
  1157
SDL_LockAudio(void)
slouken@0
  1158
{
icculus@2049
  1159
    SDL_LockAudioDevice(1);
icculus@2049
  1160
}
slouken@0
  1161
icculus@2049
  1162
void
icculus@2049
  1163
SDL_UnlockAudioDevice(SDL_AudioDeviceID devid)
icculus@2049
  1164
{
slouken@1895
  1165
    /* Obtain a lock on the mixing buffers */
icculus@2049
  1166
    SDL_AudioDevice *device = get_audio_device(devid);
icculus@2049
  1167
    if (device) {
icculus@2049
  1168
        current_audio.impl.UnlockDevice(device);
slouken@1895
  1169
    }
slouken@0
  1170
}
slouken@0
  1171
slouken@1895
  1172
void
slouken@1895
  1173
SDL_UnlockAudio(void)
slouken@0
  1174
{
icculus@2049
  1175
    SDL_UnlockAudioDevice(1);
icculus@2049
  1176
}
slouken@0
  1177
icculus@2049
  1178
void
icculus@2049
  1179
SDL_CloseAudioDevice(SDL_AudioDeviceID devid)
icculus@2049
  1180
{
icculus@2049
  1181
    SDL_AudioDevice *device = get_audio_device(devid);
icculus@2049
  1182
    if (device) {
icculus@2049
  1183
        close_audio_device(device);
slouken@2060
  1184
        open_devices[devid - 1] = NULL;
slouken@1895
  1185
    }
slouken@0
  1186
}
slouken@0
  1187
slouken@1895
  1188
void
slouken@1895
  1189
SDL_CloseAudio(void)
slouken@0
  1190
{
icculus@2049
  1191
    SDL_CloseAudioDevice(1);
slouken@0
  1192
}
slouken@0
  1193
slouken@1895
  1194
void
slouken@1895
  1195
SDL_AudioQuit(void)
slouken@0
  1196
{
icculus@7348
  1197
    SDL_AudioDeviceID i;
icculus@7348
  1198
icculus@7345
  1199
    if (!current_audio.name) {  /* not initialized?! */
icculus@7345
  1200
        return;
icculus@7345
  1201
    }
icculus@7345
  1202
icculus@2049
  1203
    for (i = 0; i < SDL_arraysize(open_devices); i++) {
icculus@7342
  1204
        if (open_devices[i] != NULL) {
icculus@7446
  1205
            SDL_CloseAudioDevice(i+1);
icculus@7342
  1206
        }
icculus@2049
  1207
    }
slouken@0
  1208
icculus@2049
  1209
    /* Free the driver data */
icculus@2049
  1210
    current_audio.impl.Deinitialize();
icculus@5593
  1211
    free_device_list(&current_audio.outputDevices,
icculus@5593
  1212
                     &current_audio.outputDeviceCount);
icculus@5593
  1213
    free_device_list(&current_audio.inputDevices,
icculus@5593
  1214
                     &current_audio.inputDeviceCount);
slouken@2060
  1215
    SDL_memset(&current_audio, '\0', sizeof(current_audio));
slouken@2060
  1216
    SDL_memset(open_devices, '\0', sizeof(open_devices));
slouken@0
  1217
}
slouken@0
  1218
icculus@1982
  1219
#define NUM_FORMATS 10
slouken@0
  1220
static int format_idx;
slouken@0
  1221
static int format_idx_sub;
icculus@1982
  1222
static SDL_AudioFormat format_list[NUM_FORMATS][NUM_FORMATS] = {
slouken@1895
  1223
    {AUDIO_U8, AUDIO_S8, AUDIO_S16LSB, AUDIO_S16MSB, AUDIO_U16LSB,
icculus@1982
  1224
     AUDIO_U16MSB, AUDIO_S32LSB, AUDIO_S32MSB, AUDIO_F32LSB, AUDIO_F32MSB},
slouken@1895
  1225
    {AUDIO_S8, AUDIO_U8, AUDIO_S16LSB, AUDIO_S16MSB, AUDIO_U16LSB,
icculus@1982
  1226
     AUDIO_U16MSB, AUDIO_S32LSB, AUDIO_S32MSB, AUDIO_F32LSB, AUDIO_F32MSB},
icculus@1982
  1227
    {AUDIO_S16LSB, AUDIO_S16MSB, AUDIO_U16LSB, AUDIO_U16MSB, AUDIO_S32LSB,
icculus@1982
  1228
     AUDIO_S32MSB, AUDIO_F32LSB, AUDIO_F32MSB, AUDIO_U8, AUDIO_S8},
icculus@1982
  1229
    {AUDIO_S16MSB, AUDIO_S16LSB, AUDIO_U16MSB, AUDIO_U16LSB, AUDIO_S32MSB,
icculus@1982
  1230
     AUDIO_S32LSB, AUDIO_F32MSB, AUDIO_F32LSB, AUDIO_U8, AUDIO_S8},
icculus@1982
  1231
    {AUDIO_U16LSB, AUDIO_U16MSB, AUDIO_S16LSB, AUDIO_S16MSB, AUDIO_S32LSB,
icculus@1982
  1232
     AUDIO_S32MSB, AUDIO_F32LSB, AUDIO_F32MSB, AUDIO_U8, AUDIO_S8},
icculus@1982
  1233
    {AUDIO_U16MSB, AUDIO_U16LSB, AUDIO_S16MSB, AUDIO_S16LSB, AUDIO_S32MSB,
icculus@1982
  1234
     AUDIO_S32LSB, AUDIO_F32MSB, AUDIO_F32LSB, AUDIO_U8, AUDIO_S8},
icculus@1993
  1235
    {AUDIO_S32LSB, AUDIO_S32MSB, AUDIO_F32LSB, AUDIO_F32MSB, AUDIO_S16LSB,
icculus@1993
  1236
     AUDIO_S16MSB, AUDIO_U16LSB, AUDIO_U16MSB, AUDIO_U8, AUDIO_S8},
icculus@1993
  1237
    {AUDIO_S32MSB, AUDIO_S32LSB, AUDIO_F32MSB, AUDIO_F32LSB, AUDIO_S16MSB,
icculus@1993
  1238
     AUDIO_S16LSB, AUDIO_U16MSB, AUDIO_U16LSB, AUDIO_U8, AUDIO_S8},
icculus@1993
  1239
    {AUDIO_F32LSB, AUDIO_F32MSB, AUDIO_S32LSB, AUDIO_S32MSB, AUDIO_S16LSB,
icculus@1993
  1240
     AUDIO_S16MSB, AUDIO_U16LSB, AUDIO_U16MSB, AUDIO_U8, AUDIO_S8},
icculus@1993
  1241
    {AUDIO_F32MSB, AUDIO_F32LSB, AUDIO_S32MSB, AUDIO_S32LSB, AUDIO_S16MSB,
icculus@1993
  1242
     AUDIO_S16LSB, AUDIO_U16MSB, AUDIO_U16LSB, AUDIO_U8, AUDIO_S8},
slouken@0
  1243
};
slouken@0
  1244
icculus@1982
  1245
SDL_AudioFormat
icculus@1982
  1246
SDL_FirstAudioFormat(SDL_AudioFormat format)
slouken@0
  1247
{
slouken@1895
  1248
    for (format_idx = 0; format_idx < NUM_FORMATS; ++format_idx) {
slouken@1895
  1249
        if (format_list[format_idx][0] == format) {
slouken@1895
  1250
            break;
slouken@1895
  1251
        }
slouken@1895
  1252
    }
slouken@1895
  1253
    format_idx_sub = 0;
slouken@1895
  1254
    return (SDL_NextAudioFormat());
slouken@0
  1255
}
slouken@0
  1256
icculus@1982
  1257
SDL_AudioFormat
slouken@1895
  1258
SDL_NextAudioFormat(void)
slouken@0
  1259
{
slouken@1895
  1260
    if ((format_idx == NUM_FORMATS) || (format_idx_sub == NUM_FORMATS)) {
slouken@1895
  1261
        return (0);
slouken@1895
  1262
    }
slouken@1895
  1263
    return (format_list[format_idx][format_idx_sub++]);
slouken@0
  1264
}
slouken@0
  1265
slouken@1895
  1266
void
slouken@1895
  1267
SDL_CalculateAudioSpec(SDL_AudioSpec * spec)
slouken@0
  1268
{
slouken@1895
  1269
    switch (spec->format) {
slouken@1895
  1270
    case AUDIO_U8:
slouken@1895
  1271
        spec->silence = 0x80;
slouken@1895
  1272
        break;
slouken@1895
  1273
    default:
slouken@1895
  1274
        spec->silence = 0x00;
slouken@1895
  1275
        break;
slouken@1895
  1276
    }
icculus@2049
  1277
    spec->size = SDL_AUDIO_BITSIZE(spec->format) / 8;
slouken@1895
  1278
    spec->size *= spec->channels;
slouken@1895
  1279
    spec->size *= spec->samples;
slouken@0
  1280
}
slouken@1895
  1281
icculus@2049
  1282
icculus@2049
  1283
/*
icculus@2049
  1284
 * Moved here from SDL_mixer.c, since it relies on internals of an opened
icculus@2049
  1285
 *  audio device (and is deprecated, by the way!).
icculus@2049
  1286
 */
icculus@2049
  1287
void
icculus@2049
  1288
SDL_MixAudio(Uint8 * dst, const Uint8 * src, Uint32 len, int volume)
icculus@2049
  1289
{
icculus@2049
  1290
    /* Mix the user-level audio format */
icculus@2049
  1291
    SDL_AudioDevice *device = get_audio_device(1);
icculus@2049
  1292
    if (device != NULL) {
icculus@2049
  1293
        SDL_AudioFormat format;
icculus@2049
  1294
        if (device->convert.needed) {
icculus@2049
  1295
            format = device->convert.src_format;
icculus@2049
  1296
        } else {
icculus@2049
  1297
            format = device->spec.format;
icculus@2049
  1298
        }
icculus@2049
  1299
        SDL_MixAudioFormat(dst, src, format, len, volume);
icculus@2049
  1300
    }
icculus@2049
  1301
}
icculus@2049
  1302
slouken@1895
  1303
/* vi: set ts=4 sw=4 expandtab: */