org.papervision3d.core.geom.TriangleMesh3D

Public Properties

	Property		Defined by
		children : Object Returns the children object.	DisplayObjectContainer3D
		containerBlendMode : int	DisplayObject3D
		containerSortMode : int	DisplayObject3D
		culled : Boolean [internal use] Is this object culled by camera frustum?	DisplayObject3D
		extra : Object An object that contains user defined properties.	DisplayObject3D
		faceLevelMode : Boolean [static] This allows objects faces to have their own containers.	DisplayObject3D
		faces : Array [internal-use]	DisplayObject3D
		filters : Array	DisplayObject3D
		frustumTestMethod : int = 0 Defines how the object should be frustum-checked.	DisplayObject3D
		geometry : GeometryObject3D The GeometryObject3D object that contains the 3D definition of this instance.	DisplayObject3D
		id : int [read-only] Unique id of this instance.	DisplayObject3D
		material : MaterialObject3D [write-only]	TriangleMesh3D
		materials : MaterialsList The list of materials for this instance.	DisplayObject3D
		meshSort : uint = 1 tells Mesh3D's render() method to compare the measurement choice of the user for a triangle's sorting	DisplayObject3D
		name : String An optional object name.	DisplayObject3D
		numChildren : int Returns the number of children of this object.	DisplayObjectContainer3D
		parent : DisplayObjectContainer3D [read-only] Indicates the DisplayObjectContainer3D object that contains this display object.	DisplayObject3D
		root : DisplayObjectContainer3D [read-only] [read-only] The scene, which is the top-most displayObjectContainer3D in the tree structure.	DisplayObjectContainer3D
		rotationX : Number Specifies the rotation around the X axis from its original orientation.	DisplayObject3D
		rotationY : Number Specifies the rotation around the Y axis from its original orientation.	DisplayObject3D
		rotationZ : Number Specifies the rotation around the Z axis from its original orientation.	DisplayObject3D
		scale : Number Sets the 3D scale as applied from the registration point of the object.	DisplayObject3D
		scaleX : Number Sets the scale along the local X axis as applied from the registration point of the object.	DisplayObject3D
		scaleY : Number Sets the scale along the local Y axis as applied from the registration point of the object.	DisplayObject3D
		scaleZ : Number Sets the scale along the local Z axis as applied from the registration point of the object.	DisplayObject3D
		scene : SceneObject3D	DisplayObject3D
		sceneX : Number The X coordinate of a object relative to the scene coordinate system.	DisplayObject3D
		sceneY : Number The Y coordinate of a object relative to the scene coordinate system.	DisplayObject3D
		sceneZ : Number The Z coordinate of a object relative to the scene coordinate system.	DisplayObject3D
		screen : Number3D [read-only] The coordinate of the object on screen.	DisplayObject3D
		screenZ : Number [internal-use] The average depth of the object faces center.	DisplayObject3D
		sortedArray : Array [static]	DisplayObject3D
		transform : Matrix3D A Matrix3D object containing values that affect the scaling, rotation, and translation of the display object.	DisplayObject3D
		useOwnContainer : Boolean	DisplayObject3D
		userData : UserData	DisplayObject3D
		view : Matrix3D [internal-use] A camera transformed Matrix3D object.	DisplayObject3D
		visible : Boolean Whether or not the display object is visible.	DisplayObject3D
		world : Matrix3D World transformation.	DisplayObject3D
		x : Number An Number that sets the X coordinate of a object relative to the origin of its parent.	DisplayObject3D
		y : Number An Number that sets the Y coordinate of a object relative to the origin of its parent.	DisplayObject3D
		z : Number An Number that sets the Z coordinate of a object relative to the origin of its parent.	DisplayObject3D
		ZERO : DisplayObject3D [static] Returns an empty DiplayObject3D object positioned in the center of the 3D coordinate system (0, 0 ,0).	DisplayObject3D

	Property	Defined by
		_children : Dictionary [internal-use] Names indexed by children.	DisplayObjectContainer3D
		_childrenByName : Object [internal-use] Children indexed by name.	DisplayObjectContainer3D
		_containerBlendMode : int	DisplayObject3D
		_containerSortMode : int	DisplayObject3D
		_filters : Array	DisplayObject3D
		_scene : SceneObject3D = null The scene where the object belongs.	DisplayObject3D
		_sorted : Array	DisplayObject3D
		_transformDirty : Boolean = false [internal-use]	DisplayObject3D
		_useOwnContainer : Boolean	DisplayObject3D
		_userData : UserData	DisplayObject3D

