PlayOnObject()

static int SEffectManager::PlayOnObject ( notnull Effect eff, Object obj, vector local_pos = "0 0 0", vector local_ori = "0 0 0", bool force_rotation_relative_to_world = false )

inlinestaticprotected

Play an Effect.

Предупреждения

Read PlayInWorld warning

Аргументы

eff	Effect The Effect to play
obj	Object The parent of the Effect
local_pos	vector The local position to play the Effect in relation to the parent (Optional)
local_ori	vector The local orientation to play the Effect in relation to the parent (Optional)
force_rotation_relative_to_world	bool Whether to force the orientation to stay in WS (Optional)

Возвращает

int The registered ID of the Effect

См. определение в файле EffectManager.c строка 70

    {
        // Stop the effect first, just in case
        eff.Stop();
        
        int id = EffectRegister(eff);
        
        if (!obj)
        {
            ErrorEx("Parent object is null.", ErrorExSeverity.WARNING);
            eff.SetPosition(local_pos);
        }
        else
        {
            eff.SetPosition(obj.GetPosition());
        }
            
        eff.SetParent(obj);
        eff.SetLocalPosition(local_pos);
        eff.SetAttachedLocalOri(local_ori);
        
        if (force_rotation_relative_to_world)
        {
            EffectParticle eff_particle = EffectParticle.Cast(eff);
            
            if (eff_particle)
            {
                eff_particle.ForceParticleRotationRelativeToWorld(force_rotation_relative_to_world);
            }
        }
        
        eff.Start();
        
        return id;
    }

Перекрестные ссылки Effect(), EffectRegister(), ErrorEx и EffectParticle::ForceParticleRotationRelativeToWorld().

Используется в CreateCarDestroyedEffect(), EOnPostSimulate(), ManBase::SetDecayEffects() и ItemBase::StartLoopSound().