Packageorg.papervision3d.cameras
Classpublic class FrustumCamera3D
InheritanceFrustumCamera3D Inheritance CameraObject3D Inheritance DisplayObject3D Inheritance DisplayObjectContainer3D Inheritance flash.events.EventDispatcher
ImplementsIObjectCuller



Public Properties
 PropertyDefined by
 Inheritedchildren : Object
Returns the children object.
DisplayObjectContainer3D
 InheritedcontainerBlendMode : int
DisplayObject3D
 InheritedcontainerSortMode : int
DisplayObject3D
 Inheritedculled : Boolean
[internal use] Is this object culled by camera frustum?
DisplayObject3D
 InheritedDEFAULT_POS : Number3D
[static] The default position for new cameras.
CameraObject3D
 Inheritedextra : Object
An object that contains user defined properties.
DisplayObject3D
 Inheritedeye : Matrix3D
CameraObject3D
 InheritedfaceLevelMode : Boolean
[static] This allows objects faces to have their own containers.
DisplayObject3D
 Inheritedfaces : Array
[internal-use]
DisplayObject3D
  far : Number
Gets or sets the distance to far plane.
FrustumCamera3D
 Inheritedfilters : Array
DisplayObject3D
 Inheritedfocus : Number
This value is a positive number representing the distance of the observer from the front clipping plane, which is the closest any object can be to the camera.
CameraObject3D
  fov : Number
Gets or sets the field of view in degrees.
FrustumCamera3D
 Inheritedgeometry : GeometryObject3D
The GeometryObject3D object that contains the 3D definition of this instance.
DisplayObject3D
 Inheritedid : int
[read-only] Unique id of this instance.
DisplayObject3D
 Inheritedmaterial : MaterialObject3D
DisplayObject3D
 Inheritedmaterials : MaterialsList
The list of materials for this instance.
DisplayObject3D
 InheritedmeshSort : uint = 1
tells Mesh3D's render() method to compare the measurement choice of the user for a triangle's sorting
DisplayObject3D
 Inheritedname : String
An optional object name.
DisplayObject3D
  near : Number
Gets or sets the distance to near plane (positive number).
FrustumCamera3D
 InheritednumChildren : int
Returns the number of children of this object.
DisplayObjectContainer3D
 Inheritedparent : DisplayObjectContainer3D
[read-only] Indicates the DisplayObjectContainer3D object that contains this display object.
DisplayObject3D
  planes : Array
frustum planes
FrustumCamera3D
  _projection : Matrix3D
projection matrix
FrustumCamera3D
  projection : uint
Gets or sets the projection type
FrustumCamera3D
 Inheritedroot : DisplayObjectContainer3D
[read-only] [read-only] The scene, which is the top-most displayObjectContainer3D in the tree structure.
DisplayObjectContainer3D
 InheritedrotationX : Number
Specifies the rotation around the X axis from its original orientation.
DisplayObject3D
 InheritedrotationY : Number
Specifies the rotation around the Y axis from its original orientation.
DisplayObject3D
 InheritedrotationZ : Number
Specifies the rotation around the Z axis from its original orientation.
DisplayObject3D
 Inheritedscale : Number
Sets the 3D scale as applied from the registration point of the object.
DisplayObject3D
 InheritedscaleX : Number
Sets the scale along the local X axis as applied from the registration point of the object.
DisplayObject3D
 InheritedscaleY : Number
Sets the scale along the local Y axis as applied from the registration point of the object.
DisplayObject3D
 InheritedscaleZ : Number
Sets the scale along the local Z axis as applied from the registration point of the object.
DisplayObject3D
 Inheritedscene : SceneObject3D
DisplayObject3D
 InheritedsceneX : Number
The X coordinate of a object relative to the scene coordinate system.
DisplayObject3D
 InheritedsceneY : Number
The Y coordinate of a object relative to the scene coordinate system.
DisplayObject3D
 InheritedsceneZ : Number
The Z coordinate of a object relative to the scene coordinate system.
DisplayObject3D
 Inheritedscreen : Number3D
[read-only] The coordinate of the object on screen.
DisplayObject3D
 InheritedscreenZ : Number
[internal-use] The average depth of the object faces center.
DisplayObject3D
 Inheritedsort : Boolean
