Packageflare.core
Classpublic class Pivot3D
InheritancePivot3D Inheritance flash.events.EventDispatcher
Subclasses Camera3D, ColladaLoader, DebugLight, F3DLoader, F3DScene, Flare3DLoader, Flare3DLoader1, Flare3DLoader2, Flare3DLoader3, Light3D, Mesh3D, MeshBatch3D, Particles3D, Scene3D, Shape3D, SpriteParticles3D, ZF3DLoader

The Pivot3D class is the most basic three-dimensional element.

Represents a point, its orientation and scale in the 3d space.

The Pivot3D object can also be parent or container of other 3d objects and can be animated.


Public Properties
 PropertyDefined By
  animationEnabled : Boolean = true
Activates or deactivates the animation.
Pivot3D
  animationSmoothMode : int = 2
Sets or gets the animation method used to interpolate between frames.
Pivot3D
  castShadows : Boolean = true
Gets or sets if the object should cast shadows.
Pivot3D
  children : Vector.<Pivot3D>
[read-only] Returns a Pivot3D-type vector with its children.
Pivot3D
  collider : Collider
Pivot3D
  components : Vector.<IComponent>
A collection vector that contains all the components of the object.
Pivot3D
  currentFrame : Number
Returns or sets the frame number where the pivot is situated.
Pivot3D
  currentLabel : Label3D
[read-only]
Pivot3D
  dirty : Boolean = true
Gets or sets when the object has changed his transform matrix by hand.
Pivot3D
  frames : Vector.<Frame3D>
Vector that contains all the animation frames.
Pivot3D
  frameSpeed : Number
Returns or sets animation speed.
Pivot3D
  inView : Boolean
[read-only]
Pivot3D
  invWorld : Matrix3D
[read-only] Returns a matrix with the inverse global position, rotation and scale of the object.
Pivot3D
  isPlaying : Boolean
[read-only] Returns true if an animation is being played.
Pivot3D
  isStatic : Boolean
Pivot3D
  labels : Object
Returns or sets an object that contains the Labels3D objects used to play and manage animations.
Pivot3D
  layer : int = 0
Gets or sets the layer to render the object.
Pivot3D
  lock : Boolean
Sets the pivot lock mode.
Pivot3D
  name : String
Sets or returns the object name.
Pivot3D
  parent : Pivot3D
Returns or sets the object’s parent.
Pivot3D
  priority : int = 0
This value is for internal use to calculate the priority acording the distance from the camera during the render.
Pivot3D
  receiveShadows : Boolean = true
Gets or sets if the object should receive shadows.
Pivot3D
  scaleX : Number
Increases or decreases the object scale on the X axis from its current scale.
Pivot3D
  scaleY : Number
Increases or decreases the object scale on the Y axis from its current scale.
Pivot3D
  scaleZ : Number
Increases or decreases the object scale on the Z axis from its current scale.
Pivot3D
  scene : Scene3D
[read-only] Gets a reference to the scene that contains the object.
Pivot3D
  sortMode : int
Gets ot sets the sorting mode for the object.
Pivot3D
  transform : Matrix3D
Sets or returns the matrix of local position, rotation and scale.
Pivot3D
  updatable : Boolean
Pivot3D
  userData : Object
Sets or returns an object for free use by the user.
Pivot3D
  visible : Boolean = true
Sets or returns whether the object is visible.
Pivot3D
  world : Matrix3D
Returns a matrix with the global position, rotation and scale of the object.
Pivot3D
  x : Number
Returns or sets the position on the X axis.
Pivot3D
  y : Number
Returns or sets the position on the Y axis.
Pivot3D
  z : Number
Returns or sets the position on the Z axis.
Pivot3D
Public Methods
 MethodDefined By
  
Pivot3D(name:String)
Creates a new Pivot3D object.
Pivot3D
  
addChild(pivot:Pivot3D, useGlobalSpace:Boolean = false):Pivot3D
Add a new object as a child.
Pivot3D
  
addChildAt(pivot:Pivot3D, index:int, useGlobalSpace:Boolean = false):Pivot3D
Pivot3D
  
addComponent(component:IComponent):Boolean
Adds a new component to the object.
Pivot3D
  
addFrameScript(frame:int, callback:Function):void
Pivot3D
  
addLabel(label:Label3D, includeChildren:Boolean = true):Label3D
Adds a label that refers to a given animation.
Pivot3D
  
clone():Pivot3D
Creates a copy of the object and all its elements.
Pivot3D
  
copyFrom(pivot:Pivot3D):void
Copy basic pivot properties to anotheer pivot.
Pivot3D
  
copyTransformFrom(source:Pivot3D, local:Boolean = true):void
Copies all transformations (position, rotation and scale) from another Pivot3D object.
Pivot3D
  
dispose():void
Disposes the pivot and all associated resources.
Pivot3D
  
download(includeChildren:Boolean = true):void
Pivot3D
  
draw(includeChildren:Boolean = true, material:Material3D = null):void
Draws the object.
Pivot3D
  
forEach(callback:Function, filterClass:Class = null, params:Object = null, includeChildren:Boolean = true):void
Excecutes a calback functions for each of his children.
Pivot3D
  
getBackward(local:Boolean = true, out:Vector3D = null):Vector3D
Returns the direction vector that points to the back of the object.
Pivot3D
  
getChildByName(name:String, startIndex:int = 0, includeChildren:Boolean = true):Pivot3D
Returns the first child that matches the specified name.
Pivot3D
  
getChildrenByClass(cl:Class, includeChildren:Boolean = true, out:Vector.<Pivot3D> = null):Vector.<Pivot3D>
Pivot3D
  
getDir(local:Boolean = true, out:Vector3D = null):Vector3D
Returns the direction vector that points to the front of the object.
Pivot3D
  
getDown(local:Boolean = true, out:Vector3D = null):Vector3D
Returns the direction vector that points to the bottom side of the object.
Pivot3D
  
getLeft(local:Boolean = true, out:Vector3D = null):Vector3D
Returns the direction vector that points to the left side of the object.
Pivot3D
  
getMaterialByName(name:String, includeChildren:Boolean = true):Material3D
Returns the first material that matches the specified name.
Pivot3D
  
getMaterials(includeChildren:Boolean = true, out:Vector.<Material3D> = null):Vector.<Material3D>
Returns an unique vector of pivot materials currently in use.
Pivot3D
  
getPosition(local:Boolean = true, out:Vector3D = null):Vector3D
Returns the current position of the object.
Pivot3D
  
getRight(local:Boolean = true, out:Vector3D = null):Vector3D
Returns the direction vector that points to the right side of the object.
Pivot3D
  
getRotation(local:Boolean = true, out:Vector3D = null):Vector3D
Returns the current rotation of the object in euler angles.
Pivot3D
  
