src/audio/SDL_sysaudio.h
author Ryan C. Gordon
Sun, 08 Jul 2012 07:20:50 -0400
branchSDL-1.2
changeset 6353 dfcbd0d9209c
parent 6137 4720145f848b
permissions -rw-r--r--
Added OpenBSD "sndio" audio target.

Thanks to Brad Smith and the OpenBSD team for the patch!
slouken@0
     1
/*
slouken@0
     2
    SDL - Simple DirectMedia Layer
slouken@6137
     3
    Copyright (C) 1997-2012 Sam Lantinga
slouken@0
     4
slouken@1336
     5
    This library is SDL_free software; you can redistribute it and/or
slouken@1312
     6
    modify it under the terms of the GNU Lesser General Public
slouken@0
     7
    License as published by the Free Software Foundation; either
slouken@1312
     8
    version 2.1 of the License, or (at your option) any later version.
slouken@0
     9
slouken@0
    10
    This library is distributed in the hope that it will be useful,
slouken@0
    11
    but WITHOUT ANY WARRANTY; without even the implied warranty of
slouken@0
    12
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
slouken@1312
    13
    Lesser General Public License for more details.
slouken@0
    14
slouken@1312
    15
    You should have received a copy of the GNU Lesser General Public
slouken@1312
    16
    License along with this library; if not, write to the Free Software
slouken@1312
    17
    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
slouken@0
    18
slouken@0
    19
    Sam Lantinga
slouken@252
    20
    slouken@libsdl.org
slouken@0
    21
*/
slouken@1402
    22
#include "SDL_config.h"
slouken@0
    23
slouken@0
    24
#ifndef _SDL_sysaudio_h
slouken@0
    25
#define _SDL_sysaudio_h
slouken@0
    26
slouken@0
    27
#include "SDL_mutex.h"
slouken@0
    28
#include "SDL_thread.h"
slouken@0
    29
slouken@0
    30
/* The SDL audio driver */
slouken@0
    31
typedef struct SDL_AudioDevice SDL_AudioDevice;
slouken@0
    32
slouken@0
    33
/* Define the SDL audio driver structure */
slouken@0
    34
#define _THIS	SDL_AudioDevice *_this
slouken@0
    35
#ifndef _STATUS
slouken@0
    36
#define _STATUS	SDL_status *status
slouken@0
    37
#endif
slouken@0
    38
struct SDL_AudioDevice {
slouken@0
    39
	/* * * */
slouken@0
    40
	/* The name of this audio driver */
slouken@0
    41
	const char *name;
slouken@0
    42
slouken@0
    43
	/* * * */
slouken@0
    44
	/* The description of this audio driver */
slouken@0
    45
	const char *desc;
slouken@0
    46
slouken@0
    47
	/* * * */
slouken@0
    48
	/* Public driver functions */
slouken@0
    49
	int  (*OpenAudio)(_THIS, SDL_AudioSpec *spec);
slouken@0
    50
	void (*ThreadInit)(_THIS);	/* Called by audio thread at start */
slouken@0
    51
	void (*WaitAudio)(_THIS);
slouken@0
    52
	void (*PlayAudio)(_THIS);
slouken@0
    53
	Uint8 *(*GetAudioBuf)(_THIS);
slouken@0
    54
	void (*WaitDone)(_THIS);
slouken@0
    55
	void (*CloseAudio)(_THIS);
slouken@0
    56
slouken@0
    57
	/* * * */
slouken@322
    58
	/* Lock / Unlock functions added for the Mac port */
slouken@322
    59
	void (*LockAudio)(_THIS);
slouken@322
    60
	void (*UnlockAudio)(_THIS);
slouken@322
    61
icculus@4398
    62
	void (*SetCaption)(_THIS, const char *caption);
icculus@4398
    63
slouken@322
    64
	/* * * */
slouken@0
    65
	/* Data common to all devices */
slouken@0
    66
slouken@0
    67
	/* The current audio specification (shared with audio thread) */
slouken@0
    68
	SDL_AudioSpec spec;
slouken@0
    69
slouken@0
    70
	/* An audio conversion block for audio format emulation */
slouken@0
    71
	SDL_AudioCVT convert;
slouken@0
    72
slouken@0
    73
	/* Current state flags */
slouken@0
    74
	int enabled;
slouken@0
    75
	int paused;
slouken@0
    76
	int opened;
slouken@0
    77
slouken@0
    78
	/* Fake audio buffer for when the audio hardware is busy */
slouken@0
    79
	Uint8 *fake_stream;
slouken@0
    80
slouken@0
    81
	/* A semaphore for locking the mixing buffers */
slouken@0
    82
	SDL_mutex *mixer_lock;
slouken@0
    83
slouken@0
    84
	/* A thread to feed the audio device */
slouken@0
    85
	SDL_Thread *thread;
slouken@0
    86
	Uint32 threadid;
slouken@0
    87
slouken@0
    88
	/* * * */
slouken@0
    89
	/* Data private to this driver */
slouken@0
    90
	struct SDL_PrivateAudioData *hidden;
slouken@0
    91
slouken@0
    92
	/* * * */
slouken@0
    93
	/* The function used to dispose of this structure */
slouken@0
    94
	void (*free)(_THIS);
slouken@0
    95
};
slouken@0
    96
#undef _THIS
slouken@0
    97
slouken@0
    98
typedef struct AudioBootStrap {
slouken@0
    99
	const char *name;
slouken@0
   100
	const char *desc;
slouken@0
   101
	int (*available)(void);
slouken@0
   102
	SDL_AudioDevice *(*create)(int devindex);
slouken@0
   103
} AudioBootStrap;
slouken@0
   104
icculus@6353
   105
