Packageflare.core
Classpublic class Particles3D
InheritanceParticles3D Inheritance Pivot3D Inheritance flash.events.EventDispatcher
Implements IDrawable

The Particles3D class creates billboard particle effects.



Public Properties
 PropertyDefined By
  alphaRatios : Array
[read-only] Get the ratios used for the alpha channel.
Particles3D
  alphas : Array
[read-only] Gets the alpha values of the alpha channel.
Particles3D
 InheritedanimationEnabled : Boolean = true
Activates or deactivates the animation.
Pivot3D
 InheritedanimationSmoothMode : int = 2
Sets or gets the animation method used to interpolate between frames.
Pivot3D
  area : Vector3D
Gets or sets the emitter area where the particles are born.
Particles3D
  blendMode : int
Gets or sets the blend mode used for the particles.
Particles3D
  blendTexture : Texture3D
Gets or sets a blending texture to use trough the particle's life.
Particles3D
 InheritedcastShadows : Boolean = true
Gets or sets if the object should cast shadows.
Pivot3D
 Inheritedchildren : Vector.<Pivot3D>
[read-only] Returns a Pivot3D-type vector with its children.
Pivot3D
 Inheritedcollider : Collider
Pivot3D
  colorRatios : Array
[read-only] Gets the color ratios used for the gradient color channel.
Particles3D
  colors : Array
[read-only] Gets the colors used for the gradient color channel.
Particles3D
 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
 InheritedcurrentLabel : Label3D
[read-only]
Pivot3D
  delay : Number
Gets or sets a delay interval for the particles creation, expressed in seconds.
Particles3D
 Inheriteddirty : Boolean = true
Gets or sets when the object has changed his transform matrix by hand.
Pivot3D
  duration : Number = 1
Gets or sets the cycle length of the emitter.
Particles3D
  endSize : Point
Gets or sets the final size of the particle.
Particles3D
  energy : Vector3D
Gets or sets the starting velocity of the particles, working as a range value.
Particles3D
 Inheritedframes : Vector.<Frame3D>
Vector that contains all the animation frames.
Pivot3D
 InheritedframeSpeed : Number
Returns or sets animation speed.
Pivot3D
  gravity : Vector3D
Gets or sets the gravity vector of the emitter.
Particles3D
  gravityPower : Number
Gets or sets the curve intensity to use for the gravity parameter.
Particles3D
  hemisphere : Boolean
Gets or sets whatever the particles energy should dispatch in all directions or only up to the floor plane.
Particles3D
  initParticleFunction : Function
Gets or sets a custom callback function to initializate the particles.
Particles3D
  inView : Boolean
[override] [read-only]
Particles3D
 InheritedinvWorld : Matrix3D
[read-only] Returns a matrix with the inverse global position, rotation and scale of the object.
Pivot3D
  isPlaying : Boolean
[override] [read-only]
Particles3D
 InheritedisStatic : Boolean
Pivot3D
 Inheritedlabels : Object
Returns or sets an object 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
 Inheritedlock : Boolean
Sets the pivot lock mode.
Pivot3D
  loops : Number
Gets ot sets the number of cylces for the emitter.
Particles3D
  material : FLSLMaterial
[read-only]
Particles3D
 Inheritedname : String
Sets or returns the object name.
Pivot3D
  numParticles : int
Gets or sets the number of particles to be used.
Particles3D
 Inheritedparent : Pivot3D
Returns or sets the object’s parent.
Pivot3D
  paused : Boolean
[read-only]
Particles3D
 Inheritedpriority : int = 0
This value is for internal use to calculate the priority acording the distance from the camera during the render.
Pivot3D
  randomFrame : Boolean
Gets or sets whether the particles should use a random frame from the textureFrams property.
Particles3D
  randomScale : Number
Gets or sets a random scale range value for each particle.
Particles3D
  randomSeed : uint = 200
Defines a random seed to be used when generating the particles.
Particles3D
  randomSpin : Number
Gets or sets a random spin range value for each particle.
Particles3D
  randomVelocity : Number
Gets or sets a random velocity range value for each particle.
Particles3D
 InheritedreceiveShadows : Boolean = true
Gets or sets if the object should receive shadows.
Pivot3D
  reverse : Boolean
Particles3D
 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
  shots : int
Gets or sets the number of particles interval to emit trough the emitter duration.
Particles3D
  sortMode : int
