away3d.extrusions.PathDuplicator

Public Properties

	Property		Defined By
		aligntopath : Boolean Defines if the profile point array should be orientated on path or not.	PathDuplicator
		alpha : Number An optional alpha value that can be applied to the 3d object.	Object3D
		animationLibrary : AnimationLibrary Reference container for all animations used in the container.	Object3D
		back : Material Defines a triangle material to be used for the backface of all faces in the 3d object.	Mesh
		blendMode : String An optional blend mode that can be applied to the 3d object.	Object3D
		bothsides : Boolean Indicates whether both the front and reverse sides of a face should be rendered.	Mesh
		boundingRadius : Number [read-only] Returns the bounding radius of the 3d object	Object3D
		closepath : Boolean Defines if the last segment should join the first one and close the loop.	PathDuplicator
		collider : Boolean Indicates whether this object is used for collision detection.	Object3D
		debugbb : Boolean Indicates whether a debug bounding box should be rendered around the 3d object.	Object3D
		debugBoundingBox : WireCube [read-only]	Object3D
		debugBoundingSphere : WireSphere [read-only]	Object3D
		debugbs : Boolean Indicates whether a debug bounding sphere should be rendered around the 3d object.	Object3D
		elements : Vector.<Element> [read-only] Returns an array of all elements contained in the mesh object.	Mesh
		eulers : Vector3D Defines the rotation of the 3d object as a Vector3D object containing euler angles for rotation around x, y and z axis.	Object3D
		extra : Object An optional untyped object that can contain used-defined properties	Object3D
		faces : Vector.<Face> [read-only] Returns an array of the faces contained in the mesh object.	Mesh
		faceVOs : Vector.<FaceVO> [read-only] Returns an array of the faceVOs contained in the mesh object.	Mesh
		filters : Array An optional array of filters that can be applied to the 3d object.	Object3D
		geometry : Geometry Defines the geometry object used for the mesh.	Mesh
		geometryLibrary : GeometryLibrary Reference container for all geometries used in the container.	Object3D
		id : int [read-only]	Object3D
		indexes : Array Placeholder for md2 frame indexes	Mesh
		indices : Vector.<int> [read-only] Returns an array of the indices contained in the mesh object.	Mesh
		inverseSceneTransform : Matrix3D Returns the inverse of sceneTransform.	Object3D
		material : Material Defines the material used to render the faces, segments or 3d sprites in the geometry object.	Mesh
		materialLibrary : MaterialLibrary Reference container for all materials used in the container.	Object3D
		maxX : Number [read-only] Returns the maximum x value of the 3d object	Object3D
		maxY : Number [read-only] Returns the maximum y value of the 3d object	Object3D
		maxZ : Number [read-only] Returns the maximum z value of the 3d object	Object3D
		mesh : Object3D Sets and defines the Array of Vector3D's (the profile information to be projected according to the Path object).	PathDuplicator
		meshes : Array Sets and defines the optional Array of meshes.	PathDuplicator
		minX : Number [read-only] Returns the minimum x value of the 3d object	Object3D
		minY : Number [read-only] Returns the minimum y value of the 3d object	Object3D
		minZ : Number [read-only] Returns the minimum z value of the 3d object	Object3D
		mouseEnabled : Boolean = true Defines whether mouse events are received on the 3d object	Object3D
		name : String An optional name string for the 3d object.	Object3D
		objectDepth : Number [read-only] Boundary depth of the 3d object return The depth of the mesh	Object3D
		objectHeight : Number [read-only] Boundary height of the 3d object return The height of the mesh	Object3D
		objectWidth : Number [read-only] Boundary width of the 3d object return The width of the object	Object3D
		outline : Material Defines a segment material to be used for outlining the 3d object.	Mesh
		ownCanvas : Boolean Defines whether the contents of the 3d object are rendered using it's own render session	Object3D
		ownSession : AbstractSession Defines a unique render session for the 3d object.	Object3D
		parent : ObjectContainer3D Defines the parent of the 3d object.	Object3D
		path : Path Sets and defines the Path object.	PathDuplicator
		pivotPoint : Vector3D Defines the local point around which the object rotates.	Object3D
		pivotZero : Boolean [read-only]	Object3D
		position : Vector3D Defines the position of the 3d object, relative to the local coordinates of the parent ObjectContainer3D.	Object3D
		pushback : Boolean Elements use their furthest point from the camera when z-sorting	Object3D
		pushfront : Boolean Elements use their nearest point to the camera when z-sorting	Object3D
		recenter : Boolean Defines if the final mesh should have its pivot reset to its center after generation.	PathDuplicator
		renderer : Renderer An optional renderer object that can be used to render the contents of the object.	Object3D
		rotations : Array Sets and defines the optional Array of Vector3D's.	PathDuplicator
		rotationX : Number Defines the euler angle of rotation of the 3d object around the x-axis, relative to the local coordinates of the parent ObjectContainer3D.	Object3D
		rotationY : Number Defines the euler angle of rotation of the 3d object around the y-axis, relative to the local coordinates of the parent ObjectContainer3D.	Object3D
		rotationZ : Number Defines the euler angle of rotation of the 3d object around the z-axis, relative to the local coordinates of the parent ObjectContainer3D.	Object3D
		scales : Array Sets and defines the optional Array of Vector3D's.	PathDuplicator
		scaleX : Number Defines the scale of the 3d object along the x-axis, relative to local coordinates.	Object3D
		scaleY : Number Defines the scale of the 3d object along the y-axis, relative to local coordinates.	Object3D
		scaleZ : Number Defines the scale of the 3d object along the z-axis, relative to local coordinates.	Object3D
		scaling : Number Defines the scaling of the final generated mesh.	PathDuplicator
		scene : Scene3D [read-only] Returns the parent scene of the 3d object	Object3D
		scenePivotPoint : Vector3D [read-only]	Object3D
		scenePosition : Vector3D [read-only] Returns the position of the 3d object, relative to the global coordinates of the Scene3D object.	Object3D
		sceneTransform : Matrix3D [read-only] Returns the transformation of the 3d object, relative to the global coordinates of the Scene3D object.	Object3D
		screenXOffset : Number Defines an additional offset to the x coordinate used on mesh elements or objects with ownCanvas set to true	Object3D
		screenYOffset : Number Defines an additional offset to the y coordinate used on mesh elements or objects with ownCanvas set to true	Object3D
		screenZOffset : Number Defines an additional offset to the z-sorting algorithm used on mesh elements or objects with ownCanvas set to true	Object3D
		segments : Vector.<Segment> [read-only] Returns an array of the segments contained in the mesh object.	Mesh
		segmentspread : Boolean if the optional Array of meshes is passed, segmentspread define if the meshes[index] is repeated per segments or duplicated after each others.	PathDuplicator
		segmentVOs : Vector.<SegmentVO> [read-only] Returns an array of the segmentVOs contained in the mesh object.	Mesh
		session : AbstractSession [read-only] The render session used by the 3d object	Object3D
		smoothscale : Boolean Defines if a scale array of Vector3D is passed if the scaling should be affecting the whole segment or spreaded from previous curvesegmentscale to the next curvesegmentscale.	PathDuplicator
		sprites : Vector.<Sprite3D> [read-only] Returns an array of the 3d sprites contained in the mesh object.	Mesh
		spriteVOs : Vector.<SpriteVO> [read-only] Returns an array of the spriteVOs contained in the mesh object.	Mesh
		startIndices : Vector.<int> [read-only] Returns an array of the start indices contained in the mesh object.	Mesh
		subdivision : int Defines the resolution beetween each CurveSegments.	PathDuplicator
		texture : Material Sets and defines the optional material to apply on each duplicated mesh information, according to source mesh.	PathDuplicator
		transform : Matrix3D Defines the transformation of the 3d object, relative to the local coordinates of the parent ObjectContainer3D.	Object3D
		type : String = mesh String defining the type of class used to generate the mesh.	Mesh
		url : String String defining the source of the mesh.	Mesh
		useHandCursor : Boolean = false Defines whether a hand cursor is displayed when the mouse rolls over the 3d object.	Object3D
		vertices : Vector.<Vertex> Returns an array of the vertices contained in the mesh object.	Mesh
		verts : Vector.<Number> [read-only]	Mesh
		visible : Boolean Defines whether the 3d object is visible in the scene	Object3D
		x : Number Defines the x coordinate of the 3d object relative to the local coordinates of the parent ObjectContainer3D.	Object3D
		y : Number Defines the y coordinate of the 3d object relative to the local coordinates of the parent ObjectContainer3D.	Object3D
		z : Number Defines the z coordinate of the 3d object relative to the local coordinates of the parent ObjectContainer3D.	Object3D

	Property	Defined By
		ini : Init Instance of the Init object used to hold and parse default property values specified by the initialiser object in the 3d object constructor.	Object3D
		_pivotPoint : Vector3D	Object3D