getScale(local:Boolean = true, out:Vector3D = null):Vector3D
Returns the current scale of the object.
Pivot3D
  
getScreenCoords(out:Vector3D = null, camera:Camera3D = null, viewPort:Rectangle = null):Vector3D
Returns the coordinates of an object with respect to the screen.
Pivot3D
  
getSurfaces(includeChildren:Boolean = true, out:Vector.<Surface3D> = null):Vector.<Surface3D>
Returns an unique vector of surface objects used by the pivots.
Pivot3D
  
getTextures(includeChildren:Boolean = true, out:Vector.<Texture3D> = null):Vector.<Texture3D>
Returns an unique vector of textures objects used by the pivot materials.
Pivot3D
  
getUp(local:Boolean = true, out:Vector3D = null):Vector3D
Returns the direction vector that points to the upper side of the object.
Pivot3D
  
globalToLocal(point:Vector3D, out:Vector3D = null):Vector3D
Transforms a point of the global space of the object into a local space.
Pivot3D
  
globalToLocalVector(vector:Vector3D, out:Vector3D = null):Vector3D
Transforms a point of the global space of the object into a local space without translation.
Pivot3D
  
gotoAndPlay(frame:Object, blendFrames:Number = 0, animationMode:int, includeChildren:Boolean = true):void
Starts playing the animation at the specified frame
Pivot3D
  
gotoAndStop(frame:Object, blendFrames:Number = 0, includeChildren:Boolean = true):void
Stops the animation at the specified frame.
Pivot3D
  
hide():void
Sets the visible property of this object and all its children recursively to false.
Pivot3D
  
localToGlobal(point:Vector3D, out:Vector3D = null):Vector3D
Transforms a point of the local space into the global space.
Pivot3D
  
localToGlobalVector(vector:Vector3D, out:Vector3D = null):Vector3D
Transforms a point of the local space of the object into a global space without translation.
Pivot3D
  
lookAt(x:Number, y:Number, z:Number, up:Vector3D = null, smooth:Number = 1):void
Directs the object towards the specified position.
Pivot3D
  
nextFrame():void
Pivot3D
  
play(animationMode:int = 0, includeChildren:Boolean = true, resetAnimation:Boolean = true):void
Starts playing the animation.
Pivot3D
  
prevFrame():void
Pivot3D
  
removeChild(pivot:Pivot3D):Pivot3D
Removes a child of the object.
Pivot3D
  
removeComponent(component:IComponent):Boolean
Removes a component from the object.
Pivot3D
  
removeLabel(label:Label3D, includeChildren:Boolean = true):Label3D
Removes a label.
Pivot3D
  
replaceMaterial(source:Material3D, replaceFor:Material3D, includeChildren:Boolean = true):void
Replaces an existing material of the object with another material.
Pivot3D
  
replaceSurface(source:Surface3D, replaceFor:Surface3D, includeChildren:Boolean = true):void
Replaces an existing surface of the object with another surface.
Pivot3D
  
replaceTexture(source:Texture3D, replaceFor:Texture3D, includeChildren:Boolean = true):void
Replaces an existing texture of the object materials with another texture.
Pivot3D
  
resetTransforms():void
Resets the object position, rotation and scale.
Pivot3D
  
rotateAxis(angle:Number, axis:Vector3D, pivotPoint:Vector3D = null):void
Rotates the object on the specified axis from its current position.
Pivot3D
  
rotateX(angle:Number, local:Boolean = true, pivotPoint:Vector3D = null):void
Rotates the object on the X axis from its current position.
Pivot3D
  
rotateY(angle:Number, local:Boolean = true, pivotPoint:Vector3D = null):void
Rotates the object on the Y axis from its current position.
Pivot3D
  
rotateZ(angle:Number, local:Boolean = true, pivotPoint:Vector3D = null):void
Rotates the pivot on the Z axis from its current position.
Pivot3D
  
setAnimationLabel(label:Object, animationMode:int, includeChildren:Boolean = true):void
Sets the current animation label.
Pivot3D
  
setAnimationSmooth(mode:int, includeChildren:Boolean = true):void
Sets the animation interpolation mode for this pivot and its children.
Pivot3D
  
setLayer(value:int, includeChildren:Boolean = true):void
Sets the layer to render the object and all of his children.
Pivot3D
  
setMaterial(material:Material3D, includeChildren:Boolean = true):void
Sets a material for the object and, optionally, all its descendants.
Pivot3D
  
setNormalOrientation(normal:Vector3D, smooth:Number = 1):void
Aligns the object to a normal.
Pivot3D
  
setOrientation(dir:Vector3D, up:Vector3D = null, smooth:Number = 1):void
Orients the object in a specific direction.
Pivot3D
  
setPosition(x:Number, y:Number, z:Number, smooth:Number = 1, local:Boolean = true):void
Sets the position of the object.
Pivot3D
  
setRotation(x:Number, y:Number, z:Number):void
Sets the object rotation using euler angles.
Pivot3D
  
setScale(x:Number, y:Number, z:Number, smooth:Number = 1):void
Sets the object scale.
Pivot3D
  
setShadowsProperties(cast:Boolean = false, receive:Boolean = false, includeChildren:Boolean = true):void
Sets whether the object should cast and receive shadows.
Pivot3D
  
setStatic(value:Boolean, includeChildren:Boolean = true):void
Pivot3D
  
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
  
show():void
Sets the visible property of this object and all its children recursively to true.
Pivot3D
  
startDrag(lockCenter:Boolean = false, refPlaneNormal:Vector3D = null):void
Lets the user drag the specified Pivot3D.
Pivot3D
  
stop(includeChildren:Boolean = true):void
Pivot3D
  
stopDrag():void
Ends the startDrag() method.
Pivot3D
  
translateAxis(distance:Number, axis:Vector3D):void
Translates the object on a certain axis from its current position.
Pivot3D
  
translateX(distance:Number, local:Boolean = true):void
Translates the object on the X axis from its current position.
Pivot3D
  
translateY(distance:Number, local:Boolean = true):void
Translates the object on the Y axis from its current position.
Pivot3D
  
translateZ(distance:Number, local:Boolean = true):void
Translates the object on the Z axis from its current position.
Pivot3D
  
update():void
Pivot3D
  
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
  
upload(scene:Scene3D, includeChildren:Boolean = true):void
Pivot3D
Events
 Event Summary Defined By
  
added
This event occurs when the object is added to a scene or to any other object.Pivot3D
  
addedToScene
This event occurs when the object is added to a scene.Pivot3D
  
animationComplete
This event occurs at the end of an animation.Pivot3D
  
changeTransform
This event occurs whatever the object changes his position, rotation or scale.Pivot3D
  