#if SDL_AUDIO_DRIVER_SNDIO
icculus@6353
   106
extern AudioBootStrap SNDIO_bootstrap;
icculus@6353
   107
#endif
slouken@1567
   108
#if SDL_AUDIO_DRIVER_BSD
slouken@1567
   109
extern AudioBootStrap BSD_AUDIO_bootstrap;
slouken@94
   110
#endif
icculus@3939
   111
#if SDL_AUDIO_DRIVER_PULSE
icculus@3939
   112
extern AudioBootStrap PULSE_bootstrap;
icculus@3939
   113
#endif
slouken@4301
   114
#if SDL_AUDIO_DRIVER_ALSA
slouken@4301
   115
extern AudioBootStrap ALSA_bootstrap;
slouken@4301
   116
#endif
slouken@1361
   117
#if SDL_AUDIO_DRIVER_OSS
slouken@0
   118
extern AudioBootStrap DSP_bootstrap;
slouken@0
   119
extern AudioBootStrap DMA_bootstrap;
slouken@0
   120
#endif
slouken@1361
   121
#if SDL_AUDIO_DRIVER_QNXNTO
slouken@663
   122
extern AudioBootStrap QNXNTOAUDIO_bootstrap;
slouken@663
   123
#endif
slouken@1361
   124
#if SDL_AUDIO_DRIVER_SUNAUDIO
slouken@148
   125
extern AudioBootStrap SUNAUDIO_bootstrap;
slouken@148
   126
#endif
slouken@1361
   127
#if SDL_AUDIO_DRIVER_DMEDIA
slouken@148
   128
extern AudioBootStrap DMEDIA_bootstrap;
slouken@35
   129
#endif
slouken@1361
   130
#if SDL_AUDIO_DRIVER_ARTS
slouken@1361
   131
extern AudioBootStrap ARTS_bootstrap;
slouken@0
   132
#endif
slouken@1361
   133
#if SDL_AUDIO_DRIVER_ESD
slouken@0
   134
extern AudioBootStrap ESD_bootstrap;
slouken@0
   135
#endif
slouken@1361
   136
#if SDL_AUDIO_DRIVER_NAS
slouken@0
   137
extern AudioBootStrap NAS_bootstrap;
slouken@0
   138
#endif
slouken@1361
   139
#if SDL_AUDIO_DRIVER_DSOUND
slouken@0
   140
extern AudioBootStrap DSOUND_bootstrap;
slouken@0
   141
#endif
slouken@1361
   142
#if SDL_AUDIO_DRIVER_WAVEOUT
slouken@0
   143
extern AudioBootStrap WAVEOUT_bootstrap;
slouken@0
   144
#endif
slouken@1361
   145
#if SDL_AUDIO_DRIVER_PAUD
slouken@21
   146
extern AudioBootStrap Paud_bootstrap;
slouken@21
   147
#endif
slouken@1361
   148
#if SDL_AUDIO_DRIVER_BAUDIO
slouken@0
   149
extern AudioBootStrap BAUDIO_bootstrap;
slouken@0
   150
#endif
slouken@1361
   151
#if SDL_AUDIO_DRIVER_COREAUDIO
slouken@935
   152
extern AudioBootStrap COREAUDIO_bootstrap;
slouken@935
   153
#endif
slouken@1361
   154
#if SDL_AUDIO_DRIVER_SNDMGR
slouken@0
   155
extern AudioBootStrap SNDMGR_bootstrap;
slouken@0
   156
#endif
slouken@1361
   157
#if SDL_AUDIO_DRIVER_MINT
patmandin@644
   158
extern AudioBootStrap MINTAUDIO_GSXB_bootstrap;
patmandin@644
   159
extern AudioBootStrap MINTAUDIO_MCSN_bootstrap;
patmandin@644
   160
extern AudioBootStrap MINTAUDIO_STFA_bootstrap;
patmandin@644
   161
extern AudioBootStrap MINTAUDIO_XBIOS_bootstrap;
patmandin@644
   162
extern AudioBootStrap MINTAUDIO_DMA8_bootstrap;
slouken@398
   163
#endif
slouken@1361
   164
#if SDL_AUDIO_DRIVER_DISK
slouken@68
   165
extern AudioBootStrap DISKAUD_bootstrap;
slouken@68
   166
#endif
icculus@1532
   167
#if SDL_AUDIO_DRIVER_DUMMY
icculus@1532
   168
extern AudioBootStrap DUMMYAUD_bootstrap;
icculus@1532
   169
#endif
slouken@1361
   170
#if SDL_AUDIO_DRIVER_DC
slouken@509
   171
extern AudioBootStrap DCAUD_bootstrap;
slouken@509
   172
#endif
slouken@3976
   173
#if SDL_AUDIO_DRIVER_NDS
slouken@3976
   174
extern AudioBootStrap NDSAUD_bootstrap;
slouken@3976
   175
#endif
slouken@1361
   176
#if SDL_AUDIO_DRIVER_MMEAUDIO
slouken@654
   177
extern AudioBootStrap MMEAUDIO_bootstrap;
slouken@654
   178
#endif
slouken@1361
   179
#if SDL_AUDIO_DRIVER_DART
icculus@1190
   180
extern AudioBootStrap DART_bootstrap;
icculus@1190
   181
#endif
icculus@3975
   182
#if SDL_AUDIO_DRIVER_EPOCAUDIO
icculus@3975
   183
extern AudioBootStrap EPOCAudio_bootstrap; 
icculus@3975
   184
#endif
slouken@0
   185
slouken@0
   186
/* This is the current audio device */
slouken@0
   187
extern SDL_AudioDevice *current_audio;
slouken@0
   188
slouken@0
   189
#endif /* _SDL_sysaudio_h */