[override] Gets or sets the sorting mode for the particles.
Particles3D
  spin : Number
Gets or sets a start spin value for all particles.
Particles3D
  startSize : Point
Gets or sets the start size of all particles.
Particles3D
  texture : Texture3D
Gets or sets the base particle texture to use for all particles.
Particles3D
  textureFrames : Point
Gets or sets the number of frames in x and y axis of the texture.
Particles3D
  time : Number
Gets or sets the current emitter time, expressed in seconds.
Particles3D
  tint : Vector.<Number>
[read-only]
Particles3D
 Inheritedtransform : Matrix3D
Sets or returns the matrix of local position, rotation and scale.
Pivot3D
 Inheritedupdatable : Boolean
Pivot3D
  useRandomColors : Boolean
Gets or sets whether the particles should use any random color based on the range provided in setColors method.
Particles3D
 InheriteduserData : Object
Sets or returns an object for free use by the user.
Pivot3D
  velocity : Vector3D
Gets or sets the initial velocity for all particles.
Particles3D
 Inheritedvisible : Boolean = true
Sets or returns whether the object is visible.
Pivot3D
 Inheritedworld : Matrix3D
Returns a matrix with the global position, rotation and scale of the object.
Pivot3D
  worldPositions : Boolean
Gets or sets if the particles positions should be linked to the emitter as a regular child or they're parented the world coordinates.
Particles3D
  worldVelocities : Boolean
Gets or sets if the particles velocities should be linked to the emitter as a regular child or they are parented the world coordinates.
Particles3D
 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
  
Particles3D(name:String = particles, texture:Texture3D = null)
Creates a new particles emitter.
Particles3D
 Inherited
addChild(pivot:Pivot3D, useGlobalSpace:Boolean = false):Pivot3D
Add a new object as a child.
Pivot3D
 Inherited
addChildAt(pivot:Pivot3D, index:int, useGlobalSpace:Boolean = false):Pivot3D
Pivot3D
 Inherited
addComponent(component:IComponent):Boolean
Adds a new component to the object.
Pivot3D
 Inherited
addFrameScript(frame:int, callback:Function):void
Pivot3D
 Inherited
addLabel(label:Label3D, includeChildren:Boolean = true):Label3D
Adds a label that refers to a given animation.
Pivot3D
  
build():void
Builds and initializes the particles buffers.
Particles3D
 Inherited
Creates a copy of the object and all its elements.
Pivot3D
 Inherited
copyFrom(pivot:Pivot3D):void
Copy basic pivot properties to anotheer pivot.
Pivot3D
 Inherited
copyTransformFrom(source:Pivot3D, local:Boolean = true):void
Copies all transformations (position, rotation and scale) from another Pivot3D object.
Pivot3D
 Inherited
dispose():void
Disposes the pivot and all associated resources.
Pivot3D
 Inherited
download(includeChildren:Boolean = true):void
Pivot3D
 Inherited
draw(includeChildren:Boolean = true, material:Material3D = null):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
getChildrenByClass(cl:Class, includeChildren:Boolean = true, out:Vector.<Pivot3D> = null):Vector.<Pivot3D>
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
getMaterials(includeChildren:Boolean = true, out:Vector.<Material3D> = null):Vector.<Material3D>
Returns an unique vector of pivot materials currently in use.
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
getSurfaces(includeChildren:Boolean = true, out:Vector.<Surface3D> = null):Vector.<Surface3D>
Returns an unique vector of surface objects used by the pivots.
Pivot3D
 Inherited
getTextures(includeChildren:Boolean = true, out:Vector.<Texture3D> = null):Vector.<Texture3D>
Returns an unique vector of textures objects used by the pivot materials.
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, includeChildren:Boolean = true):void
Starts playing the animation at the specified frame
Pivot3D
 Inherited
gotoAndStop(frame:Object, blendFrames:Number = 0, includeChildren:Boolean = true):void
Stops the animation at the specified frame.
Pivot3D
 Inherited
hide():void
Sets the visible property of this object and all its children recursively to false.
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
  
pause():void
Pauses the emission of particles.
Particles3D
 Inherited
play(animationMode:int = 0, includeChildren:Boolean = true, resetAnimation:Boolean = true):void
Starts playing the animation.
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
replaceSurface(source:Surface3D, replaceFor:Surface3D, includeChildren:Boolean = true):void
Replaces an existing surface of the object with another surface.
Pivot3D
 Inherited
