You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

1299 lines
40 KiB

/*==LICENSE==*
CyanWorlds.com Engine - MMOG client, server and tools
Copyright (C) 2011 Cyan Worlds, 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/>.
Additional permissions under GNU GPL version 3 section 7
If you modify this Program, or any covered work, by linking or
combining it with any of RAD Game Tools Bink SDK, Autodesk 3ds Max SDK,
NVIDIA PhysX SDK, Microsoft DirectX SDK, OpenSSL library, Independent
JPEG Group JPEG library, Microsoft Windows Media SDK, or Apple QuickTime SDK
(or a modified version of those libraries),
containing parts covered by the terms of the Bink SDK EULA, 3ds Max EULA,
PhysX SDK EULA, DirectX SDK EULA, OpenSSL and SSLeay licenses, IJG
JPEG Library README, Windows Media SDK EULA, or QuickTime SDK EULA, the
licensors of this Program grant you additional
permission to convey the resulting work. Corresponding Source for a
non-source form of such a combination shall include the source code for
the parts of OpenSSL and IJG JPEG Library used as well as that of the covered
work.
You can contact Cyan Worlds, Inc. by email legal@cyan.com
or by snail mail at:
Cyan Worlds, Inc.
14617 N Newport Hwy
Mead, WA 99021
*==LICENSE==*/
#include "HeadSpin.h"
#include <al.h>
#include <alc.h>
#include <efx.h>
#include <MMREG.H>
#ifdef EAX_SDK_AVAILABLE
#include <eax.h>
#endif
#include "hsTimer.h"
#include "hsGeometry3.h"
#include "plgDispatch.h"
#include "plProfile.h"
#include "plStatusLog/plStatusLog.h"
#include "plSound.h"
#include "plAudioCaps.h"
#include "plAudioSystem.h"
#include "plDSoundBuffer.h"
#include "plEAXEffects.h"
#include "plEAXListenerMod.h"
#include "plVoiceChat.h"
#include "pnMessage/plAudioSysMsg.h"
#include "plMessage/plRenderMsg.h"
#include "pnMessage/plRefMsg.h"
#include "plMessage/plAgeLoadedMsg.h"
#include "pnMessage/plTimeMsg.h"
#include "pnKeyedObject/plFixedKey.h"
#include "pnKeyedObject/plKey.h"
#define SAFE_RELEASE(p) if(p){ p->Release(); p = nil; }
#define FADE_TIME 3
#define MAX_NUM_SOURCES 128
#define UPDATE_TIME_MS 100
plProfile_CreateTimer("EAX Update", "Sound", SoundEAXUpdate);
plProfile_CreateTimer("Soft Update", "Sound", SoundSoftUpdate);
plProfile_CreateCounter("Max Sounds", "Sound", SoundMaxNum);
plProfile_CreateTimer("AudioUpdate", "RenderSetup", AudioUpdate);
typedef std::vector<DeviceDescriptor>::iterator DeviceIter;
//// Internal plSoftSoundNode Class Definition ///////////////////////////////
class plSoftSoundNode
{
public:
const plKey fSoundKey;
hsScalar fRank;
plSoftSoundNode *fNext;
plSoftSoundNode **fPrev;
plSoftSoundNode *fSortNext;
plSoftSoundNode **fSortPrev;
plSoftSoundNode( const plKey s ) : fSoundKey( s ) { fNext = nil; fPrev = nil; }
~plSoftSoundNode() { Unlink(); }
void Link( plSoftSoundNode **prev )
{
fNext = *prev;
fPrev = prev;
if( fNext != nil )
fNext->fPrev = &fNext;
*prev = this;
}
void Unlink( void )
{
if( fPrev != nil )
{
*fPrev = fNext;
if( fNext )
fNext->fPrev = fPrev;
fPrev = nil;
fNext = nil;
}
}
void SortedLink( plSoftSoundNode **prev, hsScalar rank )
{
fRank = rank;
fSortNext = *prev;
fSortPrev = prev;
if( fSortNext != nil )
fSortNext->fSortPrev = &fSortNext;
*prev = this;
}
// Larger values are first in the list
void AddToSortedLink( plSoftSoundNode *toAdd, hsScalar rank )
{
if( fRank > rank )
{
if( fSortNext != nil )
fSortNext->AddToSortedLink( toAdd, rank );
else
{
toAdd->SortedLink( &fSortNext, rank );
}
}
else
{
// Cute trick here...
toAdd->SortedLink( fSortPrev, rank );
}
}
void BootSourceOff( void )
{
plSound *sound = plSound::ConvertNoRef( fSoundKey->ObjectIsLoaded() );
if( sound != nil )
{
sound->ForceUnregisterFromAudioSys();
}
}
};
// plAudioSystem //////////////////////////////////////////////////////////////////////////
Int32 plAudioSystem::fMaxNumSounds = 16;
Int32 plAudioSystem::fNumSoundsSlop = 8;
plAudioSystem::plAudioSystem() :
fStartTime(0),
fListenerInit(false),
fSoftRegionSounds(nil),
fActiveSofts(nil),
fCurrDebugSound(nil),
fDebugActiveSoundDisplay(nil),
fUsingEAX(false),
fRestartOnDestruct(false),
fWaitingForShutdown(false),
fActive(false),
fDisplayNumBuffers(false),
fStartFade(0),
fFadeLength(FADE_TIME),
fCaptureDevice(nil),
fLastUpdateTimeMs(0)
{
fCurrListenerPos.Set( -1.e30, -1.e30, -1.e30 );
//fCommittedListenerPos.Set( -1.e30, -1.e30, -1.e30 );
fLastPos.Set(100, 100, 100);
}
plAudioSystem::~plAudioSystem()
{
}
void plAudioSystem::IEnumerateDevices()
{
fDeviceList.clear();
plStatusLog::AddLineS("audio.log", "--Audio Devices --" );
char *devices = (char *)alcGetString(nil, ALC_DEVICE_SPECIFIER);
int major, minor;
while(*devices != nil)
{
ALCdevice *device = alcOpenDevice(devices);
if (device)
{
ALCcontext *context = alcCreateContext(device, NULL);
if (context)
{
alcMakeContextCurrent(context);
// if new actual device name isn't already in the list, then add it...
bool bNewName = true;
for (DeviceIter i = fDeviceList.begin(); i != fDeviceList.end(); i++)
{
if (strcmp((*i).GetDeviceName(), devices) == 0)
{
bNewName = false;
}
}
if ((bNewName))
{
alcGetIntegerv(device, ALC_MAJOR_VERSION, sizeof(int), &major);
alcGetIntegerv(device, ALC_MINOR_VERSION, sizeof(int), &minor);
plStatusLog::AddLineS("audio.log", "%s OpenAL ver: %d.%d", devices, major, minor );
// filter out any devices that aren't openal 1.1 compliant
if(major > 1 || (major == 1 && minor >= 1))
{
hsBool supportsEAX = false;
#ifdef EAX_SDK_AVAILABLE
if(alIsExtensionPresent((ALchar *)"EAX4.0") || alIsExtensionPresent((ALchar *) "EAX4.0Emulated"))
{
supportsEAX = true;
}
#endif
DeviceDescriptor desc(devices, supportsEAX);
fDeviceList.push_back(desc);
}
}
alcMakeContextCurrent(nil);
alcDestroyContext(context);
}
alcCloseDevice(device);
}
devices += strlen(devices) + 1;
}
DeviceDescriptor temp("", 0);
// attempt to order devices
for(unsigned i = 0; i < fDeviceList.size(); ++i)
{
if(strstr(fDeviceList[i].GetDeviceName(), "Software"))
{
temp = fDeviceList[i];
fDeviceList[i] = fDeviceList[0];
fDeviceList[0] = temp;
}
if(strstr(fDeviceList[i].GetDeviceName(), "Hardware"))
{
temp = fDeviceList[i];
fDeviceList[i] = fDeviceList[1];
fDeviceList[1] = temp;
}
}
}
//// Init ////////////////////////////////////////////////////////////////////
hsBool plAudioSystem::Init( hsWindowHndl hWnd )
{
plgAudioSys::fRestarting = false;
static hsBool firstTimeInit = true;
plStatusLog::AddLineS( "audio.log", plStatusLog::kBlue, "ASYS: -- Init --" );
fMaxNumSources = 0;
plStatusLog::AddLineS( "audio.log", plStatusLog::kGreen, "ASYS: Detecting caps..." );
plSoundBuffer::Init();
// Set the maximum number of sounds based on priority cutoff slider
SetMaxNumberOfActiveSounds();
const char *deviceName = plgAudioSys::fDeviceName.c_str();
hsBool useDefaultDevice = true;
if(firstTimeInit)
{
IEnumerateDevices();
firstTimeInit = false;
}
if(!fDeviceList.size())
{
plStatusLog::AddLineS( "audio.log", plStatusLog::kRed, "ASYS: ERROR Unable to query any devices, is openal installed?" );
return false;
}
// shouldn't ever happen, but just in case
if(!deviceName)
plgAudioSys::SetDeviceName(DEFAULT_AUDIO_DEVICE_NAME);
for(DeviceIter i = fDeviceList.begin(); i != fDeviceList.end(); i++)
{
if(!strcmp((*i).GetDeviceName(), deviceName))
{
useDefaultDevice = false;
break;
}
}
if(useDefaultDevice)
{
// if no device has been specified we will use the "Generic Software" device by default. If "Generic Software" is unavailable(which can happen) we select the first available device
// We want to use software by default since some audio cards have major problems with hardware + eax.
const char *defaultDev = fDeviceList.front().GetDeviceName();
for(DeviceIter i = fDeviceList.begin(); i != fDeviceList.end(); i++)
{
if(!strcmp(DEFAULT_AUDIO_DEVICE_NAME, (*i).GetDeviceName()))
{
defaultDev = DEFAULT_AUDIO_DEVICE_NAME;
break;
}
}
plgAudioSys::SetDeviceName(defaultDev, false);
fDevice = alcOpenDevice(defaultDev);
plStatusLog::AddLineS( "audio.log", plStatusLog::kRed, "ASYS: %s device selected", defaultDev );
deviceName = defaultDev;
}
else
{
plgAudioSys::SetDeviceName(deviceName, false);
fDevice = alcOpenDevice(deviceName);
plStatusLog::AddLineS( "audio.log", plStatusLog::kRed, "ASYS: %s device selected", deviceName );
}
if(!fDevice)
{
plStatusLog::AddLineS( "audio.log", plStatusLog::kRed, "ASYS: ERROR initializing OpenAL" );
return false;
}
fContext = alcCreateContext(fDevice, 0);
alcMakeContextCurrent(fContext);
ALenum error;
if(alGetError() != AL_NO_ERROR)
{
plStatusLog::AddLineS( "audio.log", plStatusLog::kRed, "ASYS: ERROR alcMakeContextCurrent failed" );
return false;
}
plStatusLog::AddLineS("audio.log", "OpenAL vendor: %s", alGetString(AL_VENDOR));
plStatusLog::AddLineS("audio.log", "OpenAL version: %s", alGetString(AL_VERSION));
plStatusLog::AddLineS("audio.log", "OpenAL renderer: %s", alGetString(AL_RENDERER));
plStatusLog::AddLineS("audio.log", "OpenAL extensions: %s", alGetString(AL_EXTENSIONS));
plAudioCaps caps = plAudioCapsDetector::Detect();
if(strcmp(deviceName, DEFAULT_AUDIO_DEVICE_NAME))
{
// we are using a hardware device, set priority based on number of hardware voices
unsigned int numVoices = caps.GetMaxNumVoices();
if(numVoices < 16)
plgAudioSys::SetPriorityCutoff(3);
SetMaxNumberOfActiveSounds();
}
// setup capture device
ALCsizei bufferSize = FREQUENCY * 2 * BUFFER_LEN_SECONDS; // times 2 for 16-bit format
//const char *dev = alcGetString(fDevice, ALC_CAPTURE_DEFAULT_DEVICE_SPECIFIER);
fCaptureDevice = alcCaptureOpenDevice(nil, FREQUENCY, AL_FORMAT_MONO16, bufferSize);
fMaxNumSources = caps.GetMaxNumVoices();
// attempt to init the EAX listener.
if( plgAudioSys::fEnableEAX )
{
fUsingEAX = plEAXListener::GetInstance().Init();
if( fUsingEAX )
{
plStatusLog::AddLineS( "audio.log", plStatusLog::kGreen, "ASYS: EAX support detected and enabled." );
}
else
{
plStatusLog::AddLineS( "audio.log", plStatusLog::kRed, "ASYS: EAX support NOT detected. EAX effects disabled." );
}
}
else
fUsingEAX = false;
plProfile_Set(SoundMaxNum, fMaxNumSounds);
alDistanceModel(AL_INVERSE_DISTANCE_CLAMPED);
error = alGetError();
fWaitingForShutdown = false;
plgDispatch::Dispatch()->RegisterForExactType( plAgeLoadedMsg::Index(), GetKey() );
return true;
}
//// Shutdown ////////////////////////////////////////////////////////////////
void plAudioSystem::Shutdown()
{
plStatusLog::AddLineS( "audio.log", plStatusLog::kBlue, "ASYS: -- Shutdown --" );
plSoundBuffer::Shutdown();
// Delete our active sounds list
delete fDebugActiveSoundDisplay;
fDebugActiveSoundDisplay = nil;
// Unregister soft sounds
while( fSoftRegionSounds != nil )
{
fSoftRegionSounds->BootSourceOff();
delete fSoftRegionSounds;
}
while( fActiveSofts != nil )
{
fActiveSofts->BootSourceOff();
delete fActiveSofts;
}
while( fEAXRegions.GetCount() > 0 )
{
if( fEAXRegions[ 0 ] != nil && fEAXRegions[ 0 ]->GetKey() != nil )
{
GetKey()->Release( fEAXRegions[ 0 ]->GetKey() );
}
fEAXRegions.Remove( 0 );
}
plEAXListener::GetInstance().ClearProcessCache();
plSound::SetCurrDebugPlate( nil );
fCurrDebugSound = nil;
// Reset this, just in case
fPendingRegisters.Reset();
//fListenerInit = false;
if( fUsingEAX )
{
plEAXListener::GetInstance().Shutdown();
}
alcCaptureStop(fCaptureDevice);
alcCaptureCloseDevice(fCaptureDevice);
fCaptureDevice = nil;
alcMakeContextCurrent(nil);
alcDestroyContext(fContext);
alcCloseDevice(fDevice);
fContext = nil;
fDevice = nil;
fStartTime = 0;
fUsingEAX = false;
fCurrListenerPos.Set( -1.e30, -1.e30, -1.e30 );
//fCommittedListenerPos.Set( -1.e30, -1.e30, -1.e30 );
if( fRestartOnDestruct )
{
fRestartOnDestruct = false;
plgAudioSys::Activate( true );
}
plgDispatch::Dispatch()->UnRegisterForExactType(plAgeLoadedMsg::Index(), GetKey() );
fWaitingForShutdown = false;
}
int plAudioSystem::GetNumAudioDevices()
{
return fDeviceList.size();
}
const char *plAudioSystem::GetAudioDeviceName(int index)
{
if(index < 0 || index >= fDeviceList.size())
{
hsAssert(false, "Invalid index passed to GetAudioDeviceName");
return nil;
}
return fDeviceList[index].GetDeviceName();
}
hsBool plAudioSystem::SupportsEAX(const char *deviceName)
{
for(DeviceIter i = fDeviceList.begin(); i != fDeviceList.end(); i++)
{
if(!strcmp((*i).GetDeviceName(), deviceName))
{
return (*i).SupportsEAX();
}
}
return false;
}
void plAudioSystem::SetDistanceModel(int i)
{
switch(i)
{
case 0: alDistanceModel(AL_NONE); break;
case 1: alDistanceModel(AL_INVERSE_DISTANCE ); break;
case 2: alDistanceModel(AL_INVERSE_DISTANCE_CLAMPED); break;
case 3: alDistanceModel(AL_LINEAR_DISTANCE ); break;
case 4: alDistanceModel(AL_LINEAR_DISTANCE_CLAMPED ); break;
case 5: alDistanceModel(AL_EXPONENT_DISTANCE ); break;
case 6: alDistanceModel(AL_EXPONENT_DISTANCE_CLAMPED); break;
}
}
// Set the number of active sounds the audio system is allowed to play, based on the priority cutoff
void plAudioSystem::SetMaxNumberOfActiveSounds()
{
UInt16 priorityCutoff = plgAudioSys::GetPriorityCutoff();
int maxNumSounds = 24;
// Keep this to a reasonable amount based on the users hardware, since we want the sounds to be played in hardware
if(maxNumSounds > fMaxNumSources && fMaxNumSources != 0 )
maxNumSounds = fMaxNumSources / 2;
// Allow a certain number of sounds based on a user specified setting.
// Above that limit, we want 1/2 more sounds (8 for the max of 16) for a slop buffer,
// if they fit, so that sounds that shouldn't be playing can still play in case they suddenly pop
// back into priority range (so we don't incur performance hits when sounds hover on
// the edge of being high enough priority to play)
fMaxNumSounds = maxNumSounds;
fNumSoundsSlop = fMaxNumSounds / 2;
plStatusLog::AddLineS( "audio.log", "Max Number of Sounds Set to: %d", fMaxNumSounds);
}
void plAudioSystem::SetListenerPos(const hsPoint3 pos)
{
fCurrListenerPos = pos;
alListener3f(AL_POSITION, pos.fX, pos.fZ, -pos.fY); // negate z coord, since openal uses opposite handedness
}
void plAudioSystem::SetListenerVelocity(const hsVector3 vel)
{
alListener3f(AL_VELOCITY, 0, 0, 0); // no doppler shift
}
void plAudioSystem::SetListenerOrientation(const hsVector3 view, const hsVector3 up)
{
ALfloat orientation[] = { view.fX, view.fZ, -view.fY, up.fX, up.fZ, -up.fY };
alListenerfv(AL_ORIENTATION, orientation);
}
void plAudioSystem::SetActive( hsBool b )
{
fActive = b;
if( fActive )
{
// Clear to send activate message (if listener not inited yet, delay until then)
plgDispatch::MsgSend( TRACKED_NEW plAudioSysMsg( plAudioSysMsg::kActivate ) );
}
}
//// IRegisterSoftSound //////////////////////////////////////////////////////
// Note: each sound might kick another off the top-n-ranked-sounds list, so
// we call IUpdateSoftSounds() each time one is added. Ugly as sin, but at
// least all the calc code is in one place. Possible optimization in the
// future: when calling IUpdate(), any sounds that are already active don't
// need to be recalced, just resorted.
void plAudioSystem::RegisterSoftSound( const plKey soundKey )
{
plSoftSoundNode *node = TRACKED_NEW plSoftSoundNode( soundKey );
node->Link( &fSoftRegionSounds );
fCurrDebugSound = nil;
plSound::SetCurrDebugPlate( nil );
}
//// IUnregisterSoftSound ////////////////////////////////////////////////////
void plAudioSystem::UnregisterSoftSound( const plKey soundKey )
{
plSoftSoundNode *node;
for( node = fActiveSofts; node != nil; node = node->fNext )
{
if( node->fSoundKey == soundKey )
{
delete node;
return;
}
}
for( node = fSoftRegionSounds; node != nil; node = node->fNext )
{
if( node->fSoundKey == soundKey )
{
delete node;
return;
}
}
// We might have unregistered it ourselves on destruction, so don't bother
fCurrDebugSound = nil;
plSound::SetCurrDebugPlate( nil );
}
//// IUpdateSoftSounds ///////////////////////////////////////////////////////
// OK, so the listener moved. Since our sound soft volumes are all based on
// the listener's position, we have to update all sounds with soft volumes
// now. This involves some steps:
// - Determining what volumes the listener has moved out of
// - Determining what volumes the listener has changed position in
// - Determining what volumes the listener has entered
// - Updating the levels of all sounds associated with all of the above
// volumes
// The first two tests are easy, since we'll have kept track of what volumes
// the listener was in last time. The last part is the tricky one and the
// one that will kill us in performance if we're not careful. However, we
// can first check the bounding box of the sounds in question, since outside
// of them the soft volume won't have any effect. The last part is simply a
// matter of querying the sound volumes based on the listener's position and
// setting the soft volume attenuation on the sound to that level.
//
// Note: for each sound that is still in range, we call CalcSoftVolume() and
// use the resulting value to rank each sound. Then, we take the top n sounds
// and disable the rest. We *could* rank by distance to listener, which would
// be far faster; however, we could have a sound (or background music) that
// is technically closest to the listener but completely faded by a soft volume,
// thus needlessly cutting off another sound that might be more important.
// This way is slower, but better quality.
// Also note: to differentiate between two sounds in the same soft volume at
// full strength, we divide the soft volume ranks by the distSquared, thus
// giving us a reasonable approximation at a good rank...<sigh>
void plAudioSystem::IUpdateSoftSounds( const hsPoint3 &newPosition )
{
plSoftSoundNode *node, *myNode;
hsScalar distSquared, rank;
plSoftSoundNode *sortedList = nil;
Int32 i;
plProfile_BeginTiming(SoundSoftUpdate);
// Check the sounds the listener is already inside of. If we moved out, stop sound, else
// just change attenuation
for( node = fActiveSofts; node != nil; )
{
plSound *sound = plSound::ConvertNoRef( node->fSoundKey->ObjectIsLoaded() );
bool notActive = false;
if(sound)
sound->Update();
// Quick checks for not-active
if( sound == nil )
notActive = true;
else if( !sound->IsWithinRange( newPosition, &distSquared ) )
notActive = true;
else if(sound->GetPriority() > plgAudioSys::GetPriorityCutoff())
notActive = true;
if(plgAudioSys::fMutedStateChange)
{
sound->SetMuted(plgAudioSys::fMuted);
}
if( !notActive )
{
/// Our initial guess is that it's enabled...
sound->CalcSoftVolume( true, distSquared );
rank = sound->GetVolumeRank();
if( rank <= 0.f )
notActive = true;
else
{
/// Queue up in our sorted list...
if( sortedList == nil )
node->SortedLink( &sortedList, (10.0f - sound->GetPriority()) * rank );
else
sortedList->AddToSortedLink( node, (10.0f - sound->GetPriority()) * rank );
/// Still in radius, so consider it still "active".
node = node->fNext;
}
}
if( notActive )
{
/// Moved out of range of the sound--stop the sound entirely and move it to our
/// yeah-they're-registered-but-not-active list
myNode = node;
node = node->fNext;
myNode->Unlink();
myNode->Link( &fSoftRegionSounds );
/// We know this sound won't be enabled, so skip the Calc() call
if( sound != nil )
sound->UpdateSoftVolume( false );
}
}
// Now check remaining sounds to see if the listener moved into them
for( node = fSoftRegionSounds; node != nil; )
{
if( !fListenerInit )
{
node = node->fNext;
continue;
}
plSound *sound = plSound::ConvertNoRef( node->fSoundKey->ObjectIsLoaded() );
if( !sound || sound->GetPriority() > plgAudioSys::GetPriorityCutoff() )
{
node = node->fNext;
continue;
}
sound->Update();
if(plgAudioSys::fMutedStateChange)
{
sound->SetMuted(plgAudioSys::fMuted);
}
if( sound->IsWithinRange( newPosition, &distSquared ) )
{
/// Our initial guess is that it's enabled...
sound->CalcSoftVolume( true, distSquared );
rank = sound->GetVolumeRank();
if( rank > 0.f )
{
/// We just moved into its range, so move it to our active list and start the sucker
myNode = node;
node = node->fNext;
myNode->Unlink();
myNode->Link( &fActiveSofts );
/// Queue up in our sorted list...
if( sortedList == nil )
myNode->SortedLink( &sortedList, (10.0f - sound->GetPriority()) * rank );
else
sortedList->AddToSortedLink( myNode, (10.0f - sound->GetPriority()) * rank );
}
else
{
/// Do NOT notify sound, since we were outside of its range and still are
// (but if we're playing, we shouldn't be, so better update)
if( sound->IsPlaying() )
sound->UpdateSoftVolume( false );
node = node->fNext;
}
}
else
{
/// Do NOT notify sound, since we were outside of its range and still are
node = node->fNext;
sound->Disable(); // ensure that dist attenuation is set to zero so we don't accidentally play
}
}
plgAudioSys::fMutedStateChange = false;
/// Go through sorted list, enabling only the first n sounds and disabling the rest
// DEBUG: Create a screen-only statusLog to display which sounds are what
if( fDebugActiveSoundDisplay == nil )
fDebugActiveSoundDisplay = plStatusLogMgr::GetInstance().CreateStatusLog( 32, "Active Sounds", plStatusLog::kDontWriteFile | plStatusLog::kDeleteForMe | plStatusLog::kFilledBackground );
fDebugActiveSoundDisplay->Clear();
if(fDisplayNumBuffers)
fDebugActiveSoundDisplay->AddLineF(0xffffffff, "Num Buffers: %d", plDSoundBuffer::GetNumBuffers() );
fDebugActiveSoundDisplay->AddLine("Not streamed", plStatusLog::kGreen);
fDebugActiveSoundDisplay->AddLine("Disk streamed", plStatusLog::kYellow);
fDebugActiveSoundDisplay->AddLine("RAM streamed", plStatusLog::kWhite);
fDebugActiveSoundDisplay->AddLine("Ogg streamed", plStatusLog::kRed);
fDebugActiveSoundDisplay->AddLine("Incidentals", 0xff00ffff);
fDebugActiveSoundDisplay->AddLine("--------------------");
for( i = 0; sortedList != nil && i < fMaxNumSounds; sortedList = sortedList->fSortNext )
{
plSound *sound = plSound::ConvertNoRef( sortedList->fSoundKey->GetObjectPtr() );
if(!sound) continue;
/// Notify sound that it really is still enabled
sound->UpdateSoftVolume( true );
UInt32 color = plStatusLog::kGreen;
switch (sound->GetStreamType())
{
case plSound::kStreamFromDisk: color = plStatusLog::kYellow; break;
case plSound::kStreamFromRAM: color = plStatusLog::kWhite; break;
case plSound::kStreamCompressed: color = plStatusLog::kRed; break;
}
if(sound->GetType() == plgAudioSys::kVoice) color = 0xffff8800;
if(sound->IsPropertySet(plSound::kPropIncidental)) color = 0xff00ffff;
if( fUsingEAX && sound->GetEAXSettings().IsEnabled() )
{
fDebugActiveSoundDisplay->AddLineF(
color,
"%d %1.2f %1.2f (%d occ) %s",
sound->GetPriority(),
sortedList->fRank,
sound->GetVolume() ? sound->GetVolumeRank() / sound->GetVolume() : 0,
sound->GetEAXSettings().GetCurrSofts().GetOcclusion(),
sound->GetKeyName()
);
}
else
{
fDebugActiveSoundDisplay->AddLineF(
color,
"%d %1.2f %1.2f %s",
sound->GetPriority(),
sortedList->fRank,
sound->GetVolume() ? sound->GetVolumeRank() / sound->GetVolume() : 0,
sound->GetKeyName()
);
}
i++;
}
for( ; sortedList != nil; sortedList = sortedList->fSortNext, i++ )
{
plSound *sound = plSound::ConvertNoRef( sortedList->fSoundKey->GetObjectPtr() );
if(!sound) continue;
/// These unlucky sounds don't get to play (yet). Also, be extra mean
/// and pretend we're updating for "the first time", which will force them to
/// stop immediately
// Update: since being extra mean can incur a nasty performance hit when sounds hover back and
// forth around the fMaxNumSounds mark, we have a "slop" allowance: i.e. sounds that we're going
// to say shouldn't be playing but we'll let them play for a bit anyway just in case they raise
// in priority. So only be mean to the sounds outside this slop range
sound->UpdateSoftVolume( false, ( i < fMaxNumSounds + fNumSoundsSlop ) ? false : true );
fDebugActiveSoundDisplay->AddLineF(
0xff808080,
"%d %1.2f %s",
sound->GetPriority(),
sound->GetVolume() ? sound->GetVolumeRank() / sound->GetVolume() : 0,
sound->GetKeyName()
);
}
plProfile_EndTiming(SoundSoftUpdate);
}
void plAudioSystem::NextDebugSound( void )
{
plSoftSoundNode *node;
if( fCurrDebugSound == nil )
fCurrDebugSound = ( fSoftRegionSounds == nil ) ? fActiveSofts : fSoftRegionSounds;
else
{
node = fCurrDebugSound;
fCurrDebugSound = fCurrDebugSound->fNext;
if( fCurrDebugSound == nil )
{
// Trace back to find which list we were in
for( fCurrDebugSound = fSoftRegionSounds; fCurrDebugSound != nil; fCurrDebugSound = fCurrDebugSound->fNext )
{
if( fCurrDebugSound == node ) // Was in first list, move to 2nd
{
fCurrDebugSound = fActiveSofts;
break;
}
}
// else Must've been in 2nd list, so keep nil
}
}
if( fCurrDebugSound != nil )
plSound::SetCurrDebugPlate( fCurrDebugSound->fSoundKey );
else
plSound::SetCurrDebugPlate( nil );
}
void plAudioSystem::SetFadeLength(float lengthSec)
{
fFadeLength = lengthSec;
}
hsBool plAudioSystem::MsgReceive(plMessage* msg)
{
if(plTimeMsg *time = plTimeMsg::ConvertNoRef( msg ) )
{
if(!plgAudioSys::IsMuted())
{
double currTime = hsTimer::GetSeconds();
if(fStartFade == 0)
{
plStatusLog::AddLineS("audio.log", "Starting Fade %f", currTime);
}
if((currTime - fStartFade) > fFadeLength)
{
fStartFade = 0;
plgDispatch::Dispatch()->UnRegisterForExactType( plTimeMsg::Index(), GetKey() );
plStatusLog::AddLineS("audio.log", "Stopping Fade %f", currTime);
plgAudioSys::SetGlobalFadeVolume( 1.0 );
}
else
{
plgAudioSys::SetGlobalFadeVolume( (hsScalar)((currTime-fStartFade) / fFadeLength) );
}
}
return true;
}
if (plAudioSysMsg* pASMsg = plAudioSysMsg::ConvertNoRef( msg ))
{
if (pASMsg->GetAudFlag() == plAudioSysMsg::kPing && fListenerInit)
{
plAudioSysMsg* pMsg = TRACKED_NEW plAudioSysMsg( plAudioSysMsg::kActivate );
pMsg->AddReceiver( pASMsg->GetSender() );
pMsg->SetBCastFlag(plMessage::kBCastByExactType, false);
plgDispatch::MsgSend( pMsg );
return true;
}
else if (pASMsg->GetAudFlag() == plAudioSysMsg::kSetVol)
{
return true;
}
else if( pASMsg->GetAudFlag() == plAudioSysMsg::kDestroy )
{
if( fWaitingForShutdown )
Shutdown();
return true;
}
else if( pASMsg->GetAudFlag() == plAudioSysMsg::kUnmuteAll )
{
if( !pASMsg->HasBCastFlag( plMessage::kBCastByExactType ) )
plgAudioSys::SetMuted( false );
return true;
}
}
if(plRenderMsg* pRMsg = plRenderMsg::ConvertNoRef( msg ))
{
//if( fListener )
{
plProfile_BeginLap(AudioUpdate, this->GetKey()->GetUoid().GetObjectName());
if(hsTimer::GetMilliSeconds() - fLastUpdateTimeMs > UPDATE_TIME_MS)
{
IUpdateSoftSounds( fCurrListenerPos );
if( fUsingEAX )
{
plProfile_BeginTiming(SoundEAXUpdate);
plEAXListener::GetInstance().ProcessMods( fEAXRegions );
plProfile_EndTiming(SoundEAXUpdate);
}
//fCommittedListenerPos = fCurrListenerPos;
}
plProfile_EndLap(AudioUpdate, this->GetKey()->GetUoid().GetObjectName());
}
return true;
}
if(plGenRefMsg *refMsg = plGenRefMsg::ConvertNoRef( msg ))
{
if( refMsg->GetContext() & ( plRefMsg::kOnCreate | plRefMsg::kOnRequest | plRefMsg::kOnReplace ) )
{
fEAXRegions.Append( plEAXListenerMod::ConvertNoRef( refMsg->GetRef() ) );
plEAXListener::GetInstance().ClearProcessCache();
}
else if( refMsg->GetContext() & ( plRefMsg::kOnRemove | plRefMsg::kOnDestroy ) )
{
int idx = fEAXRegions.Find( plEAXListenerMod::ConvertNoRef( refMsg->GetRef() ) );
if( idx != fEAXRegions.kMissingIndex )
fEAXRegions.Remove( idx );
plEAXListener::GetInstance().ClearProcessCache();
}
return true;
}
if(plAgeLoadedMsg *pALMsg = plAgeLoadedMsg::ConvertNoRef(msg))
{
if(!pALMsg->fLoaded)
{
fLastPos = fCurrListenerPos;
fListenerInit = false;
}
else
{
fListenerInit = true;
}
}
return hsKeyedObject::MsgReceive(msg);
}
// plgAudioSystem //////////////////////////////////////////////////////////////////////
plAudioSystem* plgAudioSys::fSys = nil;
hsBool plgAudioSys::fInit = false;
hsBool plgAudioSys::fActive = false;
hsBool plgAudioSys::fUseHardware = false;
hsBool plgAudioSys::fMuted = true;
hsBool plgAudioSys::fDelayedActivate = false;
hsBool plgAudioSys::fEnableEAX = false;
hsWindowHndl plgAudioSys::fWnd = nil;
hsScalar plgAudioSys::fChannelVolumes[ kNumChannels ] = { 1.f, 1.f, 1.f, 1.f, 1.f, 1.f };
hsScalar plgAudioSys::f2D3DBias = 0.75f;
UInt32 plgAudioSys::fDebugFlags = 0;
hsScalar plgAudioSys::fStreamingBufferSize = 2.f;
hsScalar plgAudioSys::fStreamFromRAMCutoff = 10.f;
UInt8 plgAudioSys::fPriorityCutoff = 9; // We cut off sounds above this priority
hsBool plgAudioSys::fEnableExtendedLogs = false;
hsScalar plgAudioSys::fGlobalFadeVolume = 1.f;
hsBool plgAudioSys::fLogStreamingUpdates = false;
std::string plgAudioSys::fDeviceName;
hsBool plgAudioSys::fRestarting = false;
hsBool plgAudioSys::fMutedStateChange = false;
void plgAudioSys::Init(hsWindowHndl hWnd)
{
fSys = TRACKED_NEW plAudioSystem;
fSys->RegisterAs( kAudioSystem_KEY );
plgDispatch::Dispatch()->RegisterForExactType( plAudioSysMsg::Index(), fSys->GetKey() );
plgDispatch::Dispatch()->RegisterForExactType( plRenderMsg::Index(), fSys->GetKey() );
if(hsPhysicalMemory() <= 380)
{
plStatusLog::AddLineS("audio.log", "StreamFromRam Disabled");
fStreamFromRAMCutoff = 4;
}
fWnd = hWnd;
if(fMuted)
SetGlobalFadeVolume(0.0f);
if( fDelayedActivate )
Activate( true );
}
void plgAudioSys::SetActive(hsBool b)
{
fActive = b;
}
void plgAudioSys::SetMuted( hsBool b )
{
fMuted = b;
fMutedStateChange = true;
if(fMuted)
SetGlobalFadeVolume(0.0f);
else
SetGlobalFadeVolume(1.0);
}
void plgAudioSys::SetUseHardware(hsBool b)
{
fUseHardware = b;
if( fActive )
Restart();
}
void plgAudioSys::EnableEAX( hsBool b )
{
fEnableEAX = b;
if( fActive )
Restart();
}
void plgAudioSys::SetAudioMode(AudioMode mode)
{
if(mode == kDisabled)
{
Activate(false);
return;
}
else if(mode == kSoftware)
{
fActive = true;
fUseHardware = false;
fEnableEAX = false;
}
else if(mode == kHardware)
{
fActive = true;
fUseHardware = true;
fEnableEAX = false;
}
else if(mode == kHardwarePlusEAX)
{
fActive = true;
fUseHardware = true;
fEnableEAX = true;
}
Restart();
}
int plgAudioSys::GetAudioMode()
{
if (fActive)
{
if (fUseHardware)
{
if (fEnableEAX)
{
return kHardwarePlusEAX;
}
else
{
return kHardware;
}
}
else
{
return kSoftware;
}
}
else
{
return kDisabled;
}
}
void plgAudioSys::Restart( void )
{
if( fSys )
{
fSys->fRestartOnDestruct = true;
Activate( false );
fRestarting = true;
}
}
void plgAudioSys::Shutdown()
{
Activate( false );
if( fSys )
{
fSys->UnRegisterAs( kAudioSystem_KEY );
}
}
void plgAudioSys::Activate(hsBool b)
{
if( fSys == nil )
{
fDelayedActivate = true;
return;
}
if (b == fInit)
return;
if (!fActive)
return;
if( b )
{
plStatusLog::AddLineS( "audio.log", plStatusLog::kBlue, "ASYS: -- Attempting audio system init --" );
if( !fSys->Init( fWnd ) )
{
// Cannot init audio system. Don't activate
return;
}
fInit = true;
fSys->SetActive( true );
if( !IsMuted() )
{
SetMuted( true );
plAudioSysMsg *msg = TRACKED_NEW plAudioSysMsg( plAudioSysMsg::kUnmuteAll );
msg->SetTimeStamp( hsTimer::GetSysSeconds() );
msg->AddReceiver( fSys->GetKey() );
msg->SetBCastFlag( plMessage::kBCastByExactType, false );
msg->Send();
}
return;
}
fSys->SetActive( false );
plStatusLog::AddLineS( "audio.log", plStatusLog::kBlue, "ASYS: -- Sending deactivate/destroy messages --" );
plgDispatch::MsgSend( TRACKED_NEW plAudioSysMsg( plAudioSysMsg::kDeActivate ) );
// Send ourselves a shutdown message, so that the deactivates get processed first
fSys->fWaitingForShutdown = true;
plAudioSysMsg *msg = TRACKED_NEW plAudioSysMsg( plAudioSysMsg::kDestroy );
msg->SetBCastFlag( plMessage::kBCastByExactType, false );
msg->Send( fSys->GetKey() );
// fSys->Shutdown();
fInit = false;
}
void plgAudioSys::SetChannelVolume( ASChannel chan, hsScalar vol )
{
fChannelVolumes[ chan ] = vol;
}
void plgAudioSys::SetGlobalFadeVolume( hsScalar vol )
{
if(!fMuted)
fGlobalFadeVolume = vol;
else
fGlobalFadeVolume = 0;
}
hsScalar plgAudioSys::GetChannelVolume( ASChannel chan )
{
return fChannelVolumes[ chan ];
}
void plgAudioSys::NextDebugSound( void )
{
fSys->NextDebugSound();
}
void plgAudioSys::Set2D3DBias( hsScalar bias )
{
f2D3DBias = bias;
}
hsScalar plgAudioSys::Get2D3Dbias()
{
return f2D3DBias;
}
void plgAudioSys::SetDeviceName(const char *device, hsBool restart /* = false */)
{
fDeviceName = device;
if(restart)
Restart();
}
int plgAudioSys::GetNumAudioDevices()
{
if(fSys)
return fSys->GetNumAudioDevices();
return 0;
}
const char *plgAudioSys::GetAudioDeviceName(int index)
{
if(fSys)
{
return fSys->GetAudioDeviceName(index);
}
return nil;
}
ALCdevice *plgAudioSys::GetCaptureDevice()
{
if(fSys)
{
return fSys->fCaptureDevice;
}
return nil;
}
hsBool plgAudioSys::SupportsEAX(const char *deviceName)
{
if(fSys)
{
return fSys->SupportsEAX(deviceName);
}
return nil;
}
void plgAudioSys::RegisterSoftSound( const plKey soundKey )
{
if(fSys)
{
fSys->RegisterSoftSound(soundKey);
}
}
void plgAudioSys::UnregisterSoftSound( const plKey soundKey )
{
if(fSys)
{
fSys->UnregisterSoftSound(soundKey);
}
}
void plgAudioSys::SetListenerPos(const hsPoint3 pos)
{
if(fSys)
{
fSys->SetListenerPos(pos);
}
}
void plgAudioSys::SetListenerVelocity(const hsVector3 vel)
{
if(fSys)
{
fSys->SetListenerVelocity(vel);
}
}
void plgAudioSys::SetListenerOrientation(const hsVector3 view, const hsVector3 up)
{
if(fSys)
{
fSys->SetListenerOrientation(view, up);
}
}