Packagesandy.core.scenegraph
Classpublic class StarField
InheritanceStarField Inheritance ATransformable Inheritance Node
ImplementsIDisplayable

The StarField class renders dense star field at reasonable FPS.



Public Properties
 PropertyDefined by
 Inheritedappearance : Appearance
Set that appearance to all the children of that node
Node
 InheritedboundingBox : BBox
The bounding box of this node IMPORTANT: Do not modify it unless you perfectly know what you are doing
Node
 InheritedboundingSphere : BSphere
The bounding sphere of this node IMPORTANT: Do not modify it unless you perfectly know what you are doing
Node
 Inheritedbroadcaster : BubbleEventBroadcaster
The broadcaster

The broadcaster is used to send events to listeners.
This property is a BubbleEventBroadcaster.

Node
 Inheritedchanged : Boolean = false
This property set the cache status of the current node.
Node
  container : Sprite
[read-only] The container of this object
StarField
 Inheritedculled : CullingState
This property represent the culling state of the current node.
Node
  depth : Number
The depth to draw the starfield at.
StarField
  depthIndex : int = -1
An index in stars array; if set to valid value, depth returns distance to that star.
StarField
 Inheriteddisable : Boolean = false
Disable the local transformations applied to this Node if set to false.
ATransformable
 InheritedenableBackFaceCulling : Boolean
Change the backface culling state to all the shapes objects in the children list
Node
 InheritedenableEvents : Boolean
Enable event handling to all the children objects that can broadcast bubbling events
Node
 InheritedenableInteractivity : Boolean
Change the interactivity of all the children
Node
  fadeFrom : Number = 0
Distance from screen where stars start to fade out
StarField
  fadeTo : Number = 1000
Distance from fadeFrom to the point where stars fade out completely
StarField
 Inheritedmatrix : Matrix4
ATransformable
 Inheritedname : String
Name of this node.
Node
 Inheritedout : Vector
Forward direction ( local z ) in parent coordinates.
ATransformable
 Inheritedpan : Number
Pans this object around the local y axis.
ATransformable
 Inheritedparent : Node
The parent node of this node.
Node
 Inheritedroll : Number
Rolls this object around the local z axis.
ATransformable
 InheritedrotateX : Number
Rotates this object around an axis parallel to the parents x axis.
ATransformable
 InheritedrotateY : Number
Rotates this object around an axis parallel to the parents y axis.
ATransformable
 InheritedrotateZ : Number
Rotates this object around an axis paralell to the parents z axis.
ATransformable
 InheritedscaleX : Number
x scale of this object.
ATransformable
 InheritedscaleY : Number
y scale of this object.
ATransformable
 InheritedscaleZ : Number
z scale of this object.
ATransformable
 Inheritedscene : Scene3D = null
Reference to the scene is it linked to.
Node
 Inheritedside : Vector
Side direction ( local x ) in parent coordinates.
ATransformable
  starColors : Array
Array of star colors (if not specified, white is used).
StarField
  stars : Array
Array of Vertex - star coordinates data.
StarField
  starSprites : Array
Array of star sprites (any IBitmapDrawable-s; if not specified, StarField uses setPixel to draw a star).
StarField
 Inheritedtarget : Vector
The position in the parent frame this object should "look at".
ATransformable
 Inheritedtilt : Number
Tilts this object around the local x axis.
ATransformable
 Inheritedup : Vector
Up direction ( local y ) in parent coordinates.
ATransformable
 InheriteduseSingleContainer : Boolean
Make all the Shape3D and descendants children react to this value.
Node
 Inheritedvisible : Boolean = true
Specify the visibility of this node.
Node
 Inheritedx : Number
x position of this object in its parent frame.
ATransformable
 Inheritedy : Number
y position of this object in its parent frame.
ATransformable
 Inheritedz : Number
z position of the node in its parent frame.
ATransformable
Protected Properties
 PropertyDefined by
 Inheritedm_oEB : BubbleEventBroadcaster
Node
 Inheritedm_oPreviousOffsetRotation : Vector
ATransformable
 Inheritedm_tmpMt : Matrix4
ATransformable
 Inherited_oScale : Vector
ATransformable
 Inherited_p : Vector
ATransformable
 Inherited_vOut : Vector
ATransformable
 Inherited_vSide : Vector
ATransformable
 Inherited_vUp : Vector
ATransformable
Public Methods
 MethodDefined by
  
StarField(p_sName:String = "")
Creates a StarField.
StarField
 Inherited
addChild(p_oChild:Node):void
Adds a new child to this node.
Node
 Inherited
addEventListener(p_sEvt:String, p_oL:*):void
Adds a listener for the specified event.
Node
  
clear():void
Clearing is done in render() method.
StarField
  
cull(p_oScene:Scene3D, p_oFrustum:Frustum, p_oViewMatrix:Matrix4, p_bChanged:Boolean):void
This tests for stars visibility.
StarField
 Inherited
destroy():void
Delete this node and all its child nodes.
Node
  
display(p_oScene:Scene3D, p_oContainer:Sprite = null):void
Displays the starfield.
StarField
 Inherited