Public Methods

Hide Inherited Public Methods

Show Inherited Public Methods

	Method		Defined by
		TriangleMesh3D(material:MaterialObject3D, vertices:Array, faces:Array, name:String = null, initObject:Object = null) Creates a new Mesh object.	TriangleMesh3D
		addChild(child:DisplayObject3D, name:String = null):DisplayObject3D Adds a child DisplayObject3D instance to this DisplayObjectContainer instance.	DisplayObject3D
		addChildren(parent:DisplayObject3D):DisplayObjectContainer3D Adds all the children of a DisplayObject3D instance to this DisplayObjectContainer instance.	DisplayObjectContainer3D
		addGeometry(geometry:GeometryObject3D = null):void Adds a geometry definition to the instance.	DisplayObject3D
		boundingBox():Object Calculates 3D bounding box.	Vertices3D
		childrenList():String Returns a string value with the list of objects.	DisplayObjectContainer3D
		clone():DisplayObject3D Clones this object.	TriangleMesh3D
		copyPosition(reference:*):void Copies the position information (x, y and z coordinates) from another object or Matrix3D.	DisplayObject3D
		copyTransform(reference:*):void Copies the transformation information (position, rotation and scale) from another object or Matrix3D.	DisplayObject3D
		distanceTo(obj:DisplayObject3D):Number Gets the distance to the position of the given object.	DisplayObject3D
		getChildByName(name:String, recursive:Boolean = false):DisplayObject3D Returns the child display object that exists with the specified name.	DisplayObjectContainer3D
		getMaterialByName(name:String):MaterialObject3D Returns the material that exists with the specified name in the materials list.	DisplayObject3D
		hitTestObject(obj:DisplayObject3D, multiplier:Number = 1):Boolean Evaluates the display object to see if it overlaps or intersects with the obj display object.	DisplayObject3D
		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
		lookAt(targetObject:DisplayObject3D, upAxis:Number3D = null):void Make the object look at a specific position.	DisplayObject3D
		materialsList():String Returns a string value with the list of material names of the materials list.	DisplayObject3D
		mergeVertices():void Merges duplicated vertices.	TriangleMesh3D
		moveBackward(distance:Number):void Translate the display object in the opposite direction it is facing, i.e.	DisplayObject3D
		moveDown(distance:Number):void Translate the display object downwards, with respect to the direction it is facing, i.e.	DisplayObject3D
		moveForward(distance:Number):void Translate the display object in the direction it is facing, i.e.	DisplayObject3D
		moveLeft(distance:Number):void Translate the display object lateraly, to the left of the direction it is facing, i.e.	DisplayObject3D
		moveRight(distance:Number):void Translate the display object lateraly, to the right of the direction it is facing, i.e.	DisplayObject3D
		moveUp(distance:Number):void Translate the display object upwards, with respect to the direction it is facing, i.e.	DisplayObject3D
		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
		project(parent:DisplayObject3D, renderSessionData:RenderSessionData):Number Projects three dimensional coordinates onto a two dimensional plane to simulate the relationship of the camera to subject.	TriangleMesh3D
		projectFrustum(parent:DisplayObject3D, renderSessionData:RenderSessionData):Number	Vertices3D
		projectTexture(u:String = "x", v:String = "y"):void Planar projection from the specified plane.	TriangleMesh3D
		quarterFaces():void Divides all faces into 4.	TriangleMesh3D
		removeChild(child:DisplayObject3D):DisplayObject3D Removes the specified child DisplayObject3D instance from the child list of the DisplayObjectContainer3D instance.	DisplayObjectContainer3D
		removeChild(child:DisplayObject3D):DisplayObject3D	DisplayObjectContainer3D
		removeChildByName(name:String):DisplayObject3D Removes the child DisplayObject3D instance that exists with the specified name, from the child list of the DisplayObjectContainer3D instance.	DisplayObjectContainer3D
		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
		toString():String Returns a string value representing the three-dimensional position values of the display object instance.	DisplayObject3D
		transformVertices(transformation:Matrix3D):void	Vertices3D
		translate(distance:Number, axis:Number3D):void Move the object along a given direction.	DisplayObject3D
		yaw(angle:Number):void Rotate the display object around about the vertical axis —an axis drawn from top to bottom.	DisplayObject3D

	Method	Defined by
		updateTransform():void [internal-use] Updates the transform Matrix3D with the current rotation and scale values.	DisplayObject3D

	Constant	Defined by
		MESH_SORT_CENTER : uint = 1 [static] tells Mesh3D's render() method to sort by measuring from the center of a triangle	DisplayObject3D
		MESH_SORT_CLOSE : uint = 3 [static] tells Mesh3D's render() method to sort by measuring from the closest point of a triangle	DisplayObject3D
		MESH_SORT_FAR : uint = 2 [static] tells Mesh3D's render() method to sort by measuring from the farthest point of a triangle	DisplayObject3D

