Packagelaya.d3.terrain
Classpublic class Terrain
InheritanceTerrain Inheritance Sprite3D Inheritance ComponentNode Inheritance Node Inheritance EventDispatcher Inheritance Object

Terrain 类用于创建地块。



Public Properties
 PropertyDefined By
 Inheritedactive : Boolean
获取自身是否激活。
Sprite3D
 InheritedactiveInHierarchy : Boolean
[read-only] 获取在场景中是否激活。
Sprite3D
 InheritedcomponentsCount : int
[read-only] 获得组件的数量。
Sprite3D
 Inheriteddestroyed : Boolean
[只读]是否已经销毁。对象销毁后不能再使用。
Node
 InheriteddisplayedInStage : Boolean
[read-only] 表示是否在显示列表中显示。
Node
 Inheritedid : int
[read-only] 获取唯一标识ID。
Sprite3D
 InheritedisStatic : Boolean
是否静态,静态包含一系列的静态处理。
Sprite3D
 Inheritedlayer : Layer
获取蒙版。
Sprite3D
 Inheritedloaded : Boolean
[read-only] 获取是否已加载完成。
Sprite3D
  LOD_DISTANCE_FACTOR : Number = 2.0
[static]
Terrain
  LOD_TOLERANCE_VALUE : Number = 4
[static]
Terrain
 Inheritedname : String
节点名称。
Node
 InheritednumChildren : int
[read-only] 子对象数量。
Node
 Inheritedparent : Node
父节点。
Node
  RENDER_LINE_MODEL : Boolean = false
[static]
Terrain
 Inheritedscene : Scene
[read-only] 获得所属场景。
Sprite3D
  terrainRes : TerrainRes
[write-only]
Terrain
 Inheritedtimer : Timer
时间控制器,默认为Laya.timer。
Node
 Inheritedtransform : Transform3D
[read-only] 获取精灵变换。
Sprite3D
 Inheritedurl : String
获取资源的URL地址。
Sprite3D
  __VECTOR3__ : Vector3
[static]
Terrain
Public Methods
 MethodDefined By
  
Terrain(terrainRes:TerrainRes = null)
创建一个 MeshSprite3D 实例。
Terrain
 Inherited
_getSortID(renderElement:IRenderable, material:BaseMaterial):int
排序函数。
Sprite3D
 Inherited
_update(state:RenderState):void
更新
Sprite3D
 Inherited
更新
Sprite3D
 Inherited
[override] 添加子节点。
Sprite3D
 Inherited
addChildAt(node:Node, index:int):Node
[override] 添加子节点到指定的索引位置。
Sprite3D
 Inherited
addChildren(... args):void
批量增加子节点
Node
 Inherited
添加指定类型组件。
Sprite3D
  
buildTerrain(terrainRes:TerrainRes):void
Terrain
 Inherited
clearTimer(caller:*, method:Function):void
清理定时器。功能同Laya.timer.clearTimer()。
Node
 Inherited
clone():*
克隆。
Sprite3D
 Inherited
cloneTo(destObject:*):void
克隆。
Sprite3D
 Inherited
contains(node:Node):Boolean
当前容器是否包含指定的 Node 节点对象 。
Node
  
depth():Number
获取地形Z轴长度。
Terrain
 Inherited
destroy(destroyChild:Boolean = true):void
[override] 销毁此对象。destroy对象默认会把自己从父节点移除,并且清理自身引用关系,等待js自动垃圾回收机制回收。destroy后不能再使用。 destroy时会移除自身的事情监听,自身的timer监听,移除子对象及从父节点移除自己。
Sprite3D
 Inherited
销毁所有子对象,不销毁自己本身。
Node
  
Terrain
 Inherited
event(type:String, data:* = null):Boolean
派发事件。
EventDispatcher
 Inherited
frameLoop(delay:int, caller:*, method:Function, args:Array = null, coverBefore:Boolean = true):void
定时重复执行某函数(基于帧率)。功能同Laya.timer.frameLoop()。
Node
 Inherited
frameOnce(delay:int, caller:*, method:Function, args:Array = null, coverBefore:Boolean = true):void
定时执行一次某函数(基于帧率)。功能同Laya.timer.frameOnce()。
Node
 Inherited
getChildAt(index:int):Node
根据子节点的索引位置,获取子节点对象。
Node
 Inherited
getChildByName(name:String):Node
根据子节点的名字,获取子节点对象。
Node
 Inherited
根据子节点对象,获取子节点的索引位置。
Node
 Inherited
通过指定索引获得组件。
Sprite3D
 Inherited
getComponentByType(type:*, typeIndex:int = 0):Component3D
通过指定类型和类型索引获得组件。
Sprite3D
 Inherited
getComponentsByType(type:*, components:Vector.<Component3D>):void
通过指定类型获得所有组件。
Sprite3D
  
getHeightXZ(x:Number, z:Number):Number
获取地形高度。
Terrain
 Inherited
获取投影视图世界矩阵。
Sprite3D
 Inherited
hasListener(type:String):Boolean
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
instantiate(original:Sprite3D, parent:Node = null, worldPositionStays:Boolean = true, position:Vector3 = null, rotation:Quaternion = null):Sprite3D
[static] 创建精灵的克隆实例。
Sprite3D
 Inherited
isMouseEvent(type:String):Boolean
检测指定事件类型是否是鼠标事件。
EventDispatcher
  
load(url:String):Terrain
[static] 加载网格模板,注意:不缓存。
Terrain
 Inherited