enterDrag
This event occurs before drag the object.Pivot3D
  
enterDraw
This event occurs before draw the object.Pivot3D
  
enterFrame
This event occurs before entering any frame.Pivot3D
  
exitDrag
This event occurs after drag the object.Pivot3D
  
exitDraw
This event occurs after draw the object.Pivot3D
  
exitFrame
This event occurs after updating every frame.Pivot3D
  
removed
This event occurs when the object is removed from a scene or from any other object.Pivot3D
  
removedFromScene
This event occurs when the object is removed from a scene.Pivot3D
  
unload
This event occurs when the dispose method of the object itself or of a parent object is called.Pivot3D
Public Constants
 ConstantDefined By
  ADDED_EVENT : String = added
[static] Defines the value for the 'added' event.
Pivot3D
  ADDED_TO_SCENE_EVENT : String = addedToScene
[static] Defines the value for the 'addedToScene' event.
Pivot3D
  ANIMATION_COMPLETE_EVENT : String = animationComplete
[static] Defines the value for the 'animationComplete' event.
Pivot3D
  ANIMATION_LOOP_MODE : int = 0
[static]
Pivot3D
  ANIMATION_PING_PONG_MODE : int = 1
[static]
Pivot3D
  ANIMATION_SMOOTH_BEST : int = 2
[static]
Pivot3D
  ANIMATION_SMOOTH_NONE : int = 0
[static]
Pivot3D
  ANIMATION_SMOOTH_NORMAL : int = 1
[static]
Pivot3D
  ANIMATION_STOP_MODE : int = 2
[static]
Pivot3D
  ENTER_DRAG_EVENT : String = enterDrag
[static] Defines the value for the 'enterDrag' event.
Pivot3D
  ENTER_DRAW_EVENT : String = enterDraw
[static] Defines the value for the 'enterDraw' event.
Pivot3D
  ENTER_FRAME_EVENT : String = enterFrame
[static] Defines the value for the 'enterFrame' event.
Pivot3D
  EXIT_DRAG_EVENT : String = exitDrag
[static] Defines the value for the 'exitDrag' event.
Pivot3D
  EXIT_DRAW_EVENT : String = exitDraw
[static] Defines the value for the 'exitDraw' event.
Pivot3D
  EXIT_FRAME_EVENT : String = exitFrame
[static] Defines the value for the 'exitFrame' event.
Pivot3D
  REMOVED_EVENT : String = removed
[static] Defines the value for the 'removed' event.
Pivot3D
  REMOVED_FROM_SCENE_EVENT : String = removedFromScene
[static] Defines the value for the 'removedFromScene' event.
Pivot3D
  SORT_CENTER : int = 1
[static]
Pivot3D
  SORT_FAR : int = 4
[static]
Pivot3D
  SORT_NEAR : int = 2
[static]
Pivot3D
  SORT_NONE : int = 0
[static]
Pivot3D
  UNLOAD_EVENT : String = unload
[static] Defines the value for the 'unload' event.
Pivot3D
  UPDATE_TRANSFORM_EVENT : String = updateTransform
[static] Defines the value for the 'updateTransform' event.
Pivot3D
Property Detail
animationEnabledproperty
public var animationEnabled:Boolean = true

Activates or deactivates the animation. If the object is animated and this animation is being placed, the element will be blocked by the animation and will not be able to move or rotate manually; therefore, if an animated object is to be controlled, the animation must first be disabled by setting animationEnabled false.

animationSmoothModeproperty 
public var animationSmoothMode:int = 2

Sets or gets the animation method used to interpolate between frames. This setting is used when the frameSpeed property is set to a value less than 1 or when performing an animation blending operation. Should be one of the following constants, Pivot3D.ANIMATION_SMOOTH_NONE, Pivot3D.ANIMATION_SMOOTH_NORMAL or Pivot3D.ANIMATION_SMOOTH_BEST. When setting this property to NONE, no interpolation is performed. A value of NORMAL, produces a fast interpolation, which is usually the correct setting in most of the cases, but can produce some issues when interpolating scaled objects, in which case, set this value to BEST which is slower, but more accurate.

See also

frameSpeed
setAnimationSmooth()
ANIMATION_SMOOTH_NONE
ANIMATION_SMOOTH_NORMAL
ANIMATION_SMOOTH_BEST
castShadowsproperty 
public var castShadows:Boolean = true

Gets or sets if the object should cast shadows.

childrenproperty 
children:Vector.<Pivot3D>  [read-only]

Returns a Pivot3D-type vector with its children.


Implementation
    public function get children():Vector.<Pivot3D>
colliderproperty 
collider:Collider


Implementation
    public function get collider():Collider
    public function set collider(value:Collider):void
componentsproperty 
public var components:Vector.<IComponent>

A collection vector that contains all the components of the object.

currentFrameproperty 
currentFrame:Number

Returns or sets the frame number where the pivot is situated. Animation frames are zero-based.


Implementation
    public function get currentFrame():Number
    public function set currentFrame(value:Number):void
currentLabelproperty 
currentLabel:Label3D  [read-only]


Implementation
    public function get currentLabel():Label3D
dirtyproperty 
public var dirty:Boolean = true

Gets or sets when the object has changed his transform matrix by hand.

See also

updateTransforms()
framesproperty 
public var frames:Vector.<Frame3D>

Vector that contains all the animation frames.

frameSpeedproperty 
frameSpeed:Number

Returns or sets animation speed. The default value is 1. The frame number is increased by the “frameSpeed” value in each update (“update” event) and is directly related to the number of updates per second in Device3D.


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

See also

Device3D.setFPS()
currentFrame
inViewproperty 
inView:Boolean  [read-only]


Implementation
    public function get inView():Boolean
invWorldproperty 
invWorld:Matrix3D  [read-only]

Returns a matrix with the inverse global position, rotation and scale of the object. If the object is part of a hierarchy that has been moved, rotated, scaled, etc., this property will return the matrix relative to the furthest parent that can be found. In general, this could be the scene.


Implementation
    public function get invWorld():Matrix3D

See also

world
global
updateTransforms()
isPlayingproperty 
isPlaying:Boolean  [read-only]

Returns true if an animation is being played.


Implementation
    public function get isPlaying():Boolean
isStaticproperty 
isStatic:Boolean


Implementation
    public function get isStatic():Boolean
    public function set isStatic(value:Boolean):void
labelsproperty 
public var labels:Object

Returns or sets an object that contains the Labels3D objects used to play and manage animations.

See also

addLabel()
playLabel()
removeLabel()
layerproperty 
public var layer:int = 0

Gets or sets the layer to render the object.

lockproperty 
lock:Boolean

