org.flintparticles.threeD.emitters.Emitter3D

Package	org.flintparticles.threeD.emitters
Class	public class Emitter3D
Inheritance	Emitter3D Emitter flash.events.EventDispatcher
Subclasses	Emitter3D

The Emitter3D class defines an emitter that exists in 3D space. It is the main emitter for using Flint in a 3D coordinate system.

This emitter is not constrained to any particular 3D rendering environment. The emitter manages the creation and updating of each particle's state but does not do any rendering of the particles. The rendering is handled by a renderer. Renderer's could be created for drawing an emitter's particles on any 3D drawing environment.

This emitter adds 3D specific features to the base emitter class.

Public Properties

Hide Inherited Public Properties

Show Inherited Public Properties

	Property		Defined By
		actions : Vector.<Action> The array of all actions being used by this emitter.	Emitter
		activities : Vector.<Activity> The array of all actions being used by this emitter.	Emitter
		counter : Counter The Counter for the Emitter.	Emitter
		defaultParticleFactory : ParticleFactory [static] [read-only] The default particle factory used to manage the creation, reuse and destruction of particles.	Emitter3D
		fixedFrameTime : Number Indicates a fixed time (in seconds) to use for every frame.	Emitter
		initializers : Vector.<Initializer> The array of all initializers being used by this emitter.	Emitter
		maximumFrameTime : Number The maximum duration for a single update frame, in seconds.	Emitter
		particleFactory : ParticleFactory This is the particle factory used by the emitter to create and dispose of particles.	Emitter
		particles : Vector.<Particle> The collection of all particles being managed by this emitter.	Emitter
		particlesArray : Array [read-only] The actual array of particles used internally by this emitter.	Emitter
		position : Vector3D Indicates the position of the Emitter instance relative to the local coordinate system of the Renderer.	Emitter3D
		rotation : Quaternion Indicates the rotation of the Emitter instance relative to the local coordinate system of the Renderer.	Emitter3D
		rotationTransform : Matrix3D [read-only] Indicates the rotation of the Emitter instance relative to the local coordinate system of the Renderer, as a matrix transformation.	Emitter3D
		running : Boolean [read-only] Indicates if the emitter is currently running.	Emitter
		spaceSort : Boolean = false Identifies whether the particles should be arranged into a spacially sorted array - this speeds up proximity testing for those actions that need it.	Emitter3D
		useInternalTick : Boolean Indicates whether the emitter should manage its own internal update tick.	Emitter

	Property	Defined By
		_dispatchCounterComplete : Boolean = false Indicates if the emitter should dispatch a counterComplete event at the end of the next update cycle.	Emitter

Public Methods

Hide Inherited Public Methods

Show Inherited Public Methods

	Method		Defined By
		Emitter3D() The constructor creates an emitter 3D.	Emitter3D
		addAction(action:Action):void Adds an Action to the Emitter.	Emitter
		addActivity(activity:Activity):void Adds an Activity to the Emitter.	Emitter
		addInitializer(initializer:Initializer):void Adds an Initializer object to the Emitter.	Emitter
		addParticle(particle:Particle, applyInitializers:Boolean = false):void Add a particle to the emitter.	Emitter
		addParticles(particles:Vector.<Particle>, applyInitializers:Boolean = false):void Adds existing particles to the emitter.	Emitter
		dispatchCounterComplete():void Used by counters to tell the emitter to dispatch a counter complete event.	Emitter
		hasAction(action:Action):Boolean Detects if the emitter is using a particular action or not.	Emitter
		hasActionOfType(actionClass:Class):Boolean Detects if the emitter is using an action of a particular class.	Emitter
		hasActivity(activity:Activity):Boolean Detects if the emitter is using a particular activity or not.	Emitter
		hasActivityOfType(activityClass:Class):Boolean Detects if the emitter is using an activity of a particular class.	Emitter
		hasInitializer(initializer:Initializer):Boolean Detects if the emitter is using a particular initializer or not.	Emitter
		hasInitializerOfType(initializerClass:Class):Boolean Detects if the emitter is using an initializer of a particular class.	Emitter
		killAllParticles():void Kill all the particles on this emitter.	Emitter
		pause():void Pauses the emitter.	Emitter
		removeAction(action:Action):void Removes an Action from the Emitter.	Emitter
		removeActivity(activity:Activity):void Removes an Activity from the Emitter.	Emitter
		removeInitializer(initializer:Initializer):void Removes an Initializer from the Emitter.	Emitter
		removeParticle(particle:Particle):Boolean Remove a particle from this emitter.	Emitter
		removeParticles(particles:Vector.<Particle>):void Remove a collection of particles from this emitter.	Emitter
		resume():void Resumes the emitter after a pause.	Emitter
		runAhead(time:Number, frameRate:Number = 10):void Makes the emitter skip forwards a period of time with a single update.	Emitter
		start():void Starts the emitter.	Emitter
		stop():void Stops the emitter, killing all current particles and returning them to the particle factory for reuse.	Emitter
		update(time:Number):void Used to update the emitter.	Emitter

	Method	Defined By
		createParticle():Particle	Emitter
		initParticle(particle:Particle):void [override]	Emitter3D
		sortParticles():void [override] If the spaceSort property is true, this method creates the spaceSortedX array.	Emitter3D

Summary	Defined By
counterComplete	Dispatched when the counter for the particle system has finished its cycle and so the system will not emit any more particles unless the counter is changed or restarted.	Emitter
emitterEmpty	Dispatched when an emitter attempts to update the particles' state but it contains no particles.	Emitter
emitterUpdated	Dispatched when the particle system has updated and the state of the particles has changed.	Emitter
particleAdded	Dispatched when a pre-existing particle is added to the emitter.	Emitter
particleCreated	Dispatched when a particle is created and has just been added to the emitter.	Emitter
particleDead	Dispatched when a particle dies and is about to be removed from the system.	Emitter

Property Detail

defaultParticleFactory

property

defaultParticleFactory:ParticleFactory [read-only]

The default particle factory used to manage the creation, reuse and destruction of particles.

Implementation
public static function get defaultParticleFactory():ParticleFactory

position

property

position:Vector3D

Indicates the position of the Emitter instance relative to the local coordinate system of the Renderer.

Implementation
public function get position():Vector3D
public function set position(value:Vector3D):void

rotation

property

rotation:Quaternion

Indicates the rotation of the Emitter instance relative to the local coordinate system of the Renderer.

Implementation
public function get rotation():Quaternion
public function set rotation(value:Quaternion):void

rotationTransform

property

rotationTransform:Matrix3D [read-only]

Indicates the rotation of the Emitter instance relative to the local coordinate system of the Renderer, as a matrix transformation.

Implementation
public function get rotationTransform():Matrix3D

spaceSort

property

public var spaceSort:Boolean = false

Identifies whether the particles should be arranged into a spacially sorted array - this speeds up proximity testing for those actions that need it.

Constructor Detail

Emitter3D

()

Constructor

public function Emitter3D()

The constructor creates an emitter 3D.

Method Detail

initParticle

()

method

override protected function initParticle(particle:Particle):void

Parameters

particle:Particle

sortParticles

()

method

override protected function sortParticles():void

If the spaceSort property is true, this method creates the spaceSortedX array.

Sun Feb 27 2011, 06:00 PM Z

Flint Particles documentation v3.0.1	All Packages \| All Classes \| Index \| Frames No Frames
Emitter3D	Properties \| Methods \| Events