Mercurial > sdl-ios-xcode
annotate src/audio/SDL_sysaudio.h @ 4001:6831b8723a85 SDL-1.2
Don't initialize the audio buffer passed to the application's audio callback,
since they are expected to entirely fill it with data or silence.
For legacy apps that might expect the buffer to already have silence and thus
may not fill the buffer in the callback, there's an environment variable to
expose the old behaviour.
Fixes Bugzilla #416.
| author | Ryan C. Gordon <icculus@icculus.org> |
|---|---|
| date | Thu, 05 Jul 2007 02:24:36 +0000 |
| parents | 8582c6a5ca16 |
| children | a1b03ba2fcd0 |
| rev | line source |
|---|---|
| 0 | 1 /* |
| 2 SDL - Simple DirectMedia Layer | |
|
1312
c9b51268668f
Updated copyright information and removed rcs id lines (problematic in branch merges)
Sam Lantinga <slouken@libsdl.org>
parents:
1190
diff
changeset
|
3 Copyright (C) 1997-2006 Sam Lantinga |
| 0 | 4 |
|
1336
3692456e7b0f
Use SDL_ prefixed versions of C library functions.
Sam Lantinga <slouken@libsdl.org>
parents:
1312
diff
changeset
|
5 This library is SDL_free software; you can redistribute it and/or |
|
1312
c9b51268668f
Updated copyright information and removed rcs id lines (problematic in branch merges)
Sam Lantinga <slouken@libsdl.org>
parents:
1190
diff
changeset
|
6 modify it under the terms of the GNU Lesser General Public |
| 0 | 7 License as published by the Free Software Foundation; either |
|
1312
c9b51268668f
Updated copyright information and removed rcs id lines (problematic in branch merges)
Sam Lantinga <slouken@libsdl.org>
parents:
1190
diff
changeset
|
8 version 2.1 of the License, or (at your option) any later version. |
| 0 | 9 |
| 10 This library is distributed in the hope that it will be useful, | |
| 11 but WITHOUT ANY WARRANTY; without even the implied warranty of | |
| 12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
|
1312
c9b51268668f
Updated copyright information and removed rcs id lines (problematic in branch merges)
Sam Lantinga <slouken@libsdl.org>
parents:
1190
diff
changeset
|
13 Lesser General Public License for more details. |
| 0 | 14 |
|
1312
c9b51268668f
Updated copyright information and removed rcs id lines (problematic in branch merges)
Sam Lantinga <slouken@libsdl.org>
parents:
1190
diff
changeset
|
15 You should have received a copy of the GNU Lesser General Public |
|
c9b51268668f
Updated copyright information and removed rcs id lines (problematic in branch merges)
Sam Lantinga <slouken@libsdl.org>
parents:
1190
diff
changeset
|
16 License along with this library; if not, write to the Free Software |
|
c9b51268668f
Updated copyright information and removed rcs id lines (problematic in branch merges)
Sam Lantinga <slouken@libsdl.org>
parents:
1190
diff
changeset
|
17 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA |
| 0 | 18 |
| 19 Sam Lantinga | |
|
252
e8157fcb3114
Updated the source with the correct e-mail address
Sam Lantinga <slouken@libsdl.org>
parents:
148
diff
changeset
|
20 slouken@libsdl.org |
| 0 | 21 */ |
|
1402
d910939febfa
Use consistent identifiers for the various platforms we support.
Sam Lantinga <slouken@libsdl.org>
parents:
1361
diff
changeset
|
22 #include "SDL_config.h" |
| 0 | 23 |
| 24 #ifndef _SDL_sysaudio_h | |
| 25 #define _SDL_sysaudio_h | |
| 26 | |
| 27 #include "SDL_mutex.h" | |
| 28 #include "SDL_thread.h" | |
| 29 | |
| 30 /* The SDL audio driver */ | |
| 31 typedef struct SDL_AudioDevice SDL_AudioDevice; | |
| 32 | |
| 33 /* Define the SDL audio driver structure */ | |
| 34 #define _THIS SDL_AudioDevice *_this | |
| 35 #ifndef _STATUS | |
| 36 #define _STATUS SDL_status *status | |
| 37 #endif | |
| 38 struct SDL_AudioDevice { | |
| 39 /* * * */ | |
| 40 /* The name of this audio driver */ | |
| 41 const char *name; | |
| 42 | |
| 43 /* * * */ | |
| 44 /* The description of this audio driver */ | |
| 45 const char *desc; | |
| 46 | |
| 47 /* * * */ | |
| 48 /* Public driver functions */ | |
| 49 int (*OpenAudio)(_THIS, SDL_AudioSpec *spec); | |
| 50 void (*ThreadInit)(_THIS); /* Called by audio thread at start */ | |
| 51 void (*WaitAudio)(_THIS); | |
| 52 void (*PlayAudio)(_THIS); | |
| 53 Uint8 *(*GetAudioBuf)(_THIS); | |
| 54 void (*WaitDone)(_THIS); | |
| 55 void (*CloseAudio)(_THIS); | |
| 56 | |
| 57 /* * * */ | |
|
322
fd93a09655e3
The audio lock and unlock functions are now a part of the driver.
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
58 /* Lock / Unlock functions added for the Mac port */ |
|
fd93a09655e3
The audio lock and unlock functions are now a part of the driver.
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
59 void (*LockAudio)(_THIS); |
|
fd93a09655e3
The audio lock and unlock functions are now a part of the driver.
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
60 void (*UnlockAudio)(_THIS); |
|
fd93a09655e3
The audio lock and unlock functions are now a part of the driver.
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
61 |
|
fd93a09655e3
The audio lock and unlock functions are now a part of the driver.
Sam Lantinga <slouken@libsdl.org>
parents:
297
diff
changeset
|
62 /* * * */ |
| 0 | 63 /* Data common to all devices */ |
| 64 | |
| 65 /* The current audio specification (shared with audio thread) */ | |
| 66 SDL_AudioSpec spec; | |
| 67 | |
| 68 /* An audio conversion block for audio format emulation */ | |
| 69 SDL_AudioCVT convert; | |
| 70 | |
| 71 /* Current state flags */ | |
| 72 int enabled; | |
| 73 int paused; | |
| 74 int opened; | |
| 75 | |
| 76 /* Fake audio buffer for when the audio hardware is busy */ | |
| 77 Uint8 *fake_stream; | |
| 78 | |
| 79 /* A semaphore for locking the mixing buffers */ | |
| 80 SDL_mutex *mixer_lock; | |
| 81 | |
| 82 /* A thread to feed the audio device */ | |
| 83 SDL_Thread *thread; | |
| 84 Uint32 threadid; | |
| 85 | |
| 86 /* * * */ | |
| 87 /* Data private to this driver */ | |
| 88 struct SDL_PrivateAudioData *hidden; | |
| 89 | |
| 90 /* * * */ | |
| 91 /* The function used to dispose of this structure */ | |
| 92 void (*free)(_THIS); | |
| 93 }; | |
| 94 #undef _THIS | |
| 95 | |
| 96 typedef struct AudioBootStrap { | |
| 97 const char *name; | |
| 98 const char *desc; | |
| 99 int (*available)(void); | |
| 100 SDL_AudioDevice *(*create)(int devindex); | |
| 101 } AudioBootStrap; | |
| 102 | |
|
1567
12b6d331d82a
Good idea, renaming OpenBSD audio to BSD audio.
Sam Lantinga <slouken@libsdl.org>
parents:
1532
diff
changeset
|
103 #if SDL_AUDIO_DRIVER_BSD |
|
12b6d331d82a
Good idea, renaming OpenBSD audio to BSD audio.
Sam Lantinga <slouken@libsdl.org>
parents:
1532
diff
changeset
|
104 extern AudioBootStrap BSD_AUDIO_bootstrap; |
|
94
ae6e6b73333f
Cleaned up the OpenBSD port, thanks to Peter Valchev
Sam Lantinga <slouken@lokigames.com>
parents:
68
diff
changeset
|
105 #endif |
|
3939
42e83d81224b
Committed PulseAudio driver. Thanks, Stephan!
Ryan C. Gordon <icculus@icculus.org>
parents:
3889
diff
changeset
|
106 #if SDL_AUDIO_DRIVER_PULSE |
|
42e83d81224b
Committed PulseAudio driver. Thanks, Stephan!
Ryan C. Gordon <icculus@icculus.org>
parents:
3889
diff
changeset
|
107 extern AudioBootStrap PULSE_bootstrap; |
|
42e83d81224b
Committed PulseAudio driver. Thanks, Stephan!
Ryan C. Gordon <icculus@icculus.org>
parents:
3889
diff
changeset
|
108 #endif |
|
1361
19418e4422cb
New configure-based build system. Still work in progress, but much improved
Sam Lantinga <slouken@libsdl.org>
parents:
1336
diff
changeset
|
109 #if SDL_AUDIO_DRIVER_OSS |
| 0 | 110 extern AudioBootStrap DSP_bootstrap; |
| 111 extern AudioBootStrap DMA_bootstrap; | |
| 112 #endif | |
|
1361
19418e4422cb
New configure-based build system. Still work in progress, but much improved
Sam Lantinga <slouken@libsdl.org>
parents:
1336
diff
changeset
|
113 #if SDL_AUDIO_DRIVER_ALSA |
| 0 | 114 extern AudioBootStrap ALSA_bootstrap; |
| 115 #endif | |
|
1361
19418e4422cb
New configure-based build system. Still work in progress, but much improved
Sam Lantinga <slouken@libsdl.org>
parents:
1336
diff
changeset
|
116 #if SDL_AUDIO_DRIVER_QNXNTO |
|
663
8bedd6d61642
Date: Sat, 2 Aug 2003 16:22:51 +0300
Sam Lantinga <slouken@libsdl.org>
parents:
654
diff
changeset
|
117 extern AudioBootStrap QNXNTOAUDIO_bootstrap; |
|
8bedd6d61642
Date: Sat, 2 Aug 2003 16:22:51 +0300
Sam Lantinga <slouken@libsdl.org>
parents:
654
diff
changeset
|
118 #endif |
|
1361
19418e4422cb
New configure-based build system. Still work in progress, but much improved
Sam Lantinga <slouken@libsdl.org>
parents:
1336
diff
changeset
|
119 #if SDL_AUDIO_DRIVER_SUNAUDIO |
|
148
8758b8d42cd9
Audio subsystem no longer assumes sun audio API on UNIX systems
Sam Lantinga <slouken@libsdl.org>
parents:
121
diff
changeset
|
120 extern AudioBootStrap SUNAUDIO_bootstrap; |
|
8758b8d42cd9
Audio subsystem no longer assumes sun audio API on UNIX systems
Sam Lantinga <slouken@libsdl.org>
parents:
121
diff
changeset
|
121 #endif |
|
1361
19418e4422cb
New configure-based build system. Still work in progress, but much improved
Sam Lantinga <slouken@libsdl.org>
parents:
1336
diff
changeset
|
122 #if SDL_AUDIO_DRIVER_DMEDIA |
|
148
8758b8d42cd9
Audio subsystem no longer assumes sun audio API on UNIX systems
Sam Lantinga <slouken@libsdl.org>
parents:
121
diff
changeset
|
123 extern AudioBootStrap DMEDIA_bootstrap; |
|
35
d3bc792e136d
Added detection of Open Sound System on Solaris x86
Sam Lantinga <slouken@lokigames.com>
parents:
21
diff
changeset
|
124 #endif |
|
1361
19418e4422cb
New configure-based build system. Still work in progress, but much improved
Sam Lantinga <slouken@libsdl.org>
parents:
1336
diff
changeset
|
125 #if SDL_AUDIO_DRIVER_ARTS |
|
19418e4422cb
New configure-based build system. Still work in progress, but much improved
Sam Lantinga <slouken@libsdl.org>
parents:
1336
diff
changeset
|
126 extern AudioBootStrap ARTS_bootstrap; |
| 0 | 127 #endif |
|
1361
19418e4422cb
New configure-based build system. Still work in progress, but much improved
Sam Lantinga <slouken@libsdl.org>
parents:
1336
diff
changeset
|
128 #if SDL_AUDIO_DRIVER_ESD |
| 0 | 129 extern AudioBootStrap ESD_bootstrap; |
| 130 #endif | |
|
1361
19418e4422cb
New configure-based build system. Still work in progress, but much improved
Sam Lantinga <slouken@libsdl.org>
parents:
1336
diff
changeset
|
131 #if SDL_AUDIO_DRIVER_NAS |
| 0 | 132 extern AudioBootStrap NAS_bootstrap; |
| 133 #endif | |
|
1361
19418e4422cb
New configure-based build system. Still work in progress, but much improved
Sam Lantinga <slouken@libsdl.org>
parents:
1336
diff
changeset
|
134 #if SDL_AUDIO_DRIVER_DSOUND |
| 0 | 135 extern AudioBootStrap DSOUND_bootstrap; |
| 136 #endif | |
|
1361
19418e4422cb
New configure-based build system. Still work in progress, but much improved
Sam Lantinga <slouken@libsdl.org>
parents:
1336
diff
changeset
|
137 #if SDL_AUDIO_DRIVER_WAVEOUT |
| 0 | 138 extern AudioBootStrap WAVEOUT_bootstrap; |
| 139 #endif | |
|
1361
19418e4422cb
New configure-based build system. Still work in progress, but much improved
Sam Lantinga <slouken@libsdl.org>
parents:
1336
diff
changeset
|
140 #if SDL_AUDIO_DRIVER_PAUD |
|
21
75a95f82bc1f
Updated the Amiga OS port of SDL (thanks Gabriele)
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
141 extern AudioBootStrap Paud_bootstrap; |
|
75a95f82bc1f
Updated the Amiga OS port of SDL (thanks Gabriele)
Sam Lantinga <slouken@lokigames.com>
parents:
0
diff
changeset
|
142 #endif |
|
1361
19418e4422cb
New configure-based build system. Still work in progress, but much improved
Sam Lantinga <slouken@libsdl.org>
parents:
1336
diff
changeset
|
143 #if SDL_AUDIO_DRIVER_BAUDIO |
| 0 | 144 extern AudioBootStrap BAUDIO_bootstrap; |
| 145 #endif | |
|
1361
19418e4422cb
New configure-based build system. Still work in progress, but much improved
Sam Lantinga <slouken@libsdl.org>
parents:
1336
diff
changeset
|
146 #if SDL_AUDIO_DRIVER_COREAUDIO |
|
935
f8d5ddc7aef1
Audio improvements from Max Horn, including a new CoreAudio driver for MacOSX
Sam Lantinga <slouken@libsdl.org>
parents:
769
diff
changeset
|
147 extern AudioBootStrap COREAUDIO_bootstrap; |
|
f8d5ddc7aef1
Audio improvements from Max Horn, including a new CoreAudio driver for MacOSX
Sam Lantinga <slouken@libsdl.org>
parents:
769
diff
changeset
|
148 #endif |
|
1361
19418e4422cb
New configure-based build system. Still work in progress, but much improved
Sam Lantinga <slouken@libsdl.org>
parents:
1336
diff
changeset
|
149 #if SDL_AUDIO_DRIVER_SNDMGR |
| 0 | 150 extern AudioBootStrap SNDMGR_bootstrap; |
| 151 #endif | |
|
1361
19418e4422cb
New configure-based build system. Still work in progress, but much improved
Sam Lantinga <slouken@libsdl.org>
parents:
1336
diff
changeset
|
152 #if SDL_AUDIO_DRIVER_MINT |
|
644
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
630
diff
changeset
|
153 extern AudioBootStrap MINTAUDIO_GSXB_bootstrap; |
|
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
630
diff
changeset
|
154 extern AudioBootStrap MINTAUDIO_MCSN_bootstrap; |
|
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
630
diff
changeset
|
155 extern AudioBootStrap MINTAUDIO_STFA_bootstrap; |
|
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
630
diff
changeset
|
156 extern AudioBootStrap MINTAUDIO_XBIOS_bootstrap; |
|
594422ab8f9f
Atari MiNT: added more audio drivers
Patrice Mandin <patmandin@gmail.com>
parents:
630
diff
changeset
|
157 extern AudioBootStrap MINTAUDIO_DMA8_bootstrap; |
|
398
d219b0e02f5f
Added Atari audio support (thanks Patrice!)
Sam Lantinga <slouken@libsdl.org>
parents:
322
diff
changeset
|
158 #endif |
|
1361
19418e4422cb
New configure-based build system. Still work in progress, but much improved
Sam Lantinga <slouken@libsdl.org>
parents:
1336
diff
changeset
|
159 #if SDL_AUDIO_DRIVER_DISK |
|
68
ac6645260d31
Added an audio driver that writes to disk (thanks Ryan!)
Sam Lantinga <slouken@lokigames.com>
parents:
37
diff
changeset
|
160 extern AudioBootStrap DISKAUD_bootstrap; |
|
ac6645260d31
Added an audio driver that writes to disk (thanks Ryan!)
Sam Lantinga <slouken@lokigames.com>
parents:
37
diff
changeset
|
161 #endif |
|
1532
30f189cdd82b
Implemented dummy audio driver.
Ryan C. Gordon <icculus@icculus.org>
parents:
1402
diff
changeset
|
162 #if SDL_AUDIO_DRIVER_DUMMY |
|
30f189cdd82b
Implemented dummy audio driver.
Ryan C. Gordon <icculus@icculus.org>
parents:
1402
diff
changeset
|
163 extern AudioBootStrap DUMMYAUD_bootstrap; |
|
30f189cdd82b
Implemented dummy audio driver.
Ryan C. Gordon <icculus@icculus.org>
parents:
1402
diff
changeset
|
164 #endif |
|
1361
19418e4422cb
New configure-based build system. Still work in progress, but much improved
Sam Lantinga <slouken@libsdl.org>
parents:
1336
diff
changeset
|
165 #if SDL_AUDIO_DRIVER_DC |
|
509
dad72daf44b3
Added initial support for Dreamcast (thanks HERO!)
Sam Lantinga <slouken@libsdl.org>
parents:
398
diff
changeset
|
166 extern AudioBootStrap DCAUD_bootstrap; |
|
dad72daf44b3
Added initial support for Dreamcast (thanks HERO!)
Sam Lantinga <slouken@libsdl.org>
parents:
398
diff
changeset
|
167 #endif |
|
3976
8582c6a5ca16
Added initial support for Nintendo DS, based on the work by Troy Davis (GPF)
Sam Lantinga <slouken@libsdl.org>
parents:
3975
diff
changeset
|
168 #if SDL_AUDIO_DRIVER_NDS |
|
8582c6a5ca16
Added initial support for Nintendo DS, based on the work by Troy Davis (GPF)
Sam Lantinga <slouken@libsdl.org>
parents:
3975
diff
changeset
|
169 extern AudioBootStrap NDSAUD_bootstrap; |
|
8582c6a5ca16
Added initial support for Nintendo DS, based on the work by Troy Davis (GPF)
Sam Lantinga <slouken@libsdl.org>
parents:
3975
diff
changeset
|
170 #endif |
|
1361
19418e4422cb
New configure-based build system. Still work in progress, but much improved
Sam Lantinga <slouken@libsdl.org>
parents:
1336
diff
changeset
|
171 #if SDL_AUDIO_DRIVER_MMEAUDIO |
|
654
e92bcf2573cb
Added audio and CD-ROM support for OSF/Tru64 (thanks Hayashi!)
Sam Lantinga <slouken@libsdl.org>
parents:
644
diff
changeset
|
172 extern AudioBootStrap MMEAUDIO_bootstrap; |
|
e92bcf2573cb
Added audio and CD-ROM support for OSF/Tru64 (thanks Hayashi!)
Sam Lantinga <slouken@libsdl.org>
parents:
644
diff
changeset
|
173 #endif |
|
1361
19418e4422cb
New configure-based build system. Still work in progress, but much improved
Sam Lantinga <slouken@libsdl.org>
parents:
1336
diff
changeset
|
174 #if SDL_AUDIO_DRIVER_DART |
| 1190 | 175 extern AudioBootStrap DART_bootstrap; |
| 176 #endif | |
| 3975 | 177 #if SDL_AUDIO_DRIVER_EPOCAUDIO |
| 178 extern AudioBootStrap EPOCAudio_bootstrap; | |
| 179 #endif | |
| 0 | 180 |
| 181 /* This is the current audio device */ | |
| 182 extern SDL_AudioDevice *current_audio; | |
| 183 | |
| 184 #endif /* _SDL_sysaudio_h */ |