Packageaway3d.extrusions
Classpublic class Elevation
InheritanceElevation Inheritance Mesh Inheritance Entity Inheritance ObjectContainer3D Inheritance Object3D Inheritance flash.events.EventDispatcher

Public Properties
 PropertyDefined by
 Inheritedanimation : AnimationBase
The type of animation used to influence the geometry.
Mesh
 InheritedanimationController : AnimatorBase
The animation controller that will update the mesh's animation state.
Mesh
 InheritedanimationState : AnimationStateBase
The animation state of the mesh, defining how the animation should influence the mesh's geometry.
Mesh
 Inheritedbounds : BoundingVolumeBase
The bounding volume approximating the volume occupied by the Entity.
Entity
 InheritedcastsShadows : Boolean
Indicates whether or not the Mesh can cast shadows
Mesh
  depth : Number
The depth of the terrain plane.
Elevation
 Inheritedeulers : Vector3D
Defines the rotation of the 3d object as a Vector3D object containing euler angles for rotation around x, y and z axis.
Object3D
 Inheritedextra : Object
An object that can contain any extra data.
Object3D
 Inheritedgeometry : Geometry
The geometry used by the mesh that provides it with its shape.
Mesh
  height : Number
Elevation
 InheritedinverseSceneTransform : Matrix3D
The inverse scene transform object that transforms from world to model space.
ObjectContainer3D
 Inheritedmaterial : MaterialBase
The material with which to render the Mesh.
Mesh
  maxElevation : uint
Elevation
 InheritedmaxX : Number
The maximum extremum of the object along the X-axis.
Entity
 InheritedmaxY : Number
The maximum extremum of the object along the Y-axis.
Entity
 InheritedmaxZ : Number
The maximum extremum of the object along the Z-axis.
Entity
  minElevation : uint
Elevation
 InheritedminX : Number
The minimum extremum of the object along the X-axis.
Entity
 InheritedminY : Number
The minimum extremum of the object along the Y-axis.
Entity
 InheritedminZ : Number
The minimum extremum of the object along the Z-axis.
Entity
 InheritedmodelViewProjection : Matrix3D
The current model-view-projection (MVP) matrix - the one on the top of the stack - used to transform from model to homogeneous projection space.
Entity
 InheritedmouseDetails : Boolean
Indicates whether or not mouse events contain UV and position coordinates.
Mesh
 InheritedmouseEnabled : Boolean
Indicates whether the IRenderable should trigger mouse events, and hence should be rendered for hit testing.
Entity
 Inheritedname : String
The name of the object.
Object3D
 InheritednumChildren : uint
The amount of child objects of the ObjectContainer3D.
ObjectContainer3D
 Inheritedparent : ObjectContainer3D
The parent ObjectContainer3D to which this object's transformation is relative.
ObjectContainer3D
 Inheritedpartition : Partition3D
The space partition to be used by the object container and all its recursive children, unless it has its own space partition assigned.
ObjectContainer3D
 InheritedpivotPoint : Vector3D
Defines the local point around which the object rotates.
Object3D
 Inheritedposition : Vector3D
Defines the position of the 3d object, relative to the local coordinates of the parent ObjectContainer3D.
Object3D
 InheritedrotationX : 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
 InheritedrotationY : 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
 InheritedrotationZ : 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
 InheritedscaleX : Number
Defines the scale of the 3d object along the x-axis, relative to local coordinates.
Object3D
 InheritedscaleY : Number
Defines the scale of the 3d object along the y-axis, relative to local coordinates.
Object3D
 InheritedscaleZ : Number
Defines the scale of the 3d object along the z-axis, relative to local coordinates.
Object3D
 InheritedscenePosition : Vector3D
The global position of the ObjectContainer3D in the scene.
ObjectContainer3D
 InheritedsceneTransform : Matrix3D
The transformation matrix that transforms from model to world space.
ObjectContainer3D
  segmentsH : uint
The number of segments that make up the plane along the Y or Z-axis, depending on whether yUp is true or false, respectively.
Elevation
  smoothedHeightMap : BitmapData
[read-only]
Elevation
 InheritedsubMeshes : Vector
The SubMeshes out of which the Mesh consists.
Mesh
 Inheritedtransform : Matrix3D
The local transformation matrix that transforms to the parent object's space.
ObjectContainer3D
  width : Number
The width of the terrain plane.
Elevation
 Inheritedx : Number
Defines the x coordinate of the 3d object relative to the local coordinates of the parent ObjectContainer3D.
Object3D
 Inheritedy : Number
Defines the y coordinate of the 3d object relative to the local coordinates of the parent ObjectContainer3D.
Object3D
 Inheritedz : Number
Defines the z coordinate of the 3d object relative to the local coordinates of the parent ObjectContainer3D.
Object3D
 InheritedzIndex : Number