Sets the pivot lock mode. When a pivot is locked, it will not be updated / played directly and will not dispatch events like enter and exit frame. This is usually the case on bones, that they are updated trough an external controller.


Implementation
    public function get lock():Boolean
    public function set lock(value:Boolean):void
nameproperty 
public var name:String

Sets or returns the object name.

parentproperty 
parent:Pivot3D

Returns or sets the object’s parent. Setting the parent through the “parent” property has the same effect as establishing the “parent” property with the AddChild method of the Pivot3D that will be parent. It can remove parent object by setting the “parent” property to “null”.


Implementation
    public function get parent():Pivot3D
    public function set parent(value:Pivot3D):void

See also

addChild()
priorityproperty 
public var priority:int = 0

This value is for internal use to calculate the priority acording the distance from the camera during the render.

receiveShadowsproperty 
public var receiveShadows:Boolean = true

Gets or sets if the object should receive shadows.

scaleXproperty 
scaleX:Number

Increases or decreases the object scale on the X axis from its current scale. Use a value greater than one to increase or less than one to decrease. Setting the scale to 2 means that objects will be scaled to twice their original size, whereas a value of 0.5 would scale objects to one half of their original size.


Implementation
    public function get scaleX():Number
    public function set scaleX(value:Number):void
scaleYproperty 
scaleY:Number

Increases or decreases the object scale on the Y axis from its current scale. Use a value greater than one to increase or less than one to decrease. Setting the scale to 2 means that objects will be scaled to twice their original size, whereas a value of 0.5 would scale objects to one half of their original size.


Implementation
    public function get scaleY():Number
    public function set scaleY(value:Number):void
scaleZproperty 
scaleZ:Number

Increases or decreases the object scale on the Z axis from its current scale. Use a value greater than one to increase or less than one to decrease. Setting the scale to 2 means that objects will be scaled to twice their original size, whereas a value of 0.5 would scale objects to one half their original size.


Implementation
    public function get scaleZ():Number
    public function set scaleZ(value:Number):void
sceneproperty 
scene:Scene3D  [read-only]

Gets a reference to the scene that contains the object.


Implementation
    public function get scene():Scene3D
sortModeproperty 
sortMode:int

Gets ot sets the sorting mode for the object.


Implementation
    public function get sortMode():int
    public function set sortMode(value:int):void
transformproperty 
public var transform:Matrix3D

Sets or returns the matrix of local position, rotation and scale. The transform property corresponds to the local space of the object.

updatableproperty 
updatable:Boolean


Implementation
    public function get updatable():Boolean
    public function set updatable(value:Boolean):void
userDataproperty 
public var userData:Object

Sets or returns an object for free use by the user. The userData object may also contain variables included within the f3d files.

visibleproperty 
public var visible:Boolean = true

Sets or returns whether the object is visible. Only affects the current object.

See also

show()
hide()
worldproperty 
world:Matrix3D

Returns a matrix with the global position, rotation and scale of the object. If the object is part of a hierarchy that has been moved, rotated, scaled, etc., this property will return the matrix relative to the furthest parent that can be found. In general, this could be the scene. The “world” matrix, instead, represents the local position, rotation and scale. If the “world” matrix has been manually modified, it will have to call the updateTransforms method to update the global matrix.


Implementation
    public function get world():Matrix3D
    public function set world(value:Matrix3D):void

See also

world
invGlobal
updateTransforms()
xproperty 
x:Number

Returns or sets the position on the X axis.


Implementation
    public function get x():Number
    public function set x(value:Number):void
yproperty 
y:Number

Returns or sets the position on the Y axis.


Implementation
    public function get y():Number
    public function set y(value:Number):void
zproperty 
z:Number

Returns or sets the position on the Z axis.


Implementation
    public function get z():Number
    public function set z(value:Number):void
Constructor Detail
Pivot3D()Constructor
public function Pivot3D(name:String)

Creates a new Pivot3D object.

Parameters
name:String — 3d object name.
Method Detail
addChild()method
public function addChild(pivot:Pivot3D, useGlobalSpace:Boolean = false):Pivot3D

Add a new object as a child.

Parameters

pivot:Pivot3D — Object to be added.
 
useGlobalSpace:Boolean (default = false)

Returns
Pivot3D — The object that has been added.

See also

parent
addChildAt()method 
public function addChildAt(pivot:Pivot3D, index:int, useGlobalSpace:Boolean = false):Pivot3D

Parameters

pivot:Pivot3D
 
index:int
 
useGlobalSpace:Boolean (default = false)

Returns
Pivot3D
addComponent()method 
public function addComponent(component:IComponent):Boolean

Adds a new component to the object.

Parameters

component:IComponent — The component to add.

Returns
Boolean — 'true' is the component was sucesfully added, 'false' otherwise.
addFrameScript()method 
public function addFrameScript(frame:int, callback:Function):void

Parameters

frame:int
 
callback:Function

addLabel()method 
public function addLabel(label:Label3D, includeChildren:Boolean = true):Label3D

Adds a label that refers to a given animation.

Parameters

label:Label3D — Label3D object.
 
includeChildren:Boolean (default = true) — true if labels are to be included in all the sub-objects.

Returns
Label3D — Returns same Label3D object that contains the label information.
clone()method 
public function clone():Pivot3D

Creates a copy of the object and all its elements.

Returns
Pivot3D — A new Pivot3D object.
copyFrom()method 
public function copyFrom(pivot:Pivot3D):void

Copy basic pivot properties to anotheer pivot.

Parameters

pivot:Pivot3D

copyTransformFrom()method 
public function copyTransformFrom(source:Pivot3D, local:Boolean = true):void

Copies all transformations (position, rotation and scale) from another Pivot3D object.

Parameters

source:Pivot3D — Source object from you want to copy.
 
local:Boolean (default = true) — true to copy from/to local coordinates, false will take global space coordinates.

dispose()method 
public function dispose():void

Disposes the pivot and all associated resources.

download()method 
public function download(includeChildren:Boolean = true):void

Parameters

includeChildren:Boolean (default = true)

draw()method 
public function draw(includeChildren:Boolean = true, material:Material3D = null):void

Draws the object. This method is generally called by the scene that contains it and manages it. However, it is possible to manage the drawing process independently from a scene. To do so, it is essential that the canvas and the camera be properly set in the Device3D class and that the calculateView method of the Camera3D class be previously called.

Parameters

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

See also

Device3D.camera
Device3D.canvas
Camera3D calculateView()
forEach()method 
public function forEach(callback:Function, filterClass:Class = null, params:Object = null, includeChildren:Boolean = true):void

Excecutes a calback functions for each of his children. The callback should recibe a object:Pivot3D parameter.

Parameters

callback:Function
 
