Packagealternativa.engine3d.objects
Classpublic class Sprite3D
InheritanceSprite3D Inheritance Object3D Inheritance Object
Subclasses AnimSprite

Sprite3D is a flat Object3D always turned in to the camera.



Public Properties
 PropertyDefined By
  alwaysOnTop : Boolean = false
If true, Sprite3D will drawn over all the rest objects which uses z-buffer sorting.
Sprite3D
 InheritedboundBox : BoundBox
Bounds of the object described as rectangular parallelepiped.
Object3D
 InheritedconcatenatedMatrix : Matrix3D
[read-only] A Matrix3D object representing the combined transformation matrices of the Object3D and all of its parent objects, back to the root level.
Object3D
 InheriteddoubleClickEnabled : Boolean = false
Specifies whether the object receives doubleClick events.
Object3D
 InheritedexcludedLights : Vector.<Light3D>
[read-only] Returns excluded lights list of current object.
Object3D
  height : Number
Height.
Sprite3D
  material : Material
Material of the Sprite3D.
Sprite3D
 Inheritedmatrix : Matrix3D
The matrix property represents a transformation matrix that determines the position and orientation of an Object3D.
Object3D
 InheritedmouseChildren : Boolean = true
Determines whether or not the children of the object are mouse, or user input device, enabled.
Object3D
 InheritedmouseEnabled : Boolean = true
Specifies whether this object receives mouse, or other user input, messages.
Object3D
 Inheritedname : String
Name of the object.
Object3D
 InheritednumChildren : int
[read-only] Returns the number of children of this object.
Object3D
  originX : Number = 0.5
Horizontal coordinate in the Sprite3D plane which defines what part of the plane will placed in x = 0 of the Sprite3D object.
Sprite3D
  originY : Number = 0.5
Vertical coordinate in the Sprite3D plane which defines what part of the plane will placed in y = 0 of the Sprite3D object.
Sprite3D
 Inheritedparent : Object3D
[read-only] Object3D, to which this object was added as a child.
Object3D
  perspectiveScale : Boolean = true
If true, screen size of a Sprite3D will have perspective correction according to distance to a camera.
Sprite3D
  rotation : Number = 0
Rotation in the screen plane, defines in radians.
Sprite3D
 InheritedrotationX : Number
The angle of rotation of Object3D around the X-axis expressed in radians.
Object3D
 InheritedrotationY : Number
The angle of rotation of Object3D around the Y-axis expressed in radians.
Object3D
 InheritedrotationZ : Number
The angle of rotation of Object3D around the Z-axis expressed in radians.
Object3D
 InheritedscaleX : Number
The scale of the Object3D along the X-axis.
Object3D
 InheritedscaleY : Number
The scale of the Object3D along the Y-axis.
Object3D
 InheritedscaleZ : Number
The scale of the Object3D along the Z-axis.
Object3D
 InheriteduseHandCursor : Boolean
A Boolean value that indicates whether the pointing hand (hand cursor) appears when the pointer rolls over a Object3D.
Object3D
 InheriteduserData : Object
Custom data available to store within Object3D by user.
Object3D
 Inheritedvisible : Boolean = true
Whether or not the display object is visible.
Object3D
  width : Number
Width.
Sprite3D
 Inheritedx : Number
X coordinate.
Object3D
 Inheritedy : Number
Y coordinate.
Object3D
 Inheritedz : Number
Z coordinate.
Object3D
Public Methods
 MethodDefined By
  
Sprite3D(width:Number, height:Number, material:Material = null)
Creates a new Sprite3D instance.
Sprite3D
 Inherited
Adds given Object3D instance as a child to the end of this Object3D's children list.
Object3D
 Inherited
addChildAt(child:Object3D, index:int):Object3D
Adds a child Object3D instance to this Object3D instance.
Object3D
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event.
Object3D
 Inherited
Calculates object's bounds in its own coordinates
Object3D
 Inherited
clearExcludedLights(updateChildren:Boolean = false):void
Resets list of lights excluded from lighting this object.
Object3D
  
[override] Returns a copy of object.
Sprite3D
 Inherited
contains(child:Object3D):Boolean
Check if given object is child of this Object3D.
Object3D
 Inherited
dispatchEvent(event:Event):Boolean
Dispatches an event into the event flow.
Object3D
 Inherited
excludeLight(light:Light3D, updateChildren:Boolean = false):void
Disables lighting of the object by given light.
Object3D
 Inherited
getChildAt(index:int):Object3D
Returns the child Object3D instance that exists at the specified index.
Object3D
 Inherited
Returns child Object3D instance with given name.
Object3D
 Inherited
Returns index of given child Object3D instance.
Object3D
 Inherited
getResources(hierarchy:Boolean = false, resourceType:Class = null):Vector.<Resource>
Gather the resources of this Object3D.
Object3D
 Inherited
globalToLocal(point:Vector3D):Vector3D
Converts the Vector3D object from the root Object3D (global) coordinates to the local Object3D's own coordinates.
Object3D
 Inherited
hasEventListener(type:String):Boolean
Checks whether the EventDispatcher object has any listeners registered for a specific type of event.
Object3D
 Inherited