Public Methods

Hide Inherited Public Methods

Show Inherited Public Methods

	Method		Defined By
		PathDuplicator(path:Path = null, mesh:Object3D = null, scales:Array = null, rotations:Array = null, init:Object = null) Creates a new PathDuplicator	PathDuplicator
		addFace(face:Face):void Adds a face object to the mesh object.	Mesh
		addOnDimensionsChange(listener:Function):void Default method for adding a dimensionschanged event listener	Object3D
		addOnMouseDown(listener:Function):void Default method for adding a mouseDown3D event listener	Object3D
		addOnMouseMove(listener:Function):void Default method for adding a mouseMove3D event listener	Object3D
		addOnMouseOut(listener:Function):void Default method for adding a mouseOut3D event listener	Object3D
		addOnMouseOver(listener:Function):void Default method for adding a mouseOver3D event listener	Object3D
		addOnMouseUp(listener:Function):void Default method for adding a mouseUp3D event listener	Object3D
		addOnPositionChange(listener:Function):void Default method for adding a positionchanged event listener	Object3D
		addOnRollOut(listener:Function):void Default method for adding a rollOut3D event listener	Object3D
		addOnRollOver(listener:Function):void Default method for adding a rollOver3D event listener	Object3D
		addOnScaleChange(listener:Function):void Default method for adding a scalechanged event listener	Object3D
		addOnSceneChange(listener:Function):void Default method for adding a scenechanged event listener	Object3D
		addOnSceneTransformChange(listener:Function):void Default method for adding a scenetransformchanged event listener	Object3D
		addOnSessionChange(listener:Function):void Default method for adding a sessionchanged event listener	Object3D
		addOnVisibilityUpdate(listener:Function):void Default method for adding a visibilityUpdated event listener	Object3D
		addSegment(segment:Segment):void Adds a segment object to the mesh object.	Mesh
		addSprite(sprite3d:Sprite3D):void Adds a sprite3d object to the mesh object.	Mesh
		applyPosition(dx:Number, dy:Number, dz:Number):void [override] Apply the given position to the geometry without altering the appearance of the mesh	Mesh
		applyRotations():void [override] Apply the local rotations to the geometry without altering the appearance of the mesh	Mesh
		asAS3Class(classname:String = null, packagename:String, round:Boolean = false, animated:Boolean = false):String Returns a formatted string containing a self contained AS3 class definition that can be used to re-create the mesh.	Mesh
		asXML():XML Returns an xml representation of the mesh	Mesh
		build():void	PathDuplicator
		centerPivot():void Adjusts the pivot point of the object so that it lies at the center of it's geoemtry.	Object3D
		clone(object:Object3D = null):Object3D [override] Duplicates the mesh properties to another 3d object.	Mesh
		cloneAll(object:Object3D = null):Object3D Duplicates the mesh properties to another 3d object, including geometry.	Mesh
		distanceTo(obj:Object3D):Number Calulates the absolute distance between the local 3d object position and the position of the given 3d object	Object3D
		invertFaces():void Inverts the geometry of all face objects.	Mesh
		lookAt(target:Vector3D, upAxis:Vector3D = null):void Rotates the 3d object around to face a point defined relative to the local coordinates of the parent ObjectContainer3D.	Object3D
		moveBackward(distance:Number):void Moves the 3d object backwards along it's local z axis	Object3D
		moveDown(distance:Number):void Moves the 3d object backwards along it's local y axis	Object3D
		moveForward(distance:Number):void Moves the 3d object forwards along it's local z axis	Object3D
		moveLeft(distance:Number):void Moves the 3d object backwards along it's local x axis	Object3D
		movePivot(dx:Number, dy:Number, dz:Number):void Moves the local point around which the object rotates.	Object3D
		moveRight(distance:Number):void Moves the 3d object forwards along it's local x axis	Object3D
		moveTo(dx:Number, dy:Number, dz:Number):void Moves the 3d object directly to a point in space	Object3D
		moveUp(distance:Number):void Moves the 3d object forwards along it's local y axis	Object3D
		pitch(angle:Number):void Rotates the 3d object around it's local x-axis	Object3D
		quarterFace(face:Face):void Divides a face object into 4 equal sized face objects.	Mesh
		quarterFaces():void Divides all faces objects of a Mesh into 4 equal sized face objects.	Mesh
		removeFace(face:Face):void Removes a face object from the mesh object.	Mesh
		removeOnDimensionsChange(listener:Function):void Default method for removing a dimensionschanged event listener	Object3D
		removeOnMouseDown(listener:Function):void Default method for removing a mouseDown3D event listener	Object3D
		removeOnMouseMove(listener:Function):void Default method for removing a mouseMove3D event listener	Object3D
		removeOnMouseOut(listener:Function):void Default method for removing a mouseOut3D event listener	Object3D
		removeOnMouseOver(listener:Function):void Default method for removing a mouseOver3D event listener	Object3D
		removeOnMouseUp(listener:Function):void Default method for removing a mouseUp3D event listener	Object3D
		removeOnPositionChange(listener:Function):void Default method for removing a positionchanged event listener	Object3D
		removeOnRollOut(listener:Function):void Default method for removing a rollOut3D event listener	Object3D
		removeOnRollOver(listener:Function):void Default method for removing a rollOver3D event listener	Object3D
		removeOnScaleChange(listener:Function):void Default method for removing a scalechanged event listener	Object3D
		removeOnSceneChange(listener:Function):void Default method for removing a scenechanged event listener	Object3D
		removeOnSceneTransformChange(listener:Function):void Default method for removing a scenetransformchanged event listener	Object3D
		removeOnSessionChange(listener:Function):void Default method for removing a sessionchanged event listener	Object3D
		removeOnVisibilityUpdate(listener:Function):void Default method for removing a visibilityUpdated event listener	Object3D
		removeSegment(segment:Segment):void Removes a segment object from the mesh object.	Mesh
		removeSprite(sprite3d:Sprite3D):void Removes a 3d sprite object from the mesh object.	Mesh
		roll(angle:Number):void Rotates the 3d object around it's local z-axis	Object3D
		rotate(axis:Vector3D, angle:Number):void Rotates the 3d object around an axis by a defined angle	Object3D
		rotateTo(ax:Number, ay:Number, az:Number):void Rotates the 3d object directly to a euler angle	Object3D
		scale(scale:Number):void Scales the contents of the 3d object.	Object3D
		splitFace(face:Face, side:int = 0):void Divides a face object into 2 face objects.	Mesh
		splitFaces(side:int = 0):void Divides all faces objects of a Mesh into 2 face objects.	Mesh
		tick(time:int):void Called by the TickTraverser.	Object3D
		toString():String [override] Used to trace the values of a 3d object.	Object3D
		translate(axis:Vector3D, distance:Number):void Moves the 3d object along a vector by a defined length	Object3D
		traverse(traverser:Traverser):void Used when traversing the scenegraph	Object3D
		triFace(face:Face):void Divides a face object into 3 face objects.	Mesh
		triFaces():void Divides all faces objects of a Mesh into 3 face objects.	Mesh
		updateBounds():void	Mesh
		updateMesh(view:View3D):void Updates the materials in the mesh object	Mesh
		updateVertex(v:Vertex, x:Number, y:Number, z:Number, refreshNormals:Boolean = false):void update vertex information.	Mesh
		yaw(angle:Number):void Rotates the 3d object around it's local y-axis	Object3D

	Method	Defined By
		updateDimensions():void [override]	Mesh
		updateTransform():void	Object3D