filterClass:Class (default = null)
 
params:Object (default = null)
 
includeChildren:Boolean (default = true)

getBackward()method 
public function getBackward(local:Boolean = true, out:Vector3D = null):Vector3D

Returns the direction vector that points to the back of the object.

Parameters

local:Boolean (default = true)
 
out:Vector3D (default = null)

Returns
Vector3D — The new direction vector.
getChildByName()method 
public function getChildByName(name:String, startIndex:int = 0, includeChildren:Boolean = true):Pivot3D

Returns the first child that matches the specified name.

Parameters

name:String — Name of the object to be searched for.
 
startIndex:int (default = 0) — An optional integer specifying the starting index of the search.
 
includeChildren:Boolean (default = true) — true to extend the search to all the hierarchy.

Returns
Pivot3D — The object that matches the specified name.
getChildrenByClass()method 
public function getChildrenByClass(cl:Class, includeChildren:Boolean = true, out:Vector.<Pivot3D> = null):Vector.<Pivot3D>

Parameters

cl:Class
 
includeChildren:Boolean (default = true)
 
out:Vector.<Pivot3D> (default = null)

Returns
Vector.<Pivot3D>
getDir()method 
public function getDir(local:Boolean = true, out:Vector3D = null):Vector3D

Returns the direction vector that points to the front of the object.

Parameters

local:Boolean (default = true)
 
out:Vector3D (default = null)

Returns
Vector3D — The new direction vector.
getDown()method 
public function getDown(local:Boolean = true, out:Vector3D = null):Vector3D

Returns the direction vector that points to the bottom side of the object.

Parameters

local:Boolean (default = true)
 
out:Vector3D (default = null)

Returns
Vector3D — The new direction vector.
getLeft()method 
public function getLeft(local:Boolean = true, out:Vector3D = null):Vector3D

Returns the direction vector that points to the left side of the object.

Parameters

local:Boolean (default = true)
 
out:Vector3D (default = null)

Returns
Vector3D — The new direction vector.
getMaterialByName()method 
public function getMaterialByName(name:String, includeChildren:Boolean = true):Material3D

Returns the first material that matches the specified name.

Parameters

name:String — Name of the material to be searched for.
 
includeChildren:Boolean (default = true) — true to extend the search to all the object hierarchy.

Returns
Material3D — The material that matches the specified name.
getMaterials()method 
public function getMaterials(includeChildren:Boolean = true, out:Vector.<Material3D> = null):Vector.<Material3D>

Returns an unique vector of pivot materials currently in use. Using this method at runtime may be slow, since it goes recursively inspecting the objects. This method is different from Scene3D.materials, while Scene3D.materials returns the materials already uploaded to the GPU even if they are not currently in use, this method only returns the materials currently in use by this pivot.

Parameters

includeChildren:Boolean (default = true) — true to extend the search to all the object hierarchy.
 
out:Vector.<Material3D> (default = null) — The output vector where the materials will be pushed. If null, a new vector is created.

Returns
Vector.<Material3D> — The vector containing all pivot materials.

See also

Scene3D.materials
getPosition()method 
public function getPosition(local:Boolean = true, out:Vector3D = null):Vector3D

Returns the current position of the object.

Parameters

local:Boolean (default = true)
 
out:Vector3D (default = null)

Returns
Vector3D — A new vector with the current position of the object.
getRight()method 
public function getRight(local:Boolean = true, out:Vector3D = null):Vector3D

Returns the direction vector that points to the right side of the object.

Parameters

local:Boolean (default = true)
 
out:Vector3D (default = null)

Returns
Vector3D — The new direction vector.
getRotation()method 
public function getRotation(local:Boolean = true, out:Vector3D = null):Vector3D

Returns the current rotation of the object in euler angles.

Parameters

local:Boolean (default = true)
 
out:Vector3D (default = null)

Returns
Vector3D — A new vector with the current rotation of the object.
getScale()method 
public function getScale(local:Boolean = true, out:Vector3D = null):Vector3D

Returns the current scale of the object.

Parameters

local:Boolean (default = true)
 
out:Vector3D (default = null)

Returns
Vector3D — A new vector with the current scale of the object.
getScreenCoords()method 
public function getScreenCoords(out:Vector3D = null, camera:Camera3D = null, viewPort:Rectangle = null):Vector3D

Returns the coordinates of an object with respect to the screen. The returned values are relative to the viewPort size that is currently used.

Parameters

out:Vector3D (default = null) — If a vector is specified, this vector will be filled with the returned values.
 
camera:Camera3D (default = null)
 
viewPort:Rectangle (default = null)

Returns
Vector3D — The vector with the coordinates.
getSurfaces()method 
public function getSurfaces(includeChildren:Boolean = true, out:Vector.<Surface3D> = null):Vector.<Surface3D>

Returns an unique vector of surface objects used by the pivots. Using this method at runtime may be slow, since it goes recursively inspecting the objects. This method is different from Scene3D.surfaces, while Scene3D.surfaces returns the surfaces already uploaded to the GPU even if they are not currently in use, this method only returns the surfaces currently in use by this pivot.

Parameters

includeChildren:Boolean (default = true) — true to extend the search to all the object hierarchy.
 
out:Vector.<Surface3D> (default = null) — The output vector where the surfaces will be pushed. If null, a new vector is created.

Returns
Vector.<Surface3D> — The vector containing all pivot surfaces.

See also

Scene3D.surfaces
getTextures()method 
public function getTextures(includeChildren:Boolean = true, out:Vector.<Texture3D> = null):Vector.<Texture3D>

Returns an unique vector of textures objects used by the pivot materials. Using this method at runtime may be slow, since it goes recursively inspecting the objects. This method is different from Scene3D.textures, while Scene3D.textures returns the textures already uploaded to the GPU even if they are not currently in use, this method only returns the textures currently in use by this pivot.

Parameters

includeChildren:Boolean (default = true) — true to extend the search to all the object hierarchy.
 
out:Vector.<Texture3D> (default = null) — The output vector where the textures will be pushed. If null, a new vector is created.

Returns
Vector.<Texture3D> — The vector containing all pivot textures.

See also

Scene3D.textures
getUp()method 
public function getUp(local:Boolean = true, out:Vector3D = null):Vector3D

Returns the direction vector that points to the upper side of the object.

Parameters

local:Boolean (default = true)
 
out:Vector3D (default = null)

Returns
Vector3D — The new direction vector.
globalToLocal()method 
public function globalToLocal(point:Vector3D, out:Vector3D = null):Vector3D

Transforms a point of the global space of the object into a local space.

Parameters

point:Vector3D — The point to be transformed.
 
out:Vector3D (default = null) — Vector3D where the transformed point will be returned. If null, a new Vector3D is returned.