The distance of the IRenderable object to the view, used to sort per object.
Entity
Protected Properties
 PropertyDefined by
 Inherited_bounds : BoundingVolumeBase
Entity
 Inherited_boundsInvalid : Boolean = true
Entity
 Inherited_explicitPartition : Partition3D
ObjectContainer3D
  _geomDirty : Boolean = true
Elevation
 Inherited_geometry : Geometry
Mesh
 Inherited_implicitPartition : Partition3D
ObjectContainer3D
 Inherited_mvpIndex : int = -1
Entity
 Inherited_mvpTransformStack : Vector
Entity
 Inherited_parent : ObjectContainer3D
ObjectContainer3D
 Inherited_pivotPoint : Vector3D
Object3D
 Inherited_pivotZero : Boolean = true
Object3D
 Inherited_pos : Vector3D
A calculation placeholder.
Object3D
 Inherited_scaleX : Number = 1
Object3D
 Inherited_scaleY : Number = 1
Object3D
 Inherited_scaleZ : Number = 1
Object3D
 Inherited_scene : Scene3D
ObjectContainer3D
 Inherited_sceneTransform : Matrix3D
ObjectContainer3D
 Inherited_sceneTransformDirty : Boolean = true
ObjectContainer3D
 Inherited_stackLen : uint
Entity
 Inherited_transform : Matrix3D
Object3D
  _uvDirty : Boolean = true
Elevation
 Inherited_x : Number = 0
Object3D
 Inherited_y : Number = 0
Object3D
 Inherited_z : Number = 0
Object3D
 Inherited_zIndices : Vector
Entity
Public Methods
 MethodDefined by
  
Elevation
(material:MaterialBase, heightMap:BitmapData, width:Number = 1000, height:Number = 100, depth:Number = 1000, segmentsW:uint = 30, segmentsH:uint = 30, maxElevation:uint = 255, minElevation:uint = 0, smoothMap:Boolean = false)
Class Elevation generates (and becomes) a mesh from an heightmap.
Elevation
 Inherited
Adds a child ObjectContainer3D to the current object.
ObjectContainer3D
 Inherited
addChildren(... childarray):void
Adds an array of 3d objects to the scene as children of the container
ObjectContainer3D
 Inherited
Mesh
 Inherited
dispose(deep:Boolean):void
Cleans up any resources used by the current object.
Mesh
 Inherited
Retrieves the child object at the given index.
ObjectContainer3D
 Inherited
Gets a concrete EntityPartition3DNode subclass that is associated with this Entity instance
Entity
  
getHeightAt(x:Number, z:Number):Number
Reading the terrain height from a given x z position for surface tracking purposes
Elevation
 Inherited
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.
ObjectContainer3D
 Inherited
moveBackward(distance:Number):void
Moves the 3d object backwards along it's local z axis
Object3D
 Inherited
moveDown(distance:Number):void
Moves the 3d object backwards along it's local y axis
Object3D
 Inherited
moveForward(distance:Number):void
Moves the 3d object forwards along it's local z axis
Object3D
 Inherited
moveLeft(distance:Number):void
Moves the 3d object backwards along it's local x axis
Object3D
 Inherited
movePivot(dx:Number, dy:Number, dz:Number):void
Moves the local point around which the object rotates.
Object3D
 Inherited
moveRight(distance:Number):void
Moves the 3d object forwards along it's local x axis
Object3D
 Inherited
moveTo(dx:Number, dy:Number, dz:Number):void
Moves the 3d object directly to a point in space
Object3D
 Inherited
moveUp(distance:Number):void
Moves the 3d object forwards along it's local y axis
Object3D
 Inherited
pitch(angle:Number):void
Rotates the 3d object around it's local x-axis
Object3D
 Inherited
Removes a model view projection matrix from the stack, used when leaving a render.
Entity
 Inherited
Updates the model-view-projection (MVP) matrix used to transform from model to homogeneous projection space and places it on the stack.
Entity
 Inherited
Removes a 3d object from the child array of the container
ObjectContainer3D
 Inherited
roll(angle:Number):void
Rotates the 3d object around it's local z-axis
Object3D
 Inherited
rotate(axis:Vector3D, angle:Number):void
Rotates the 3d object around an axis by a defined angle
Object3D
 Inherited
rotateTo(ax:Number, ay:Number, az:Number):void
Rotates the 3d object directly to a euler angle
Object3D
 Inherited
scale(value:Number):void
Appends a uniform scale to the current transformation.
Object3D
  
Generates a smoother representation of the geometry using the original heightmap and subdivision settings.
Elevation
 Inherited
translate(axis:Vector3D, distance:Number):void
Moves the 3d object along a vector by a defined length
Object3D
 Inherited
translateLocal(axis:Vector3D, distance:Number):void
ObjectContainer3D
 Inherited