Property detail

material

property

material:MaterialObject3D [write-only]Implementation
public function set material(value:MaterialObject3D):void

Constructor detail

TriangleMesh3D

()

constructor

public function TriangleMesh3D(material:MaterialObject3D, vertices:Array, faces:Array, name:String = null, initObject:Object = null)

Creates a new Mesh object. The Mesh DisplayObject3D class lets you create and display solid 3D objects made of vertices and triangular polygons.

Parameters

	`material:MaterialObject3D` — A MaterialObject3D object that contains the material properties of the object.

	`vertices:Array` — An array of Vertex3D objects for the vertices of the mesh.

	`faces:Array` — An array of Face3D objects for the faces of the mesh.

	`name:String` (default = `null`) — [optional] - An object that contains user defined properties with which to populate the newly created DisplayObject3D. It includes x, y, z, rotationX, rotationY, rotationZ, scaleX, scaleY scaleZ and a user defined extra object. If extra is not an object, it is ignored. All properties of the extra field are copied into the new instance. The properties specified with extra are publicly available. sortFaces: Z-depth sorting when rendering. Some objects might not need it. Default is false (faster). showFaces: Use only if each face is on a separate MovieClip container. Default is false.

	`initObject:Object` (default = `null`)

Method detail

clone

()

method

public override function clone():DisplayObject3D

Clones this object.

Returns

DisplayObject3D — The cloned DisplayObject3D.

mergeVertices

()

method

public function mergeVertices():void

Merges duplicated vertices.

project

()

method

public override function project(parent:DisplayObject3D, renderSessionData:RenderSessionData):Number

Projects three dimensional coordinates onto a two dimensional plane to simulate the relationship of the camera to subject. This is the first step in the process of representing three dimensional shapes two dimensionally.

Parameters

	`parent:DisplayObject3D` — Camera3D object to render from.

	`renderSessionData:RenderSessionData`

Returns

Number

projectTexture

()

method

public function projectTexture(u:String = "x", v:String = "y"):void

Planar projection from the specified plane.

Parameters

	`u:String` (default = "`x`") — The texture horizontal axis. Can be "x", "y" or "z". The default value is "x".

	`v:String` (default = "`y`") — The texture vertical axis. Can be "x", "y" or "z". The default value is "y".

quarterFaces

()

method

public function quarterFaces():void

Divides all faces into 4.

API Documentation	All Packages \| All Classes \| Index \| Frames No Frames
Class TriangleMesh3D	Properties \| Methods \| Constants

Package	org.papervision3d.core.geom
Class	public class TriangleMesh3D
Inheritance	TriangleMesh3D Vertices3D DisplayObject3D DisplayObjectContainer3D flash.events.EventDispatcher
Subclasses	Ase, Cube, Cylinder, KMZ, MD2, PaperPlane, Plane, Skin3D, Sphere