1247 lines
31 KiB
Plaintext
1247 lines
31 KiB
Plaintext
/*
|
|
** Command & Conquer Red Alert(tm)
|
|
** Copyright 2025 Electronic Arts Inc.
|
|
**
|
|
** This program is free software: you can redistribute it and/or modify
|
|
** it under the terms of the GNU General Public License as published by
|
|
** the Free Software Foundation, either version 3 of the License, or
|
|
** (at your option) any later version.
|
|
**
|
|
** This program is distributed in the hope that it will be useful,
|
|
** but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
** GNU General Public License for more details.
|
|
**
|
|
** You should have received a copy of the GNU General Public License
|
|
** along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
/****************************************************************************
|
|
*
|
|
* C O N F I D E N T I A L -- W E S T W O O D S T U D I O S
|
|
*
|
|
*----------------------------------------------------------------------------
|
|
*
|
|
* PROJECT
|
|
* VQA player library. (32-Bit protected mode)
|
|
*
|
|
* FILE
|
|
* audio.c
|
|
*
|
|
* DESCRIPTION
|
|
* Audio playback and timing.
|
|
*
|
|
* PROGRAMMER
|
|
* Bill Randolph
|
|
* Denzil E. Long, Jr.
|
|
*
|
|
* DATE
|
|
* June 22, 1995
|
|
*
|
|
*----------------------------------------------------------------------------
|
|
*
|
|
* PUBLIC
|
|
* VQA_StartTimerInt - Initialize system timer interrupt.
|
|
* VQA_StopTimerInt - Remove system timer interrupt.
|
|
* VQA_SetTimer - Resets current time to given tick value.
|
|
* VQA_GetTime - Return current time.
|
|
* VQA_TimerMethod - Get timer method being used.
|
|
* VQA_OpenAudio - Open sound system.
|
|
* VQA_CloseAudio - Close sound system
|
|
* VQA_StartAudio - Starts audio playback
|
|
* VQA_StopAudio - Stop audio playback.
|
|
* CopyAudio - Copy data from Audio Temp buf into Audio play buf.
|
|
*
|
|
* PRIVATE
|
|
* TimerCallback - Timer callback routine; called by HMI
|
|
* AutoDetect - Auto detect the sound card.
|
|
* AudioCallback - Sound system callback.
|
|
*
|
|
****************************************************************************/
|
|
|
|
#include <stdio.h>
|
|
#include <stdlib.h>
|
|
#include <malloc.h>
|
|
#include <mem.h>
|
|
#include <sys\timeb.h>
|
|
#include "vqaplayp.h"
|
|
#include <vqm32\all.h>
|
|
|
|
#ifdef __WATCOMC__
|
|
#pragma pack(4);
|
|
#endif
|
|
|
|
#if(VQAAUDIO_ON)
|
|
#include "sos.h"
|
|
#endif
|
|
|
|
/*---------------------------------------------------------------------------
|
|
* AUDIO DEFINITIONS
|
|
*-------------------------------------------------------------------------*/
|
|
|
|
#define HMI_SAMPLE 0x1000
|
|
#define HMI_DEFAULT_RATE 22050
|
|
|
|
#define HMI_UNINIT 0 /* Unitialize state. */
|
|
#define HMI_VQAINIT 1 /* VQA initialized */
|
|
#define HMI_APPINIT 2 /* Application initialized */
|
|
|
|
#if(VQAAUDIO_ON)
|
|
/*---------------------------------------------------------------------------
|
|
* PROTOTYPES
|
|
*-------------------------------------------------------------------------*/
|
|
|
|
long AutoDetect(long bitsize, long channels);
|
|
void far TimerCallback(void);
|
|
void far cdecl AudioCallback(WORD wDriverHandle, WORD wAction,
|
|
WORD wSampleID);
|
|
|
|
/*---------------------------------------------------------------------------
|
|
* GLOBAL DATA
|
|
*-------------------------------------------------------------------------*/
|
|
|
|
/* HMI Start Sample structure:
|
|
*
|
|
* lpSamplePtr - Pointer to audio buffer.
|
|
* dwSampleSize - Size of buffer.
|
|
* wLoopCount - Number of time to loop (-1 = infinate)
|
|
* wChannel - Channel to play sample on.
|
|
* wVolume - Volume level to play at.
|
|
* wSampleID - ID for sample
|
|
* lpCallback - Callback function pointer.
|
|
* wSamplePort - Port to use for non-DMA
|
|
* wSampleFlags - Flags
|
|
* dwSampleByteLength - Total length including loops
|
|
* dwSampleLoopPoint -
|
|
* dwSampleLoopLength -
|
|
* dwSamplePitchAdd - Pitch shifting component.
|
|
* wSamplePitchFraction - Pitch shifting component.
|
|
* wSamplePanLocation - For panning
|
|
* wSamplePanSpeed - For panning
|
|
* wSamplePanDirection - For panning
|
|
* wSamplePanStart - For panning.
|
|
* wSamplePanEnd - For panning.
|
|
* wSampleDelayBytes - Delay part.
|
|
* wSampleDelayRepeat - Delay part.
|
|
* dwSampleADPCMPredicted - For compression
|
|
* wSampleADPCMIndex - For compression
|
|
* wSampleRootNoteMIDI - Root note for pitch shift
|
|
* dwFiller[3] - Filler for future upgrades.
|
|
*/
|
|
_SOS_START_SAMPLE sSOSSampleData = {
|
|
_NULL,
|
|
0L,
|
|
0,
|
|
_CENTER_CHANNEL,
|
|
0x7FFF,
|
|
HMI_SAMPLE,
|
|
AudioCallback,
|
|
0,
|
|
0,
|
|
0L,
|
|
0L,0L,
|
|
0L,0,
|
|
0,0,0,0,0,
|
|
0,0,
|
|
0L,0,
|
|
0,
|
|
0L,0L,0L
|
|
};
|
|
|
|
/* HMI Driver structure: Driver initialization structure.
|
|
*
|
|
* wBufferSize - Size of play buffer.
|
|
* lpBuffer - Pointer to buffer.
|
|
* wAllocateBuffer - Allocate buffer flag.
|
|
* wSampleRate - Playback rate.
|
|
* wParam -
|
|
* dwParam -
|
|
* lpFillHandler -
|
|
* lpDriverMemory -
|
|
* lpTimerMemory -
|
|
* wTimerID -
|
|
*/
|
|
_SOS_INIT_DRIVER sSOSInitDriver = {
|
|
0,
|
|
_NULL,
|
|
_TRUE,
|
|
HMI_DEFAULT_RATE,
|
|
19,
|
|
0L,
|
|
_NULL,
|
|
_NULL,
|
|
_NULL,
|
|
_SOS_NORMAL_TIMER
|
|
};
|
|
|
|
static _SOS_CAPABILITIES DigiCaps;
|
|
static _SOS_HARDWARE DigiHardware;
|
|
static WORD DigiHandle = -1;
|
|
static WORD DigiTimer = 0;
|
|
static WORD SampleHandle;
|
|
static long DigiInitFlag = HMI_UNINIT;
|
|
static long PlayingFlag = 0;
|
|
|
|
static VQAHandleP *VQAP;
|
|
static unsigned long CurBlock = 0;
|
|
static unsigned long NextBlock;
|
|
|
|
static WORD VQATimer = 0;
|
|
static long TimerMethod;
|
|
static long TimerInitFlag = HMI_UNINIT;
|
|
static long HMITimerFlag = HMI_UNINIT;
|
|
static long VQATickCount = 0;
|
|
|
|
#endif /* VQAAUDIO_ON */
|
|
|
|
static long TickOffset = 0;
|
|
char *HMIDevName = "<none>";
|
|
|
|
|
|
#if(VQAAUDIO_ON)
|
|
/****************************************************************************
|
|
*
|
|
* NAME
|
|
* VQA_StartTimerInt - Initialize system timer interrupt.
|
|
*
|
|
* SYNOPSIS
|
|
* Error = VQA_StartTimerInt(Init)
|
|
*
|
|
* long VQA_StartTimerInt(long);
|
|
*
|
|
* FUNCTION
|
|
* Initialize the HMI timer system if it hasn't been already then add
|
|
* our own timer event.
|
|
*
|
|
* INPUTS
|
|
* Init - Initialize HMI timer system flag. (TRUE = Initialize)
|
|
*
|
|
* RESULT
|
|
* Error - 0 if successful, -1 if error.
|
|
*
|
|
****************************************************************************/
|
|
|
|
long VQA_StartTimerInt(long init)
|
|
{
|
|
/* Does the caller want me to initialize the timer system? */
|
|
if (init == 0) {
|
|
|
|
/* If the timer system is uninitialized then it is the players
|
|
* responsibility to do it.
|
|
*/
|
|
if (TimerInitFlag == HMI_UNINIT) {
|
|
sosTIMERInitSystem(_TIMER_DOS_RATE, _SOS_DEBUG_NORMAL);
|
|
TimerInitFlag = HMI_VQAINIT;
|
|
}
|
|
} else {
|
|
TimerInitFlag = HMI_APPINIT;
|
|
}
|
|
|
|
/* Register the VQA_TickCount timer event. */
|
|
if (HMITimerFlag == HMI_UNINIT) {
|
|
if (sosTIMERRegisterEvent(VQA_TIMETICKS,TimerCallback,&VQATimer) == 0) {
|
|
HMITimerFlag = HMI_VQAINIT;
|
|
} else {
|
|
return (-1);
|
|
}
|
|
}
|
|
|
|
return (0);
|
|
}
|
|
|
|
|
|
/****************************************************************************
|
|
*
|
|
* NAME
|
|
* VQA_StopTimerInt - Remove system timer interrupt.
|
|
*
|
|
* SYNOPSIS
|
|
* VQA_StopTimerInt()
|
|
*
|
|
* void VQA_StopTimerInt(void);
|
|
*
|
|
* FUNCTION
|
|
* Remove our timer event from the HMI timer system. Uninitialize the
|
|
* HMI timer system if we initialized it.
|
|
*
|
|
* INPUTS
|
|
* NONE
|
|
*
|
|
* RESULT
|
|
* NONE
|
|
*
|
|
****************************************************************************/
|
|
|
|
void VQA_StopTimerInt(void)
|
|
{
|
|
/* Remove the timer event */
|
|
if (HMITimerFlag == HMI_VQAINIT) {
|
|
sosTIMERRemoveEvent(VQATimer);
|
|
}
|
|
|
|
HMITimerFlag = HMI_UNINIT;
|
|
|
|
if (TimerInitFlag == HMI_VQAINIT) {
|
|
sosTIMERUnInitSystem(0);
|
|
}
|
|
|
|
TimerInitFlag = HMI_UNINIT;
|
|
}
|
|
|
|
|
|
/****************************************************************************
|
|
*
|
|
* NAME
|
|
* TimerCallback - VQA timer event. (Called by HMI)
|
|
*
|
|
* SYNOPSIS
|
|
* TimerCallback()
|
|
*
|
|
* void TimerCallback(void);
|
|
*
|
|
* FUNCTION
|
|
* Our custom timer event. This is the timer event that we register with
|
|
* HMI for system timing.
|
|
*
|
|
* INPUTS
|
|
* NONE
|
|
*
|
|
* RESULT
|
|
* NONE
|
|
*
|
|
****************************************************************************/
|
|
|
|
void far TimerCallback(void)
|
|
{
|
|
VQATickCount++;
|
|
}
|
|
#endif /* VQAAUDIO_ON */
|
|
|
|
|
|
/****************************************************************************
|
|
*
|
|
* NAME
|
|
* VQA_SetTimer - Resets current time to given tick value.
|
|
*
|
|
* SYNOPSIS
|
|
* VQA_SetTimer(Time, Method)
|
|
*
|
|
* void VQA_SetTimer(long, long);
|
|
*
|
|
* FUNCTION
|
|
* Sets 'TickOffset' to a value that will make the current time look like
|
|
* the time passed in. This function allows the player to be "paused",
|
|
* by recording the time of the pause, and then setting the timer to
|
|
* that time. The timer method used by the player is also set. The method
|
|
* selected is not neccesarily the method that will be used because some
|
|
* timer methods work with only certain playback conditions. (EX: The
|
|
* audio DMA timer method cannot be used if there is not any audio
|
|
* playing.)
|
|
*
|
|
* INPUTS
|
|
* Time - Value to set current time to.
|
|
* Method - Timer method to use.
|
|
*
|
|
* RESULT
|
|
* NONE
|
|
*
|
|
****************************************************************************/
|
|
|
|
void VQA_SetTimer(long time, long method)
|
|
{
|
|
unsigned long curtime;
|
|
|
|
#if(VQAAUDIO_ON)
|
|
/* If the client does not have a preferencee then pick a method
|
|
* based on the state of the player.
|
|
*/
|
|
if (method == VQA_TMETHOD_DEFAULT) {
|
|
|
|
/* If we are playing audio, use the audio DMA position. */
|
|
if (PlayingFlag) {
|
|
method = VQA_TMETHOD_AUDIO;
|
|
}
|
|
|
|
/* Otherwise use the HMI timer if it is initialized. */
|
|
else if (HMITimerFlag) {
|
|
method = VQA_TMETHOD_INT;
|
|
}
|
|
|
|
/* If all else fails resort the the "jerky" DOS time. */
|
|
else {
|
|
method = VQA_TMETHOD_DOS;
|
|
}
|
|
} else {
|
|
|
|
/* We cannot use the DMA position if there isn't any audio playing. */
|
|
if (!PlayingFlag && (method == VQA_TMETHOD_AUDIO)) {
|
|
method = VQA_TMETHOD_INT;
|
|
}
|
|
|
|
/* We cannot use the timer if it has not been initialized. */
|
|
if (!HMITimerFlag && (method == VQA_TMETHOD_INT)) {
|
|
method = VQA_TMETHOD_DOS;
|
|
}
|
|
}
|
|
|
|
TimerMethod = method;
|
|
#endif
|
|
|
|
TickOffset = 0L;
|
|
curtime = VQA_GetTime();
|
|
TickOffset = (time - curtime);
|
|
}
|
|
|
|
|
|
/****************************************************************************
|
|
*
|
|
* NAME
|
|
* VQA_GetTime - Return current time.
|
|
*
|
|
* SYNOPSIS
|
|
* Time = VQA_GetTime()
|
|
*
|
|
* unsigned long VQA_GetTime(void);
|
|
*
|
|
* FUNCTION
|
|
* This routine returns timer ticks computed one of 3 ways:
|
|
*
|
|
* 1) If audio is playing, the timer is based on the DMA buffer position:
|
|
* Compute the number of audio samples that have actually been played.
|
|
* The following internal HMI variables are used:
|
|
*
|
|
* _lpSOSDMAFillCount[drv_handle]: current DMA buffer position
|
|
* _lpSOSSampleList[drv_handle][samp_handle]:
|
|
* sampleTotalBytes: total bytes sent by HMI to the DMA buffer
|
|
* sampleLastFill: HMI's last fill position in DMA buffer
|
|
*
|
|
* So, the number of samples actually played is:
|
|
*
|
|
* sampleTotalBytes - <DMA_diff>
|
|
* where <DMA_diff> is how far ahead sampleLastFill is in front of
|
|
* _lpSOSDMAFillCount: (sampleLastFill - _lpSOSDMAFillCount)
|
|
*
|
|
* These values are indices into a circular DMA buffer, so:
|
|
*
|
|
* if (sampleLastFill >= _lpSOSDMAFillCount)
|
|
* <DMA_diff> = sampleLastFill - _lpSOSDMAFillCount
|
|
* else
|
|
* <DMA_diff> = (DMA_BUF_SIZE - lpSOSDMAFillCount) + sampleLastFill
|
|
*
|
|
* Note that, if using the stereo driver with mono data, you must
|
|
* divide LastFill & FillCount by 2, but not TotalBytes. If using the
|
|
* stereo driver with stereo data, you must divide all 3 variables
|
|
* by 2.
|
|
*
|
|
* 2) If no audio is playing, but the timer interrupt is running,
|
|
* VQATickCount is used as the timer
|
|
*
|
|
* 3) If no audio is playing & no timer interrupt is going, the DOS 18.2
|
|
* system timer is used.
|
|
*
|
|
* Regardless of the method, TickOffset is used as an offset from the
|
|
* computed time.
|
|
*
|
|
* INPUTS
|
|
* NONE
|
|
*
|
|
* RESULT
|
|
* Time - Time in VQA_TIMETICKS
|
|
*
|
|
****************************************************************************/
|
|
|
|
unsigned long VQA_GetTime(void)
|
|
{
|
|
#if(VQAAUDIO_ON)
|
|
VQAAudio *audio;
|
|
unsigned long bytesleft;
|
|
unsigned long samples;
|
|
#endif
|
|
|
|
long ticks;
|
|
|
|
#if(VQAAUDIO_ON)
|
|
switch (TimerMethod) {
|
|
|
|
/* If Audio is playing then timing is based on the audio DMA buffer
|
|
* position.
|
|
*/
|
|
case VQA_TMETHOD_AUDIO:
|
|
|
|
/* Dereference commonly used data members for quicker access. */
|
|
audio = &VQAP->VQABuf->Audio;
|
|
|
|
/* Compute our current position in the audio track by getting the
|
|
* bytes processed by HMI. Then adjust the bytes processed by the
|
|
* position of the DMA fill handler, this should tell us exactly
|
|
* where we are in the audio track.
|
|
*/
|
|
samples = _lpSOSSampleList[DigiHandle][SampleHandle]->sampleTotalBytes;
|
|
bytesleft = _lpSOSSampleList[DigiHandle][SampleHandle]->sampleBytesLeft;
|
|
|
|
/* Adjust the bytes processed from the bytes left to DMA in the
|
|
* buffer.
|
|
*/
|
|
if (samples >= bytesleft) {
|
|
samples -= bytesleft;
|
|
}
|
|
|
|
/* Calculate the number of samples by taking the total number of
|
|
* bytes processed and divide it by the number of channels and
|
|
* bits per sample.
|
|
*/
|
|
samples -= (audio->NumSkipped * VQAP->Config.HMIBufSize);
|
|
samples /= (audio->Channels * (audio->BitsPerSample >> 3));
|
|
|
|
/* The elapsed ticks is calculated by the number of samples
|
|
* processed times the tick resolution per second divided by the
|
|
* sample rate.
|
|
*/
|
|
ticks = (long)((samples * VQA_TIMETICKS) / audio->SampleRate);
|
|
ticks += TickOffset;
|
|
break;
|
|
|
|
/* No audio playing, but timer interrupt is going; use VQATickCount */
|
|
case VQA_TMETHOD_INT:
|
|
ticks = (VQATickCount + TickOffset);
|
|
break;
|
|
|
|
/* No interrupts are going at all; use DOS's time */
|
|
default:
|
|
case VQA_TMETHOD_DOS:
|
|
{
|
|
struct timeb mytime;
|
|
|
|
ftime(&mytime);
|
|
ticks = (unsigned long)mytime.time*1000L+(unsigned long)mytime.millitm;
|
|
ticks = ((ticks * VQA_TIMETICKS) / 1000L);
|
|
ticks += TickOffset;
|
|
}
|
|
break;
|
|
}
|
|
#else
|
|
{
|
|
struct timeb mytime;
|
|
|
|
ftime(&mytime);
|
|
ticks = (unsigned long)mytime.time*1000L+(unsigned long)mytime.millitm;
|
|
ticks = ((ticks * VQA_TIMETICKS) / 1000L);
|
|
ticks += TickOffset;
|
|
}
|
|
#endif
|
|
|
|
return (ticks);
|
|
}
|
|
|
|
|
|
/****************************************************************************
|
|
*
|
|
* NAME
|
|
* VQA_TimerMethod - Get timer method being used.
|
|
*
|
|
* SYNOPSIS
|
|
* Method = VQA_TimerMethod()
|
|
*
|
|
* long VQA_TimerMethod(void);
|
|
*
|
|
* FUNCTION
|
|
* Returns the ID of the current timer method being used.
|
|
*
|
|
* INPUTS
|
|
* NONE
|
|
*
|
|
* RESULT
|
|
* Method - Method used for the timer.
|
|
*
|
|
****************************************************************************/
|
|
|
|
long VQA_TimerMethod(void)
|
|
{
|
|
#if(VQAAUDIO_ON)
|
|
return (TimerMethod);
|
|
#else
|
|
return (VQA_TMETHOD_DOS);
|
|
#endif
|
|
}
|
|
|
|
|
|
#if(VQAAUDIO_ON)
|
|
/****************************************************************************
|
|
*
|
|
* NAME
|
|
* VQA_OpenAudio - Open sound system.
|
|
*
|
|
* SYNOPSIS
|
|
* Error = VQA_OpenAudio(VQAHandleP)
|
|
*
|
|
* long VQA_OpenAudio(VQAHandleP *);
|
|
*
|
|
* FUNCTION
|
|
* Initialize the sound system by setting the DigiHandle to and HMI
|
|
* driver handle. The timer must first be initialized before calling
|
|
* this function.
|
|
*
|
|
* INPUTS
|
|
* VQAHandleP - Pointer to private VQAHandle.
|
|
*
|
|
* RESULT
|
|
* Error - 0 if successful, -1 if error.
|
|
*
|
|
****************************************************************************/
|
|
|
|
long VQA_OpenAudio(VQAHandleP *vqap)
|
|
{
|
|
VQAData *vqabuf;
|
|
VQAAudio *audio;
|
|
VQAConfig *config;
|
|
VQAHeader *header;
|
|
unsigned char *driver_path;
|
|
WORD port;
|
|
long rc;
|
|
|
|
/* Return if already initialized */
|
|
if (DigiInitFlag != HMI_UNINIT) {
|
|
return (0);
|
|
}
|
|
|
|
/* Dereference data memebers for quicker access. */
|
|
config = &vqap->Config;
|
|
header = &vqap->Header;
|
|
vqabuf = vqap->VQABuf;
|
|
audio = &vqabuf->Audio;
|
|
|
|
/* Fail if no audio buffer or DigiCard is 0 (no sound) */
|
|
if ((audio->Buffer == NULL) || (config->DigiCard == 0)) {
|
|
return (-1);
|
|
}
|
|
|
|
/* Reset the buffer position to the beginning. */
|
|
CurBlock = 0;
|
|
|
|
/*-------------------------------------------------------------------------
|
|
* Compute the playback rate:
|
|
*
|
|
* - If Config->AudioRate is -1, use HMI_DATA_RATE scaled to the specified
|
|
* frame rate (so the audio plays faster if we're playing faster)
|
|
* - otherwise, use the specified rate
|
|
*-----------------------------------------------------------------------*/
|
|
if (config->AudioRate != -1) {
|
|
sSOSInitDriver.wSampleRate = config->AudioRate;
|
|
}
|
|
else if (config->FrameRate != header->FPS) {
|
|
sSOSInitDriver.wSampleRate = ((audio->SampleRate * config->FrameRate)
|
|
/ (unsigned long)header->FPS);
|
|
|
|
config->AudioRate = sSOSInitDriver.wSampleRate;
|
|
} else {
|
|
sSOSInitDriver.wSampleRate = audio->SampleRate;
|
|
config->AudioRate = audio->SampleRate;
|
|
}
|
|
|
|
/* If the application has already initialized HMI then set the
|
|
* necessary variables. Otherwise we must setup HMI ourself.
|
|
*/
|
|
if (config->OptionFlags & VQAOPTF_HMIINIT) {
|
|
|
|
/* The application MUST provide the card type! */
|
|
if (config->DigiCard == -1) {
|
|
return (-1);
|
|
}
|
|
|
|
/* Init the detection system */
|
|
driver_path = (unsigned char *)".\\";
|
|
|
|
if ((rc = sosDIGIDetectInit(driver_path)) != 0) {
|
|
return (rc);
|
|
}
|
|
|
|
/* Get the capabilities of the card being used. */
|
|
rc = sosDIGIDetectGetCaps(config->DigiCard, &DigiCaps);
|
|
sosDIGIDetectUnInit();
|
|
|
|
if (rc != 0) {
|
|
return (rc);
|
|
}
|
|
|
|
DigiHandle = config->DigiHandle;
|
|
HMIDevName = "App-Specific";
|
|
TimerInitFlag = HMI_APPINIT;
|
|
DigiInitFlag = HMI_APPINIT;
|
|
} else {
|
|
|
|
/* Init the detection system */
|
|
driver_path = (unsigned char *)".\\";
|
|
|
|
if ((rc = sosDIGIDetectInit(driver_path)) != 0) {
|
|
return (rc);
|
|
}
|
|
|
|
/*-----------------------------------------------------------------------
|
|
* Initialize DigiHardware with port, IRQ, and DMA, and make sure
|
|
* Config.DigiCard contains the HMI ID we want to use:
|
|
*
|
|
* - If Config.DigiCard is -1, auto-detect the hardware; then, do a
|
|
* FindHardware so the GetSettings will work
|
|
* - If Config.DigiCard is filled in, but port, IRQ or DMA is -1, use
|
|
* FindHardware & GetSettings to get the settings
|
|
* - If all are filled in, just use them as they are
|
|
*---------------------------------------------------------------------*/
|
|
|
|
/* Auto-Detect */
|
|
if (config->DigiCard == -1) {
|
|
|
|
/* Version 1 VQA's have only 8 bit mono audio streams. */
|
|
if (header->Version == VQAHD_VER1) {
|
|
config->DigiCard = AutoDetect(8, 1);
|
|
} else {
|
|
config->DigiCard = AutoDetect(audio->BitsPerSample, audio->Channels);
|
|
|
|
/* Resort to 8bit mono */
|
|
if (config->DigiCard == -1) {
|
|
config->DigiCard = AutoDetect(8, 1);
|
|
}
|
|
}
|
|
|
|
if (config->DigiCard == -1) {
|
|
sosDIGIDetectUnInit();
|
|
return (-1);
|
|
}
|
|
}
|
|
|
|
/* Do a FindHardware & GetSettings */
|
|
if (config->DigiPort == -1) {
|
|
if (sosDIGIDetectFindHardware(config->DigiCard, &DigiCaps, &port)) {
|
|
sosDIGIDetectUnInit();
|
|
return (-1);
|
|
}
|
|
|
|
if (sosDIGIDetectGetSettings(&DigiHardware)) {
|
|
sosDIGIDetectUnInit();
|
|
return (-1);
|
|
}
|
|
|
|
config->DigiPort = DigiHardware.wPort;
|
|
config->DigiIRQ = DigiHardware.wIRQ;
|
|
config->DigiDMA = DigiHardware.wDMA;
|
|
HMIDevName = (char *)DigiCaps.szDeviceName;
|
|
} else {
|
|
DigiHardware.wPort = config->DigiPort;
|
|
DigiHardware.wIRQ = config->DigiIRQ;
|
|
DigiHardware.wDMA = config->DigiDMA;
|
|
HMIDevName = "App-Specific";
|
|
}
|
|
|
|
sosDIGIDetectUnInit();
|
|
|
|
/* Initialize the DIGI system & driver */
|
|
sosDIGIInitSystem(driver_path, _SOS_DEBUG_NORMAL);
|
|
sSOSInitDriver.wBufferSize = config->HMIBufSize;
|
|
sSOSInitDriver.lpBuffer = NULL;
|
|
sSOSInitDriver.lpFillHandler = NULL;
|
|
sSOSInitDriver.lpDriverMemory = NULL;
|
|
sSOSInitDriver.lpTimerMemory = NULL;
|
|
DigiHandle = -1;
|
|
|
|
if ((rc = sosDIGIInitDriver(config->DigiCard, &DigiHardware,
|
|
&sSOSInitDriver, &DigiHandle)) != 0) {
|
|
|
|
return (rc);
|
|
}
|
|
|
|
/*-----------------------------------------------------------------------
|
|
* Register the timer event
|
|
*---------------------------------------------------------------------*/
|
|
|
|
/* If the timer hasn't been init'd, do it now */
|
|
if (TimerInitFlag == HMI_UNINIT) {
|
|
sosTIMERInitSystem(_TIMER_DOS_RATE ,_SOS_DEBUG_NORMAL);
|
|
TimerInitFlag = HMI_VQAINIT;
|
|
}
|
|
|
|
/* Register the event */
|
|
rc = sosTIMERRegisterEvent(VQA_TIMETICKS, sSOSInitDriver.lpFillHandler,
|
|
&DigiTimer);
|
|
|
|
if (rc) {
|
|
sosDIGIUnInitDriver(DigiHandle, _TRUE, _TRUE);
|
|
sosDIGIUnInitSystem();
|
|
return (rc);
|
|
}
|
|
|
|
config->DigiHandle = DigiHandle;
|
|
DigiInitFlag = HMI_VQAINIT;
|
|
}
|
|
|
|
return (0);
|
|
}
|
|
|
|
|
|
/****************************************************************************
|
|
*
|
|
* NAME
|
|
* AutoDetect - Auto detect the sound card.
|
|
*
|
|
* SYNOPSIS
|
|
* CardID = AutoDetect(BitSize, Channels)
|
|
*
|
|
* long AutoDetect(long, long);
|
|
*
|
|
* FUNCTION
|
|
* Autodetects the type of sound card present in the system.
|
|
*
|
|
* INPUTS
|
|
* BitSize - Bits per sample size.
|
|
* Channels - Number of desired channels.
|
|
*
|
|
* RESULT
|
|
* CardID - HMI ID of the sound card found, -1 if none.
|
|
*
|
|
****************************************************************************/
|
|
|
|
long AutoDetect(long bitsize, long channels)
|
|
{
|
|
long device_id = -1;
|
|
WORD port;
|
|
long i;
|
|
long rc;
|
|
|
|
/* Search for an 8-bit mono device */
|
|
if (sosDIGIDetectFindFirst(&DigiCaps, &port)) {
|
|
return (-1);
|
|
}
|
|
|
|
channels--;
|
|
|
|
i = 0;
|
|
while (i < 6) {
|
|
i++;
|
|
|
|
if ((DigiCaps.wBitsPerSample == bitsize)
|
|
&& (DigiCaps.wChannels == channels)) {
|
|
|
|
break;
|
|
}
|
|
|
|
if (sosDIGIDetectFindNext(&DigiCaps, &port)) {
|
|
return (-1);
|
|
}
|
|
}
|
|
|
|
/* Exit if failed to find the required device */
|
|
if ((DigiCaps.wBitsPerSample != bitsize)
|
|
|| (DigiCaps.wChannels != channels)) {
|
|
|
|
return (-1);
|
|
}
|
|
|
|
/* Stash the ID */
|
|
device_id = DigiCaps.wDeviceID;
|
|
|
|
/* Now that we have handled the initial pass, verify that if we found an
|
|
* _ADLIB_GOLD_8_MONO that it is not a Logitech Sound Wave man in disguise.
|
|
*/
|
|
if ((WORD)DigiCaps.wDeviceID == _ADLIB_GOLD_8_MONO) {
|
|
rc = sosDIGIDetectFindNext(&DigiCaps, &port);
|
|
|
|
while ((i < 6) && (rc == 0)) {
|
|
i++;
|
|
|
|
if ((DigiCaps.wBitsPerSample == 8) && (DigiCaps.wChannels == 0)) {
|
|
break;
|
|
}
|
|
|
|
if ((rc = sosDIGIDetectFindNext(&DigiCaps, &port)) != 0) {
|
|
break;
|
|
}
|
|
}
|
|
|
|
/* If we don't have an error use the secondary device ID, after all,
|
|
* anything's better than an Adlib Gold. If we do have an error or there
|
|
* is nothing we can use then the device ID is already set to the adlib
|
|
* gold so just let it rip.
|
|
*/
|
|
if ((rc == 0) && ((WORD)DigiCaps.wDeviceID == _SBPRO_8_MONO)) {
|
|
return (DigiCaps.wDeviceID);
|
|
}
|
|
}
|
|
|
|
return (device_id);
|
|
}
|
|
|
|
|
|
/****************************************************************************
|
|
*
|
|
* NAME
|
|
* VQA_CloseAudio - Close sound system
|
|
*
|
|
* SYNOPSIS
|
|
* VQA_CloseAudio()
|
|
*
|
|
* void VQA_CloseAudio(void);
|
|
*
|
|
* FUNCTION
|
|
* Removes VQA's involvement in the audio system.
|
|
*
|
|
* INPUTS
|
|
* NONE
|
|
*
|
|
* RESULT
|
|
* NONE
|
|
*
|
|
****************************************************************************/
|
|
|
|
void VQA_CloseAudio(void)
|
|
{
|
|
/* Remove the Digi event */
|
|
if (DigiInitFlag == HMI_VQAINIT) {
|
|
sosTIMERRemoveEvent(DigiTimer);
|
|
}
|
|
|
|
/* Un-init timer if necessary */
|
|
if (TimerInitFlag == HMI_VQAINIT) {
|
|
sosTIMERUnInitSystem(0);
|
|
}
|
|
|
|
TimerInitFlag = HMI_UNINIT;
|
|
|
|
/* Remove the driver */
|
|
if (DigiInitFlag == HMI_VQAINIT) {
|
|
sosDIGIUnInitDriver(DigiHandle, _TRUE, _TRUE);
|
|
sosDIGIUnInitSystem();
|
|
}
|
|
|
|
DigiInitFlag = HMI_UNINIT;
|
|
|
|
if (PlayingFlag) {
|
|
PlayingFlag = 0;
|
|
}
|
|
}
|
|
|
|
|
|
/****************************************************************************
|
|
*
|
|
* NAME
|
|
* VQA_StartAudio - Starts audio playback
|
|
*
|
|
* SYNOPSIS
|
|
* Error = VQA_StartAudio(VQA)
|
|
*
|
|
* long VQA_StartAudio(VQAHandleP *);
|
|
*
|
|
* FUNCTION
|
|
* Start the audio playback for the movie.
|
|
*
|
|
* INPUTS
|
|
* VQA - Pointer to private VQA handle.
|
|
*
|
|
* RESULT
|
|
* Error - 0 if successful, or -1 error code.
|
|
*
|
|
****************************************************************************/
|
|
|
|
long VQA_StartAudio(VQAHandleP *vqap)
|
|
{
|
|
VQAConfig *config;
|
|
VQAAudio *audio;
|
|
|
|
/* Save buffers for the callback routine */
|
|
VQAP = vqap;
|
|
|
|
/* Dereference commonly used data members for quicker access. */
|
|
config = &vqap->Config;
|
|
audio = &vqap->VQABuf->Audio;
|
|
|
|
/* Return if already playing */
|
|
if (audio->Flags & VQAAUDF_ISPLAYING) {
|
|
return (-1);
|
|
}
|
|
|
|
/* Set my driver handle */
|
|
if (config->DigiHandle != -1) {
|
|
DigiHandle = config->DigiHandle;
|
|
}
|
|
|
|
if (DigiHandle == (WORD)-1) {
|
|
return (-1);
|
|
}
|
|
|
|
/*-------------------------------------------------------------------------
|
|
* Initialize the sample structure.
|
|
*-----------------------------------------------------------------------*/
|
|
memset(&sSOSSampleData, 0, sizeof(_SOS_START_SAMPLE));
|
|
sSOSSampleData.lpSamplePtr = (unsigned char *)vqap->VQABuf->Audio.Buffer;
|
|
sSOSSampleData.dwSampleSize = config->HMIBufSize;
|
|
sSOSSampleData.wVolume = (config->Volume << 7);
|
|
sSOSSampleData.wSampleID = HMI_SAMPLE;
|
|
sSOSSampleData.lpCallback = AudioCallback;
|
|
|
|
/* Set the channel flags for the type of data we have. */
|
|
if (audio->Channels == 2) {
|
|
sSOSSampleData.wChannel = _INTERLEAVED;
|
|
} else {
|
|
sSOSSampleData.wChannel = _CENTER_CHANNEL;
|
|
}
|
|
|
|
/* If the card is unable to handle stereo data the we must notify the
|
|
* sound system to convert the stereo data to mono data during playback.
|
|
*/
|
|
if ((audio->Channels - 1) > DigiCaps.wChannels) {
|
|
sSOSSampleData.wSampleFlags |= _STEREOTOMONO;
|
|
}
|
|
|
|
/* If the card is unable to handle the sample size of the audio data
|
|
* then we must notify the sound system to convert the audio data to
|
|
* the proper format.
|
|
*/
|
|
if (audio->BitsPerSample != DigiCaps.wBitsPerSample) {
|
|
if (audio->BitsPerSample > DigiCaps.wBitsPerSample) {
|
|
sSOSSampleData.wSampleFlags |= _TRANSLATE16TO8;
|
|
} else {
|
|
sSOSSampleData.wSampleFlags |= _TRANSLATE8TO16;
|
|
}
|
|
}
|
|
|
|
/* Start playback */
|
|
SampleHandle = sosDIGIStartSample(DigiHandle, &sSOSSampleData);
|
|
audio->Flags |= VQAAUDF_ISPLAYING;
|
|
PlayingFlag = 1;
|
|
|
|
return (0);
|
|
}
|
|
|
|
|
|
/****************************************************************************
|
|
*
|
|
* NAME
|
|
* VQA_StopAudio - Stop audio playback.
|
|
*
|
|
* SYNOPSIS
|
|
* VQA_StopAudio(VQA)
|
|
*
|
|
* void VQA_StopAudio(VQAHandleP *);
|
|
*
|
|
* FUNCTION
|
|
* Halts the currently playing audio stream.
|
|
*
|
|
* INPUTS
|
|
* VQA - Pointer to private VQAHandle.
|
|
*
|
|
* RESULT
|
|
* NONE
|
|
*
|
|
****************************************************************************/
|
|
|
|
void VQA_StopAudio(VQAHandleP *vqap)
|
|
{
|
|
/* Just return if not playing */
|
|
if (vqap->VQABuf->Audio.Flags & VQAAUDF_ISPLAYING) {
|
|
vqap->VQABuf->Audio.Flags &= ~VQAAUDF_ISPLAYING;
|
|
sosDIGIStopSample(DigiHandle, SampleHandle);
|
|
}
|
|
}
|
|
|
|
|
|
/****************************************************************************
|
|
*
|
|
* NAME
|
|
* AudioCallback - Sound system callback.
|
|
*
|
|
* SYNOPSIS
|
|
* AudioCallback(DriverHandle, Action, SampleID)
|
|
*
|
|
* void AudioCallback(WORD, WORD, WORD);
|
|
*
|
|
* FUNCTION
|
|
* Our custom audio callback routine that services HMI.
|
|
*
|
|
* INPUTS
|
|
* DriverHandle - HMI driver handle.
|
|
* Action - Action taken.
|
|
* SampleID - ID of sample.
|
|
*
|
|
* RESULT
|
|
* NONE
|
|
*
|
|
****************************************************************************/
|
|
|
|
void far cdecl AudioCallback(WORD wDriverHandle,WORD wAction,WORD wSampleID)
|
|
{
|
|
VQAAudio *audio;
|
|
VQAConfig *config;
|
|
|
|
/* Dereference commonly used data members for quicker access. */
|
|
audio = &VQAP->VQABuf->Audio;
|
|
config = &VQAP->Config;
|
|
|
|
/* Suppress compiler warnings */
|
|
wDriverHandle = wDriverHandle;
|
|
wSampleID = wSampleID;
|
|
|
|
/* See if we're called because the buffer is empty */
|
|
if (wAction == _SAMPLE_PROCESSED) {
|
|
|
|
/* Compute the 'NextBlock' index */
|
|
NextBlock = CurBlock + 1;
|
|
|
|
if (NextBlock >= audio->NumAudBlocks) {
|
|
NextBlock = 0;
|
|
}
|
|
|
|
/* See if the next block has data in it; if so, update the audio
|
|
* buffer play position & the 'CurBlock' value.
|
|
* If not, don't change anything and replay this block.
|
|
*/
|
|
if (audio->IsLoaded[NextBlock] == 1) {
|
|
|
|
/* Update this block's status to loadable (0) */
|
|
audio->IsLoaded[CurBlock] = 0;
|
|
|
|
/* Update position within audio buffer */
|
|
audio->PlayPosition += config->HMIBufSize;
|
|
CurBlock++;
|
|
|
|
if (audio->PlayPosition >= config->AudioBufSize) {
|
|
audio->PlayPosition = 0;
|
|
CurBlock = 0;
|
|
}
|
|
} else {
|
|
audio->NumSkipped++;
|
|
}
|
|
|
|
/* Start the new buffer playing */
|
|
sSOSSampleData.lpSamplePtr = (unsigned char *)(audio->Buffer)
|
|
+ audio->PlayPosition;
|
|
sosDIGIContinueSample(DigiHandle, SampleHandle, &sSOSSampleData);
|
|
audio->SamplesPlayed += config->HMIBufSize;
|
|
}
|
|
}
|
|
|
|
|
|
/****************************************************************************
|
|
*
|
|
* NAME
|
|
* CopyAudio - Copy data from Audio Temp buffer into Audio play buffer.
|
|
*
|
|
* SYNOPSIS
|
|
* Error = CopyAudio(VQA)
|
|
*
|
|
* long CopyAudio(VQAHandleP *);
|
|
*
|
|
* FUNCTION
|
|
* This routine just copies the data in the TempBuf into the correct
|
|
* spots in the audio play buffer. If there is no room available in the
|
|
* audio play buffer, the routine returns VQAERR_SLEEPING, which will put
|
|
* the whole Loader to "sleep" while it waits for a free buffer.
|
|
*
|
|
* If there's no data in the TempBuf to copy, the routine just returns 0.
|
|
*
|
|
* INPUTS
|
|
* VQA - Pointer to private VQAHandle structure.
|
|
*
|
|
* RESULT
|
|
* Error - 0 if successful or VQAERR_??? error code.
|
|
*
|
|
****************************************************************************/
|
|
|
|
long CopyAudio(VQAHandleP *vqap)
|
|
{
|
|
VQAAudio *audio;
|
|
VQAConfig *config;
|
|
long startblock;
|
|
long endblock;
|
|
long len1,len2;
|
|
long i;
|
|
|
|
/* Dereference commonly used data members for quicker access. */
|
|
audio = &vqap->VQABuf->Audio;
|
|
config = &vqap->Config;
|
|
|
|
/* If audio is disabled, or if we're playing from a VOC file, or if
|
|
* there's no Audio Buffer, or if there's no data to copy, just return 0
|
|
*/
|
|
#if(VQAVOC_ON && VQAAUDIO_ON)
|
|
if (((config->OptionFlags & VQAOPTF_AUDIO) == 0) || (vqap->vocfh != -1)
|
|
|| (audio->Buffer == NULL) || (audio->TempBufLen == 0)) {
|
|
#else /* VQAVOC_ON */
|
|
if (((config->OptionFlags & VQAOPTF_AUDIO) == 0) || (audio->Buffer == NULL)
|
|
|| (audio->TempBufLen == 0)) {
|
|
#endif /* VQAVOC_ON */
|
|
|
|
return (0);
|
|
}
|
|
|
|
/* Compute start & end blocks to copy into */
|
|
startblock = (audio->AudBufPos / config->HMIBufSize);
|
|
endblock = (audio->AudBufPos + audio->TempBufLen) / config->HMIBufSize;
|
|
|
|
if (endblock >= audio->NumAudBlocks) {
|
|
endblock -= audio->NumAudBlocks;
|
|
}
|
|
|
|
/* If 'endblock' hasn't played yet, return VQAERR_SLEEPING */
|
|
if (audio->IsLoaded[endblock] == 1) {
|
|
return (VQAERR_SLEEPING);
|
|
}
|
|
|
|
/* Copy the data:
|
|
*
|
|
* - If 'startblock' < 'endblock', copy the entire buffer
|
|
* - Otherwise, fill to the end of the buffer with part of the data, then
|
|
* copy the rest to the beginning of the buffer
|
|
*/
|
|
if (startblock <= endblock) {
|
|
|
|
/* Copy data */
|
|
memcpy((audio->Buffer + audio->AudBufPos), audio->TempBuf,
|
|
audio->TempBufLen);
|
|
|
|
/* Adjust current load position */
|
|
audio->AudBufPos += audio->TempBufLen;
|
|
|
|
/* Mark buffer as empty */
|
|
audio->TempBufLen = 0;
|
|
|
|
/* Set all blocks to loaded */
|
|
for (i = startblock; i < endblock; i++) {
|
|
audio->IsLoaded[i] = 1;
|
|
}
|
|
|
|
return (0);
|
|
} else {
|
|
|
|
/* Compute length of each piece */
|
|
len1 = config->AudioBufSize - audio->AudBufPos;
|
|
len2 = audio->TempBufLen - len1;
|
|
|
|
/* Copy 1st piece into end of Audio Buffer */
|
|
memcpy((audio->Buffer + audio->AudBufPos), audio->TempBuf, len1);
|
|
|
|
/* Copy 2nd piece into start of Audio Buffer */
|
|
memcpy(audio->Buffer, audio->TempBuf + len1, len2);
|
|
|
|
/* Adjust load position */
|
|
audio->AudBufPos = len2;
|
|
|
|
/* Mark buffer as empty */
|
|
audio->TempBufLen = 0;
|
|
|
|
/* Set blocks to loaded */
|
|
for (i = startblock; i < audio->NumAudBlocks; i++) {
|
|
audio->IsLoaded[i] = 1;
|
|
}
|
|
|
|
for (i = 0; i < endblock; i++) {
|
|
audio->IsLoaded[i] = 1;
|
|
}
|
|
|
|
return (0);
|
|
}
|
|
}
|
|
|
|
|
|
#ifdef __WATCOMC__
|
|
#pragma pack(1);
|
|
#endif
|
|
#endif /* VQAAUDIO_ON */
|
|
|