Method update

Engine/source/sfx/sfxBuffer.cpp:98–233

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

bool SFXBuffer::update()
{
   using namespace SFXInternal;

   if( isDead() )
   {
      // Buffer requested to finish its async operations.
      // Kill our async state and put us on the dead buffer list.

      mAsyncState->mStream->stop();
      mAsyncState = NULL;
      gDeadBufferList.pushFront( this );
      return false;
   }
   else if( isAtEnd() && isStreaming() )
   {
      // Streaming buffers remain in the update loop even if they
      // have played in full to allow for stream seeks.
      return true;
   }

   AssertFatal( mAsyncState != NULL, "SFXBuffer::update() - async state has already been released" );

   bool needFurtherUpdates = true;
   if( !isStreaming() )
   {
      // Not a streaming buffer.  If the async stream has its data
      // ready, we load it and finish up on our async work.

      SFXStreamPacket* packet;
      while( mAsyncState->mStream->read( &packet, 1 ) )
      {
         bool isLast = packet->mIsLast;

         // Write packet data into buffer.
         write( &packet, 1 );
         packet = NULL;
         
         if( isLast )
         {
            // Release async state.
            mAsyncState = NULL;

            // Once loaded, non-streaming buffers disappear from the SFX
            // update thread.
            needFurtherUpdates = false;

            // Signal that we are ready.
            _setStatus( STATUS_Ready );

            #ifdef DEBUG_SPEW
            Platform::outputDebugString( "[SFXBuffer] Buffer ready" );
            #endif

            break;
         }
      }
   }