src/audio/SDL_sysaudio.h
author Sam Lantinga <slouken@libsdl.org>
Fri, 14 Dec 2001 13:13:20 +0000
changeset 254 4fc12b8edf74
parent 252 e8157fcb3114
child 297 f6ffac90895c
permissions -rw-r--r--
*** empty log message ***
     1 /*
     2     SDL - Simple DirectMedia Layer
     3     Copyright (C) 1997, 1998, 1999, 2000, 2001  Sam Lantinga
     4 
     5     This library is free software; you can redistribute it and/or
     6     modify it under the terms of the GNU Library General Public
     7     License as published by the Free Software Foundation; either
     8     version 2 of the License, or (at your option) any later version.
     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
    13     Library General Public License for more details.
    14 
    15     You should have received a copy of the GNU Library General Public
    16     License along with this library; if not, write to the Free
    17     Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
    18 
    19     Sam Lantinga
    20     slouken@libsdl.org
    21 */
    22 
    23 #ifdef SAVE_RCSID
    24 static char rcsid =
    25  "@(#) $Id$";
    26 #endif
    27 
    28 #ifndef _SDL_sysaudio_h
    29 #define _SDL_sysaudio_h
    30 
    31 #include "SDL_mutex.h"
    32 #include "SDL_thread.h"
    33 
    34 /* The SDL audio driver */
    35 typedef struct SDL_AudioDevice SDL_AudioDevice;
    36 
    37 /* Define the SDL audio driver structure */
    38 #define _THIS	SDL_AudioDevice *_this
    39 #ifndef _STATUS
    40 #define _STATUS	SDL_status *status
    41 #endif
    42 struct SDL_AudioDevice {
    43 	/* * * */
    44 	/* The name of this audio driver */
    45 	const char *name;
    46 
    47 	/* * * */
    48 	/* The description of this audio driver */
    49 	const char *desc;
    50 
    51 	/* * * */
    52 	/* Public driver functions */
    53 	int  (*OpenAudio)(_THIS, SDL_AudioSpec *spec);
    54 	void (*ThreadInit)(_THIS);	/* Called by audio thread at start */
    55 	void (*WaitAudio)(_THIS);
    56 	void (*PlayAudio)(_THIS);
    57 	Uint8 *(*GetAudioBuf)(_THIS);
    58 	void (*WaitDone)(_THIS);
    59 	void (*CloseAudio)(_THIS);
    60 
    61 	/* * * */
    62 	/* Data common to all devices */
    63 
    64 	/* The current audio specification (shared with audio thread) */
    65 	SDL_AudioSpec spec;
    66 
    67 	/* An audio conversion block for audio format emulation */
    68 	SDL_AudioCVT convert;
    69 
    70 	/* Current state flags */
    71 	int enabled;
    72 	int paused;
    73 	int opened;
    74 
    75 	/* Fake audio buffer for when the audio hardware is busy */
    76 	Uint8 *fake_stream;
    77 
    78 	/* A semaphore for locking the mixing buffers */
    79 	SDL_mutex *mixer_lock;
    80 
    81 	/* A thread to feed the audio device */
    82 	SDL_Thread *thread;
    83 	Uint32 threadid;
    84 
    85 	/* * * */
    86 	/* Data private to this driver */
    87 	struct SDL_PrivateAudioData *hidden;
    88 
    89 	/* * * */
    90 	/* The function used to dispose of this structure */
    91 	void (*free)(_THIS);
    92 };
    93 #undef _THIS
    94 
    95 typedef struct AudioBootStrap {
    96 	const char *name;
    97 	const char *desc;
    98 	int (*available)(void);
    99 	SDL_AudioDevice *(*create)(int devindex);
   100 } AudioBootStrap;
   101 
   102 #ifdef OPENBSD_AUDIO_SUPPORT
   103 extern AudioBootStrap OPENBSD_AUDIO_bootstrap;
   104 #endif
   105 #ifdef OSS_SUPPORT
   106 extern AudioBootStrap DSP_bootstrap;
   107 extern AudioBootStrap DMA_bootstrap;
   108 #endif
   109 #ifdef ALSA_SUPPORT
   110 extern AudioBootStrap ALSA_bootstrap;
   111 #endif
   112 #ifdef SUNAUDIO_SUPPORT
   113 extern AudioBootStrap SUNAUDIO_bootstrap;
   114 #endif
   115 #ifdef DMEDIA_SUPPORT
   116 extern AudioBootStrap DMEDIA_bootstrap;
   117 #endif
   118 #ifdef ARTSC_SUPPORT
   119 extern AudioBootStrap ARTSC_bootstrap;
   120 #endif
   121 #ifdef ESD_SUPPORT
   122 extern AudioBootStrap ESD_bootstrap;
   123 #endif
   124 #ifdef NAS_SUPPORT
   125 extern AudioBootStrap NAS_bootstrap;
   126 #endif
   127 #ifdef ENABLE_DIRECTX
   128 extern AudioBootStrap DSOUND_bootstrap;
   129 #endif
   130 #ifdef ENABLE_WINDIB
   131 extern AudioBootStrap WAVEOUT_bootstrap;
   132 #endif
   133 #ifdef _AIX
   134 extern AudioBootStrap Paud_bootstrap;
   135 #endif
   136 #ifdef __BEOS__
   137 extern AudioBootStrap BAUDIO_bootstrap;
   138 #endif
   139 #if defined(macintosh) || TARGET_API_MAC_CARBON
   140 extern AudioBootStrap SNDMGR_bootstrap;
   141 #endif
   142 #ifdef ENABLE_AHI
   143 extern AudioBootStrap AHI_bootstrap;
   144 #endif
   145 #ifdef DISKAUD_SUPPORT
   146 extern AudioBootStrap DISKAUD_bootstrap;
   147 #endif
   148 
   149 /* This is the current audio device */
   150 extern SDL_AudioDevice *current_audio;
   151 
   152 #endif /* _SDL_sysaudio_h */