A Boolean value that determines whether the 3D objects are z-depth sorted between themselves when rendering.
CameraObject3D
 InheritedsortedArray : Array
[static]
DisplayObject3D
 Inheritedtransform : Matrix3D
A Matrix3D object containing values that affect the scaling, rotation, and translation of the display object.
DisplayObject3D
 InheriteduseOwnContainer : Boolean
DisplayObject3D
 Inheritedview : Matrix3D
[internal-use] A camera transformed Matrix3D object.
DisplayObject3D
 Inheritedviewport : Rectangle
CameraObject3D
  viewport3D : Viewport3D
FrustumCamera3D
 Inheritedvisible : Boolean
Whether or not the display object is visible.
DisplayObject3D
 Inheritedworld : Matrix3D
World transformation.
DisplayObject3D
 Inheritedx : Number
An Number that sets the X coordinate of a object relative to the origin of its parent.
DisplayObject3D
 Inheritedy : Number
An Number that sets the Y coordinate of a object relative to the origin of its parent.
DisplayObject3D
 Inheritedz : Number
An Number that sets the Z coordinate of a object relative to the origin of its parent.
DisplayObject3D
 InheritedZERO : DisplayObject3D
[static] Returns an empty DiplayObject3D object positioned in the center of the 3D coordinate system (0, 0 ,0).
DisplayObject3D
 Inheritedzoom : Number
This value specifies the scale at which the 3D objects are rendered.
CameraObject3D
Protected Properties
 PropertyDefined by
 Inherited_children : Dictionary
[internal-use] Names indexed by children.
DisplayObjectContainer3D
 Inherited_childrenByName : Object
[internal-use] Children indexed by name.
DisplayObjectContainer3D
 Inherited_containerBlendMode : int
DisplayObject3D
 Inherited_containerSortMode : int
DisplayObject3D
 Inherited_filters : Array
DisplayObject3D
 Inherited_scene : SceneObject3D = null
The scene where the object belongs.
DisplayObject3D
 Inherited_sorted : Array
DisplayObject3D
 Inherited_transformDirty : Boolean = false
[internal-use]
DisplayObject3D
 Inherited_useOwnContainer : Boolean
DisplayObject3D
Public Methods
 MethodDefined by
  
FrustumCamera3D(viewport3D:Viewport3D, fov:Number = 90, near:Number = 10, far:Number = 2000)
Constructor.
FrustumCamera3D
 Inherited
addChild(child:DisplayObject3D, name:String = null):DisplayObject3D
Adds a child DisplayObject3D instance to this DisplayObjectContainer instance.
DisplayObject3D
 Inherited
Adds all the children of a DisplayObject3D instance to this DisplayObjectContainer instance.
DisplayObjectContainer3D
 Inherited
addCollada(filename:String, materials:MaterialsList = null, scale:Number = 1):void
This method has been deprecated.
DisplayObjectContainer3D
 Inherited
addGeometry(geometry:GeometryObject3D = null):void
Adds a geometry definition to the instance.
DisplayObject3D
 Inherited
childrenList():String
Returns a string value with the list of objects.
DisplayObjectContainer3D
 Inherited
copyPosition(reference:*):void
Copies the position information (x, y and z coordinates) from another object or Matrix3D.
DisplayObject3D
 Inherited
copyTransform(reference:*):void
Copies the transformation information (position, rotation and scale) from another object or Matrix3D.
DisplayObject3D
  
createOrthoMatrix(left:Number, right:Number, bottom:Number, top:Number, near:Number, far:Number):Matrix3D
[static] Creates a transformation that produces a parallel projection.
FrustumCamera3D
  
createPerspectiveMatrix(fov:Number, aspect:Number, near:Number, far:Number):Matrix3D
[static] Creates a transformation that produces a perspective projection.
FrustumCamera3D
 Inherited
Gets the distance to the position of the given object.
DisplayObject3D
  
Extract the frustum planes.
FrustumCamera3D
 Inherited
Returns the child display object that exists with the specified name.
DisplayObjectContainer3D
 Inherited
Returns the material that exists with the specified name in the materials list.
DisplayObject3D
 Inherited
hitTestObject(obj:DisplayObject3D, multiplier:Number = 1):Boolean
Evaluates the display object to see if it overlaps or intersects with the obj display object.
DisplayObject3D
 Inherited