replaceTexture(source:Texture3D, replaceFor:Texture3D, includeChildren:Boolean = true):void
Replaces an existing texture of the object materials with another texture.
Pivot3D
  
reset():void
Reset particle buffers to be builded again.
Particles3D
 Inherited
Resets the object position, rotation and scale.
Pivot3D
  
resume():void
Resumes the emission of particles after being paused.
Particles3D
 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
  
setAlphas(alphas:Array, ratios:Array):void
Sets the values to use as an alpha channel for all particles to use over the time.
Particles3D
 Inherited
setAnimationLabel(label:Object, animationMode:int, includeChildren:Boolean = true):void
Sets the current animation label.
Pivot3D
 Inherited
setAnimationSmooth(mode:int, includeChildren:Boolean = true):void
Sets the animation interpolation mode for this pivot and its children.
Pivot3D
  
setColors(colors:Array, ratios:Array):void
Set the colors for the particles over the time.
Particles3D
 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
setShadowsProperties(cast:Boolean = false, receive:Boolean = false, includeChildren:Boolean = true):void
Sets whether the object should cast and receive shadows.
Pivot3D
 Inherited
setStatic(value:Boolean, includeChildren:Boolean = true):void
Pivot3D
  
setTint(r:Number, g:Number, b:Number, a:Number = 1):void
Particles3D
 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 the visible property of this object and all its children recursively to true.
Pivot3D
  
start():void
Starts the emission of particles.
Particles3D
 Inherited
startDrag(lockCenter:Boolean = false, refPlaneNormal:Vector3D = null):void
Lets the user drag the specified Pivot3D.
Pivot3D
 Inherited
stop(includeChildren:Boolean = true):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, includeChildren:Boolean = true):void
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_SMOOTH_BEST : int = 2
[static]
Pivot3D
 InheritedANIMATION_SMOOTH_NONE : int = 0
[static]
Pivot3D
 InheritedANIMATION_SMOOTH_NORMAL : int = 1
[static]
Pivot3D
 InheritedANIMATION_STOP_MODE : int = 2
[static]
Pivot3D
  BLEND_ADDITIVE : int = 1
[static]
Particles3D
  BLEND_ALPHA_BLENDED : int = 2
[static]
Particles3D
  BLEND_ALPHA_BLENDED2 : int = 5
[static]
Particles3D
  BLEND_MULTIPLY : int = 3
[static]
Particles3D
  BLEND_NONE : int = 0
[static]
Particles3D
  BLEND_SCREEN : int = 4
[static]
Particles3D
 InheritedENTER_DRAG_EVENT : String = enterDrag
[static] Defines the value for the 'enterDrag' event.
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_DRAG_EVENT : String = exitDrag
[static] Defines the value for the 'exitDrag' 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
  SORT_NONE : int = 0
[static]
Particles3D
  SORT_OLDEST_FIRST : int = 2
[static]
Particles3D
  SORT_YOUNGEST_FIRST : int = 1
[static]
Particles3D
 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
alphaRatiosproperty
alphaRatios:Array  [read-only]

Get the ratios used for the alpha channel.


Implementation
    public function get alphaRatios():Array

See also

alphasproperty 
alphas:Array  [read-only]

Gets the alpha values of the alpha channel.


Implementation
    public function get alphas():Array

See also

areaproperty 
area:Vector3D

Gets or sets the emitter area where the particles are born. Big values might be needed for the effect to be noticeable.


Implementation
    public function get area():Vector3D
    public function set area(value:Vector3D):void
blendModeproperty 
blendMode:int

Gets or sets the blend mode used for the particles. Should be one of the blending constants defined in Particle3D class.


Implementation
    public function get blendMode():int
    public function set blendMode(value:int):void

See also

blendTextureproperty 
blendTexture:Texture3D

Gets or sets a blending texture to use trough the particle's life.


Implementation
    public function get blendTexture():Texture3D
    public function set blendTexture(value:Texture3D):void
colorRatiosproperty 
colorRatios:Array  [read-only]

Gets the color ratios used for the gradient color channel.


Implementation
    public function get colorRatios():Array

See also

colorsproperty 
colors:Array  [read-only]

Gets the colors used for the gradient color channel.


