Packageflare.core
Classpublic class ParticleEmiter3D
InheritanceParticleEmiter3D Inheritance Pivot3D Inheritance flash.events.EventDispatcher
Implements IDrawable

The ParticleEmiter3D is used to create particle effects.



Public Properties
 PropertyDefined By
 InheritedanimationEnabled : Boolean = true
Activates or deactivates the animation.
Pivot3D
 InheritedanimationMode : int = 0
Pivot3D
  bounds : Boundings3D
Gets or sets the boudings to use for the emiter.
ParticleEmiter3D
 Inheritedchildren : Vector.<Pivot3D>
[read-only] Returns a Pivot3D-type vector with its children.
Pivot3D
 Inheritedcomponents : Vector.<IComponent>
A collection vector that contains all the components of the object.
Pivot3D
 InheritedcurrentFrame : Number
Returns or sets the frame number where the pivot is situated.
Pivot3D
  decrementPerFrame : Number = 0
A value of 0 (by default), keeps the particle emision constantly in loop.
ParticleEmiter3D
 Inheriteddirty : Boolean = true
Gets or sets when the object has changed his transform matrix by hand.
Pivot3D
  emitParticlesPerFrame : Number
How many particles fires each frame.
ParticleEmiter3D
  emitParticlesPerSecond : Number
How many particles fires each second.
ParticleEmiter3D
 Inheritedframes : Vector.<Frame3D>
Vector that contains all the animation frames.
Pivot3D
 InheritedframeSpeed : Number
Returns or sets animation speed.
Pivot3D
 Inheritedglobal : Matrix3D
Returns a matrix with the global position, rotation and scale of the object.
Pivot3D
 InheritedinvGlobal : Matrix3D
[read-only] Returns a matrix with the inverse global position, rotation and scale of the object.
Pivot3D
 InheritedinView : Boolean
[read-only]
Pivot3D
 InheritedisPlaying : Boolean
[read-only] Returns true if an animation is being played.
Pivot3D
 Inheritedlabels : Array
Returns or sets a vector that contains the Labels3D objects used to play and manage animations.
Pivot3D
 Inheritedlayer : int = 0
Gets or sets the layer to render the object.
Pivot3D
  material : Material3D
Sets or gets the materisl to be used to render the particles.
ParticleEmiter3D
 Inheritedname : String
Sets or returns the object name.
Pivot3D
 Inheritedparent : Pivot3D
Returns or sets the object’s parent.
Pivot3D
  particle : Particle3D
Set the particle to use as a template for all emited particles.
ParticleEmiter3D
  particlesLife : Number = 100
Particles life in frames.
ParticleEmiter3D
 Inheritedpriority : int = 0
This value is for internal use to calculate the priority acording the distance from the camera during the render.
Pivot3D
 InheritedscaleX : Number
Increases or decreases the object scale on the X axis from its current scale.
Pivot3D
 InheritedscaleY : Number
Increases or decreases the object scale on the Y axis from its current scale.
Pivot3D
 InheritedscaleZ : Number
Increases or decreases the object scale on the Z axis from its current scale.
Pivot3D
 Inheritedscene : Scene3D
[read-only] Gets a reference to the scene that contains the object.
Pivot3D
 InheritedsortMode : int
Gets ot sets the sorting mode for the object.
Pivot3D
  surface : Surface3D
[read-only] Gets the surface associated to the emiter.
ParticleEmiter3D
 Inheritedupdatable : Boolean
Pivot3D
  useGlobalSpace : Boolean
If true, all particles will be updated in global space, otherwise, will be linked to the emiter object.
ParticleEmiter3D
 InheriteduserData : Object
Sets or returns an object for free use by the user.
Pivot3D
 Inheritedvisible : Boolean
Sets or returns whether the object is visible.
Pivot3D
 Inheritedworld : Matrix3D
Sets or returns the matrix of local position, rotation and scale.
Pivot3D
 Inheritedx : Number
Returns or sets the position on the X axis.
Pivot3D
 Inheritedy : Number
Returns or sets the position on the Y axis.
Pivot3D
 Inheritedz : Number
Returns or sets the position on the Z axis.
Pivot3D
Public Methods
 MethodDefined By
  
ParticleEmiter3D(name:String, material:Material3D = null, particle:Particle3D = null)
Creates a new ParticleEmiter3D object.
ParticleEmiter3D
 Inherited
addChild(pivot:Pivot3D, useGlobalSpace:Boolean = false):Pivot3D
Add a new object as a child.
Pivot3D
 Inherited
