Class: TerrainLayer
CMAP~ TerrainLayer
地形图层类
new TerrainLayer(param)
构造函数
Parameters:
Name | Type | Description | |||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
param | Object | 参数列表 Properties
|
Extends
Members
angles :Array.<number>
三轴相对角度,相对于自身坐标
Type:
- Array.<number>
- Inherited From:
- Overrides:
brothers :THING.Selector
获取物体的所有兄弟对象(排除自己),返回物体对象集合
Type:
- Inherited From:
- Overrides:
children :Array.<THING.BaseObject>
获取子物体列表(数组)
Type:
- Array.<THING.BaseObject>
- Inherited From:
- Overrides:
controls :Array.<Object>
获取控件列表(数组)
Type:
- Array.<Object>
- Inherited From:
- Overrides:
draggable :Boolean
设置/获取 物体是否可被拖拽
Type:
- Boolean
- Inherited From:
- Overrides:
Example
obj.draggable = true
dragState :Number
获取物体当前拖拽状态 THING.DragState.No —— 非拖拽模式、 THING.DragState.DragEnd —— 拖拽结束、 THING.DragState.Dragging —— 拖拽中、
Type:
- Number
- Inherited From:
- Overrides:
id :String
设置/获取 物体 id
Type:
- String
- Inherited From:
- Overrides:
inheritAngles :Boolean
设置/获取 物体是否跟随父物体旋转, 默认true.
Type:
- Boolean
- Inherited From:
- Overrides:
inheritPickable :Boolean
设置/获取 物体拾取是否受父物体影响, 默认 true.
Type:
- Boolean
- Inherited From:
- Overrides:
inheritPosition :Boolean
设置/获取 物体位置是否跟随父物体移动, 默认true.
Type:
- Boolean
- Inherited From:
- Overrides:
inheritScale :Boolean
设置/获取 物体是否跟随父物体缩放, 默认true.
Type:
- Boolean
- Inherited From:
- Overrides:
inheritStyle :Boolean
设置/获取 物体样式是否受父物体影响, 默认 true.
Type:
- Boolean
- Inherited From:
- Overrides:
inheritTheme :Boolean
设置/获取 物体模板是否受父物体影响, 默认 true.
Type:
- Boolean
- Inherited From:
- Overrides:
inheritVisible :Boolean
设置/获取 物体可见性是否受父物体影响, 默认 true.
Type:
- Boolean
- Inherited From:
- Overrides:
keepSize :Boolean
设置/获取 图标是否保持像素大小不变。默认为 false,即图标在 3D 场景中呈现“近大远小”的表现形式。
Type:
- Boolean
- Inherited From:
- Overrides:
Example
// 设置物体始终保持像素大小(不随场景缩放“近大远小”)object.keepSize = true;
localPosition :Array.<number>
设置/获取 物体在父物体坐标系下的相对位置
Type:
- Array.<number>
- Inherited From:
- Overrides:
name :String
设置/获取 物体 name
Type:
- String
- Inherited From:
- Overrides:
parent :THING.BaseObject
获取直接父物体
Type:
- Inherited From:
- Overrides:
parents :THING.Selector
获取所有父物体(祖先),返回物体对象集合,集合中的第一个对象为直接父物体,最后一个为世界根对象
Type:
- Inherited From:
- Overrides:
Example
// 获取某对象的所有父物体var parents=obj.parents;// parents[0] 等同于 obj.parent// 遍历物体集合parents.forEach(function (parent) { THING.Utils.log(parent.name)})
pickable :Boolean
设置/获取 物体是否能被拾取
Type:
- Boolean
- Inherited From:
- Overrides:
position :Array.<number>
设置/获取 物体在世界坐标系下的绝对位置
Type:
- Array.<number>
- Inherited From:
- Overrides:
scale :Array.<number>
物体自身缩放比例
Type:
- Array.<number>
- Inherited From:
- Overrides:
Example
// 等比例缩放 2 倍obj.scale = [2,2,2]
style :THING.BaseStyle
获取物体样式
Type:
- Inherited From:
- Overrides:
subNodes :THING.Selector
获取子部件(模型的 Mesh 列表)
Type:
- Inherited From:
- Overrides:
Example
var subNodes = obj.subNodes;subNodes.forEach(function(subnode){ THING.Utils.log(subnode.name)})
terrainExaggeration :Number
地形夸张倍数
Type:
- Number
Example
map.terrainLayer.terrainExaggeration = 2;//设置地形夸张2倍
type :String
设置/获取 物体类型
Type:
- String
- Inherited From:
- Overrides:
url :String
地形服务的url 支持terrain格式的切片地形服务
Type:
- String
Example
map.terrainLayer.url = 'http://data.marsgis.cn/terrain';//设置地形服务地址map.terrainLayer.url = '';//设置url为空字符串可以取消地形
userData :Object
获取/设置用户自定义属性
Type:
- Object
- Inherited From:
- Overrides:
visible :Boolean
设置/获取 物体显示隐藏状态
Type:
- Boolean
- Inherited From:
- Overrides:
Methods
add(params [, index])
添加子物体
Parameters:
Name Type Argument Description params
THING.BaseObject | * 物体或者参数列表
Properties
Name Type Argument Description object
THING.BaseObject 物体
localPosition
Array.<Number> <optional> 相对于父物体的坐标位置
angles
Array.<Number> <optional> 旋转角度
basePoint
String <optional> 作为位置参考基准的子节点名字
index
Number <optional> 插入下标,默认插入到最后位置
- Inherited From:
- Overrides:
Example
// 将物体 box 作为孩子直接添加到 car 上car.add(box);// 添加子物体 box ,并设置其与父物体的相对位置car.add({ object: box, // 作为孩子的对象 localPosition: [0, 2, 0] // 相对于父物体的坐标});// 以某个“子节点”作为参考基准点,添加子物体car.add({ object: box, basePoint: "chazi", // 作为“基准”的“子节点”名称});
addControl(type [, name]) → {Object}
添加物体控件
Parameters:
Name Type Argument Description type
Object 系统内置控件类型 或 用户自定义控件类型
name
String <optional> 控件自定义名称(用于查找)
- Inherited From:
- Overrides:
Returns:
控件
- Type
- Object
Example
obj.addControl(new THING.AxisTransformControl(obj), 'axisControl');
destroy()
销毁自身及其所有子物体(递归删除)
- Inherited From:
- Overrides:
distanceTo(position) → {Number}
获取物体到某坐标或者另一物体的绝对距离
Parameters:
Name Type Description position
Array.<number> | THING.BaseObject 世界坐标系下的位置 或 另一物体
- Inherited From:
- Overrides:
Returns:
距离
- Type
- Number
Example
// 填写世界坐标系下的位置obj.distanceTo([0,0,0]);// 填写物体对象obj.distanceTo(otherObj);
fadeIn(param)
淡入
Parameters:
Name Type Description param
Object 参数列表
Properties
Name Type Argument Description time
Number <optional> 淡入时间(毫秒) 默认 1s
complete
function <optional> 完成时的回调
- Inherited From:
- Overrides:
Example
obj.fadeIn();// 设置时间和回调obj.fadeIn({ time:2000, complete:function(ev){ THING.Utils.log('complete') }})
fadeOut(param)
淡出
Parameters:
Name Type Description param
Object 参数列表
Properties
Name Type Argument Description time
Number <optional> 淡出时间(毫秒) 默认 1s
complete
function <optional> 完成时的回调
- Inherited From:
- Overrides:
Example
obj.fadeOut();// 设置时间和回调obj.fadeOut({ time:2000, complete:function(ev){ THING.Utils.log('complete') }})
getAttribute(key) → {*}
获取属性值
Parameters:
Name Type Description key
String 属性名,可以使用 a/b/c 的路径方式
- Inherited From:
- Overrides:
Returns:
属性值
- Type
- *
Example
obj.getAttribute("userData/power");
getControl(name) → {Object}
获取控件
Parameters:
Name Type Description name
String 控件自定义名称
- Inherited From:
- Overrides:
Returns:
控件
- Type
- Object
Example
var control = obj.getControl('axisControl');
getEvents(eventType) → {Array.<Object>}
获取绑定的事件列表,返回数组
Parameters:
Name Type Description eventType
THING.EventType | String 事件名称, 如果不传则返回所有已绑定的事件
- Inherited From:
- Overrides:
Returns:
- Type
- Array.<Object>
Example
var events=obj.getEvents();// 返回数组,结构形如:[{"type":"enterlevel","priority":50,"userData":null,'tag':'__level_scene_operations__'},{"type":"leavelevel","priority":50,"userData":null,'tag':'__level_scene_operations__'},{"type":"click","priority":50,"userData":null,'tag':'我的单击事件'}]
hasAttribute(key) → {Boolean}
判断属性是否存在
Parameters:
Name Type Description key
String 属性名,可以使用 a/b/c 的路径方式
- Inherited From:
- Overrides:
Returns:
- Type
- Boolean
Example
// 物体属性 obj.userData.power 是否存在obj.hasAttribute("userData/power");
hasChild(object) → {Boolean}
检测是否拥有此子物体
Parameters:
Name Type Description object
THING.BaseObject 物体
- Inherited From:
- Overrides:
Returns:
- Type
- Boolean
hasControl(control) → {Boolean}
查询是否拥有控件
Parameters:
Name Type Description control
Object | String 控件或者控件自定义名字
- Inherited From:
- Overrides:
Returns:
- Type
- Boolean
Example
obj.hasControl('axisControl');
isBrotherOf(object) → {Boolean}
判断该物体是否为某物体的兄弟
Parameters:
Name Type Description object
THING.BaseObject 物体
- Inherited From:
- Overrides:
Returns:
- Type
- Boolean
isChildOf(parent) → {Boolean}
判断该物体是否为某物体的孩子
Parameters:
Name Type Description parent
THING.BaseObject 物体
- Inherited From:
- Overrides:
Returns:
- Type
- Boolean
lookAt(target, params)
设置物体观察朝向
Parameters:
Name Type Description target
Array.<Number> | THING.BaseObject | THING.CameraController 世界坐标下某坐标、某物体或者摄像机,设为 null 时表示取消观察
params
Array.<Number> | Object 参数列表
Properties
Name Type Argument Description angles
Array.<Number> <optional> 叠加的修正值
lockYAxis
Boolean <optional> 是否锁定 Y 轴
always
Boolean <optional> 是否一直朝向观察物体
- Inherited From:
- Overrides:
Example
//让物体面向[0,1,0],该坐标是在世界坐标下位置obj.lookAt([0,1,0])//让物体一直面向摄影机obj.lookAt(app.camera)//让物体一直面向一个物体obj.lookAt(obj2)//让物体一直面向一个物体,同时物体沿自身Y轴向再旋转90度obj.lookAt(obj2,[0,90,0])//取消lookAt功能obj.lookAt(null)
movePath(params)
沿指定路径移动
Parameters:
Name Type Description params
Object Properties
Name Type Argument Description path
Array.<Number> 路径,由世界坐标系下的坐标点组成
orientToPath
Boolean <optional> 物体方向是否沿路径方向
orientToPathDegree
Number <optional> 相对于路径方向的角度旋转值
time
Number <optional> 沿路径移动的时间(毫秒)
local
Boolean <optional> 输入的坐标是否相对于父物体的位置(默认false), 否则路径为世界坐标
delayTime
Number <optional> 延时执行时间(毫秒)
lerpType
THING.LerpType <optional> 插值类型
loopType
String <optional> 循环类型,默认为 no
update
function <optional> 移动中的回调
complete
function <optional> 移动完成时的回调
- Inherited From:
- Overrides:
Example
// 世界坐标系下坐标点构成的数组 关于坐标的获取 可利用「工具」——>「拾取场景坐标」var path = [[0, 0, 0], [20, 0, 0], [20, 0, 10], [0, 0, 10], [0, 0, 0]];obj.movePath({ orientToPath: true, // 物体移动时沿向路径方向 path: path, // 路径坐标点数组 time: 5 * 1000, // 路径总时间 毫秒 delayTime: 1000, // 延时 1s 执行 lerpType: null, // 插值类型(默认为线性插值)此处设置为不插值 complete: function (ev) { THING.Utils.log(ev.object.name + "移动结束") }});
moveTo(params)
移动到某位置 或 某物体对象
Parameters:
Name Type Description params
Object Properties
Name Type Argument Description position
Array.<Number> | THING.BaseObject 目标位置(世界坐标系下绝对位置) 或 物体对象
orientToPath
Boolean <optional> 是否朝向目标方向
loopType
String <optional> 循环类型,默认为 no
time
Number <optional> 完成移动的时间(毫秒)
offsetPosition
Array.<Number> <optional> 相对于当前位置的移动偏移量(与 position 选填其一)
complete
function <optional> 移动完成时的回调,仅当 loopType 为 no 时才有回调
- Inherited From:
- Overrides:
Example
// 移动到世界坐标系下 [0,0,10] 处位置obj.moveTo([0, 0, 10]);// 3s 移动到世界坐标系下原点位置 [0,0,0]obj.moveTo({ position: [0,0,0], time: 3000, orientToPath: true,// 朝向目标方向 complete:function(ev) { THING.Utils.log(ev.object.name + '移动完成'); }});// 2s 向前移动 10mobj.moveTo({ offsetPosition: [0, 0, 10], // 相对自身 向前移动 10m time: 2 * 1000, orientToPath: true, complete: function (ev) { THING.Utils.log(ev.object.name + '移动完成'); }});
off(eventType, condition, callback)
移除事件绑定
Parameters:
Name Type Description eventType
String 事件类型名称
condition
String 物体类型选择条件
callback
function | String 事件触发的回调函数 或 事件标签(tag)
- Inherited From:
- Overrides:
Example
// 移除所有 Click 事件的绑定obj.off('click');// 移除对物体下 Marker 子物体的 Click 事件绑定obj.off('click','.Marker');// 移除标记为某个事件标签的事件绑定,如果绑定(on)时没写条件,则第二个参数需填写 nullobj.off('click','.Marker','我的点击事件01')obj.off('click',null,'我的点击事件02')
on(eventType [, condition] [, userData], callback [, tag] [, priority])
绑定事件
Parameters:
Name Type Argument Description eventType
String 事件类型名称
condition
String <optional> 物体类型选择条件,用于筛选子物体
userData
Object <optional> 事件传递自定义数据
callback
function 事件触发的回调函数
tag
String <optional> 事件标签
priority
Number <optional> 优先级(默认值 50 ),数值越大优先级越高,越先响应
- Inherited From:
- Overrides:
Example
// 绑定 Click 事件obj.on('click',function(ev){ THING.Utils.log(ev.object.name);})// 给物体下的所有 Marker 类型孩子,绑定 Click 事件obj.on('click','.Marker',function(ev){ THING.Utils.log(ev.object.name);})// 设置事件标签 tagobj.on('click','.Marker',function(ev){ THING.Utils.log(ev.object.name);},'我的点击事件01');// 设置事件优先级obj.on('click',function(ev){ THING.Utils.log(ev.object.name);},'我的点击事件02',51)// 填写 userData 传递参数obj.on('click', { color: '#ff0000' }, function (ev) { var color = ev.data.color; THING.Utils.log(color)});
one(eventType [, condition] [, userData], callback [, tag] [, priority])
绑定事件(只触发一次)
Parameters:
Name Type Argument Description eventType
String 事件类型名称
condition
String <optional> 物体类型选择信息
userData
Object <optional> 事件传递自定义数据
callback
function 事件触发的回调函数
tag
String <optional> 事件标签
priority
Number <optional> 优先级,数值越大优先级越高
- Inherited From:
- Overrides:
pauseEvent(eventType [, condition] [, tag])
暂停事件响应
Parameters:
Name Type Argument Description eventType
THING.EventType | String 事件名称
condition
String <optional> 物体类型选择条件
tag
String <optional> 事件标签
- Inherited From:
- Overrides:
query(param [, recursive]) → {THING.Selector}
在子物体中查询(不包括自己)
Parameters:
Name Type Argument Default Description param
String 查询条件
recursive
Boolean <optional> true 是否递归查询所有子物体, 默认true
- Inherited From:
- Overrides:
Returns:
查询结果
- Type
- THING.Selector
Example
// 查询名称为 car01 的子物体obj.query('car01');// 查询类型为 Marker 的子物体obj.query('.Marker');// 查询id为 001 的子物体obj.query('#001');// 根据自定义属性值筛选子物体obj.query('[userData/power=40]');// 根据正则表达式匹配 name 中包含 'car' 的子物体obj.query(/car/);// 上行代码等同于// var reg = new RegExp('car');// var cars=app.query(reg);
remove(object)
移除子物体
Parameters:
Name Type Description object
THING.BaseObject 物体
- Inherited From:
- Overrides:
removeAllControls()
删除该物体的所有控件
- Inherited From:
- Overrides:
removeControl(control)
删除控件
Parameters:
Name Type Description control
Object | String 控件或控件自定义名称
- Inherited From:
- Overrides:
Example
var control = obj.removeControl('axisControl');
resumeEvent(eventType [, condition] [, tag])
恢复事件响应
Parameters:
Name Type Argument Description eventType
THING.EventType | String 事件名称
condition
String <optional> 物体类型选择信息
tag
String <optional> 事件标签
- Inherited From:
- Overrides:
rotate(angle, axis)
让物体以自身坐标系下指定坐标轴旋转(默认 Y 轴)
Parameters:
Name Type Description angle
Number 旋转角度值
axis
Array.<number> 方向轴,默认为物体 Y 轴方向
- Inherited From:
- Overrides:
Example
// 绕自身 Y 轴旋转45度,等同于 obj.rotateY(45)obj.rotate(45);// 绕自身 X 轴旋转30度,等同于 obj.rotateX(30)obj.rotate( 30, [1,0,0])// 绕自身 Z 轴向旋转-45度,等同于 obj.rotateZ(-45)obj.rotate( -45, [0,0,1])
rotateAround(params)
绕某点或某物体旋转
Parameters:
Name Type Description params
Object 参数列表
Properties
Name Type Argument Description object
THING.BaseObject <optional> 围绕某物体
target
Array.<Number> <optional> 围绕世界坐标系下某位置点
angle
Number <optional> 水平旋转角度
time
Number <optional> 旋转时间(毫秒)
speed
Number <optional> 速度 (与 time 选填其一)
loopType
String <optional> 循环类型
complete
function <optional> 旋转结束时的回调函数,仅当 loopType 为 no 时才有回调
- Inherited From:
- Overrides:
- See:
Example
// obj2 绕着 obj1 旋转360度,2s转完obj2.rotateAround({ object: obj1, angle:360, time:2000, loopType:THING.LoopType.No, complete:function(){ THING.Utils.log('finish') }})// obj 绕着 世界坐标系下的原点旋转360度,2s转完obj.rotateAround({ target: [0,0,0], angle:360, time:2000, loopType:THING.LoopType.No, complete:function(){ THING.Utils.log('finish') }})
rotateTo(params)
在一段时间内物体旋转一定角度
Parameters:
Name Type Description params
Object 参数列表
Properties
Name Type Argument Description angles
Array.<number> 旋转角度
time
Number <optional> 完成旋转的时间(毫秒)
speed
Number <optional> 旋转速度(与 time 选填其一)
loopType
String <optional> 循环类型,默认为 no
lerpType
String <optional> 旋转速度插值类型
complete
function <optional> 旋转完成时的回调函数,仅当 loopType 为 no 时有回调
- Inherited From:
- Overrides:
Example
// 物体绕 Y 轴旋转 90 度,5s 转完obj.rotateTo({ angles: [0, 90, 0], // 旋转角度 time: 5000, // 总时间 complete: function () { THING.Utils.log('rotate complete'); // 旋转结束回调 }})// 物体绕 Y 轴旋转 90 度,5s 变加速转完obj.rotateTo({ angles: [0, 90, 0], time: 5000, lerpType: THING.LerpType.Quadratic.In, // 速度插值 complete: function () { THING.Utils.log('finish') }})
rotateX(value)
绕自身 X 轴旋转
Parameters:
Name Type Description value
Number 旋转角度值
- Inherited From:
- Overrides:
rotateY(value)
绕自身 Y 轴旋转
Parameters:
Name Type Description value
Number 旋转角度值
- Inherited From:
- Overrides:
rotateZ(value)
绕自身 Z 轴旋转
Parameters:
Name Type Description value
Number 旋转角度值
- Inherited From:
- Overrides:
scaleTo(params)
在一段时间内将物体缩放至某比例
Parameters:
Name Type Description params
Object Properties
Name Type Argument Description scale
Array.<number> 缩放值
time
Number <optional> 完成缩放的时间(毫秒)
speed
Number <optional> 缩放速度(与 time 选填其一)
lerpType
THING.LerpType <optional> 缩放速度插值类型
loopType
String <optional> 循环类型,默认为 no
complete
function <optional> 缩放完成时的回调
- Inherited From:
- Overrides:
Example
// 5s 物体缩放至两倍obj.scaleTo({ scale: [2,2,2], // 等比例缩放两倍 time: 5000, complete: function () { THING.Utils.log('scale completed'); // 缩放结束回调 }});// 缩放循环往复进行obj.scaleTo({ scale:[2,2,2], time: 2000, loopType: THING.LoopType.PingPong // 循环类型:来回往复})
selfToWorld(localPos) → {Array.<number>}
将物体自身坐标系下的相对位置转换成世界坐标系下的绝对位置
Parameters:
Name Type Description localPos
Array.<number> 物体自身坐标系下的相对位置
- Inherited From:
- Overrides:
Returns:
世界坐标系下的绝对位置
- Type
- Array.<number>
Example
// 例如某书柜在三楼的原点(相对位置)// floor 为三楼楼层对象,返回结果为书柜在世界坐标系下的绝对位置,比如 [5,6,-15]floor.selfToWorld([0,0,0]);
setAttribute(key, value)
设置属性值
Parameters:
Name Type Description key
String 属性名,可以使用 a/b/c 的路径方式
value
* 属性值
- Inherited From:
- Overrides:
Example
obj.setAttribute("userData/price",50);
setAttributes(attributes [, overwrite])
批量设置属性值
Parameters:
Name Type Argument Default Description attributes
Object 属性列表
overwrite
Boolean <optional> true 是否覆盖原有属性(默认覆盖),如果为 false 表示如果原属性存在,则不会更新属性值
- Inherited From:
- Overrides:
Example
obj.setAttributes({ "userData/power": 50, "userData/pirce": 60})
stopMoving()
停止移动(针对 moveTo 、 movePath)
- Inherited From:
- Overrides:
stopRotating()
停止旋转动画(停止 rotateTo 、rotateAround )
- Inherited From:
- Overrides:
stopScaling()
停止缩放动画( scaleTo )
- Inherited From:
- Overrides:
translate(offset)
相对于自身坐标系进行移动
Parameters:
Name Type Description offset
Array.<Number> 相对于自身坐标系的偏移量
- Inherited From:
- Overrides:
Example
// 沿 X 轴移动 1m (即 左移 1m)obj.translate([1,0,0]);// 沿 Y 轴移动 1m (即 上移 1m)obj.translate([0,1,0]);// 沿 Z 轴移动 1m (即 向前移动 1m)obj.translate([0,0,1]);
trigger(eventType [, ev] [, tag])
触发事件
Parameters:
Name Type Argument Description eventType
THING.EventType | String 事件名称
ev
Object <optional> 事件信息,传递回调参数
tag
String <optional> 事件标签
- Inherited From:
- Overrides:
Example
// 触发自定义的告警事件obj.trigger('Alarm');obj.on('Alarm',function(ev){ THING.Utils.log(ev.object.name);})// 传递参数obj.trigger('Alarm',{level:2});obj.on('Alarm',function(ev){ THING.Utils.log(ev.level)})
worldToSelf(worldPos) → {Array.<number>}
将世界坐标系下的绝对位置转换成物体自身的坐标系下的相对位置
Parameters:
Name Type Description worldPos
Array.<number> 世界坐标系下的绝对位置
- Inherited From:
- Overrides:
Returns:
相对坐标
- Type
- Array.<number>
Example
// 例如三楼某书柜在世界坐标系下的绝对坐标是 [5,6,-15]// floor 为三楼楼层对象,返回结果为书柜相对于该楼层的坐标,比如 [0,0,0]floor.worldToSelf([5,6,-15]);