intersectRay(origin:Vector3D, direction:Vector3D):RayIntersectionData
Searches for the intersection of an Object3D and given ray, defined by origin and direction.
Object3D
 Inherited
localToGlobal(point:Vector3D):Vector3D
Converts the Vector3D object from the Object3D's own (local) coordinates to the root Object3D (global) coordinates.
Object3D
 Inherited
Removes the specified child Object3D instance from the child list of the this Object3D instance.
Object3D
 Inherited
Removes a child Object3D from the specified index position in the child list of the Object3D.
Object3D
 Inherited
removeChildren(beginIndex:int = 0, endIndex:int = 2147483647):void
Removes child objects in given range of indexes.
Object3D
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Removes a listener from the EventDispatcher object.
Object3D
 Inherited
setChildIndex(child:Object3D, index:int):void
Sets index for child Object3D instance.
Object3D
 Inherited
swapChildren(child1:Object3D, child2:Object3D):void
Swaps index positions of two specified child objects.
Object3D
 Inherited
swapChildrenAt(index1:int, index2:int):void
Swaps index positions of two child objects by its index.
Object3D
 Inherited
toString():String
Returns the string representation of the specified object.
Object3D
 Inherited
willTrigger(type:String):Boolean
Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type.
Object3D
Protected Methods
 MethodDefined By
  
[override] Copies basic properties of Object3D.
Sprite3D
Events
 Event Summary Defined By
 InheritedDispatches when an Object3D is added as a child to another Object3D.Object3D
 InheritedDispatched when a user presses and releases the main button of the user's pointing device over the same Object3D.Object3D
 InheritedDispatched when a user presses and releases the main button of a pointing device twice in rapid succession over the same Object3D.Object3D
 InheritedDispatched when a user presses and releases the middle button of the user's pointing device over the same Object3D.Object3D
 InheritedDispatched when a user presses the middle pointing device button over an Object3D instance.Object3D
 InheritedDispatched when a user releases the pointing device button over an Object3D instance.Object3D
 InheritedDispatched when a user presses the pointing device button over an Object3D instance.Object3D
 InheritedDispatched when a user moves the pointing device while it is over an Object3D.Object3D
 InheritedDispatched when the user moves a pointing device away from an Object3D instance.Object3D
 InheritedDispatched when the user moves a pointing device over an Object3D instance.Object3D
 InheritedDispatched when a user releases the pointing device button over an Object3D instance.Object3D
 InheritedDispatched when a mouse wheel is spun over an Object3D instance.Object3D
 InheritedDispatched when a Object3D is about to be removed from the children list.Object3D
 InheritedDispatched when a user presses and releases the right button of the user's pointing device over the same Object3D.Object3D
 InheritedDispatched when a user presses the right pointing device button over an Object3D instance.Object3D
 InheritedDispatched when a user releases the pointing device button over an Object3D instance.Object3D
 InheritedDispatched when the user moves a pointing device away from an Object3D instance.Object3D
 InheritedDispatched when the user moves a pointing device over an Object3D instance.Object3D
Property Detail
alwaysOnTopproperty
public var alwaysOnTop:Boolean = false

If true, Sprite3D will drawn over all the rest objects which uses z-buffer sorting.

heightproperty 
public var height:Number

Height.

materialproperty 
material:Material

Material of the Sprite3D.


Implementation
    public function get material():Material
    public function set material(value:Material):void

See also

originXproperty 
public var originX:Number = 0.5

Horizontal coordinate in the Sprite3D plane which defines what part of the plane will placed in x = 0 of the Sprite3D object. The dimension considered with UV-coordinates. Thus, if originX = 0, image will drawn from 0 to the right, if originX = -1 – to the left. And image will drawn in the center of the Sprite3D, if originX = 0.5.

originYproperty 
public var originY:Number = 0.5

Vertical coordinate in the Sprite3D plane which defines what part of the plane will placed in y = 0 of the Sprite3D object. The dimension considered with UV-coordinates. Thus, if originY = 0, image will drawn from 0 to the bottom, if originY = -1 – to the top. And image will drawn in the center of the Sprite3D, if originY = 0.5.

perspectiveScaleproperty 
public var perspectiveScale:Boolean = true

If true, screen size of a Sprite3D will have perspective correction according to distance to a camera. Otherwise Sprite3D will have fixed size with no dependence on point of view.

rotationproperty 
public var rotation:Number = 0

Rotation in the screen plane, defines in radians.

widthproperty 
public var width:Number

Width.

Constructor Detail
Sprite3D()Constructor
public function Sprite3D(width:Number, height:Number, material:Material = null)

Creates a new Sprite3D instance.

Parameters
width:Number — Width.
 
height:Number — Height
 
material:Material (default = null) — Material.

See also

Method Detail
clone()method
override public function clone():Object3D

Returns a copy of object.

Returns
Object3D — A copy of this Object3D.
clonePropertiesFrom()method 
override protected function clonePropertiesFrom(source:Object3D):void

Copies basic properties of Object3D. This method calls from clone() method.

Parameters

source:Object3DObject3D, properties of which will be copied.