Implementation
    public function get colors():Array

See also

delayproperty 
delay:Number

Gets or sets a delay interval for the particles creation, expressed in seconds.


Implementation
    public function get delay():Number
    public function set delay(value:Number):void
durationproperty 
public var duration:Number = 1

Gets or sets the cycle length of the emitter. In seconds.

endSizeproperty 
endSize:Point

Gets or sets the final size of the particle.


Implementation
    public function get endSize():Point
    public function set endSize(value:Point):void
energyproperty 
energy:Vector3D

Gets or sets the starting velocity of the particles, working as a range value. For example a value of 100, 0, 0 means that particles will be dispatched in a range of -100 to 100 in x-axis.


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

See also

gravityproperty 
gravity:Vector3D

Gets or sets the gravity vector of the emitter.


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

See also

gravityPowerproperty 
gravityPower:Number

Gets or sets the curve intensity to use for the gravity parameter.


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

See also

hemisphereproperty 
hemisphere:Boolean

Gets or sets whatever the particles energy should dispatch in all directions or only up to the floor plane.


Implementation
    public function get hemisphere():Boolean
    public function set hemisphere(value:Boolean):void

See also

initParticleFunctionproperty 
public var initParticleFunction:Function

Gets or sets a custom callback function to initializate the particles. The function should receive the emitter, the particle index and the init properties objects. For example: myCustomParticles( emitter:Particles3D, index:int, init:ParticleInit3D ):void Inside the function, you can change the init particle properties such as position, velocity, etc.

inViewproperty 
inView:Boolean  [read-only] [override]


Implementation
    public function get inView():Boolean
isPlayingproperty 
isPlaying:Boolean  [read-only] [override]


Implementation
    public function get isPlaying():Boolean
loopsproperty 
loops:Number

Gets ot sets the number of cylces for the emitter.


Implementation
    public function get loops():Number
    public function set loops(value:Number):void
materialproperty 
material:FLSLMaterial  [read-only]


Implementation
    public function get material():FLSLMaterial
numParticlesproperty 
numParticles:int

Gets or sets the number of particles to be used.


Implementation
    public function get numParticles():int
    public function set numParticles(value:int):void
pausedproperty 
paused:Boolean  [read-only]


Implementation
    public function get paused():Boolean
randomFrameproperty 
randomFrame:Boolean

Gets or sets whether the particles should use a random frame from the textureFrams property.


Implementation
    public function get randomFrame():Boolean
    public function set randomFrame(value:Boolean):void

See also

randomScaleproperty 
randomScale:Number

Gets or sets a random scale range value for each particle.


Implementation
    public function get randomScale():Number
    public function set randomScale(value:Number):void
randomSeedproperty 
public var randomSeed:uint = 200

Defines a random seed to be used when generating the particles.

randomSpinproperty 
randomSpin:Number

Gets or sets a random spin range value for each particle.


Implementation
    public function get randomSpin():Number
    public function set randomSpin(value:Number):void
randomVelocityproperty 
randomVelocity:Number

Gets or sets a random velocity range value for each particle.


Implementation
    public function get randomVelocity():Number
    public function set randomVelocity(value:Number):void
reverseproperty 
reverse:Boolean


Implementation
    public function get reverse():Boolean
    public function set reverse(value:Boolean):void
shotsproperty 
shots:int

Gets or sets the number of particles interval to emit trough the emitter duration. A value of zero means that particles are dispatched continuously.


Implementation
    public function get shots():int
    public function set shots(value:int):void
sortModeproperty 
sortMode:int[override]

Gets or sets the sorting mode for the particles. Should be one of the constants defined in Particles3D.


Implementation
    public function get sortMode():int
    public function set sortMode(value:int):void

See also

spinproperty 
spin:Number

Gets or sets a start spin value for all particles.


Implementation
    public function get spin():Number
    public function set spin(value:Number):void
startSizeproperty 
startSize:Point

Gets or sets the start size of all particles.


Implementation
    public function get startSize():Point
    public function set startSize(value:Point):void
textureproperty 
texture:Texture3D

Gets or sets the base particle texture to use for all particles.


Implementation
    public function get texture():Texture3D
    public function set texture(value:Texture3D):void
textureFramesproperty 
textureFrames:Point

Gets or sets the number of frames in x and y axis of the texture.