Returns
Vector3D — Vector3D with the transformed point.
globalToLocalVector()method 
public function globalToLocalVector(vector:Vector3D, out:Vector3D = null):Vector3D

Transforms a point of the global space of the object into a local space without translation. Useful to convert direction normals or vectors.

Parameters

vector:Vector3D — The point to be transformed.
 
out:Vector3D (default = null) — Vector3D where the transformed point will be returned. If null, a new Vector3D is returned.

Returns
Vector3D — Vector3D with the transformed point.
gotoAndPlay()method 
public function gotoAndPlay(frame:Object, blendFrames:Number = 0, animationMode:int, includeChildren:Boolean = true):void

Starts playing the animation at the specified frame

Parameters

frame:Object — Frame number at which animation will be started. Animation frames are zero-based.
 
blendFrames:Number (default = 0) — The number of frames to use to blend from the current state to the new animation frame.
 
animationMode:int (default = NaN) — The mode to use to play the animation. Should be one of the consntants ANIMATION_LOOP_MODE, ANIMATION_PING_PONG_MODE or ANIMATION_STOP_MODE from Pivot3D.
 
includeChildren:Boolean (default = true) — true to include all the hierarchy.

See also

ANIMATION_LOOP_MODE
ANIMATION_PING_PONG_MODE
ANIMATION_STOP_MODE
gotoAndStop()method 
public function gotoAndStop(frame:Object, blendFrames:Number = 0, includeChildren:Boolean = true):void

Stops the animation at the specified frame.

Parameters

frame:Object — Frame number at which animation will be stopped. Animation frames are zero-based.
 
blendFrames:Number (default = 0) — The amount of frames to blend from the current position.
 
includeChildren:Boolean (default = true) — true to include all the hierarchy.

hide()method 
public function hide():void

Sets the visible property of this object and all its children recursively to false.

See also

visible
localToGlobal()method 
public function localToGlobal(point:Vector3D, out:Vector3D = null):Vector3D

Transforms a point of the local space into the global space.

Parameters

point:Vector3D — The point to be transformed.
 
out:Vector3D (default = null) — The Vector3D where the transformed point will be returned. If null, a new Vector3D is returned.

Returns
Vector3D — If the “out” parameter is “null”, a new Vector3D object with the transformed point will be returned, or the same “out” vector.
localToGlobalVector()method 
public function localToGlobalVector(vector:Vector3D, out:Vector3D = null):Vector3D

Transforms a point of the local space of the object into a global space without translation. Useful to convert direction normals or vectors.

Parameters

vector:Vector3D — The point to be transformed.
 
out:Vector3D (default = null) — Vector3D where the transformed point will be returned. If null, a new Vector3D is returned.

Returns
Vector3D — Vector3D with the transformed point.
lookAt()method 
public function lookAt(x:Number, y:Number, z:Number, up:Vector3D = null, smooth:Number = 1):void

Directs the object towards the specified position. Coordinates are related to the local space of the object.

Parameters

x:Number — Position on x
 
y:Number — Position on Y
 
z:Number — Position on z
 
up:Vector3D (default = null) — Vector3D related to the direction of the upper side of the object. The default value is (0, 1, 0).
 
smooth:Number (default = 1) — Optional interpolation value towards final transformation (0-1).

See also

Pivot3DUtils.lookAt()
Pivot3DUtils.lookAtWithReference()
nextFrame()method 
public function nextFrame():void

play()method 
public function play(animationMode:int = 0, includeChildren:Boolean = true, resetAnimation:Boolean = true):void

Starts playing the animation.

Parameters

animationMode:int (default = 0) — Any of the following Pivot3D constants ANIMATION_SMOOTH_NONE, ANIMATION_SMOOTH_NORMAL or ANIMATION_SMOOTH_BEST.
 
includeChildren:Boolean (default = true) — true to include all the hierarchy.
 
resetAnimation:Boolean (default = true) — Resets the the state of the current animation or label if any, otherwise, the animation continues from the current position or label.

prevFrame()method 
public function prevFrame():void

removeChild()method 
public function removeChild(pivot:Pivot3D):Pivot3D

Removes a child of the object.

Parameters

pivot:Pivot3D — Object to be removed.

Returns
Pivot3D — The object that has been removed.
removeComponent()method 
public function removeComponent(component:IComponent):Boolean

Removes a component from the object.

Parameters

component:IComponent — The component to remove.

Returns
Boolean — 'true' if the component was sucesfully removed, 'false' otherwise or if the components was in the components list..
removeLabel()method 
public function removeLabel(label:Label3D, includeChildren:Boolean = true):Label3D

Removes a label.

Parameters

label:Label3D — Label3D object to be removed.
 
includeChildren:Boolean (default = true) — true if the labels of all the sub-objects are to be removed.

Returns
Label3D — The label has been removed.
replaceMaterial()method 
public function replaceMaterial(source:Material3D, replaceFor:Material3D, includeChildren:Boolean = true):void

Replaces an existing material of the object with another material.

Parameters

source:Material3D — Material that is to be replaced.
 
replaceFor:Material3D — Material that is to replace the previous one.
 
includeChildren:Boolean (default = true) — true if children are to be included.

See also

setMaterial()
getMaterialByName()
replaceSurface()method 
public function replaceSurface(source:Surface3D, replaceFor:Surface3D, includeChildren:Boolean = true):void

Replaces an existing surface of the object with another surface.

Parameters

source:Surface3D — Surface that is to be replaced.
 
replaceFor:Surface3D — Surface that is to replace the previous one.
 
includeChildren:Boolean (default = true) — true if children are to be included.

replaceTexture()method 
public function replaceTexture(source:Texture3D, replaceFor:Texture3D, includeChildren:Boolean = true):void

Replaces an existing texture of the object materials with another texture.

Parameters

source:Texture3D — Texture that is to be replaced.
 
replaceFor:Texture3D — Texture that is to replace the previous one.
 
includeChildren:Boolean (default = true) — true if children are to be included.

resetTransforms()method 
public function resetTransforms():void

Resets the object position, rotation and scale.

rotateAxis()method 
public function rotateAxis(angle:Number, axis:Vector3D, pivotPoint:Vector3D = null):void

Rotates the object on the specified axis from its current position. The pivotPoint parameter can be used to rotate around a point.

Parameters

angle:Number — Angles to be rotated
 
axis:Vector3D — Direction vector or axis on which to rotate.
 
pivotPoint:Vector3D (default = null) — Position vector that sets an anchoring point for rotation. The position must be expressed in local units.

rotateX()method 
public function rotateX(angle:Number, local:Boolean = true, pivotPoint:Vector3D = null):void

Rotates the object on the X axis from its current position. The pivotPoint parameter can be used to rotate around a point.