hitTestPoint(x:Number, y:Number, z:Number):Boolean
Evaluates the display object to see if it overlaps or intersects with the point specified by the x, y and z parameters.
DisplayObject3D
 Inherited
lookAt(targetObject:DisplayObject3D, upAxis:Number3D = null):void
Make the object look at a specific position.
DisplayObject3D
 Inherited
materialsList():String
Returns a string value with the list of material names of the materials list.
DisplayObject3D
 Inherited
moveBackward(distance:Number):void
Translate the display object in the opposite direction it is facing, i.e.
DisplayObject3D
 Inherited
moveDown(distance:Number):void
Translate the display object downwards, with respect to the direction it is facing, i.e.
DisplayObject3D
 Inherited
moveForward(distance:Number):void
Translate the display object in the direction it is facing, i.e.
DisplayObject3D
 Inherited
moveLeft(distance:Number):void
Translate the display object lateraly, to the left of the direction it is facing, i.e.
DisplayObject3D
 Inherited
moveRight(distance:Number):void
Translate the display object lateraly, to the right of the direction it is facing, i.e.
DisplayObject3D
 Inherited
moveUp(distance:Number):void
Translate the display object upwards, with respect to the direction it is facing, i.e.
DisplayObject3D
 Inherited
pan(angle:Number):void
Rotate the camera in its horizontal plane.
CameraObject3D
 Inherited
pitch(angle:Number):void
Rotate the display object around its lateral or transverse axis —an axis running from the pilot's left to right in piloted aircraft, and parallel to the wings of a winged aircraft; thus the nose pitches up and the tail down, or vice-versa.
DisplayObject3D
 Inherited
project(parent:DisplayObject3D, renderSessionData:RenderSessionData):Number
[internal-use] Projects three dimensional coordinates onto a two dimensional plane to simulate the relationship of the camera to subject.
DisplayObject3D
 Inherited
Removes the specified child DisplayObject3D instance from the child list of the DisplayObjectContainer3D instance.
DisplayObjectContainer3D
 Inherited
Removes the child DisplayObject3D instance that exists with the specified name, from the child list of the DisplayObjectContainer3D instance.
DisplayObjectContainer3D
 Inherited
roll(angle:Number):void
Rotate the display object around the longitudinal axis —an axis drawn through the body of the vehicle from tail to nose in the normal direction of flight, or the direction the object is facing.
DisplayObject3D
  
sphereInFrustum(center:Vertex3D, radius:Number):int
Checks whether a sphere is inside, outside or intersecting the frustum.
FrustumCamera3D
  
FrustumCamera3D
 Inherited
tilt(angle:Number):void
Rotate the camera in its vertical plane.
CameraObject3D
 Inherited
toString():String
Returns a string value representing the three-dimensional position values of the display object instance.
DisplayObject3D
  
transformView(trans:Matrix3D = null):void
[internal-use] Transforms world coordinates into camera space.
FrustumCamera3D
 Inherited
translate(distance:Number, axis:Number3D):void
Move the object along a given direction.
DisplayObject3D
 Inherited
yaw(angle:Number):void
Rotate the display object around about the vertical axis —an axis drawn from top to bottom.
DisplayObject3D
Protected Methods
 MethodDefined by
 Inherited
[internal-use] Updates the transform Matrix3D with the current rotation and scale values.
DisplayObject3D
Public Constants
 ConstantDefined by
  BOTTOM : uint = 4
[static]
FrustumCamera3D
  FAR : uint = 5
[static]
FrustumCamera3D
  INSIDE : int = 1
[static]
FrustumCamera3D
  INTERSECT : int = 0
[static]
FrustumCamera3D
  LEFT : uint = 1
[static]
FrustumCamera3D
 InheritedMESH_SORT_CENTER : uint = 1
[static] tells Mesh3D's render() method to sort by measuring from the center of a triangle
DisplayObject3D
 InheritedMESH_SORT_CLOSE : uint = 3
[static] tells Mesh3D's render() method to sort by measuring from the closest point of a triangle
DisplayObject3D
 InheritedMESH_SORT_FAR : uint = 2
[static] tells Mesh3D's render() method to sort by measuring from the farthest point of a triangle
DisplayObject3D
  NEAR : uint = 0