Summary	Defined By
contentUpdated	Dispatched when the contents of the 3d object updates.	Object3D
dimensionsChanged	Dispatched when the bounding dimensions of the 3d object changes.	Object3D
mouseDown	Dispatched when a user presses the left hand mouse button while the cursor is over the 3d object.	Object3D
mouseMove	Dispatched when a user moves the cursor while it is over the 3d object.	Object3D
mouseOut	Dispatched when a user moves the cursor away from the 3d object.	Object3D
mouseOver	Dispatched when a user moves the cursor over the 3d object.	Object3D
mouseUp	Dispatched when a user releases the left hand mouse button while the cursor is over the 3d object.	Object3D
rollOut	Dispatched when a user rolls out of the 3d object.	Object3D
rollOver	Dispatched when a user rolls over the 3d object.	Object3D
sceneChanged	Dispatched when the parent scene of the 3d object changes.	Object3D
scenetransformChanged	Dispatched when the scene transform matrix of the 3d object changes.	Object3D
sessionChanged	Dispatched when the render session property of the 3d object changes.	Object3D
transformChanged	Dispatched when the local transform matrix of the 3d object changes.	Object3D

Property Detail

aligntopath

property

aligntopath:Boolean

Defines if the profile point array should be orientated on path or not. Default true. Note that Path object worldaxis property might need to be changed. default = 0,1,0.

