/* Copyright (C) 1994-1995 Apogee Software, Ltd. 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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. Modifications for JonoF's port by Jonathon Fowler (jonof@edgenetwk.com) */ /********************************************************************** module: FX_MAN.C author: James R. Dose date: March 17, 1994 Device independant sound effect routines. (c) Copyright 1994 James R. Dose. All Rights Reserved. **********************************************************************/ #include #include #include #include "multivoc.h" #include "ll_man.h" #include "fx_man.h" #ifndef TRUE #define TRUE ( 1 == 1 ) #define FALSE ( !TRUE ) #endif static unsigned FX_MixRate; int FX_SoundDevice = -1; int FX_ErrorCode = FX_Ok; int FX_Installed = FALSE; #define FX_SetErrorCode( status ) \ FX_ErrorCode = ( status ); /*--------------------------------------------------------------------- Function: FX_ErrorString Returns a pointer to the error message associated with an error number. A -1 returns a pointer the current error. ---------------------------------------------------------------------*/ char *FX_ErrorString ( int ErrorNumber ) { char *ErrorString; switch (ErrorNumber) { case FX_Warning : case FX_Error : ErrorString = FX_ErrorString(FX_ErrorCode); break; case FX_Ok : ErrorString = "Fx ok."; break; case FX_ASSVersion : ErrorString = "Apogee Sound System Version 0 " "Programmed by Jim Dose\n" "(c) Copyright 1995 James R. Dose. All Rights Reserved.\n"; break; case FX_BlasterError : case FX_SoundCardError : ErrorString = "Sound device error."; break; case FX_InvalidCard : ErrorString = "Invalid Sound Fx device."; break; case FX_MultiVocError : ErrorString = MV_ErrorString(MV_Error); break; case FX_DPMI_Error : ErrorString = "DPMI Error in FX_MAN."; break; default : ErrorString = "Unknown Fx error code."; break; } return(ErrorString); } #if 0 /*--------------------------------------------------------------------- Function: FX_SetupCard Sets the configuration of a sound device. ---------------------------------------------------------------------*/ int FX_SetupCard ( int SoundCard, fx_device *device ) { int status; int DeviceStatus; FX_SoundDevice = SoundCard; status = FX_Ok; FX_SetErrorCode(FX_Ok); switch (SoundCard) { case SoundBlaster : DeviceStatus = BLASTER_Init(); if (DeviceStatus != BLASTER_Ok) { FX_SetErrorCode(FX_SoundCardError); status = FX_Error; break; } device->MaxVoices = 32; BLASTER_GetCardInfo(&device->MaxSampleBits, &device->MaxChannels); break; default : FX_SetErrorCode(FX_InvalidCard); status = FX_Error; } return(status); } #endif #if 0 /*--------------------------------------------------------------------- Function: FX_GetBlasterSettings Returns the current BLASTER environment variable settings. ---------------------------------------------------------------------*/ int FX_GetBlasterSettings ( fx_blaster_config *blaster ) { int status; BLASTER_CONFIG Blaster; FX_SetErrorCode(FX_Ok); status = BLASTER_GetEnv(&Blaster); if (status != BLASTER_Ok) { FX_SetErrorCode(FX_BlasterError); return(FX_Error); } blaster->Type = Blaster.Type; blaster->Address = Blaster.Address; blaster->Interrupt = Blaster.Interrupt; blaster->Dma8 = Blaster.Dma8; blaster->Dma16 = Blaster.Dma16; blaster->Midi = Blaster.Midi; blaster->Emu = Blaster.Emu; return(FX_Ok); } #endif #if 0 /*--------------------------------------------------------------------- Function: FX_SetupSoundBlaster Handles manual setup of the Sound Blaster information. ---------------------------------------------------------------------*/ int FX_SetupSoundBlaster ( fx_blaster_config blaster, int *MaxVoices, int *MaxSampleBits, int *MaxChannels ) { int DeviceStatus; BLASTER_CONFIG Blaster; FX_SetErrorCode(FX_Ok); FX_SoundDevice = SoundBlaster; Blaster.Type = blaster.Type; Blaster.Address = blaster.Address; Blaster.Interrupt = blaster.Interrupt; Blaster.Dma8 = blaster.Dma8; Blaster.Dma16 = blaster.Dma16; Blaster.Midi = blaster.Midi; Blaster.Emu = blaster.Emu; BLASTER_SetCardSettings(Blaster); DeviceStatus = BLASTER_Init(); if (DeviceStatus != BLASTER_Ok) { FX_SetErrorCode(FX_SoundCardError); return(FX_Error); } *MaxVoices = 8; BLASTER_GetCardInfo(MaxSampleBits, MaxChannels); return(FX_Ok); } #endif /*--------------------------------------------------------------------- Function: FX_Init Selects which sound device to use. ---------------------------------------------------------------------*/ int FX_Init ( int SoundCard, int numvoices, int numchannels, int samplebits, unsigned mixrate ) { int status; int devicestatus; if (FX_Installed) { FX_Shutdown(); } FX_MixRate = mixrate; status = FX_Ok; FX_SoundDevice = SoundCard; devicestatus = MV_Init(SoundCard, FX_MixRate, numvoices, numchannels, samplebits); if (devicestatus != MV_Ok) { FX_SetErrorCode(FX_MultiVocError); status = FX_Error; } if (status == FX_Ok) { FX_Installed = TRUE; } return(status); } /*--------------------------------------------------------------------- Function: FX_Shutdown Terminates use of sound device. ---------------------------------------------------------------------*/ int FX_Shutdown ( void ) { int status; if (!FX_Installed) { return(FX_Ok); } status = MV_Shutdown(); if (status != MV_Ok) { FX_SetErrorCode(FX_MultiVocError); status = FX_Error; } FX_Installed = FALSE; return(status); } /*--------------------------------------------------------------------- Function: FX_SetCallback Sets the function to call when a voice is done. ---------------------------------------------------------------------*/ int FX_SetCallBack ( void(*function)(unsigned int) ) { MV_SetCallBack(function); return(FX_Ok); } /*--------------------------------------------------------------------- Function: FX_SetVolume Sets the volume of the current sound device. ---------------------------------------------------------------------*/ void FX_SetVolume ( int volume ) { MV_SetVolume(volume); } /*--------------------------------------------------------------------- Function: FX_GetVolume Returns the volume of the current sound device. ---------------------------------------------------------------------*/ int FX_GetVolume ( void ) { return MV_GetVolume(); } /*--------------------------------------------------------------------- Function: FX_SetReverseStereo Set the orientation of the left and right channels. ---------------------------------------------------------------------*/ void FX_SetReverseStereo ( int setting ) { MV_SetReverseStereo(setting); } /*--------------------------------------------------------------------- Function: FX_GetReverseStereo Returns the orientation of the left and right channels. ---------------------------------------------------------------------*/ int FX_GetReverseStereo ( void ) { return MV_GetReverseStereo(); } /*--------------------------------------------------------------------- Function: FX_SetReverb Sets the reverb level. ---------------------------------------------------------------------*/ void FX_SetReverb ( int reverb ) { MV_SetReverb(reverb); } /*--------------------------------------------------------------------- Function: FX_SetFastReverb Sets the reverb level. ---------------------------------------------------------------------*/ void FX_SetFastReverb ( int reverb ) { MV_SetFastReverb(reverb); } /*--------------------------------------------------------------------- Function: FX_GetMaxReverbDelay Returns the maximum delay time for reverb. ---------------------------------------------------------------------*/ int FX_GetMaxReverbDelay ( void ) { return MV_GetMaxReverbDelay(); } /*--------------------------------------------------------------------- Function: FX_GetReverbDelay Returns the current delay time for reverb. ---------------------------------------------------------------------*/ int FX_GetReverbDelay ( void ) { return MV_GetReverbDelay(); } /*--------------------------------------------------------------------- Function: FX_SetReverbDelay Sets the delay level of reverb to add to mix. ---------------------------------------------------------------------*/ void FX_SetReverbDelay ( int delay ) { MV_SetReverbDelay(delay); } /*--------------------------------------------------------------------- Function: FX_VoiceAvailable Checks if a voice can be play at the specified priority. ---------------------------------------------------------------------*/ int FX_VoiceAvailable ( int priority ) { return MV_VoiceAvailable(priority); } /*--------------------------------------------------------------------- Function: FX_EndLooping Stops the voice associated with the specified handle from looping without stoping the sound. ---------------------------------------------------------------------*/ int FX_EndLooping ( int handle ) { int status; status = MV_EndLooping(handle); if (status == MV_Error) { FX_SetErrorCode(FX_MultiVocError); status = FX_Warning; } return(status); } /*--------------------------------------------------------------------- Function: FX_SetPan Sets the stereo and mono volume level of the voice associated with the specified handle. ---------------------------------------------------------------------*/ int FX_SetPan ( int handle, int vol, int left, int right ) { int status; status = MV_SetPan(handle, vol, left, right); if (status == MV_Error) { FX_SetErrorCode(FX_MultiVocError); status = FX_Warning; } return(status); } /*--------------------------------------------------------------------- Function: FX_SetPitch Sets the pitch of the voice associated with the specified handle. ---------------------------------------------------------------------*/ int FX_SetPitch ( int handle, int pitchoffset ) { int status; status = MV_SetPitch(handle, pitchoffset); if (status == MV_Error) { FX_SetErrorCode(FX_MultiVocError); status = FX_Warning; } return(status); } /*--------------------------------------------------------------------- Function: FX_SetFrequency Sets the frequency of the voice associated with the specified handle. ---------------------------------------------------------------------*/ int FX_SetFrequency ( int handle, int frequency ) { int status; status = MV_SetFrequency(handle, frequency); if (status == MV_Error) { FX_SetErrorCode(FX_MultiVocError); status = FX_Warning; } return(status); } /*--------------------------------------------------------------------- Function: FX_PlayVOC Begin playback of sound data with the given volume and priority. ---------------------------------------------------------------------*/ int FX_PlayVOC ( char *ptr, int pitchoffset, int vol, int left, int right, int priority, unsigned int callbackval ) { int handle; handle = MV_PlayVOC(ptr, pitchoffset, vol, left, right, priority, callbackval); if (handle < MV_Ok) { FX_SetErrorCode(FX_MultiVocError); handle = FX_Warning; } return(handle); } /*--------------------------------------------------------------------- Function: FX_PlayLoopedVOC Begin playback of sound data with the given volume and priority. ---------------------------------------------------------------------*/ int FX_PlayLoopedVOC ( char *ptr, int loopstart, int loopend, int pitchoffset, int vol, int left, int right, int priority, unsigned int callbackval ) { int handle; handle = MV_PlayLoopedVOC(ptr, loopstart, loopend, pitchoffset, vol, left, right, priority, callbackval); if (handle < MV_Ok) { sprintf(tempbuf, "Sound error %d: %s\n",callbackval, FX_ErrorString(FX_Error)); initprintf(tempbuf); FX_SetErrorCode(FX_MultiVocError); handle = FX_Warning; } return(handle); } /*--------------------------------------------------------------------- Function: FX_PlayWAV Begin playback of sound data with the given volume and priority. ---------------------------------------------------------------------*/ int FX_PlayWAV ( char *ptr, int pitchoffset, int vol, int left, int right, int priority, unsigned int callbackval ) { int handle; handle = MV_PlayWAV(ptr, pitchoffset, vol, left, right, priority, callbackval); if (handle < MV_Ok) { FX_SetErrorCode(FX_MultiVocError); handle = FX_Warning; } return(handle); } /*--------------------------------------------------------------------- Function: FX_PlayOGG Begin playback of sound data with the given volume and priority. ---------------------------------------------------------------------*/ int FX_PlayOGG ( char *ptr, int pitchoffset, int vol, int left, int right, int priority, unsigned int callbackval ) { int handle; handle = MV_PlayOGG(ptr, pitchoffset, vol, left, right, priority, callbackval); if (handle < MV_Ok) { FX_SetErrorCode(FX_MultiVocError); handle = FX_Warning; } return(handle); } /*--------------------------------------------------------------------- Function: FX_PlayWAV Begin playback of sound data with the given volume and priority. ---------------------------------------------------------------------*/ int FX_PlayLoopedWAV ( char *ptr, int loopstart, int loopend, int pitchoffset, int vol, int left, int right, int priority, unsigned int callbackval ) { int handle; handle = MV_PlayLoopedWAV(ptr, loopstart, loopend, pitchoffset, vol, left, right, priority, callbackval); if (handle < MV_Ok) { sprintf(tempbuf, "Sound error %d: %s\n",callbackval, FX_ErrorString(FX_Error)); initprintf(tempbuf); FX_SetErrorCode(FX_MultiVocError); handle = FX_Warning; } return(handle); } int FX_PlayLoopedOGG ( char *ptr, int loopstart, int loopend, int pitchoffset, int vol, int left, int right, int priority, unsigned int callbackval ) { int handle; handle = MV_PlayLoopedOGG(ptr, loopstart, loopend, pitchoffset, vol, left, right, priority, callbackval); if (handle < MV_Ok) { sprintf(tempbuf, "Sound error %d: %s\n",callbackval, FX_ErrorString(FX_Error)); initprintf(tempbuf); FX_SetErrorCode(FX_MultiVocError); handle = FX_Warning; } return(handle); } /*--------------------------------------------------------------------- Function: FX_PlayVOC3D Begin playback of sound data at specified angle and distance from listener. ---------------------------------------------------------------------*/ int FX_PlayVOC3D ( char *ptr, int pitchoffset, int angle, int distance, int priority, unsigned int callbackval ) { int handle; handle = MV_PlayVOC3D(ptr, pitchoffset, angle, distance, priority, callbackval); if (handle < MV_Ok) { FX_SetErrorCode(FX_MultiVocError); handle = FX_Warning; } return(handle); } int FX_PlayOGG3D ( char *ptr, int pitchoffset, int angle, int distance, int priority, unsigned int callbackval ) { int handle; handle = MV_PlayOGG3D(ptr, pitchoffset, angle, distance, priority, callbackval); if (handle < MV_Ok) { FX_SetErrorCode(FX_MultiVocError); handle = FX_Warning; } return(handle); } /*--------------------------------------------------------------------- Function: FX_PlayWAV3D Begin playback of sound data at specified angle and distance from listener. ---------------------------------------------------------------------*/ int FX_PlayWAV3D ( char *ptr, int pitchoffset, int angle, int distance, int priority, unsigned int callbackval ) { int handle; handle = MV_PlayWAV3D(ptr, pitchoffset, angle, distance, priority, callbackval); if (handle < MV_Ok) { FX_SetErrorCode(FX_MultiVocError); handle = FX_Warning; } return(handle); } /*--------------------------------------------------------------------- Function: FX_PlayRaw Begin playback of raw sound data with the given volume and priority. ---------------------------------------------------------------------*/ int FX_PlayRaw ( char *ptr, unsigned int length, unsigned rate, int pitchoffset, int vol, int left, int right, int priority, unsigned int callbackval ) { int handle; handle = MV_PlayRaw(ptr, length, rate, pitchoffset, vol, left, right, priority, callbackval); if (handle < MV_Ok) { FX_SetErrorCode(FX_MultiVocError); handle = FX_Warning; } return(handle); } /*--------------------------------------------------------------------- Function: FX_PlayLoopedRaw Begin playback of raw sound data with the given volume and priority. ---------------------------------------------------------------------*/ int FX_PlayLoopedRaw ( char *ptr, unsigned int length, char *loopstart, char *loopend, unsigned rate, int pitchoffset, int vol, int left, int right, int priority, unsigned int callbackval ) { int handle; handle = MV_PlayLoopedRaw(ptr, length, loopstart, loopend, rate, pitchoffset, vol, left, right, priority, callbackval); if (handle < MV_Ok) { FX_SetErrorCode(FX_MultiVocError); handle = FX_Warning; } return(handle); } /*--------------------------------------------------------------------- Function: FX_Pan3D Set the angle and distance from the listener of the voice associated with the specified handle. ---------------------------------------------------------------------*/ int FX_Pan3D ( int handle, int angle, int distance ) { int status; status = MV_Pan3D(handle, angle, distance); if (status != MV_Ok) { FX_SetErrorCode(FX_MultiVocError); status = FX_Warning; } return(status); } /*--------------------------------------------------------------------- Function: FX_SoundActive Tests if the specified sound is currently playing. ---------------------------------------------------------------------*/ int FX_SoundActive ( int handle ) { return(MV_VoicePlaying(handle)); } /*--------------------------------------------------------------------- Function: FX_SoundsPlaying Reports the number of voices playing. ---------------------------------------------------------------------*/ int FX_SoundsPlaying ( void ) { return(MV_VoicesPlaying()); } /*--------------------------------------------------------------------- Function: FX_StopSound Halts playback of a specific voice ---------------------------------------------------------------------*/ int FX_StopSound ( int handle ) { int status; status = MV_Kill(handle); if (status != MV_Ok) { FX_SetErrorCode(FX_MultiVocError); return(FX_Warning); } return(FX_Ok); } /*--------------------------------------------------------------------- Function: FX_StopAllSounds Halts playback of all sounds. ---------------------------------------------------------------------*/ int FX_StopAllSounds ( void ) { int status; status = MV_KillAllVoices(); if (status != MV_Ok) { FX_SetErrorCode(FX_MultiVocError); return(FX_Warning); } return(FX_Ok); } /*--------------------------------------------------------------------- Function: FX_StartDemandFeedPlayback Plays a digitized sound from a user controlled buffering system. ---------------------------------------------------------------------*/ int FX_StartDemandFeedPlayback ( void(*function)(char **ptr, unsigned int *length), int rate, int pitchoffset, int vol, int left, int right, int priority, unsigned int callbackval ) { int handle; handle = MV_StartDemandFeedPlayback(function, rate, pitchoffset, vol, left, right, priority, callbackval); if (handle < MV_Ok) { FX_SetErrorCode(FX_MultiVocError); handle = FX_Warning; } return(handle); } #if 0 /*--------------------------------------------------------------------- Function: FX_StartRecording Starts the sound recording engine. ---------------------------------------------------------------------*/ int FX_StartRecording ( int MixRate, void(*function)(char *ptr, int length) ) { int status; switch (FX_SoundDevice) { case SoundBlaster : status = MV_StartRecording(MixRate, function); if (status != MV_Ok) { FX_SetErrorCode(FX_MultiVocError); status = FX_Warning; } else { status = FX_Ok; } break; default : FX_SetErrorCode(FX_InvalidCard); status = FX_Warning; break; } return(status); } #endif #if 0 /*--------------------------------------------------------------------- Function: FX_StopRecord Stops the sound record engine. ---------------------------------------------------------------------*/ void FX_StopRecord ( void ) { // Stop sound playback switch (FX_SoundDevice) { case SoundBlaster : MV_StopRecord(); break; } } #endif extern void MUSIC_Update(void); void AudioUpdate(void) { MUSIC_Update(); } void playmusic(const char *fn); #if 0 char *makename(char *destname,char *OGGname) { if (!(*OGGname)) return NULL; if (destname) Bfree(destname); destname=Bcalloc(Bstrlen(OGGname)+1,sizeof(char)); if (destname != NULL) Bstrcpy(destname,OGGname); /* if(*OGGname&&OGGname[Bstrlen(OGGname)-1]=='/') { while(*origname=='/')origname++; Bstrcat(destname,origname); } OGGname=Bstrchr(destname,'.'); if(OGGname)Bstrcpy(OGGname,".ogg");else Bstrcat(destname,".ogg"); */ return destname; } int AL_DefineSound(int ID,char *name) { if(ID>=MAXSOUNDS)return 1; g_sounds[ID].filename1=makename(g_sounds[ID].filename1,name); // initprintf("(%s)(%s)(%s)\n",g_sounds[ID].filename1,name,g_sounds[ID].filename); // loadsound(ID); return 0; } int AL_DefineMusic(char *ID,char *name) { int lev,ep,sel;char b1,b2; if(!ID)return 1; if(!Bstrcmp(ID,"intro")) {sel=MAXVOLUMES*MAXLEVELS; ID=env_music_fn[0];}else if(!Bstrcmp(ID,"briefing")){sel=MAXVOLUMES*MAXLEVELS+1;ID=env_music_fn[1];}else if(!Bstrcmp(ID,"loading")) {sel=MAXVOLUMES*MAXLEVELS+2;ID=env_music_fn[2];}else { sscanf(ID,"%c%d%c%d",&b1,&ep,&b2,&lev); lev--;ep--; if(toupper(b1)!='E'||toupper(b2)!='L'||lev>=MAXLEVELS||ep>=MAXVOLUMES)return 1; sel=(ep*MAXLEVELS)+lev; // ID=map[sel].musicfn; } map[sel].musicfn1=makename(map[sel].musicfn1,name/*,ID*/); // initprintf("%s | %3d %2d %2d | %s\n",ID,sel,ep,lev,map[sel].musicfn1); // playmusicMAP(ID,sel); return 0; } #else char *makename(char *destname,char *OGGname,char *origname) { if(!origname)return destname; if(destname)Bfree(destname); destname=Bcalloc(Bstrlen(OGGname)+Bstrlen(origname)+1,sizeof(char)); if(!destname)return 0; Bstrcpy(destname,(*OGGname)?OGGname:origname); if(*OGGname&&OGGname[Bstrlen(OGGname)-1]=='/') { while(*origname=='/')origname++; Bstrcat(destname,origname); } OGGname=Bstrchr(destname,'.'); if(OGGname)Bstrcpy(OGGname,".ogg");else Bstrcat(destname,".ogg"); return destname; } int AL_DefineSound(int ID,char *name) { if(ID>=MAXSOUNDS)return 1; g_sounds[ID].filename1=makename(g_sounds[ID].filename1,name,g_sounds[ID].filename); // initprintf("(%s)(%s)(%s)\n",g_sounds[ID].filename1,name,g_sounds[ID].filename); // loadsound(ID); return 0; } int AL_DefineMusic(char *ID,char *name) { int lev,ep,sel;char b1,b2; if(!ID)return 1; if(!Bstrcmp(ID,"intro")) {sel=MAXVOLUMES*MAXLEVELS; ID=env_music_fn[0];}else if(!Bstrcmp(ID,"briefing")){sel=MAXVOLUMES*MAXLEVELS+1;ID=env_music_fn[1];}else if(!Bstrcmp(ID,"loading")) {sel=MAXVOLUMES*MAXLEVELS+2;ID=env_music_fn[2];}else { sscanf(ID,"%c%d%c%d",&b1,&ep,&b2,&lev); lev--;ep--; if(toupper(b1)!='E'||toupper(b2)!='L'||lev>=MAXLEVELS||ep>=MAXVOLUMES)return 1; sel=(ep*MAXLEVELS)+lev; ID=map[sel].musicfn; } map[sel].musicfn1=makename(map[sel].musicfn1,name,ID); initprintf("%-15s | ",ID); initprintf("%3d %2d %2d | %s\n",sel,ep,lev,map[sel].musicfn1); // playmusicMAP(ID,sel); return 0; } #endif void playmusicMAP(const char *fn,const int sel) { Musicsize=0; if(map[sel].musicfn1) playmusic(map[sel].musicfn1); if(!Musicsize) playmusic(fn); }