getChildByName(p_sName:String, p_bRecurs:Boolean = false):Node
Returns the child node with the specified name.
Node
 Inherited
getPosition(p_sMode:String = "local"):Vector
Returns the position of this group or object.
ATransformable
 Inherited
hasParent():Boolean
Tests if this node has a parent.
Node
 Inherited
initFrame():void
Initiates the local coordinate system for this object.
ATransformable
 Inherited
isParent(p_oNode:Node):Boolean
Tests if the node passed in the argument is parent of this node.
Node
 Inherited
lookAt(p_nX:Number, p_nY:Number, p_nZ:Number):void
Makes this object "look at" the specified position in the parent frame.
ATransformable
 Inherited
moveForward(p_nD:Number):void
Translates this object along its forward vector ( local z ) in the parent frame.
ATransformable
 Inherited
moveHorizontally(p_nD:Number):void
Translates this object parallel to its parent zx plane and in its forward direction.
ATransformable
 Inherited
moveLateraly(p_nD:Number):void
Translates this object laterally in its parent frame.
ATransformable
 Inherited
moveSideways(p_nD:Number):void
Translates this object along its side vector ( local x ) in the parent frame.
ATransformable
 Inherited
moveUpwards(p_nD:Number):void
Translates this object along its up vector ( local y ) in the parent frame.
ATransformable
 Inherited
moveVertically(p_nD:Number):void
Translates this object vertically in ots parent frame.
ATransformable
 Inherited
perform(p_iOperation:INodeOperation):void
Performs an operation on this node and all of its children.
Node
  
remove():void
Provide the classical remove behaviour, plus remove the container to the display list.
StarField
 Inherited
removeChildByName(p_sName:String):Boolean
Removes the child node with the specified name.
Node
 Inherited
removeEventListener(p_sEvt:String, p_oL:*):void
Removes a listener for the specified event.
Node
  
render(p_oScene:Scene3D, p_oCamera:Camera3D):void
Renders the starfield
StarField
 Inherited
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
 Inherited
setPosition(p_nX:Number, p_nY:Number, p_nZ:Number):void
Sets the position of this object in coordinates of its parent frame.
ATransformable
 Inherited
swapParent(p_oNewParent:Node):void
Moves this node to another parent node.
Node
 Inherited
toString():String
Returns a string representation of this object
ATransformable
 Inherited
translate(p_nX:Number, p_nY:Number, p_nZ:Number):void
Translate this object from it's current position with the specified offsets.
ATransformable
 Inherited
update(p_oScene:Scene3D, p_oModelMatrix:Matrix4, p_bChanged:Boolean):void
Updates this node or object.
ATransformable
 Inherited
Updates the transform matrix of the current object/node before it is rendered.
ATransformable
Public Constants
 ConstantDefined by
 Inheritedchildren : Array
The children of this node are stored inside this array.
Node
 Inheritedid : uint
The unique id of this node in the node graph.
Node
 InheritedmodelMatrix : Matrix4
Cached matrix corresponding to the transformation to the 0,0,0 frame system
Node
 InheritedviewMatrix : Matrix4
Cached matrix corresponding to the transformation to the camera frame system
Node
Property detail
containerproperty
container:Sprite  [read-only]

The container of this object

Implementation
    public function get container():Sprite
depthproperty 
depth:Number  [read-write]

The depth to draw the starfield at. If depthIndex is set to valid value, depth returns distance to that star, otherwise value set by user (default: 1e10).

Implementation
    public function get depth():Number
    public function set depth(value:Number):void
depthIndexproperty 
public var depthIndex:int = -1

An index in stars array; if set to valid value, depth returns distance to that star.

fadeFromproperty 
public var fadeFrom:Number = 0

Distance from screen where stars start to fade out

fadeToproperty 
public var fadeTo:Number = 1000

Distance from fadeFrom to the point where stars fade out completely

starColorsproperty 
public var starColors:Array

Array of star colors (if not specified, white is used).

starsproperty 
public var stars:Array

Array of Vertex - star coordinates data.

starSpritesproperty 
public var starSprites:Array

Array of star sprites (any IBitmapDrawable-s; if not specified, StarField uses setPixel to draw a star).

Star sprites are affected by corresponding starColors value; for DisplayObject-s, StarField will use their blendMode to draw them.

Constructor detail
StarField()constructor
public function StarField(p_sName:String = "")

Creates a StarField.

Parameters
p_sName:String (default = "") — A string identifier for this object
Method detail
clear()method
public function clear():void

Clearing is done in render() method.

cull()method 
public override function cull(p_oScene:Scene3D, p_oFrustum:Frustum, p_oViewMatrix:Matrix4, p_bChanged:Boolean):void

This tests for stars visibility.

Parameters
p_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):void

Displays the starfield.

Parameters
p_oScene:Scene3D — The current scene
 
p_oContainer:Sprite (default = null) — The container to draw on
remove()method 
public override function remove():void

Provide the classical remove behaviour, plus remove the container to the display list.

render()method 
public override function render(p_oScene:Scene3D, p_oCamera:Camera3D):void

Renders the starfield

Parameters
p_oScene:Scene3D — The current scene
 
p_oCamera:Camera3D — The current camera