Implementation
public function get aligntopath():Boolean
public function set aligntopath(value:Boolean):void

closepath

property

closepath:Boolean

Defines if the last segment should join the first one and close the loop. Default false.

Implementation
public function get closepath():Boolean
public function set closepath(value:Boolean):void

mesh

property

mesh:Object3D

Sets and defines the Array of Vector3D's (the profile information to be projected according to the Path object). Required if you do not pass a meshes array.

Implementation
public function get mesh():Object3D
public function set mesh(value:Object3D):void

meshes

property

meshes:Array

Sets and defines the optional Array of meshes. A series of meshes to be placed to be duplicated within each CurveSegments. When the last one in the array is reached, the first in the array will be used until the class reaches the last segment.

Implementation
public function get meshes():Array
public function set meshes(value:Array):void

path

property

path:Path

Sets and defines the Path object. See animators.data package. Required.

Implementation
public function get path():Path
public function set path(value:Path):void

recenter

property

recenter:Boolean

Defines if the final mesh should have its pivot reset to its center after generation. Default false.

Implementation
public function get recenter():Boolean
public function set recenter(value:Boolean):void

rotations

property

rotations:Array

Sets and defines the optional Array of Vector3D's. A series of rotations to be set on each CurveSegments

Implementation
public function get rotations():Array
public function set rotations(value:Array):void