Parameters

angle:Number — Angles to be rotated.
 
local:Boolean (default = true) — true to rotate respecting current orientation, or false to rotate according to orientation relative to parent.
 
pivotPoint:Vector3D (default = null) — Position vector that sets an anchoring point for rotation. The position must be expressed in local units.

rotateY()method 
public function rotateY(angle:Number, local:Boolean = true, pivotPoint:Vector3D = null):void

Rotates the object on the Y axis from its current position. The pivotPoint parameter can be used to rotate around a point.

Parameters

angle:Number — Angles to be rotated.
 
local:Boolean (default = true) — true to rotate respecting current orientation, or false to rotate according to orientation relative to parent.
 
pivotPoint:Vector3D (default = null) — Position vector that sets an anchoring point for rotation. The position must be expressed in local units.

rotateZ()method 
public function rotateZ(angle:Number, local:Boolean = true, pivotPoint:Vector3D = null):void

Rotates the pivot on the Z axis from its current position. The pivotPoint parameter can be used to rotate around a point.

Parameters

angle:Number — Angles to be rotated.
 
local:Boolean (default = true) — true to rotate respecting current orientation, or false to rotate according to orientation relative to parent.
 
pivotPoint:Vector3D (default = null) — Position vector that sets an anchoring point for rotation. The position must be expressed in local units.

setAnimationLabel()method 
public function setAnimationLabel(label:Object, animationMode:int, includeChildren:Boolean = true):void

Sets the current animation label. The current label and animation mode affects directly to the frame range and interpolation of the animations. Use this method if you need to move between animation frames without using play() or gotoAndPlay(), e.g. setting values directly to the currentFrame property or moving between frame values using gotoAndStop().

Parameters

label:Object — an Label3D object or a label string name previously defined.
 
animationMode:int (default = NaN) — The animation mode of the label.
 
includeChildren:Boolean (default = true) — true to include all the hierarchy.

setAnimationSmooth()method 
public function setAnimationSmooth(mode:int, includeChildren:Boolean = true):void

Sets the animation interpolation mode for this pivot and its children.

Parameters

mode:int (default = NaN) — The smooth animation mode.
 
includeChildren:Boolean (default = true) — true to set the animation mode to all the objects in the pivot hierarchy.

See also

frameSpeed
animationSmoothMode
ANIMATION_SMOOTH_NONE
ANIMATION_SMOOTH_NORMAL
ANIMATION_SMOOTH_BEST
setLayer()method 
public function setLayer(value:int, includeChildren:Boolean = true):void

Sets the layer to render the object and all of his children.

Parameters

value:int — The layer index.
 
includeChildren:Boolean (default = true) — true to apply the same value to all the object hierarchy.

setMaterial()method 
public function setMaterial(material:Material3D, includeChildren:Boolean = true):void

Sets a material for the object and, optionally, all its descendants. The material will only affect Mesh3D objects that contain the Pivot3D.

Parameters

material:Material3D — Material that will be assigned.
 
includeChildren:Boolean (default = true) — true if all the hierarchy is to be included.

setNormalOrientation()method 
public function setNormalOrientation(normal:Vector3D, smooth:Number = 1):void

Aligns the object to a normal.

Parameters

normal:Vector3D — Normal used for alignment.
 
smooth:Number (default = 1) — Optional interpolation value (0-1).

setOrientation()method 
public function setOrientation(dir:Vector3D, up:Vector3D = null, smooth:Number = 1):void

Orients the object in a specific direction.

Parameters

dir:Vector3D — Direction set for orientation.
 
up:Vector3D (default = null) — Upper side of the object. The default value is (0,1,0).
 
smooth:Number (default = 1) — Optional interpolation value (0-1).

setPosition()method 
public function setPosition(x:Number, y:Number, z:Number, smooth:Number = 1, local:Boolean = true):void

Sets the position of the object.

Parameters

x:Number — Position on x
 
y:Number — Position on y
 
z:Number — Position on z
 
smooth:Number (default = 1) — Optional interpolation value towards final transformation (0-1).
 
local:Boolean (default = true)

setRotation()method 
public function setRotation(x:Number, y:Number, z:Number):void

Sets the object rotation using euler angles. Rotation is absolute, so any previous rotation will be ignored.

Parameters

x:Number — Rotation on x in angles.
 
y:Number — Rotation on y in angles.
 
z:Number — Rotation on z in angles.

setScale()method 
public function setScale(x:Number, y:Number, z:Number, smooth:Number = 1):void

Sets the object scale. This method sets the scale in an absolute manner; therefore, any previous scale will be ignored. Default value is 1, use a value greater than one to increase or less than 1 to decrease the scale. Setting the scale to 2 means that objects will be scaled to twice their original size, whereas a value of 0.5 would scale objects to one half of their original size.

Parameters

x:Number — Scale on x
 
y:Number — Scale on y
 
z:Number — Scale on z
 
smooth:Number (default = 1)

setShadowsProperties()method 
public function setShadowsProperties(cast:Boolean = false, receive:Boolean = false, includeChildren:Boolean = true):void

Sets whether the object should cast and receive shadows.

Parameters

cast:Boolean (default = false) — true if the object should cast shadows, false otherwise.
 
receive:Boolean (default = false) — true if the object should receive shadows, false, otherwise.
 
includeChildren:Boolean (default = true) — true if all the hierarchy is to be included.

setStatic()method 
public function setStatic(value:Boolean, includeChildren:Boolean = true):void

Parameters

value:Boolean
 
includeChildren:Boolean (default = true)

setTranslation()method 
public function 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.

Parameters

x:Number (default = 0) — Distance in units to translate on X axis.
 
y:Number (default = 0) — Distance in units to translate on Y axis.
 
z:Number (default = 0) — Distance in units to translate on Z axis.
 
local:Boolean (default = true) — true to translate respecting current orientation or false to translate on the coordinates relative to the parent.

See also

translateX()
translateY()
translateZ()
translateAxis()
show()method 
public function show():void

Sets the visible property of this object and all its children recursively to true.

See also

visible
startDrag()method 
public function startDrag(lockCenter:Boolean = false, refPlaneNormal:Vector3D = null):void

Lets the user drag the specified Pivot3D. The Pivot3D remains draggable until explicitly stopped through a call to the Pivot3D.stopDrag() method, or until another Pivot3D is made draggable. Only one Pivot3D is draggable at a time.

Parameters

lockCenter:Boolean (default = false) — Locks the pivot center to the mouse coordinates whtn is set to true.
 
refPlaneNormal:Vector3D (default = null) — The reference plane normal in which the object will be moved. If null, the camera view plane is used.

stop()method 
public function stop(includeChildren:Boolean = true):void

