| Package | sandy.core.scenegraph |
| Class | public class Sprite2D |
| Inheritance | Sprite2D  ATransformable Node |
| Implements | IDisplayable |
A Sprite2D object is used to display a static or dynamic texture in the Sandy world.
The sprite always shows the same side to the camera. This is useful when you want to show more
or less complex images, without heavy calculations of perspective distortion.
The Sprite2D has a fixed bounding sphere radius, set by default to 30.
In case your sprite is bigger, you can adjust it to avoid any frustum culling issue
| Property | Defined by | ||
|---|---|---|---|
| autoCenter : Boolean = true
When enabled, the sprite will be displayed at its graphical center.
| Sprite2D | ||
 | boundingBox : BBox
The bounding box of this node
IMPORTANT: Do not modify it unless you perfectly know what you are doing
| Node | |
| boundingSphere : BSphere
The bounding sphere of this node
IMPORTANT: Do not modify it unless you perfectly know what you are doing
| Node | |
| broadcaster : BubbleEventBroadcaster
The broadcaster
The broadcaster is used to send events to listeners. | Node | |
| changed : Boolean = false
This property set the cache status of the current node.
| Node | |
| children : Array
The children of this node are stored inside this array.
| Node | |
| container : Sprite [read-only]
The container of this sprite ( canvas )
| Sprite2D | ||
| content : DisplayObject
Get the content DisplayObject reference
| Sprite2D | ||
| culled : CullingState
This property represent the culling state of the current node.
| Node | |
| depth : Number [read-only]
The depth to draw this sprite at.
| Sprite2D | ||
| disable : Boolean = false
Disable the local transformations applied to this Node if set to false.
| ATransformable | |
| matrix : Matrix4 | ATransformable | |
| modelMatrix : Matrix4
Cached matrix corresponding to the transformation to the 0,0,0 frame system
| Node | |
| name : String
Name of this node.
| Node | |
| out : Vector
Forward direction ( local z ) in parent coordinates.
| ATransformable | |
| pan : Number
Pans this object around the local y axis.
| ATransformable | |
| parent : Node
The parent node of this node.
| Node | |
| roll : Number
Rolls this object around the local z axis.
| ATransformable | |
| rotateX : Number
Rotates this object around an axis parallel to the parents x axis.
| ATransformable | |
| rotateY : Number
Rotates this object around an axis parallel to the parents y axis.
| ATransformable | |
| rotateZ : Number
Rotates this object around an axis paralell to the parents z axis.
| ATransformable | |
| scale : Number
The scale of this sprite.
| Sprite2D | ||
| scaleX : Number
x scale of this object.
| ATransformable | |
| scaleY : Number
y scale of this object.
| ATransformable | |
| scaleZ : Number
z scale of this object.
| ATransformable | |
| scene : Scene3D = null
Reference to the scene is it linked to.
| Node | |
| side : Vector
Side direction ( local x ) in parent coordinates.
| ATransformable | |
| target : Vector
The position in the parent frame this object should "look at".
| ATransformable | |
| tilt : Number
Getter for the tilt value
| ATransformable | |
| up : Vector
Up direction ( local y ) in parent coordinates.
| ATransformable | |
| viewMatrix : Matrix4
Cached matrix corresponding to the transformation to the camera frame system
| Node | |
| visible : Boolean = true
Specify the visibility of this node.
| Node | |
| x : Number
x position of this object in its parent frame.
| ATransformable | |
| y : Number
y position of this object in its parent frame.
| ATransformable | |
| z : Number
z position of the node in its parent frame.
| ATransformable | |
| Property | Defined by | ||
|---|---|---|---|
| m_oEB : BubbleEventBroadcaster | Node | |
| m_oPreviousOffsetRotation : Vector | ATransformable | |
| m_tmpMt : Matrix4 | ATransformable | |
| _oScale : Vector | ATransformable | |
| _p : Vector | ATransformable | |
| _v : Vertex | Sprite2D | ||
| _vOut : Vector | ATransformable | |
| _vSide : Vector | ATransformable | |
| _vUp : Vector | ATransformable | |
| Method | Defined by | ||
|---|---|---|---|
|
Sprite2D(p_sName:String = "", p_oContent:DisplayObject = null, p_nScale:Number = 1)
Creates a Sprite2D.
| Sprite2D | ||
|
Adds a new child to this node.
| Node | |
|
addEventListener(p_sEvt:String, p_oL:*):void
Adds a listener for the specified event.
| Node | |
|
clear():void
Clears the graphics object of this object's container.
| Sprite2D | ||
|
Tests this node against the camera frustum to get its visibility.
| Sprite2D | ||
|
destroy():void
Delete this node and all its child nodes.
| Node | |
|
Displays this sprite.
| Sprite2D | ||
|
getChildByName(p_sName:String, p_bRecurs:Boolean = false):Node
Returns the child node with the specified name.
| Node | |
|
getChildFromId(p_nId:uint, p_bRecurs:Boolean = false):Node
Returns the child node with the specified id.
| Node | |
|
getChildList():Array
Returns an array with all child nodes of this node.
| Node | |
|
getPosition(p_sMode:String = "local"):Vector
Returns the position of this group or object.
| ATransformable | |
|
hasParent():Boolean
Tests if this node has a parent.
| Node | |
|
initFrame():void
Initiates the local coordinate system for this object.
| ATransformable | |
|
Tests if the node passed in the argument is parent of this node.
| Node | |
|
lookAt(p_nX:Number, p_nY:Number, p_nZ:Number):void
Makes this object "look at" the specified position in the parent frame.
| ATransformable | |
|
moveForward(p_nD:Number):void
Translates this object along its forward vector ( local z ) in the parent frame.
| ATransformable | |
|
moveHorizontally(p_nD:Number):void
Translates this object parallel to its parent zx plane and in its forward direction.
| ATransformable | |
|
moveLateraly(p_nD:Number):void
Translates this object laterally in its parent frame.
| ATransformable | |
|
moveSideways(p_nD:Number):void
Translates this object along its side vector ( local x ) in the parent frame.
| ATransformable | |
|
moveUpwards(p_nD:Number):void
Translates this object along its up vector ( local y ) in the parent frame.
| ATransformable | |
|
moveVertically(p_nD:Number):void
Translates this object vertically in ots parent frame.
| ATransformable | |
|
remove():void
Provide the classical remove behaviour, plus remove the container to the display list.
| Sprite2D | ||
|
removeChildById(p_nId:Number):Boolean
Removes the child node with the specified id.
| Node | |
|
removeChildByName(p_sName:String):Boolean
Removes the child node with the specified name.
| Node | |
|
removeEventListener(p_sEvt:String, p_oL:*):void
Removes a listener for the specified event.
| Node | |
|
Renders this 2D sprite
| Sprite2D | ||
|
rotateAxis(p_nX:Number, p_nY:Number, p_nZ:Number, p_nAngle:Number):void
Rotate this object around the specified axis in the parent frame by the specified angle.
| ATransformable | |
|
setBoundingSphereRadius(p_nRadius:Number):void
Sets the radius of bounding sphere for this sprite.
| Sprite2D | ||
|
setPosition(p_nX:Number, p_nY:Number, p_nZ:Number):void
Sets the position of this object in coordinates of its parent frame.
| ATransformable | |
|
swapParent(p_oNewParent:Node):void
Moves this node to another parent node.
| Node | |
|
toString():String
Returns a string representation of this object
| ATransformable | |
|
translate(p_nX:Number, p_nY:Number, p_nZ:Number):void
Translate this object from it's current position with the specified offsets.
| ATransformable | |
|
Updates this node or object.
| ATransformable | |
|
updateTransform():void
Updates the transform matrix of the current object/node before it is rendered.
| ATransformable | |
| autoCenter | property |
Hide Inherited Public Properties
Show Inherited Public Propertiespublic var autoCenter:Boolean = trueWhen enabled, the sprite will be displayed at its graphical center. Otherwise its top left corner will be set at the computed screen position
| container | property |
container:Sprite [read-only]The container of this sprite ( canvas )
Implementation public function get container():Sprite
| content | property |
content:DisplayObject [read-write]Get the content DisplayObject reference
Implementation public function get content():DisplayObject
public function set content(value:DisplayObject):void
| depth | property |
depth:Number [read-only]The depth to draw this sprite at.
[ToDo: Explain ]
Implementation public function get depth():Number
| scale | property |
scale:Number [read-write]The scale of this sprite.
Using scale, you can change the dimension of the sprite rapidly.
Implementation public function get scale():Number
public function set scale(value:Number):void
| _v | property |
protected var _v:Vertex
| Sprite2D | () | constructor |
public function Sprite2D(p_sName:String = "", p_oContent:DisplayObject = null, p_nScale:Number = 1)Creates a Sprite2D.
Parametersp_sName:String (default = " |
|
p_oContent:DisplayObject (default = null) |
|
p_nScale:Number (default = 1) |
| clear | () | method |
public function clear():voidClears the graphics object of this object's container.
The the graphics that were drawn on the Graphics object is erased, and the fill and line style settings are reset.
| cull | () | method |
public override function cull(p_oScene:Scene3D, p_oFrustum:Frustum, p_oViewMatrix:Matrix4, p_bChanged:Boolean):voidTests this node against the camera frustum to get its visibility.
If this node and its children are not within the frustum, the node is set to cull and it would not be displayed.
The method also updates the bounding volumes to make the more accurate culling system possible.
First the bounding sphere is updated, and if intersecting,
the bounding box is updated to perform the more precise culling.
[MANDATORY] The update method must be called first!
Parametersp_oScene:Scene3D — The current scene
|
|
p_oFrustum:Frustum — The frustum of the current camera
|
|
p_oViewMatrix:Matrix4 — The view martix of the curren camera
|
|
p_bChanged:Boolean |
| display | () | method |
public function display(p_oScene:Scene3D, p_oContainer:Sprite = null):voidDisplays this sprite.
display the object onto the scene. If the object has autocenter enabled, sprite center is set at screen position. Otherwise the sprite top left corner will be at that position.
Parametersp_oScene:Scene3D — The current scene
|
|
p_oContainer:Sprite (default = null) |
| remove | () | method |
public override function remove():voidProvide the classical remove behaviour, plus remove the container to the display list.
| render | () | method |
public override function render(p_oScene:Scene3D, p_oCamera:Camera3D):voidRenders this 2D sprite
Parametersp_oScene:Scene3D — The current scene
|
|
p_oCamera:Camera3D — The current camera
|
| setBoundingSphereRadius | () | method |
public function setBoundingSphereRadius(p_nRadius:Number):voidSets the radius of bounding sphere for this sprite.
Parametersp_nRadius:Number — The radius
|