Method update

Engine/source/sfx/sfxSoundscape.cpp:109–216

//-----------------------------------------------------------------------------

void SFXSoundscapeManager::update()
{
   // Make sure the topmost reverb on the stack is active.
   
   S32 reverbIndex = _findTopmostReverbOnStack( mStack );
   if( mCurrentReverbIndex != reverbIndex )
   {
      if( reverbIndex == -1 )
      {
         // No ambience on the stack has reverb settings so reset
         // to default.
         SFX->setReverb( SFXReverbProperties() );
      }
      else
      {
         SFXAmbience* ambience = mStack[ reverbIndex ]->getAmbience();
         AssertFatal( ambience->getEnvironment(), "SFXSoundscapeManager::update - Reverb lookup return ambience without reverb!" );

         SFX->setRolloffFactor( ambience->getRolloffFactor() );
         SFX->setDopplerFactor( ambience->getDopplerFactor() );
         SFX->setReverb( ambience->getEnvironment()->getReverb() );
      }

      mCurrentReverbIndex = reverbIndex;
   }
   
   // Update the active soundscapes.
   
   for( U32 i = 0; i < mStack.size(); ++ i )
   {
      SFXSoundscape* soundscape = mStack[ i ];
      
      // If the soundscape's associated ambience has changed
         
      if( soundscape->mDirtyBits.test( SFXSoundscape::AmbienceDirty ) )
      {
         SFXAmbience* ambience = soundscape->getAmbience();
         
         // Start playing the ambient audio track if it isn't
         // already playing and if the soundscape isn't overridden
         // by an instance lower down the stack.
         
         if( !soundscape->_isOverridden() )
         {
            SFXTrack* track = ambience->getSoundTrackProfile();
            if( !soundscape->mSource || soundscape->mSource->getTrack() != track )
            {
               if( soundscape->mSource != NULL )
               {
                  soundscape->mSource->stop();
                  soundscape->mSource = NULL;
               }
               
               if( track )
                  soundscape->mSource = SFX->playOnce( track );
            }
            else if( soundscape->mSource != NULL )
            {