addComponent(component:IComponent):Boolean
Adds a new component to the object.
Pivot3D
 Inherited
addLabel(label:Label3D, includeChildren:Boolean = true):Label3D
Adds a label that refers to a given animation.
Pivot3D
 Inherited
Creates a copy of the object and all its elements.
Pivot3D
 Inherited
copyTransformFrom(source:Pivot3D, local:Boolean = true):void
Copies all transformations (position, rotation and scale) from another Pivot3D object.
Pivot3D
  
dispose():void
[override]
ParticleEmiter3D
 Inherited
download():void
Pivot3D
 Inherited
draw(includeChildren:Boolean = true):void
Draws the object.
Pivot3D
 Inherited
forEach(callback:Function, filterClass:Class = null, params:Object = null, includeChildren:Boolean = true):void
Excecutes a calback functions for each of his children.
Pivot3D
 Inherited
getBackward(local:Boolean = true, out:Vector3D = null):Vector3D
Returns the direction vector that points to the back of the object.
Pivot3D
 Inherited
getChildByName(name:String, startIndex:int = 0, includeChildren:Boolean = true):Pivot3D
Returns the first child that matches the specified name.
Pivot3D
 Inherited
getDir(local:Boolean = true, out:Vector3D = null):Vector3D
Returns the direction vector that points to the front of the object.
Pivot3D
 Inherited
getDown(local:Boolean = true, out:Vector3D = null):Vector3D
Returns the direction vector that points to the bottom side of the object.
Pivot3D
 Inherited
getLeft(local:Boolean = true, out:Vector3D = null):Vector3D
Returns the direction vector that points to the left side of the object.
Pivot3D
 Inherited
getMaterialByName(name:String, includeChildren:Boolean = true):Material3D
Returns the first material that matches the specified name.
Pivot3D
 Inherited
getPosition(local:Boolean = true, out:Vector3D = null):Vector3D
Returns the current position of the object.
Pivot3D
 Inherited
getRight(local:Boolean = true, out:Vector3D = null):Vector3D
Returns the direction vector that points to the right side of the object.
Pivot3D
 Inherited
getRotation(local:Boolean = true, out:Vector3D = null):Vector3D
Returns the current rotation of the object in euler angles.
Pivot3D
 Inherited
getScale(local:Boolean = true, out:Vector3D = null):Vector3D
Returns the current scale of the object.
Pivot3D
 Inherited
getScreenCoords(out:Vector3D = null, camera:Camera3D = null, viewPort:Rectangle = null):Vector3D
Returns the coordinates of an object with respect to the screen.
Pivot3D
 Inherited
getUp(local:Boolean = true, out:Vector3D = null):Vector3D
Returns the direction vector that points to the upper side of the object.
Pivot3D
 Inherited
globalToLocal(point:Vector3D, out:Vector3D = null):Vector3D
Transforms a point of the global space of the object into a local space.
Pivot3D
 Inherited
globalToLocalVector(vector:Vector3D, out:Vector3D = null):Vector3D
Transforms a point of the global space of the object into a local space without translation.
Pivot3D
 Inherited
gotoAndPlay(frame:Object, blendFrames:Number = 0, animationMode:int):void
Pivot3D
 Inherited
gotoAndStop(frame:Object, blendFrames:Number = 0):void
Stops the animation at the specified frame.
Pivot3D
 Inherited
hide():void
Sets whether the object is visible.
Pivot3D
 Inherited
localToGlobal(point:Vector3D, out:Vector3D = null):Vector3D
Transforms a point of the local space into the global space.
Pivot3D
 Inherited
localToGlobalVector(vector:Vector3D, out:Vector3D = null):Vector3D
Transforms a point of the local space of the object into a global space without translation.
Pivot3D
 Inherited
lookAt(x:Number, y:Number, z:Number, up:Vector3D = null, smooth:Number = 1):void
Directs the object towards the specified position.
Pivot3D
 Inherited
nextFrame():void
Pivot3D
 Inherited
play(animationMode:int = 0):void
Pivot3D
 Inherited
prevFrame():void
Pivot3D
 Inherited
Removes a child of the object.
Pivot3D
 Inherited
removeComponent(component:IComponent):Boolean
Removes a component from the object.
Pivot3D
 Inherited
removeLabel(label:Label3D, includeChildren:Boolean = true):Label3D
Removes a label.
Pivot3D
 Inherited