Implementation
    public function get textureFrames():Point
    public function set textureFrames(value:Point):void

See also

timeproperty 
time:Number

Gets or sets the current emitter time, expressed in seconds.


Implementation
    public function get time():Number
    public function set time(value:Number):void
tintproperty 
tint:Vector.<Number>  [read-only]


Implementation
    public function get tint():Vector.<Number>
useRandomColorsproperty 
useRandomColors:Boolean

Gets or sets whether the particles should use any random color based on the range provided in setColors method.


Implementation
    public function get useRandomColors():Boolean
    public function set useRandomColors(value:Boolean):void

See also

velocityproperty 
velocity:Vector3D

Gets or sets the initial velocity for all particles.


Implementation
    public function get velocity():Vector3D
    public function set velocity(value:Vector3D):void
worldPositionsproperty 
worldPositions:Boolean

Gets or sets if the particles positions should be linked to the emitter as a regular child or they're parented the world coordinates.


Implementation
    public function get worldPositions():Boolean
    public function set worldPositions(value:Boolean):void
worldVelocitiesproperty 
worldVelocities:Boolean

Gets or sets if the particles velocities should be linked to the emitter as a regular child or they are parented the world coordinates.


Implementation
    public function get worldVelocities():Boolean
    public function set worldVelocities(value:Boolean):void
Constructor Detail
Particles3D()Constructor
public function Particles3D(name:String = particles, texture:Texture3D = null)

Creates a new particles emitter.

Parameters
name:String (default = particles) — The name of the particles object.
 
texture:Texture3D (default = null)
Method Detail
build()method
public function build():void

Builds and initializes the particles buffers. You should not call to this method unless you explicity want to build the buffers manually.

pause()method 
public function pause():void

Pauses the emission of particles.

See also

reset()method 
public function reset():void

Reset particle buffers to be builded again. The build process is not inmediate, the engine will build the particles as soon as they need to be render. To force also the build process, call to build() method.

See also

resume()method 
public function resume():void

Resumes the emission of particles after being paused.

See also

setAlphas()method 
public function setAlphas(alphas:Array, ratios:Array):void

Sets the values to use as an alpha channel for all particles to use over the time.

Parameters

alphas:Array — alphas: An array of alpha values for the corresponding colors in the colors array; valid values go from 0 to 1. The value will be clamped between 0 and 1.
 
ratios:Array — An array of color distribution ratios; valid values go from 0 to 255. This value defines the percentage of the width where the color is sampled at 100%. The value 0 represents the initial position, and 255 represents the final position.

setColors()method 
public function setColors(colors:Array, ratios:Array):void

Set the colors for the particles over the time.

Parameters

colors:Array — An array of RGB hexadecimal color values to be used in the gradient; for example, red is 0xFF0000, blue is 0x0000FF, and so on. You can specify up to 15 colors. For each color, be sure you specify a corresponding value in the alphas and ratios parameters.
 
ratios:Array — An array of color distribution ratios; valid values are 0 to 255. This value defines the percentage of the width where the color is sampled at 100%. The value 0 represents the initial position, and 255 represents the final position.

setTint()method 
public function setTint(r:Number, g:Number, b:Number, a:Number = 1):void

Parameters

r:Number
 
g:Number
 
b:Number
 
a:Number (default = 1)

start()method 
public function start():void

Starts the emission of particles. This method reinitializes the buffers when worldPositions or worldVelocities are set to true, and may affect performance when using it with large amount of particles.

See also

Constant Detail
BLEND_ADDITIVEConstant
public static const BLEND_ADDITIVE:int = 1

BLEND_ALPHA_BLENDEDConstant 
public static const BLEND_ALPHA_BLENDED:int = 2

BLEND_ALPHA_BLENDED2Constant 
public static const BLEND_ALPHA_BLENDED2:int = 5

BLEND_MULTIPLYConstant 
public static const BLEND_MULTIPLY:int = 3

BLEND_NONEConstant 
public static const BLEND_NONE:int = 0

BLEND_SCREENConstant 
public static const BLEND_SCREEN:int = 4

SORT_NONEConstant 
public static const SORT_NONE:int = 0

SORT_OLDEST_FIRSTConstant 
public static const SORT_OLDEST_FIRST:int = 2

SORT_YOUNGEST_FIRSTConstant 
public static const SORT_YOUNGEST_FIRST:int = 1