loadHierarchy(url:String):void
加载层级文件,并作为该节点的子节点。
Sprite3D
 Inherited
off(type:String, caller:*, listener:Function, onceOnly:Boolean = false):EventDispatcher
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
offAll(type:String = null):EventDispatcher
从 EventDispatcher 对象中删除指定事件类型的所有侦听器。
EventDispatcher
 Inherited
on(type:String, caller:*, listener:Function, args:Array = null):EventDispatcher
[override] 增加事件侦听器,以使侦听器能够接收事件通知。 如果侦听鼠标事件,则会自动设置自己和父亲节点的属性 mouseEnabled 的值为 true(如果父节点mouseEnabled=false,则停止设置父节点mouseEnabled属性)。
Node
 Inherited
onAsynLoaded(url:String, data:*, params:Array):void
private
Sprite3D
 Inherited
once(type:String, caller:*, listener:Function, args:Array = null):EventDispatcher
[override] 增加事件侦听器,以使侦听器能够接收事件通知,此侦听事件响应一次后则自动移除侦听。 如果侦听鼠标事件,则会自动设置自己和父亲节点的属性 mouseEnabled 的值为 true(如果父节点mouseEnabled=false,则停止设置父节点mouseEnabled属性)。
Node
 Inherited
移除全部组件。
Sprite3D
 Inherited
删除子节点。
Node
 Inherited
removeChildAt(index:int):Node
[override] 根据子节点索引位置,删除对应的子节点对象。
Sprite3D
 Inherited
removeChildByName(name:String):Node
根据子节点名字删除对应的子节点对象,如果找不到不会抛出异常。
Node
 Inherited
removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):Node
[override] 删除指定索引区间的所有子对象。
Sprite3D
 Inherited
removeComponentByType(type:*, typeIndex:int = 0):void
通过指定类型和类型索引移除组件。
Sprite3D
 Inherited
通过指定类型移除所有组件。
Sprite3D
 Inherited
从父容器删除自己,如已经被删除不会抛出异常。
Node
 Inherited
replaceChild(newNode:Node, oldNode:Node):Node
替换子节点。
Node
 Inherited
setChildIndex(node:Node, index:int):Node
设置子节点的索引位置。
Node
  
setLightmapIndex(value:int):void
Terrain
  
Terrain
 Inherited
timerLoop(delay:int, caller:*, method:Function, args:Array = null, coverBefore:Boolean = true, jumpFrame:Boolean = false):void
定时重复执行某函数。功能同Laya.timer.timerLoop()。
Node
 Inherited
timerOnce(delay:int, caller:*, method:Function, args:Array = null, coverBefore:Boolean = true):void
定时执行某函数一次。功能同Laya.timer.timerOnce()。
Node
  
width():Number
获取地形X轴长度。
Terrain
Protected Methods
 MethodDefined By
 Inherited
添加自身渲染物体,请重载此函数。
Sprite3D
 Inherited
清理自身渲染物体,请重载此函数。
Sprite3D
  
_parseCustomProps(rootNode:ComponentNode, innerResouMap:Object, customProps:Object, json:Object):void
[override] private
Terrain
 Inherited
更新子节点。
Sprite3D
 Inherited
更新子节点。
Sprite3D
Events
 Event Summary Defined By
 Inherited添加到父对象后调度。Node
 Inherited加入节点树时调度。Node
 Inherited被父对象移除后调度。Node
 Inherited从节点树移除时调度。Node
Property Detail
__VECTOR3__property
public static var __VECTOR3__:Vector3

LOD_DISTANCE_FACTORproperty 
public static var LOD_DISTANCE_FACTOR:Number = 2.0

LOD_TOLERANCE_VALUEproperty 
public static var LOD_TOLERANCE_VALUE:Number = 4

RENDER_LINE_MODELproperty 
public static var RENDER_LINE_MODEL:Boolean = false

terrainResproperty 
terrainRes:TerrainRes  [write-only]


Implementation
    public function set terrainRes(value:TerrainRes):void
Constructor Detail
Terrain()Constructor
public function Terrain(terrainRes:TerrainRes = null)

创建一个 MeshSprite3D 实例。

Parameters
terrainRes:TerrainRes (default = null) — 网格,同时会加载网格所用默认材质。
Method Detail
_parseCustomProps()method
override protected function _parseCustomProps(rootNode:ComponentNode, innerResouMap:Object, customProps:Object, json:Object):void

private

Parameters

rootNode:ComponentNode
 
innerResouMap:Object
 
customProps:Object
 
json:Object

buildTerrain()method 
public function buildTerrain(terrainRes:TerrainRes):void

Parameters

terrainRes:TerrainRes

depth()method 
public function depth():Number

获取地形Z轴长度。

Returns
Number — 地形Z轴长度。
disableLight()method 
public function disableLight():void

getHeightXZ()method 
public function getHeightXZ(x:Number, z:Number):Number

获取地形高度。

Parameters

x:Number — X轴坐标。
 
z:Number — Z轴坐标。

Returns
Number
load()method 
public static function load(url:String):Terrain

加载网格模板,注意:不缓存。

Parameters

url:String — 模板地址。

Returns
Terrain
setLightmapIndex()method 
public function setLightmapIndex(value:int):void

Parameters

value:int

setLightmapScaleOffset()method 
public function setLightmapScaleOffset(value:Vector4):void

Parameters

value:Vector4

width()method 
public function width():Number

获取地形X轴长度。

Returns
Number — 地形X轴长度。