Packageflare.core
Classpublic class SpriteParticles3D
InheritanceSpriteParticles3D Inheritance Pivot3D Inheritance flash.events.EventDispatcher
Implements IDrawable



Public Properties
 PropertyDefined By
 InheritedanimationEnabled : Boolean = true
Activates or deactivates the animation.
Pivot3D
 InheritedanimationSmoothMode : int = 2
Sets or gets the animation method used to interpolate between frames.
Pivot3D
  autoSort : int = 0
SpriteParticles3D
  blendMode : int
SpriteParticles3D
 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
  colorTexture : Texture3D
[read-only]
SpriteParticles3D
 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
 Inheriteddirty : Boolean = true
Gets or sets when the object has changed his transform matrix by hand.
Pivot3D
 Inheritedframes : Vector.<Frame3D>
Vector that contains all the animation frames.
Pivot3D
 InheritedframeSpeed : Number
Returns or sets animation speed.
Pivot3D
  inView : Boolean
[override] [read-only]
SpriteParticles3D
 InheritedinvWorld : Matrix3D
[read-only] Returns a matrix with the inverse global position, rotation and scale of the object.
Pivot3D
 InheritedisPlaying : Boolean
[read-only] Returns true if an animation is being played.
Pivot3D
 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
  length : int
[read-only]
SpriteParticles3D
 Inheritedlock : Boolean
Sets the pivot lock mode.
Pivot3D
  material : FLSLMaterial
[read-only]
SpriteParticles3D
 Inheritedname : String
Sets or returns the object name.
Pivot3D
 Inheritedparent : Pivot3D
Returns or sets the object’s parent.
Pivot3D
 Inheritedpriority : int = 0
This value is for internal use to calculate the priority acording the distance from the camera during the render.
Pivot3D
 InheritedreceiveShadows : Boolean = true
Gets or sets if the object should receive shadows.
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
  sprites : Vector.<Sprite3D>
SpriteParticles3D
  texture : Texture3D
SpriteParticles3D
 Inheritedtransform : Matrix3D
Sets or returns the matrix of local position, rotation and scale.
Pivot3D
 Inheritedupdatable : Boolean
Pivot3D
 InheriteduserData : Object
Sets or returns an object for free use by the user.
Pivot3D
 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
 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
  
SpriteParticles3D(texture:Texture3D, enableRotations:Boolean = false, tiles:Point = null)
SpriteParticles3D
 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
 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
  
draw(includeChildren:Boolean = true, material:Material3D = null):void
[override]
SpriteParticles3D
 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
 Inherited
play(animationMode:int = 0, includeChildren:Boolean = true, resetAnimation:Boolean = true):void
Starts playing the animation.
Pivot3D
 Inherited
prevFrame():void
Pivot3D
  
remove(sprite:Sprite3D):int
SpriteParticles3D
  
Removes the specified index and push the instance to the end while decreasing the maxInstances property.
SpriteParticles3D
 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
 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
  
setAlphas(alphas:Array, ratios:Array):void
Sets the values to use as an alpha channel for all particles to use over the time.
SpriteParticles3D
 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.
SpriteParticles3D
 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
 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
  
sort(sortMode:int):void
Forces to sort particles.
SpriteParticles3D
  
spawn(spriteClass:Class = null):Sprite3D
Spanws a new particle and increaases the maxInstances count using an efficient pooling systtem.
SpriteParticles3D
 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
 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
  SORT_BACK_TO_FRONT : int = 2
[static]
SpriteParticles3D
 InheritedSORT_CENTER : int = 1
[static]
Pivot3D
 InheritedSORT_FAR : int = 4
[static]
Pivot3D
  SORT_FRONT_TO_BACK : int = 1
[static]
SpriteParticles3D
 InheritedSORT_NEAR : int = 2
[static]
Pivot3D
  SORT_NONE : int = 0
[static]
SpriteParticles3D
  SORT_REVERSE : int = 3
[static]
SpriteParticles3D
 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
autoSortproperty
public var autoSort:int = 0

blendModeproperty 
blendMode:int


Implementation
    public function get blendMode():int
    public function set blendMode(value:int):void
colorTextureproperty 
colorTexture:Texture3D  [read-only]


Implementation
    public function get colorTexture():Texture3D
inViewproperty 
inView:Boolean  [read-only] [override]


Implementation
    public function get inView():Boolean
lengthproperty 
length:int  [read-only]


Implementation
    public function get length():int
materialproperty 
material:FLSLMaterial  [read-only]


Implementation
    public function get material():FLSLMaterial
spritesproperty 
public var sprites:Vector.<Sprite3D>

textureproperty 
public var texture:Texture3D

Constructor Detail
SpriteParticles3D()Constructor
public function SpriteParticles3D(texture:Texture3D, enableRotations:Boolean = false, tiles:Point = null)



Parameters
texture:Texture3D
 
enableRotations:Boolean (default = false)
 
tiles:Point (default = null)
Method Detail
draw()method
override public function draw(includeChildren:Boolean = true, material:Material3D = null):void

Parameters

includeChildren:Boolean (default = true)
 
material:Material3D (default = null)

remove()method 
public function remove(sprite:Sprite3D):int

Parameters

sprite:Sprite3D

Returns
int
removeByIndex()method 
public function removeByIndex(index:int):Sprite3D

Removes the specified index and push the instance to the end while decreasing the maxInstances property. This metrhod allows for an efficient pooling system, moving the unused objects at the end for later use. The maxInstances is drecreased only when its value is different than -1.

Parameters

index:int — The index of the instance.

Returns
Sprite3D

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.

sort()method 
public function sort(sortMode:int):void

Forces to sort particles. If autoSort property is set to a value different than 0, this method is called automatically when rendering.

Parameters

sortMode:int — One of the sorting constants defined in SpriteParticles3D classs.

See also

spawn()method 
public function spawn(spriteClass:Class = null):Sprite3D

Spanws a new particle and increaases the maxInstances count using an efficient pooling systtem. IF maxInstances is -1, this method always creates a new particule and pooling is deactivated.

Parameters

spriteClass:Class (default = null) — An optional custom sprite class. This class should extends Sprite3D class.

Returns
Sprite3D — A new or a previously avilable Sprite3D instance.

See also

Constant Detail
SORT_BACK_TO_FRONTConstant
public static const SORT_BACK_TO_FRONT:int = 2

SORT_FRONT_TO_BACKConstant 
public static const SORT_FRONT_TO_BACK:int = 1

SORT_NONEConstant 
public static const SORT_NONE:int = 0

SORT_REVERSEConstant 
public static const SORT_REVERSE:int = 3