Parameters

includeChildren:Boolean (default = true)

stopDrag()method 
public function stopDrag():void

Ends the startDrag() method. A Pivot3D that was made draggable with the startDrag() method remains draggable until a stopDrag() method is added, or until another Pivot3D becomes draggable. Only one Pivot3D is draggable at a time.

translateAxis()method 
public function translateAxis(distance:Number, axis:Vector3D):void

Translates the object on a certain axis from its current position.

Parameters

distance:Number — Distance to translate.
 
axis:Vector3D — Direction vector or axis on which to translate.

See also

translateX()
translateY()
translateZ()
setTranslation()
translateX()method 
public function translateX(distance:Number, local:Boolean = true):void

Translates the object on the X axis from its current position.

Parameters

distance:Number — Distance to translate.
 
local:Boolean (default = true) — true to translate respecting current orientation, or false to translate on the coordinates relative to parent.

See also

setTranslation()
translateAxis()
translateY()method 
public function translateY(distance:Number, local:Boolean = true):void

Translates the object on the Y axis from its current position.

Parameters

distance:Number — Distance to translate.
 
local:Boolean (default = true) — true to translate respecting current orientation, or false to translate on the coordinates relative to parent.

See also

setTranslation()
translateAxis()
translateZ()method 
public function translateZ(distance:Number, local:Boolean = true):void

Translates the object on the Z axis from its current position.

Parameters

distance:Number — Distance to translate.
 
local:Boolean (default = true) — true to translate respecting current orientation, or false to translate on the coordinates relative to parent.

See also

setTranslation()
translateAxis()
update()method 
public function update():void

updateTransforms()method 
public function 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.

Parameters

includeChildren:Boolean (default = false) — true to include all the hierarchy.

upload()method 
public function upload(scene:Scene3D, includeChildren:Boolean = true):void

Parameters

scene:Scene3D
 
includeChildren:Boolean (default = true)

Event Detail
added Event
Event Object Type: flash.events.Event
Event.type property = flash.events.Event

This event occurs when the object is added to a scene or to any other object.

addedToScene Event  
Event Object Type: flash.events.Event
Event.type property = flash.events.Event

This event occurs when the object is added to a scene.

animationComplete Event  
Event Object Type: flash.events.Event
Event.type property = flash.events.Event

This event occurs at the end of an animation.

changeTransform Event  
Event Object Type: flash.events.Event
Event.type property = flash.events.Event

This event occurs whatever the object changes his position, rotation or scale.

enterDrag Event  
Event Object Type: flash.events.Event
Event.type property = flash.events.Event

This event occurs before drag the object.

enterDraw Event  
Event Object Type: flash.events.Event
Event.type property = flash.events.Event

This event occurs before draw the object.

enterFrame Event  
Event Object Type: flash.events.Event
Event.type property = flash.events.Event

This event occurs before entering any frame.

exitDrag Event  
Event Object Type: flash.events.Event
Event.type property = flash.events.Event

This event occurs after drag the object.

exitDraw Event  
Event Object Type: flash.events.Event
Event.type property = flash.events.Event

This event occurs after draw the object.

exitFrame Event  
Event Object Type: flash.events.Event
Event.type property = flash.events.Event

This event occurs after updating every frame.

removed Event  
Event Object Type: flash.events.Event
Event.type property = flash.events.Event

This event occurs when the object is removed from a scene or from any other object.

removedFromScene Event  
Event Object Type: flash.events.Event
Event.type property = flash.events.Event

This event occurs when the object is removed from a scene.

unload Event  
Event Object Type: flash.events.Event
Event.type property = flash.events.Event

This event occurs when the dispose method of the object itself or of a parent object is called.

Constant Detail
ADDED_EVENTConstant
public static const ADDED_EVENT:String = added

Defines the value for the 'added' event.

ADDED_TO_SCENE_EVENTConstant 
public static const ADDED_TO_SCENE_EVENT:String = addedToScene

Defines the value for the 'addedToScene' event.

ANIMATION_COMPLETE_EVENTConstant 
public static const ANIMATION_COMPLETE_EVENT:String = animationComplete

Defines the value for the 'animationComplete' event.

ANIMATION_LOOP_MODEConstant 
public static const ANIMATION_LOOP_MODE:int = 0

ANIMATION_PING_PONG_MODEConstant 
public static const ANIMATION_PING_PONG_MODE:int = 1

ANIMATION_SMOOTH_BESTConstant 
public static const ANIMATION_SMOOTH_BEST:int = 2

ANIMATION_SMOOTH_NONEConstant 
public static const ANIMATION_SMOOTH_NONE:int = 0

ANIMATION_SMOOTH_NORMALConstant 
public static const ANIMATION_SMOOTH_NORMAL:int = 1

ANIMATION_STOP_MODEConstant 
public static const ANIMATION_STOP_MODE:int = 2

ENTER_DRAG_EVENTConstant 
public static const ENTER_DRAG_EVENT:String = enterDrag

Defines the value for the 'enterDrag' event.

ENTER_DRAW_EVENTConstant 
public static const ENTER_DRAW_EVENT:String = enterDraw

Defines the value for the 'enterDraw' event.

ENTER_FRAME_EVENTConstant 
public static const ENTER_FRAME_EVENT:String = enterFrame

Defines the value for the 'enterFrame' event.

EXIT_DRAG_EVENTConstant 
public static const EXIT_DRAG_EVENT:String = exitDrag

Defines the value for the 'exitDrag' event.

EXIT_DRAW_EVENTConstant 
public static const EXIT_DRAW_EVENT:String = exitDraw

Defines the value for the 'exitDraw' event.

EXIT_FRAME_EVENTConstant 
public static const EXIT_FRAME_EVENT:String = exitFrame

Defines the value for the 'exitFrame' event.

REMOVED_EVENTConstant 
public static const REMOVED_EVENT:String = removed

Defines the value for the 'removed' event.

REMOVED_FROM_SCENE_EVENTConstant 
public static const REMOVED_FROM_SCENE_EVENT:String = removedFromScene

Defines the value for the 'removedFromScene' event.

SORT_CENTERConstant 
public static const SORT_CENTER:int = 1

SORT_FARConstant 
public static const SORT_FAR:int = 4

SORT_NEARConstant 
public static const SORT_NEAR:int = 2

SORT_NONEConstant 
public static const SORT_NONE:int = 0

UNLOAD_EVENTConstant 
public static const UNLOAD_EVENT:String = unload

Defines the value for the 'unload' event.

UPDATE_TRANSFORM_EVENTConstant 
public static const UPDATE_TRANSFORM_EVENT:String = updateTransform

Defines the value for the 'updateTransform' event.





Fri Dec 5 2014, 10:51 AM -06:00