Method onAdd

Engine/source/sfx/sfxSource.cpp:335–394

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

bool SFXSource::onAdd()
{
   if( !Parent::onAdd() )
      return false;
      
   // Make sure we have a description.
                  
   if( !mDescription )
   {
      Con::errorf( "SFXSource::onAdd() - no description set on source %i (%s)", getId(), getName() );
      return false;
   }
         
   // Set our initial properties.
        
   _setVolume( mDescription->mVolume ); 
   _setPitch( mDescription->mPitch );
   _setPriority( mDescription->mPriority );
   _setFadeTimes( mDescription->mFadeInTime, mDescription->mFadeOutTime );

   _setMinMaxDistance( mDescription->mMinDistance, mDescription->mMaxDistance );
   _setCone( F32( mDescription->mConeInsideAngle ),
             F32( mDescription->mConeOutsideAngle ),
             mDescription->mConeOutsideVolume );

   // Add the parameters from the description.
   
   for( U32 i = 0; i < SFXDescription::MaxNumParameters; ++ i )
   {
      StringTableEntry name = mDescription->mParameters[ i ];
      if( name && name[ 0 ] )
         _addParameter( name );
   }

   // Add the parameters from the track.
   
   if( mTrack != NULL )
      for( U32 i = 0; i < SFXTrack::MaxNumParameters; ++ i )
      {
         StringTableEntry name = mTrack->getParameter( i );
         if( name && name[ 0 ] )
            _addParameter( name );
      }

   // Add us to the description's source group.
   
   if( mDescription->mSourceGroup )
      mDescription->mSourceGroup->addObject( this );

   // Add to source set.

   if( Sim::getSFXSourceSet() )
      Sim::getSFXSourceSet()->addObject( this );
      
   // Register with SFX system.
      
   SFX->_onAddSource( this );