replaceMaterial(source:Material3D, replaceFor:Material3D, includeChildren:Boolean = true):void
Replaces an existing material of the object with another material.
Pivot3D
 Inherited
Resets the object position, rotation and scale.
Pivot3D
 Inherited
rotateAxis(angle:Number, axis:Vector3D, pivotPoint:Vector3D = null):void
Rotates the object on the specified axis from its current position.
Pivot3D
 Inherited
rotateX(angle:Number, local:Boolean = true, pivotPoint:Vector3D = null):void
Rotates the object on the X axis from its current position.
Pivot3D
 Inherited
rotateY(angle:Number, local:Boolean = true, pivotPoint:Vector3D = null):void
Rotates the object on the Y axis from its current position.
Pivot3D
 Inherited
rotateZ(angle:Number, local:Boolean = true, pivotPoint:Vector3D = null):void
Rotates the pivot on the Z axis from its current position.
Pivot3D
 Inherited
setLayer(value:int, includeChildren:Boolean = true):void
Sets the layer to render the object and all of his children.
Pivot3D
 Inherited
setMaterial(material:Material3D, includeChildren:Boolean = true):void
Sets a material for the object and, optionally, all its descendants.
Pivot3D
 Inherited
setNormalOrientation(normal:Vector3D, smooth:Number = 1):void
Aligns the object to a normal.
Pivot3D
 Inherited
setOrientation(dir:Vector3D, up:Vector3D = null, smooth:Number = 1):void
Orients the object in a specific direction.
Pivot3D
 Inherited
setPosition(x:Number, y:Number, z:Number, smooth:Number = 1, local:Boolean = true):void
Sets the position of the object.
Pivot3D
 Inherited
setRotation(x:Number, y:Number, z:Number):void
Sets the object rotation using euler angles.
Pivot3D
 Inherited
setScale(x:Number, y:Number, z:Number, smooth:Number = 1):void
Sets the object scale.
Pivot3D
 Inherited
setTranslation(x:Number = 0, y:Number = 0, z:Number = 0, local:Boolean = true):void
Translates the object from its current position to the specified distance.
Pivot3D
 Inherited
show():void
Sets whether the object is visible.
Pivot3D
 Inherited
startDrag(lockCenter:Boolean = false, reference:Vector3D = null):void
Lets the user drag the specified Pivot3D.
Pivot3D
 Inherited
stop():void
Pivot3D
 Inherited
stopDrag():void
Ends the startDrag() method.
Pivot3D
 Inherited
translateAxis(distance:Number, axis:Vector3D):void
Translates the object on a certain axis from its current position.
Pivot3D
 Inherited
translateX(distance:Number, local:Boolean = true):void
Translates the object on the X axis from its current position.
Pivot3D
 Inherited
translateY(distance:Number, local:Boolean = true):void
Translates the object on the Y axis from its current position.
Pivot3D
 Inherited
translateZ(distance:Number, local:Boolean = true):void
Translates the object on the Z axis from its current position.
Pivot3D
 Inherited
update():void
Pivot3D
 Inherited
updateTransforms(includeChildren:Boolean = false):void
This method is used to force the system to update the object in those cases where its matrices have been modified manually.
Pivot3D
 Inherited
upload(scene:Scene3D = null, force:Boolean = false, includeChildren:Boolean = true):Boolean
Pivot3D
Events
 Event Summary Defined By
 InheritedThis event occurs when the object is added to a scene or to any other object.Pivot3D
 InheritedThis event occurs when the object is added to a scene.Pivot3D
 InheritedThis event occurs at the end of an animation.Pivot3D
 InheritedThis event occurs whatever the object changes his position, rotation or scale.Pivot3D
 InheritedThis event occurs before drag the object.Pivot3D
 InheritedThis event occurs before draw the object.Pivot3D
 InheritedThis event occurs before entering any frame.Pivot3D
 InheritedThis event occurs after drag the object.Pivot3D
 InheritedThis event occurs after draw the object.Pivot3D
 InheritedThis event occurs after updating every frame.Pivot3D
 InheritedThis event occurs when the object is removed from a scene or from any other object.Pivot3D
 InheritedThis event occurs when the object is removed from a scene.Pivot3D
 InheritedThis event occurs when the dispose method of the object itself or of a parent object is called.Pivot3D
Public Constants
 ConstantDefined By
 InheritedADDED_EVENT : String = added
[static] Defines the value for the 'added' event.
Pivot3D
 InheritedADDED_TO_SCENE_EVENT : String = addedToScene
