Engine.EmitterPool

Extends

Actor

Modifiers

native config ( Game )

this class manages a pool of ParticleSystemComponents it is meant to be used for single shot effects spawned during gameplay to reduce object overhead that would otherwise be caused by spawning dozens of Emitters Copyright 1998-2008 Epic Games, Inc. All Rights Reserved.

Core.Object
|   
+-- Engine.Actor
   |   
   +-- Engine.EmitterPool

Direct Known Subclasses:

UTEmitterPool

Functions Summary
		FreeMaterialInstanceConstants (StaticMeshComponent SMC)
		FreeStaticMeshComponents (ParticleSystemComponent PSC)
	MaterialInstanceConstant	GetFreeMatInstConsts (bool bCreateNewObject = true)
	StaticMeshComponent	GetFreeStaticMeshComponent (bool bCreateNewObject = true)
	ParticleSystemComponent	GetPooledComponent (ParticleSystem EmitterTemplate)
		OnParticleSystemFinished (ParticleSystemComponent PSC))
		ReturnToPool (ParticleSystemComponent PSC)
	ParticleSystemComponent	SpawnEmitter (ParticleSystem EmitterTemplate, vector SpawnLocation, optional rotator SpawnRotation, optional Actor AttachToActor))
	ParticleSystemComponent	SpawnEmitterCustomLifetime (ParticleSystem EmitterTemplate))

ActiveComponents Source code

components currently active

bLogPoolOverflow Source code

option to log out the names of all active effects when the pool overflows

bLogPoolOverflowList Source code

FreeMatInstConsts Source code

The free MaterialInstanceConstants used by emitters in this pool

FreeSMComponents Source code

The free StaticMeshComponents used by emitters in this pool

IdealMaterialInstanceConstants Source code

IdealStaticMeshComponents Source code

The ideal number of StaticMeshComponents and MaterialInstanceConstants. If their counts are greater than this for more than ReductionTime, then they will be chopped down to their respective settings.

MaxActiveEffects Source code

maximum allowed active components - if this is greater than 0 and is exceeded, the oldest active effect is taken

PoolComponents Source code

components currently in the pool

PSCTemplate Source code

template to base pool components off of - should not be used for effects or attached to anything

RelativePSCs Source code

SMC_MIC_CurrentReductionTime Source code

SMC_MIC_ReductionTime Source code

The amount of time to allow the SMC and MIC arrays to be beyond their ideals.

EmitterBaseInfo Source code

list of components that should be relative to an Actor

FreeMaterialInstanceConstants Source code

internal - moves the MIConstants from given SMComponent to the pool free list

FreeStaticMeshComponents Source code

internal - moves the SMComponents from given PSC to the pool free list

GetFreeMatInstConsts Source code

internal - retrieves a MaterialInstanceConstant from the pool free list
@param bCreateNewObject If TRUE, create an MIC w/ the pool as its outer
@return MaterialInstanceConstant The MIC, NULL if none was available/created

GetFreeStaticMeshComponent Source code

internal - retrieves a SMComponent from the pool free list
@param bCreateNewObject If TRUE, create an SMC w/ the pool as its outer
@return StaticMeshComponent The SMC, NULL if none was available/created

GetPooledComponent Source code

internal - helper for spawning functions gets a component from the appropriate pool array (checks PerEmitterPools) includes creating a new one if necessary as well as taking one from the active list if the max number active has been exceeded
@return the ParticleSystemComponent to use

OnParticleSystemFinished Source code

set to each pool component's finished delegate to return it to the pool for custom lifetime PSCs, must be called manually when done with the component

ReturnToPool Source code

internal - detaches the given PSC and returns it to the pool

SpawnEmitter Source code

plays the specified effect at the given location and rotation, taking a component from the pool or creating as necessary
@note: the component is returned so the caller can perform any additional modifications (parameters, etc), but it shouldn't keep the reference around as the component will be returned to the pool as soon as the effect is complete
@param EmitterTemplate - particle system to create
@param SpawnLocation - location to place the effect in world space
@param SpawnRotation (opt) - rotation to place the effect in world space
@param AttachToActor (opt) - if specified, component will move along with this Actor
@return the ParticleSystemComponent the effect will use

SpawnEmitterCustomLifetime Source code

spawns a pooled component that has a custom lifetime (controlled by the caller) the caller is responsible for attaching/detaching the component as well as calling our OnParticleSystemFinished() function when it is done with the component the pool may take the component back early - if it does, it will trigger the component's OnSystemFinished delegate so the caller can guarantee that it will be triggered
@param EmitterTemplate - particle system to create
@return the ParticleSystemComponent to use

defaultproperties
{
   Begin Object Class=ParticleSystemComponent Name=ParticleSystemComponent0 ObjName=ParticleSystemComponent0 Archetype=ParticleSystemComponent'Engine.Default__ParticleSystemComponent'
      AbsoluteTranslation=True
      AbsoluteRotation=True
      Name="ParticleSystemComponent0"
      ObjectArchetype=ParticleSystemComponent'Engine.Default__ParticleSystemComponent'
   End Object
   PSCTemplate=ParticleSystemComponent0
   SMC_MIC_ReductionTime=2.500000
   IdealStaticMeshComponents=250
   IdealMaterialInstanceConstants=250
   TickGroup=TG_DuringAsyncWork
   CollisionType=COLLIDE_CustomDefault
   Name="Default__EmitterPool"
   ObjectArchetype=Actor'Engine.Default__Actor'
}