1190
+ − 1 /*
+ − 2 SDL - Simple DirectMedia Layer
+ − 3 Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002 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 /* Allow access to a raw mixing buffer */
+ − 29
+ − 30 #include <stdio.h>
+ − 31 #include <stdlib.h>
+ − 32 #include <string.h>
+ − 33
+ − 34 #include "SDL_types.h"
+ − 35 #include "SDL_error.h"
+ − 36 #include "SDL_timer.h"
+ − 37 #include "SDL_audio.h"
+ − 38 #include "SDL_audio_c.h"
+ − 39 #include "SDL_dart.h"
+ − 40
+ − 41 // Buffer states:
+ − 42 #define BUFFER_EMPTY 0
+ − 43 #define BUFFER_USED 1
+ − 44
+ − 45 typedef struct _tMixBufferDesc {
+ − 46 int iBufferUsage; // BUFFER_EMPTY or BUFFER_USED
+ − 47 SDL_AudioDevice *pSDLAudioDevice;
+ − 48 } tMixBufferDesc, *pMixBufferDesc;
+ − 49
+ − 50
+ − 51 //---------------------------------------------------------------------
+ − 52 // DARTEventFunc
+ − 53 //
+ − 54 // This function is called by DART, when an event occures, like end of
+ − 55 // playback of a buffer, etc...
+ − 56 //---------------------------------------------------------------------
+ − 57 LONG APIENTRY DARTEventFunc(ULONG ulStatus,
+ − 58 PMCI_MIX_BUFFER pBuffer,
+ − 59 ULONG ulFlags)
+ − 60 {
+ − 61 if (ulFlags && MIX_WRITE_COMPLETE)
+ − 62 { // Playback of buffer completed!
+ − 63
+ − 64 // Get pointer to buffer description
+ − 65 pMixBufferDesc pBufDesc;
+ − 66
+ − 67 if (pBuffer)
+ − 68 {
+ − 69 pBufDesc = (pMixBufferDesc) (*pBuffer).ulUserParm;
+ − 70
+ − 71 if (pBufDesc)
+ − 72 {
+ − 73 SDL_AudioDevice *pSDLAudioDevice = pBufDesc->pSDLAudioDevice;
+ − 74 // Set the buffer to be empty
+ − 75 pBufDesc->iBufferUsage = BUFFER_EMPTY;
+ − 76 // And notify DART feeder thread that it will have to work a bit.
+ − 77 if (pSDLAudioDevice)
+ − 78 DosPostEventSem(pSDLAudioDevice->hidden->hevAudioBufferPlayed);
+ − 79 }
+ − 80 }
+ − 81 }
+ − 82 return TRUE;
+ − 83 }
+ − 84
+ − 85
+ − 86 int DART_OpenAudio(_THIS, SDL_AudioSpec *spec)
+ − 87 {
+ − 88 MCI_AMP_OPEN_PARMS AmpOpenParms;
+ − 89 MCI_GENERIC_PARMS GenericParms;
+ − 90 int iDeviceOrd = 0; // Default device to be used
+ − 91 int bOpenShared = 1; // Try opening it shared
+ − 92 int iBits = 16; // Default is 16 bits signed
+ − 93 int iFreq = 44100; // Default is 44KHz
+ − 94 int iChannels = 2; // Default is 2 channels (Stereo)
+ − 95 int iNumBufs = 2; // Number of audio buffers: 2
+ − 96 int iBufSize;
+ − 97 int iOpenMode;
+ − 98 int iSilence;
+ − 99 int rc;
+ − 100
+ − 101 // First thing is to try to open a given DART device!
+ − 102 memset(&AmpOpenParms, 0, sizeof(MCI_AMP_OPEN_PARMS));
+ − 103 // pszDeviceType should contain the device type in low word, and device ordinal in high word!
+ − 104 AmpOpenParms.pszDeviceType = (PSZ) (MCI_DEVTYPE_AUDIO_AMPMIX | (iDeviceOrd << 16));
+ − 105
+ − 106 iOpenMode = MCI_WAIT | MCI_OPEN_TYPE_ID;
+ − 107 if (bOpenShared) iOpenMode |= MCI_OPEN_SHAREABLE;
+ − 108
+ − 109 rc = mciSendCommand( 0, MCI_OPEN,
+ − 110 iOpenMode,
+ − 111 (PVOID) &AmpOpenParms, 0);
+ − 112 if (rc!=MCIERR_SUCCESS) // No audio available??
+ − 113 return (-1);
+ − 114 // Save the device ID we got from DART!
+ − 115 // We will use this in the next calls!
+ − 116 iDeviceOrd = AmpOpenParms.usDeviceID;
+ − 117
+ − 118 // Determine the audio parameters from the AudioSpec
+ − 119 switch ( spec->format & 0xFF )
+ − 120 {
+ − 121 case 8:
+ − 122 /* Unsigned 8 bit audio data */
+ − 123 spec->format = AUDIO_U8;
+ − 124 iSilence = 0x80;
+ − 125 iBits = 8;
+ − 126 break;
+ − 127 case 16:
+ − 128 /* Signed 16 bit audio data */
+ − 129 spec->format = AUDIO_S16;
+ − 130 iSilence = 0x00;
+ − 131 iBits = 16;
+ − 132 break;
+ − 133 default:
+ − 134 // Close DART, and exit with error code!
+ − 135 mciSendCommand(iDeviceOrd, MCI_CLOSE, MCI_WAIT, &GenericParms, 0);
+ − 136 SDL_SetError("Unsupported audio format");
+ − 137 return(-1);
+ − 138 }
+ − 139 iFreq = spec->freq;
+ − 140 iChannels = spec->channels;
+ − 141 /* Update the fragment size as size in bytes */
+ − 142 SDL_CalculateAudioSpec(spec);
+ − 143 iBufSize = spec->size;
+ − 144
+ − 145 // Now query this device if it supports the given freq/bits/channels!
+ − 146 memset(&(_this->hidden->MixSetupParms), 0, sizeof(MCI_MIXSETUP_PARMS));
+ − 147 _this->hidden->MixSetupParms.ulBitsPerSample = iBits;
+ − 148 _this->hidden->MixSetupParms.ulFormatTag = MCI_WAVE_FORMAT_PCM;
+ − 149 _this->hidden->MixSetupParms.ulSamplesPerSec = iFreq;
+ − 150 _this->hidden->MixSetupParms.ulChannels = iChannels;
+ − 151 _this->hidden->MixSetupParms.ulFormatMode = MCI_PLAY;
+ − 152 _this->hidden->MixSetupParms.ulDeviceType = MCI_DEVTYPE_WAVEFORM_AUDIO;
+ − 153 _this->hidden->MixSetupParms.pmixEvent = DARTEventFunc;
+ − 154 rc = mciSendCommand (iDeviceOrd, MCI_MIXSETUP,
+ − 155 MCI_WAIT | MCI_MIXSETUP_QUERYMODE,
+ − 156 &(_this->hidden->MixSetupParms), 0);
+ − 157 if (rc!=MCIERR_SUCCESS)
+ − 158 { // The device cannot handle this format!
+ − 159 // Close DART, and exit with error code!
+ − 160 mciSendCommand(iDeviceOrd, MCI_CLOSE, MCI_WAIT, &GenericParms, 0);
+ − 161 SDL_SetError("Audio device doesn't support requested audio format");
+ − 162 return(-1);
+ − 163 }
+ − 164 // The device can handle this format, so initialize!
+ − 165 rc = mciSendCommand(iDeviceOrd, MCI_MIXSETUP,
+ − 166 MCI_WAIT | MCI_MIXSETUP_INIT,
+ − 167 &(_this->hidden->MixSetupParms), 0);
+ − 168 if (rc!=MCIERR_SUCCESS)
+ − 169 { // The device could not be opened!
+ − 170 // Close DART, and exit with error code!
+ − 171 mciSendCommand(iDeviceOrd, MCI_CLOSE, MCI_WAIT, &GenericParms, 0);
+ − 172 SDL_SetError("Audio device could not be set up");
+ − 173 return(-1);
+ − 174 }
+ − 175 // Ok, the device is initialized.
+ − 176 // Now we should allocate buffers. For this, we need a place where
+ − 177 // the buffer descriptors will be:
+ − 178 _this->hidden->pMixBuffers = (MCI_MIX_BUFFER *) malloc(sizeof(MCI_MIX_BUFFER)*iNumBufs);
+ − 179 if (!(_this->hidden->pMixBuffers))
+ − 180 { // Not enough memory!
+ − 181 // Close DART, and exit with error code!
+ − 182 mciSendCommand(iDeviceOrd, MCI_CLOSE, MCI_WAIT, &GenericParms, 0);
+ − 183 SDL_SetError("Not enough memory for audio buffer descriptors");
+ − 184 return(-1);
+ − 185 }
+ − 186 // Now that we have the place for buffer list, we can ask DART for the
+ − 187 // buffers!
+ − 188 _this->hidden->BufferParms.ulNumBuffers = iNumBufs; // Number of buffers
+ − 189 _this->hidden->BufferParms.ulBufferSize = iBufSize; // each with this size
+ − 190 _this->hidden->BufferParms.pBufList = _this->hidden->pMixBuffers; // getting descriptorts into this list
+ − 191 // Allocate buffers!
+ − 192 rc = mciSendCommand(iDeviceOrd, MCI_BUFFER,
+ − 193 MCI_WAIT | MCI_ALLOCATE_MEMORY,
+ − 194 &(_this->hidden->BufferParms), 0);
+ − 195 if ((rc!=MCIERR_SUCCESS) || (iNumBufs != _this->hidden->BufferParms.ulNumBuffers) || (_this->hidden->BufferParms.ulBufferSize==0))
+ − 196 { // Could not allocate memory!
+ − 197 // Close DART, and exit with error code!
+ − 198 free(_this->hidden->pMixBuffers); _this->hidden->pMixBuffers = NULL;
+ − 199 mciSendCommand(iDeviceOrd, MCI_CLOSE, MCI_WAIT, &GenericParms, 0);
+ − 200 SDL_SetError("DART could not allocate buffers");
+ − 201 return(-1);
+ − 202 }
+ − 203 // Ok, we have all the buffers allocated, let's mark them!
+ − 204 {
+ − 205 int i;
+ − 206 for (i=0; i<iNumBufs; i++)
+ − 207 {
+ − 208 pMixBufferDesc pBufferDesc = (pMixBufferDesc) malloc(sizeof(tMixBufferDesc));;
+ − 209 // Check if this buffer was really allocated by DART
+ − 210 if ((!(_this->hidden->pMixBuffers[i].pBuffer)) || (!pBufferDesc))
+ − 211 { // Wrong buffer!
+ − 212 // Close DART, and exit with error code!
+ − 213 // Free buffer descriptions
+ − 214 { int j;
+ − 215 for (j=0; j<i; j++) free((void *)(_this->hidden->pMixBuffers[j].ulUserParm));
+ − 216 }
+ − 217 // and cleanup
+ − 218 mciSendCommand(iDeviceOrd, MCI_BUFFER, MCI_WAIT | MCI_DEALLOCATE_MEMORY, &(_this->hidden->BufferParms), 0);
+ − 219 free(_this->hidden->pMixBuffers); _this->hidden->pMixBuffers = NULL;
+ − 220 mciSendCommand(iDeviceOrd, MCI_CLOSE, MCI_WAIT, &GenericParms, 0);
+ − 221 SDL_SetError("Error at internal buffer check");
+ − 222 return(-1);
+ − 223 }
+ − 224 pBufferDesc->iBufferUsage = BUFFER_EMPTY;
+ − 225 pBufferDesc->pSDLAudioDevice = _this;
+ − 226
+ − 227 _this->hidden->pMixBuffers[i].ulBufferLength = _this->hidden->BufferParms.ulBufferSize;
+ − 228 _this->hidden->pMixBuffers[i].ulUserParm = (ULONG) pBufferDesc; // User parameter: Description of buffer
+ − 229 _this->hidden->pMixBuffers[i].ulFlags = 0; // Some stuff should be flagged here for DART, like end of
+ − 230 // audio data, but as we will continously send
+ − 231 // audio data, there will be no end.:)
+ − 232 memset(_this->hidden->pMixBuffers[i].pBuffer, iSilence, iBufSize);
+ − 233 }
+ − 234 }
+ − 235 _this->hidden->iNextFreeBuffer = 0;
+ − 236 _this->hidden->iLastPlayedBuf = -1;
+ − 237 // Create event semaphore
+ − 238 if (DosCreateEventSem(NULL, &(_this->hidden->hevAudioBufferPlayed), 0, FALSE)!=NO_ERROR)
+ − 239 {
+ − 240 // Could not create event semaphore!
+ − 241 {
+ − 242 int i;
+ − 243 for (i=0; i<iNumBufs; i++) free((void *)(_this->hidden->pMixBuffers[i].ulUserParm));
+ − 244 }
+ − 245 mciSendCommand(iDeviceOrd, MCI_BUFFER, MCI_WAIT | MCI_DEALLOCATE_MEMORY, &(_this->hidden->BufferParms), 0);
+ − 246 free(_this->hidden->pMixBuffers); _this->hidden->pMixBuffers = NULL;
+ − 247 mciSendCommand(iDeviceOrd, MCI_CLOSE, MCI_WAIT, &GenericParms, 0);
+ − 248 SDL_SetError("Could not create event semaphore");
+ − 249 return(-1);
+ − 250 }
+ − 251
+ − 252 // Store the new settings in global variables
+ − 253 _this->hidden->iCurrDeviceOrd = iDeviceOrd;
+ − 254 _this->hidden->iCurrFreq = iFreq;
+ − 255 _this->hidden->iCurrBits = iBits;
+ − 256 _this->hidden->iCurrChannels = iChannels;
+ − 257 _this->hidden->iCurrNumBufs = iNumBufs;
+ − 258 _this->hidden->iCurrBufSize = iBufSize;
+ − 259
+ − 260 return (0);
+ − 261 }
+ − 262
+ − 263
+ − 264
+ − 265 void DART_ThreadInit(_THIS)
+ − 266 {
+ − 267 return;
+ − 268 }
+ − 269
+ − 270 /* This function waits until it is possible to write a full sound buffer */
+ − 271 void DART_WaitAudio(_THIS)
+ − 272 {
+ − 273 int i;
+ − 274 pMixBufferDesc pBufDesc;
+ − 275 ULONG ulPostCount;
+ − 276
+ − 277 DosResetEventSem(_this->hidden->hevAudioBufferPlayed, &ulPostCount);
+ − 278 // If there is already an empty buffer, then return now!
+ − 279 for (i=0; i<_this->hidden->iCurrNumBufs; i++)
+ − 280 {
+ − 281 pBufDesc = (pMixBufferDesc) _this->hidden->pMixBuffers[i].ulUserParm;
+ − 282 if (pBufDesc->iBufferUsage == BUFFER_EMPTY)
+ − 283 return;
+ − 284 }
+ − 285 // If there is no empty buffer, wait for one to be empty!
+ − 286 DosWaitEventSem(_this->hidden->hevAudioBufferPlayed, 1000); // Wait max 1 sec!!! Important!
+ − 287 return;
+ − 288 }
+ − 289
+ − 290 void DART_PlayAudio(_THIS)
+ − 291 {
+ − 292 int iFreeBuf = _this->hidden->iNextFreeBuffer;
+ − 293 pMixBufferDesc pBufDesc;
+ − 294
+ − 295 pBufDesc = (pMixBufferDesc) _this->hidden->pMixBuffers[iFreeBuf].ulUserParm;
+ − 296 pBufDesc->iBufferUsage = BUFFER_USED;
+ − 297 // Send it to DART to be queued
+ − 298 _this->hidden->MixSetupParms.pmixWrite(_this->hidden->MixSetupParms.ulMixHandle,
+ − 299 &(_this->hidden->pMixBuffers[iFreeBuf]), 1);
+ − 300
+ − 301 _this->hidden->iLastPlayedBuf = iFreeBuf;
+ − 302 iFreeBuf = (iFreeBuf+1) % _this->hidden->iCurrNumBufs;
+ − 303 _this->hidden->iNextFreeBuffer = iFreeBuf;
+ − 304 }
+ − 305
+ − 306 Uint8 *DART_GetAudioBuf(_THIS)
+ − 307 {
+ − 308 int iFreeBuf;
+ − 309 Uint8 *pResult;
+ − 310 pMixBufferDesc pBufDesc;
+ − 311
+ − 312 if (_this)
+ − 313 {
+ − 314 if (_this->hidden)
+ − 315 {
+ − 316 iFreeBuf = _this->hidden->iNextFreeBuffer;
+ − 317 pBufDesc = (pMixBufferDesc) _this->hidden->pMixBuffers[iFreeBuf].ulUserParm;
+ − 318
+ − 319 if (pBufDesc)
+ − 320 {
+ − 321 if (pBufDesc->iBufferUsage == BUFFER_EMPTY)
+ − 322 {
+ − 323 pResult = _this->hidden->pMixBuffers[iFreeBuf].pBuffer;
+ − 324 return pResult;
+ − 325 }
+ − 326 } else
+ − 327 printf("[DART_GetAudioBuf] : ERROR! pBufDesc = %p\n", pBufDesc);
+ − 328 } else
+ − 329 printf("[DART_GetAudioBuf] : ERROR! _this->hidden = %p\n", _this->hidden);
+ − 330 } else
+ − 331 printf("[DART_GetAudioBuf] : ERROR! _this = %p\n", _this);
+ − 332 return NULL;
+ − 333 }
+ − 334
+ − 335 void DART_WaitDone(_THIS)
+ − 336 {
+ − 337 pMixBufferDesc pBufDesc;
+ − 338 ULONG ulPostCount;
+ − 339 APIRET rc;
+ − 340
+ − 341 pBufDesc = (pMixBufferDesc) _this->hidden->pMixBuffers[_this->hidden->iLastPlayedBuf].ulUserParm;
+ − 342 rc = NO_ERROR;
+ − 343 while ((pBufDesc->iBufferUsage != BUFFER_EMPTY) && (rc==NO_ERROR))
+ − 344 {
+ − 345 DosResetEventSem(_this->hidden->hevAudioBufferPlayed, &ulPostCount);
+ − 346 rc = DosWaitEventSem(_this->hidden->hevAudioBufferPlayed, 1000); // 1 sec timeout! Important!
+ − 347 }
+ − 348 }
+ − 349
+ − 350 void DART_CloseAudio(_THIS)
+ − 351 {
+ − 352 MCI_GENERIC_PARMS GenericParms;
+ − 353 int rc;
+ − 354
+ − 355 // Stop DART playback
+ − 356 rc = mciSendCommand(_this->hidden->iCurrDeviceOrd, MCI_STOP, MCI_WAIT, &GenericParms, 0);
+ − 357 if (rc!=MCIERR_SUCCESS)
+ − 358 {
+ − 359 #ifdef SFX_DEBUG_BUILD
+ − 360 printf("Could not stop DART playback!\n");
+ − 361 fflush(stdout);
+ − 362 #endif
+ − 363 }
+ − 364
+ − 365 // Close event semaphore
+ − 366 DosCloseEventSem(_this->hidden->hevAudioBufferPlayed);
+ − 367
+ − 368 // Free memory of buffer descriptions
+ − 369 {
+ − 370 int i;
+ − 371 for (i=0; i<_this->hidden->iCurrNumBufs; i++) free((void *)(_this->hidden->pMixBuffers[i].ulUserParm));
+ − 372 }
+ − 373
+ − 374 // Deallocate buffers
+ − 375 rc = mciSendCommand(_this->hidden->iCurrDeviceOrd, MCI_BUFFER, MCI_WAIT | MCI_DEALLOCATE_MEMORY, &(_this->hidden->BufferParms), 0);
+ − 376
+ − 377 // Free bufferlist
+ − 378 free(_this->hidden->pMixBuffers); _this->hidden->pMixBuffers = NULL;
+ − 379
+ − 380 // Close dart
+ − 381 rc = mciSendCommand(_this->hidden->iCurrDeviceOrd, MCI_CLOSE, MCI_WAIT, &(GenericParms), 0);
+ − 382 }
+ − 383
+ − 384 /* Audio driver bootstrap functions */
+ − 385
+ − 386 int Audio_Available(void)
+ − 387 {
+ − 388 return(1);
+ − 389 }
+ − 390
+ − 391 void Audio_DeleteDevice(SDL_AudioDevice *device)
+ − 392 {
+ − 393 free(device->hidden);
+ − 394 free(device);
+ − 395 }
+ − 396
+ − 397 SDL_AudioDevice *Audio_CreateDevice(int devindex)
+ − 398 {
+ − 399 SDL_AudioDevice *this;
+ − 400
+ − 401 /* Initialize all variables that we clean on shutdown */
+ − 402 this = (SDL_AudioDevice *)malloc(sizeof(SDL_AudioDevice));
+ − 403 if ( this )
+ − 404 {
+ − 405 memset(this, 0, (sizeof *this));
+ − 406 this->hidden = (struct SDL_PrivateAudioData *)
+ − 407 malloc((sizeof *this->hidden));
+ − 408 }
+ − 409 if ( (this == NULL) || (this->hidden == NULL) )
+ − 410 {
+ − 411 SDL_OutOfMemory();
+ − 412 if ( this )
+ − 413 free(this);
+ − 414 return(0);
+ − 415 }
+ − 416 memset(this->hidden, 0, (sizeof *this->hidden));
+ − 417
+ − 418 /* Set the function pointers */
+ − 419 this->OpenAudio = DART_OpenAudio;
+ − 420 this->ThreadInit = DART_ThreadInit;
+ − 421 this->WaitAudio = DART_WaitAudio;
+ − 422 this->PlayAudio = DART_PlayAudio;
+ − 423 this->GetAudioBuf = DART_GetAudioBuf;
+ − 424 this->WaitDone = DART_WaitDone;
+ − 425 this->CloseAudio = DART_CloseAudio;
+ − 426
+ − 427 this->free = Audio_DeleteDevice;
+ − 428
+ − 429 return this;
+ − 430 }
+ − 431
+ − 432 AudioBootStrap DART_bootstrap = {
+ − 433 "dart", "OS/2 Direct Audio RouTines (DART)",
+ − 434 Audio_Available, Audio_CreateDevice
+ − 435 };
+ − 436