[static] Defines the value for the 'addedToScene' event.
Pivot3D
 InheritedANIMATION_COMPLETE_EVENT : String = animationComplete
[static] Defines the value for the 'animationComplete' event.
Pivot3D
 InheritedANIMATION_LOOP_MODE : int = 0
[static]
Pivot3D
 InheritedANIMATION_PING_PONG_MODE : int = 1
[static]
Pivot3D
 InheritedANIMATION_STOP_MODE : int = 2
[static]
Pivot3D
 InheritedENTER_DRAW_EVENT : String = enterDraw
[static] Defines the value for the 'enterDraw' event.
Pivot3D
 InheritedENTER_FRAME_EVENT : String = enterFrame
[static] Defines the value for the 'enterFrame' event.
Pivot3D
 InheritedEXIT_DRAW_EVENT : String = exitDraw
[static] Defines the value for the 'exitDraw' event.
Pivot3D
 InheritedEXIT_FRAME_EVENT : String = exitFrame
[static] Defines the value for the 'exitFrame' event.
Pivot3D
 InheritedREMOVED_EVENT : String = removed
[static] Defines the value for the 'removed' event.
Pivot3D
 InheritedREMOVED_FROM_SCENE_EVENT : String = removedFromScene
[static] Defines the value for the 'removedFromScene' event.
Pivot3D
 InheritedSORT_CENTER : int = 1
[static]
Pivot3D
 InheritedSORT_FAR : int = 4
[static]
Pivot3D
 InheritedSORT_NEAR : int = 2
[static]
Pivot3D
 InheritedSORT_NONE : int = 0
[static]
Pivot3D
 InheritedUNLOAD_EVENT : String = unload
[static] Defines the value for the 'unload' event.
Pivot3D
 InheritedUPDATE_TRANSFORM_EVENT : String = updateTransform
[static] Defines the value for the 'updateTransform' event.
Pivot3D
Property Detail
boundsproperty
bounds:Boundings3D

Gets or sets the boudings to use for the emiter.


Implementation
    public function get bounds():Boundings3D
    public function set bounds(value:Boundings3D):void
decrementPerFrameproperty 
public var decrementPerFrame:Number = 0

A value of 0 (by default), keeps the particle emision constantly in loop. A value from 1 to n, will decrement each frame the amount of particles to fire by this value. If we set a emitParticlesPerFrame to a value of 10, and decrementPerFrame to 2, the first frame will fire 10, the second 8, the third 6, etc...until emitParticlesPerFrame is equal to 0. If the value is -1, the emitParticlesPerFrame property will be seted to 0 after fire the particles and no particles will be fired after a new emitParticlesPerFrame value is defined.

See also

emitParticlesPerFrameproperty 
emitParticlesPerFrame:Number

How many particles fires each frame. When this property is changed, the emitParticlesPerSecond is also updated.


Implementation
    public function get emitParticlesPerFrame():Number
    public function set emitParticlesPerFrame(value:Number):void

See also

emitParticlesPerSecondproperty 
emitParticlesPerSecond:Number

How many particles fires each second. When this property is changed, the emitParticlesPerFrame is also updated.


Implementation
    public function get emitParticlesPerSecond():Number
    public function set emitParticlesPerSecond(value:Number):void

See also

materialproperty 
material:Material3D

Sets or gets the materisl to be used to render the particles. The material should be a compatible material for particle emiters.


Implementation
    public function get material():Material3D
    public function set material(value:Material3D):void
particleproperty 
particle:Particle3D

Set the particle to use as a template for all emited particles.


Implementation
    public function get particle():Particle3D
    public function set particle(value:Particle3D):void
particlesLifeproperty 
public var particlesLife:Number = 100

Particles life in frames.

surfaceproperty 
surface:Surface3D  [read-only]

Gets the surface associated to the emiter.


Implementation
    public function get surface():Surface3D
useGlobalSpaceproperty 
useGlobalSpace:Boolean

If true, all particles will be updated in global space, otherwise, will be linked to the emiter object.


Implementation
    public function get useGlobalSpace():Boolean
    public function set useGlobalSpace(value:Boolean):void
Constructor Detail
ParticleEmiter3D()Constructor
public function ParticleEmiter3D(name:String, material:Material3D = null, particle:Particle3D = null)

Creates a new ParticleEmiter3D object.

Parameters
name:String — The name of the particle emiter.
 
material:Material3D (default = null) — The texture to use for the particles.
 
particle:Particle3D (default = null) — The particle to use as a template for all emited particles.
Method Detail
dispose()method
override public function dispose():void