2 Copyright (C) 1996-1997 Id Software, Inc.
4 This program is free software; you can redistribute it and/or
5 modify it under the terms of the GNU General Public License
6 as published by the Free Software Foundation; either version 2
7 of the License, or (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
13 See the GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the Free Software
17 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
24 extern HWND mainwindow;
26 #define iDirectSoundCreate(a,b,c) pDirectSoundCreate(a,b,c)
28 HRESULT (WINAPI *pDirectSoundCreate)(GUID FAR *lpGUID, LPDIRECTSOUND FAR *lplpDS, IUnknown FAR *pUnkOuter);
30 // 64K is > 1 second at 16-bit, 22050 Hz
31 #define WAV_BUFFERS 64
33 #define WAV_BUFFER_SIZE 0x0400
34 #define SECONDARY_BUFFER_SIZE 0x10000
36 typedef enum {SIS_SUCCESS, SIS_FAILURE, SIS_NOTAVAIL} sndinitstat;
38 static qboolean wavonly;
39 static qboolean dsound_init;
40 static qboolean wav_init;
41 static qboolean snd_firsttime = true, snd_isdirect, snd_iswave;
42 static qboolean primary_format_set;
45 static int snd_sent, snd_completed;
49 * Global variables. Must be visible to window-procedure function
50 * so it can unlock and free the data block after it has been played.
54 HPSTR lpData, lpData2;
68 LPDIRECTSOUNDBUFFER pDSBuf, pDSPBuf;
72 qboolean SNDDMA_InitWav (void);
73 sndinitstat SNDDMA_InitDirect (void);
80 void S_BlockSound (void)
83 // DirectSound takes care of blocking itself
90 waveOutReset (hWaveOut);
101 void S_UnblockSound (void)
104 // DirectSound takes care of blocking itself
117 void FreeSound (void)
123 pDSBuf->lpVtbl->Stop(pDSBuf);
124 pDSBuf->lpVtbl->Release(pDSBuf);
127 // only release primary buffer if it's not also the mixing buffer we just released
128 if (pDSPBuf && (pDSBuf != pDSPBuf))
130 pDSPBuf->lpVtbl->Release(pDSPBuf);
135 pDS->lpVtbl->SetCooperativeLevel (pDS, mainwindow, DSSCL_NORMAL);
136 pDS->lpVtbl->Release(pDS);
141 waveOutReset (hWaveOut);
145 for (i=0 ; i< WAV_BUFFERS ; i++)
146 waveOutUnprepareHeader (hWaveOut, lpWaveHdr+i, sizeof(WAVEHDR));
149 waveOutClose (hWaveOut);
153 GlobalUnlock(hWaveHdr);
154 GlobalFree(hWaveHdr);
185 sndinitstat SNDDMA_InitDirect (void)
189 DWORD dwSize, dwWrite;
191 WAVEFORMATEX format, pformat;
196 memset((void *)shm, 0, sizeof(*shm));
198 shm->samplebits = 16;
199 i = COM_CheckParm ("-sndspeed"); // LordHavoc: -sndspeed option
200 if (i && i != (com_argc - 1))
201 shm->speed = atoi(com_argv[i+1]);
205 memset (&format, 0, sizeof(format));
206 format.wFormatTag = WAVE_FORMAT_PCM;
207 format.nChannels = shm->channels;
208 format.wBitsPerSample = shm->samplebits;
209 format.nSamplesPerSec = shm->speed;
210 format.nBlockAlign = format.nChannels * format.wBitsPerSample / 8;
212 format.nAvgBytesPerSec = format.nSamplesPerSec * format.nBlockAlign;
216 hInstDS = LoadLibrary("dsound.dll");
220 Con_SafePrintf ("Couldn't load dsound.dll\n");
224 pDirectSoundCreate = (void *)GetProcAddress(hInstDS,"DirectSoundCreate");
226 if (!pDirectSoundCreate)
228 Con_SafePrintf ("Couldn't get DS proc addr\n");
233 while ((hresult = iDirectSoundCreate(NULL, &pDS, NULL)) != DS_OK)
235 if (hresult != DSERR_ALLOCATED)
237 Con_SafePrintf ("DirectSound create failed\n");
241 if (MessageBox (NULL,
242 "The sound hardware is in use by another app.\n\n"
243 "Select Retry to try to start sound again or Cancel to run Quake with no sound.",
244 "Sound not available",
245 MB_RETRYCANCEL | MB_SETFOREGROUND | MB_ICONEXCLAMATION) != IDRETRY)
247 Con_SafePrintf ("DirectSoundCreate failure\n"
248 " hardware already in use\n");
253 dscaps.dwSize = sizeof(dscaps);
255 if (DS_OK != pDS->lpVtbl->GetCaps (pDS, &dscaps))
257 Con_SafePrintf ("Couldn't get DS caps\n");
260 if (dscaps.dwFlags & DSCAPS_EMULDRIVER)
262 Con_SafePrintf ("No DirectSound driver installed\n");
267 if (DS_OK != pDS->lpVtbl->SetCooperativeLevel (pDS, mainwindow, DSSCL_EXCLUSIVE))
269 Con_SafePrintf ("Set coop level failed\n");
274 // get access to the primary buffer, if possible, so we can set the
275 // sound hardware format
276 memset (&dsbuf, 0, sizeof(dsbuf));
277 dsbuf.dwSize = sizeof(DSBUFFERDESC);
278 dsbuf.dwFlags = DSBCAPS_PRIMARYBUFFER;
279 dsbuf.dwBufferBytes = 0;
280 dsbuf.lpwfxFormat = NULL;
282 memset(&dsbcaps, 0, sizeof(dsbcaps));
283 dsbcaps.dwSize = sizeof(dsbcaps);
284 primary_format_set = false;
286 if (!COM_CheckParm ("-snoforceformat"))
288 if (DS_OK == pDS->lpVtbl->CreateSoundBuffer(pDS, &dsbuf, &pDSPBuf, NULL))
292 if (DS_OK != pDSPBuf->lpVtbl->SetFormat (pDSPBuf, &pformat))
295 Con_SafePrintf ("Set primary sound buffer format: no\n");
300 Con_SafePrintf ("Set primary sound buffer format: yes\n");
302 primary_format_set = true;
307 if (!primary_format_set || !COM_CheckParm ("-primarysound"))
309 // create the secondary buffer we'll actually work with
310 memset (&dsbuf, 0, sizeof(dsbuf));
311 dsbuf.dwSize = sizeof(DSBUFFERDESC);
312 dsbuf.dwFlags = DSBCAPS_CTRLFREQUENCY | DSBCAPS_LOCSOFTWARE;
313 dsbuf.dwBufferBytes = SECONDARY_BUFFER_SIZE;
314 dsbuf.lpwfxFormat = &format;
316 memset(&dsbcaps, 0, sizeof(dsbcaps));
317 dsbcaps.dwSize = sizeof(dsbcaps);
319 if (DS_OK != pDS->lpVtbl->CreateSoundBuffer(pDS, &dsbuf, &pDSBuf, NULL))
321 Con_SafePrintf ("DS:CreateSoundBuffer Failed");
326 shm->channels = format.nChannels;
327 shm->samplebits = format.wBitsPerSample;
328 shm->speed = format.nSamplesPerSec;
330 if (DS_OK != pDSBuf->lpVtbl->GetCaps (pDSBuf, &dsbcaps))
332 Con_SafePrintf ("DS:GetCaps failed\n");
338 Con_SafePrintf ("Using secondary sound buffer\n");
342 if (DS_OK != pDS->lpVtbl->SetCooperativeLevel (pDS, mainwindow, DSSCL_WRITEPRIMARY))
344 Con_SafePrintf ("Set coop level failed\n");
349 if (DS_OK != pDSPBuf->lpVtbl->GetCaps (pDSPBuf, &dsbcaps))
351 Con_Printf ("DS:GetCaps failed\n");
356 Con_SafePrintf ("Using primary sound buffer\n");
359 // Make sure mixer is active
360 pDSBuf->lpVtbl->Play(pDSBuf, 0, 0, DSBPLAY_LOOPING);
363 Con_SafePrintf(" %d channel(s)\n"
366 shm->channels, shm->samplebits, shm->speed);
368 gSndBufSize = dsbcaps.dwBufferBytes;
370 // initialize the buffer
373 while ((hresult = pDSBuf->lpVtbl->Lock(pDSBuf, 0, gSndBufSize, (LPVOID*)&lpData, &dwSize, NULL, NULL, 0)) != DS_OK)
375 if (hresult != DSERR_BUFFERLOST)
377 Con_SafePrintf ("SNDDMA_InitDirect: DS::Lock Sound Buffer Failed\n");
384 Con_SafePrintf ("SNDDMA_InitDirect: DS: couldn't restore buffer\n");
391 memset(lpData, 0, dwSize);
393 pDSBuf->lpVtbl->Unlock(pDSBuf, lpData, dwSize, NULL, 0);
395 /* we don't want anyone to access the buffer directly w/o locking it first. */
398 pDSBuf->lpVtbl->Stop(pDSBuf);
399 pDSBuf->lpVtbl->GetCurrentPosition(pDSBuf, &mmstarttime.u.sample, &dwWrite);
400 pDSBuf->lpVtbl->Play(pDSBuf, 0, 0, DSBPLAY_LOOPING);
402 shm->samples = gSndBufSize/(shm->samplebits/8);
404 shm->buffer = (unsigned char *) lpData;
405 sample16 = (shm->samplebits/8) - 1;
417 Crappy windows multimedia base
420 qboolean SNDDMA_InitWav (void)
429 memset((void *)shm, 0, sizeof(*shm));
431 shm->samplebits = 16;
432 i = COM_CheckParm ("-sndspeed"); // LordHavoc: -sndspeed option
433 if (i && i != (com_argc - 1))
434 shm->speed = atoi(com_argv[i+1]);
438 memset (&format, 0, sizeof(format));
439 format.wFormatTag = WAVE_FORMAT_PCM;
440 format.nChannels = shm->channels;
441 format.wBitsPerSample = shm->samplebits;
442 format.nSamplesPerSec = shm->speed;
443 format.nBlockAlign = format.nChannels
444 *format.wBitsPerSample / 8;
446 format.nAvgBytesPerSec = format.nSamplesPerSec
449 /* Open a waveform device for output using window callback. */
450 while ((hr = waveOutOpen((LPHWAVEOUT)&hWaveOut, WAVE_MAPPER,
452 0, 0L, CALLBACK_NULL)) != MMSYSERR_NOERROR)
454 if (hr != MMSYSERR_ALLOCATED)
456 Con_SafePrintf ("waveOutOpen failed\n");
460 if (MessageBox (NULL,
461 "The sound hardware is in use by another app.\n\n"
462 "Select Retry to try to start sound again or Cancel to run Quake with no sound.",
463 "Sound not available",
464 MB_RETRYCANCEL | MB_SETFOREGROUND | MB_ICONEXCLAMATION) != IDRETRY)
466 Con_SafePrintf ("waveOutOpen failure;\n"
467 " hardware already in use\n");
473 * Allocate and lock memory for the waveform data. The memory
474 * for waveform data must be globally allocated with
475 * GMEM_MOVEABLE and GMEM_SHARE flags.
478 gSndBufSize = WAV_BUFFERS*WAV_BUFFER_SIZE;
479 hData = GlobalAlloc(GMEM_MOVEABLE | GMEM_SHARE, gSndBufSize);
482 Con_SafePrintf ("Sound: Out of memory.\n");
486 lpData = GlobalLock(hData);
489 Con_SafePrintf ("Sound: Failed to lock.\n");
493 memset (lpData, 0, gSndBufSize);
496 * Allocate and lock memory for the header. This memory must
497 * also be globally allocated with GMEM_MOVEABLE and
500 hWaveHdr = GlobalAlloc(GMEM_MOVEABLE | GMEM_SHARE,
501 (DWORD) sizeof(WAVEHDR) * WAV_BUFFERS);
503 if (hWaveHdr == NULL)
505 Con_SafePrintf ("Sound: Failed to Alloc header.\n");
510 lpWaveHdr = (LPWAVEHDR) GlobalLock(hWaveHdr);
512 if (lpWaveHdr == NULL)
514 Con_SafePrintf ("Sound: Failed to lock header.\n");
519 memset (lpWaveHdr, 0, sizeof(WAVEHDR) * WAV_BUFFERS);
521 /* After allocation, set up and prepare headers. */
522 for (i=0 ; i<WAV_BUFFERS ; i++)
524 lpWaveHdr[i].dwBufferLength = WAV_BUFFER_SIZE;
525 lpWaveHdr[i].lpData = lpData + i*WAV_BUFFER_SIZE;
527 if (waveOutPrepareHeader(hWaveOut, lpWaveHdr+i, sizeof(WAVEHDR)) !=
530 Con_SafePrintf ("Sound: failed to prepare wave headers\n");
536 shm->samples = gSndBufSize/(shm->samplebits/8);
538 shm->buffer = (unsigned char *) lpData;
539 sample16 = (shm->samplebits/8) - 1;
550 Try to find a sound device to mix for.
551 Returns false if nothing is found.
555 qboolean SNDDMA_Init(void)
559 if (COM_CheckParm ("-wavonly"))
562 dsound_init = wav_init = 0;
564 stat = SIS_FAILURE; // assume DirectSound won't initialize
566 /* Init DirectSound */
569 if (snd_firsttime || snd_isdirect)
571 stat = SNDDMA_InitDirect ();;
573 if (stat == SIS_SUCCESS)
578 Con_SafePrintf ("DirectSound initialized\n");
582 snd_isdirect = false;
583 Con_SafePrintf ("DirectSound failed to init\n");
588 // if DirectSound didn't succeed in initializing, try to initialize
589 // waveOut sound, unless DirectSound failed because the hardware is
590 // already allocated (in which case the user has already chosen not
592 if (!dsound_init && (stat != SIS_NOTAVAIL))
594 if (snd_firsttime || snd_iswave)
597 snd_iswave = SNDDMA_InitWav ();
602 Con_SafePrintf ("Wave sound initialized\n");
606 Con_SafePrintf ("Wave sound failed to init\n");
611 snd_firsttime = false;
613 if (!dsound_init && !wav_init)
623 return the current sample position (in mono samples read)
624 inside the recirculating dma buffer, so the mixing code will know
625 how many sample are required to fill it up.
628 int SNDDMA_GetDMAPos(void)
636 mmtime.wType = TIME_SAMPLES;
637 pDSBuf->lpVtbl->GetCurrentPosition(pDSBuf, &mmtime.u.sample, &dwWrite);
638 s = mmtime.u.sample - mmstarttime.u.sample;
642 s = snd_sent * WAV_BUFFER_SIZE;
650 s &= (shm->samples-1);
659 Send sound to device if buffer isn't really the dma buffer
662 void SNDDMA_Submit(void)
671 // find which sound blocks have completed
675 if ( snd_completed == snd_sent )
677 Con_DPrintf ("Sound overrun\n");
681 if ( ! (lpWaveHdr[ snd_completed & WAV_MASK].dwFlags & WHDR_DONE) )
686 snd_completed++; // this buffer has been played
690 // submit two new sound blocks
692 while (((snd_sent - snd_completed) >> sample16) < 4)
694 h = lpWaveHdr + ( snd_sent&WAV_MASK );
698 * Now the data block can be sent to the output device. The
699 * waveOutWrite function returns immediately and waveform
700 * data is sent to the output device in the background.
702 wResult = waveOutWrite(hWaveOut, h, sizeof(WAVEHDR));
704 if (wResult != MMSYSERR_NOERROR)
706 Con_SafePrintf ("Failed to write block to device\n");
717 Reset the sound device for exiting
720 void SNDDMA_Shutdown(void)
726 DWORD dsound_dwSize2;
729 void *S_LockBuffer(void)
738 while ((hresult = pDSBuf->lpVtbl->Lock(pDSBuf, 0, gSndBufSize, (LPVOID*)&dsound_pbuf, &dsound_dwSize, (LPVOID*)&dsound_pbuf2, &dsound_dwSize2, 0)) != DS_OK)
740 if (hresult != DSERR_BUFFERLOST)
742 Con_Printf ("S_LockBuffer: DS::Lock Sound Buffer Failed\n");
750 Con_Printf ("S_LockBuffer: DS: couldn't restore buffer\n");
762 void S_UnlockBuffer(void)
765 pDSBuf->lpVtbl->Unlock(pDSBuf, dsound_pbuf, dsound_dwSize, dsound_pbuf2, dsound_dwSize2);