scales

property

scales:Array

Sets and defines the optional Array of Vector3D's. A series of scales to be set on each CurveSegments

Implementation
public function get scales():Array
public function set scales(value:Array):void

scaling

property

scaling:Number

Defines the scaling of the final generated mesh. Not being considered while building the mesh. Default 1.

Implementation
public function get scaling():Number
public function set scaling(value:Number):void

segmentspread

property

segmentspread:Boolean

if the optional Array of meshes is passed, segmentspread define if the meshes[index] is repeated per segments or duplicated after each others. default = false.

Implementation
public function get segmentspread():Boolean
public function set segmentspread(value:Boolean):void

smoothscale

property

smoothscale:Boolean

Defines if a scale array of Vector3D is passed if the scaling should be affecting the whole segment or spreaded from previous curvesegmentscale to the next curvesegmentscale. Default true.

Implementation
public function get smoothscale():Boolean
public function set smoothscale(value:Boolean):void

subdivision

property

subdivision:int

Defines the resolution beetween each CurveSegments. Default 2, minimum 2.

Implementation
public function get subdivision():int
public function set subdivision(value:int):void

texture

property

texture:Material

Sets and defines the optional material to apply on each duplicated mesh information, according to source mesh.

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

Constructor Detail

PathDuplicator

()

Constructor

public function PathDuplicator(path:Path = null, mesh:Object3D = null, scales:Array = null, rotations:Array = null, init:Object = null)

Creates a new PathDuplicator

Parameters

	`path:Path` (default = `null`) — A Path object. The _path definition.

	`mesh:Object3D` (default = `null`) — An Object3D Mesh. The Mesh that will be duplicated according to subdivision factor along the path. Note that you can pass a meshes array to the init object or set it if you want to distribute more meshes along the path.

	`scales:Array` (default = `null`) — [optional] An array containing a series of Vector3D [Vector3D(1,1,1)]. Defines the scale per segment. Init object smoothscale true smooth the scale across the segments, set to false the scale is applied equally to the whole segment, default is true.

	`rotations:Array` (default = `null`) — [optional] An array containing a series of Vector3D [Vector3D(0,0,0)]. Defines the rotation per segment. Default is null. Note that last value entered is reused for the next segment.

	`init:Object` (default = `null`) — [optional] An initialisation object for specifying default instance properties. Default is null.

####INIT####

Method Detail

build

()

method

public function build():void

Tue Jun 7 2011, 11:27 PM +01:00

Away3D FP10 V3.6.0 API Documentation	All Packages \| All Classes \| Index \| Frames No Frames
PathDuplicator	Properties \| Methods \| Events

Package	away3d.extrusions
Class	public class PathDuplicator
Inheritance	PathDuplicator Mesh Object3D flash.events.EventDispatcher