yaw(angle:Number):void
Rotates the 3d object around it's local y-axis
Object3D
Protected Methods
 MethodDefined by
 Inherited
Factory method that returns the current partition node.
Mesh
 Inherited
Creates the default bounding box to be used by this type of Entity.
Entity
 Inherited
initGeometry():void
Initialises the SubMesh objects to map unto the Geometry's SubGeometry objects.
Mesh
 Inherited
Invalidates the bounding volume, causing to be updated when requested.
Entity
  
Invalidates the primitive's geometry, causing it to be updated when requested.
Elevation
 Inherited
Invalidates the scene transformation matrix, causing it to be updated the next time it's requested.
Entity
 Inherited
Invalidates the transformation matrix, causing it to be updated upon the next request
ObjectContainer3D
  
invalidateUVs():void
Invalidates the primitive's uv coordinates, causing them to be updated when requested.
Elevation
 Inherited
updateBounds():void
Updates the bounding volume for the object.
Mesh
 Inherited
Updates the scene transformation matrix.
ObjectContainer3D
 Inherited
Object3D
Property detail
depthproperty
depth:Number  [read-write]

The depth of the terrain plane.

Implementation
    public function get depth():Number
    public function set depth(value:Number):void
_geomDirtyproperty 
protected var _geomDirty:Boolean = true
heightproperty 
height:Number  [read-write]Implementation
    public function get height():Number
    public function set height(value:Number):void
maxElevationproperty 
maxElevation:uint  [read-write]Implementation
    public function get maxElevation():uint
    public function set maxElevation(value:uint):void
minElevationproperty 
minElevation:uint  [read-write]Implementation
    public function get minElevation():uint
    public function set minElevation(value:uint):void
segmentsHproperty 
segmentsH:uint  [read-write]

The number of segments that make up the plane along the Y or Z-axis, depending on whether yUp is true or false, respectively. Defaults to 1.

Implementation
    public function get segmentsH():uint
    public function set segmentsH(value:uint):void
smoothedHeightMapproperty 
smoothedHeightMap:BitmapData  [read-only]Implementation
    public function get smoothedHeightMap():BitmapData
_uvDirtyproperty 
protected var _uvDirty:Boolean = true
widthproperty 
width:Number  [read-write]

The width of the terrain plane.

Implementation
    public function get width():Number
    public function set width(value:Number):void
Constructor detail
Elevation()constructor
public function Elevation(material:MaterialBase, heightMap:BitmapData, width:Number = 1000, height:Number = 100, depth:Number = 1000, segmentsW:uint = 30, segmentsH:uint = 30, maxElevation:uint = 255, minElevation:uint = 0, smoothMap:Boolean = false)Parameters
material:MaterialBase — MaterialBase. The Mesh (Elevation) material
 
heightMap:BitmapData — BitmapData. The heightmap to generate the mesh from
 
width:Number (default = 1000) — [optional] Number. The width of the mesh. Default is 1000.
 
height:Number (default = 100) — [optional] Number. The height of the mesh. Default is 100.
 
depth:Number (default = 1000) — [optional] Number. The depth of the mesh. Default is 1000.
 
segmentsW:uint (default = 30) — [optional] uint. The subdivision of the mesh along the x axis. Default is 30.
 
segmentsH:uint (default = 30) — [optional] uint. The subdivision of the mesh along the y axis. Default is 30.
 
maxElevation:uint (default = 255) — [optional] uint. The maximum color value to be used. Allows canyon like elevations instead of mountainious. Default is 255.
 
minElevation:uint (default = 0) — [optional] uint. The minimum color value to be used. Default is 0.
 
smoothMap:Boolean (default = false) — [optional] Boolean. If surface tracking is used, an internal smoothed version of the map is generated, prevents irregular height readings if original map is blowed up or is having noise. Default is false.
Init Parameters
Method detail
getHeightAt()method
public function getHeightAt(x:Number, z:Number):Number

Reading the terrain height from a given x z position for surface tracking purposes

Parameters
x:Number
 
z:Number

Returns
Number

See also

away3d.extrusions.Elevation.smoothHeightMap
invalidateGeometry()method 
protected function invalidateGeometry():void

Invalidates the primitive's geometry, causing it to be updated when requested.

invalidateUVs()method 
protected function invalidateUVs():void

Invalidates the primitive's uv coordinates, causing them to be updated when requested.

smoothHeightMap()method 
public function smoothHeightMap():void

Generates a smoother representation of the geometry using the original heightmap and subdivision settings. Allows smoother readings for surface tracking if original heightmap has noise, causing choppy camera movement.

See also

away3d.extrusions.Elevation.getHeightAt
Wiki link
Click to go to the wiki page for 'away3d.extrusions.Elevation'

Code examples

Comments