[static]
FrustumCamera3D
  ORTHO_PROJECTION : uint = 1
[static] constant used to set projection type.
FrustumCamera3D
  OUTSIDE : int = -1
[static]
FrustumCamera3D
  PERSPECTIVE_PROJECTION : uint = 0
[static] constant used to set projection type.
FrustumCamera3D
  RIGHT : uint = 2
[static]
FrustumCamera3D
  TOP : uint = 3
[static]
FrustumCamera3D
  TYPE : String = "FRUSTRUMCAMERA3D"
[static]
FrustumCamera3D
Property detail
farproperty
far:Number  [read-write]

Gets or sets the distance to far plane.

Implementation
    public function get far():Number
    public function set far(value:Number):void
fovproperty 
fov:Number  [read-write]

Gets or sets the field of view in degrees.

Implementation
    public function get fov():Number
    public function set fov(value:Number):void
nearproperty 
near:Number  [read-write]

Gets or sets the distance to near plane (positive number).

Implementation
    public function get near():Number
    public function set near(value:Number):void
planesproperty 
public var planes:Array

frustum planes

_projectionproperty 
public var _projection:Matrix3D

projection matrix

projectionproperty 
projection:uint  [read-write]

Gets or sets the projection type

Implementation
    public function get projection():uint
    public function set projection(value:uint):void
viewport3Dproperty 
viewport3D:Viewport3D  [read-write]Implementation
    public function get viewport3D():Viewport3D
    public function set viewport3D(value:Viewport3D):void
Constructor detail
FrustumCamera3D()constructor
public function FrustumCamera3D(viewport3D:Viewport3D, fov:Number = 90, near:Number = 10, far:Number = 2000)

Constructor.

Parameters
viewport3D:Viewport3D — Field of view in degrees.
 
fov:Number (default = 90) — Distance to near plane.
 
near:Number (default = 10) — Distance to far plane.
 
far:Number (default = 2000) — Viewport to render to.

See also

flash.geom.Rectangle.
Method detail
createOrthoMatrix()method
public static function createOrthoMatrix(left:Number, right:Number, bottom:Number, top:Number, near:Number, far:Number):Matrix3D

Creates a transformation that produces a parallel projection.

Parameters
left:Number
 
right:Number
 
bottom:Number
 
top:Number
 
near:Number
 
far:Number

Returns
Matrix3D
createPerspectiveMatrix()method 
public static function createPerspectiveMatrix(fov:Number, aspect:Number, near:Number, far:Number):Matrix3D

Creates a transformation that produces a perspective projection.

Parameters
fov:Number
 
aspect:Number
 
near:Number
 
far:Number

Returns
Matrix3D
extractPlanes()method 
public function extractPlanes(m:Matrix3D):void

Extract the frustum planes.

Parameters
m:Matrix3D
sphereInFrustum()method 
public function sphereInFrustum(center:Vertex3D, radius:Number):int

Checks whether a sphere is inside, outside or intersecting the frustum.

Parameters
center:Vertex3D — center of sphere
 
radius:Number — radius of sphere

Returns
int
testObject()method 
public function testObject(obj:DisplayObject3D):int

Parameters
obj:DisplayObject3D

Returns
int
transformView()method 
public override function transformView(trans:Matrix3D = null):void

[internal-use] Transforms world coordinates into camera space.

Parameters
trans:Matrix3D (default = null)
Constant detail
BOTTOMconstant
public static const BOTTOM:uint = 4
FARconstant 
public static const FAR:uint = 5
INSIDEconstant 
public static const INSIDE:int = 1
INTERSECTconstant 
public static const INTERSECT:int = 0
LEFTconstant 
public static const LEFT:uint = 1
NEARconstant 
public static const NEAR:uint = 0
ORTHO_PROJECTIONconstant 
public static const ORTHO_PROJECTION:uint = 1

constant used to set projection type.

See also

OUTSIDEconstant 
public static const OUTSIDE:int = -1
PERSPECTIVE_PROJECTIONconstant 
public static const PERSPECTIVE_PROJECTION:uint = 0

constant used to set projection type.

See also

RIGHTconstant 
public static const RIGHT:uint = 2
TOPconstant 
public static const TOP:uint = 3
TYPEconstant 
public static const TYPE:String = "FRUSTRUMCAMERA3D"