Method play

Engine/source/sfx/sfxVoice.cpp:178–221

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

void SFXVoice::play( bool looping )
{
   AssertFatal( mBuffer != NULL, "SFXVoice::play() - no buffer" );
   using namespace SFXInternal;

   // For streaming, check whether we have played previously.
   // If so, reset the buffer's stream.

   if( mBuffer->isStreaming() &&
       mStatus == SFXStatusStopped )
      _resetStream( 0 );

   // Now switch state.

   while( mStatus != SFXStatusPlaying &&
          mStatus != SFXStatusBlocked )
   {
      if( !mBuffer->isReady() &&
          ( dCompareAndSwap( ( U32& ) mStatus, SFXStatusNull, SFXStatusBlocked ) ||
            dCompareAndSwap( ( U32& ) mStatus, SFXStatusStopped, SFXStatusBlocked ) ||
            dCompareAndSwap( ( U32& ) mStatus, SFXStatusPaused, SFXStatusBlocked ) ) )
      {
         #ifdef DEBUG_SPEW
         Platform::outputDebugString( "[SFXVoice] Wanted to start playback but buffer isn't ready" );
         #endif

         break;
      }

      else if( dCompareAndSwap( ( U32& ) mStatus, SFXStatusNull, SFXStatusTransition ) ||
               dCompareAndSwap( ( U32& ) mStatus, SFXStatusStopped, SFXStatusTransition ) ||
               dCompareAndSwap( ( U32& ) mStatus, SFXStatusPaused, SFXStatusTransition ) )
      {
         _play();
         dCompareAndSwap( ( U32& ) mStatus, SFXStatusTransition, SFXStatusPlaying );

         #ifdef DEBUG_SPEW
         Platform::outputDebugString( "[SFXVoice] Started playback" );
         #endif

         break;
      }
   }
}

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