CIMCubeSDK v3.34.0

Class: GSMMLayer

Glodon.CIMCube.Layer. GSMMLayer

GSMMLayer图层

new GSMMLayer(opts)

GSMMLayer图层构造函数
Parameters:
Name Type Description
opts Object 图层配置参数
Properties
Name Type Argument Default Description
url String .gsmm文件的url;
assetsUrl String assets文件夹位置;
origin Array 图层原点在地球上的位置，用经纬度表示，例：[106.689936, 29.559434, 500.0]
offset Array 偏移量，单位米，例：[1000.0, 500.0, 100.0]
rotation Array 旋转参数（右手坐标系，第一个元素绕X轴旋转指定角度，第二个元素绕Y轴旋转指定角度，第三个元素绕Z轴旋转指定角度）
scale Number 图层放大与缩小比例,默认1
luminanceAtZenith Number 光源亮度,默认0.2
gamma Number 伽马值,默认为：1
contrast Number 对比度,默认为：1
hue Number 颜色的色相 (H)SB,默认0.0;值范围：-PI~PI
saturation Number 颜色的饱和度 H(S)B,默认1.0;值范围：0~2
brightness Number 颜色的明度 HS(B),默认1.0;值范围：0~2
metallicRoughnessFactor Array 金属度|粗糙度调整;建议用在白膜上,会替换材质中原本金属度|粗糙度; 例：[0.5,0.5];取值范围:0~1
doubleSided Boolean 图层是否使用双面材质, 会覆盖图层内部材质的双面属性, 该值默认为undefined
shadowMode ShadowMode <optional>
 ShadowMode.DISABLED 阴影模式
color Color 吊绳的颜色,默认#191919
radius Number 吊绳的半径,默认0.02
slices Number 吊绳的绘制精细程度,默认16
dynamicPoint Object 动态点特效
Properties
Name Type Description
show Boolean 是否显示
type Number 特效类型,默认"breathe"：呼吸特效
color Color 特效颜色,默认rgba(0,127.5,255,1.0)
duration Number 特效时长(单位秒),默认2.0
delay Number 特效间隔时长(单位秒),默认1.0
radius Number 特效半径，默认1m
points Array 特效点坐标数组,模型坐标：[{Cartesian3},Cartesian3,...]

Extends

Members

alpha :Number

透明度 0.0~1.0
Type:
  • Number
Overrides:

boxColor :Color

包围盒颜色
Type:
  • Color

brightness :Number

明度调整
Type:
  • Number

cacheable :Boolean

是否可缓存
Type:
  • Boolean
Inherited From:
Overrides:

canHighlight :Boolean

可否高亮
Type:
  • Boolean
Inherited From:
Overrides:

canSelected :Boolean

可否被选中
Type:
  • Boolean
Inherited From:
Overrides:

colorMode :String

色彩模式调整
Type:
  • String

contrast :Number

对比度调整
Type:
  • Number

enableMouseMove :Boolean

图层是否可以触发鼠标移动事件
Type:
  • Boolean
Inherited From:
Overrides:
Default Value:
  • true

gamma :Number

伽马值调整
Type:
  • Number

glowColor :String

发光颜色
Type:
  • String
Inherited From:
Overrides:

glowTimeInterval :String

闪烁的颜色
Type:
  • String
Inherited From:
Overrides:

gsmm :GSMM

返回封装的gsmm对象
Type:
  • GSMM

hue :Number

色相调整
Type:
  • Number

id :String

id
Type:
  • String
Inherited From:
Overrides:

inverseTransformMatrix4 :Cesium.Matrix4

模型逆变换矩阵
Type:
  • Cesium.Matrix4

isPipeline :Boolean

数据是否是管线类型
Type:
  • Boolean
Inherited From:
Overrides:

lightColor :ArrayList|Color

光颜色调整
Type:
  • ArrayList | Color

luminanceAtZenith :Number

图层光源亮度
Type:
  • Number

matrix :Object

图层偏移
Type:
  • Object
Inherited From:
Overrides:

metallicRoughnessFactor :ArrayList

金属度与粗糙度调整;建议用在白膜上,会替换材质中原本金属度|粗糙度; 例：[0.5,0.5];取值范围:0~1
Type:
  • ArrayList

name :String

图层名称
Type:
  • String
Inherited From:
Overrides:

offset :Array

获取偏移量,第一个元素表示向东偏移的距离，第二个元素表示向北偏移的距离，第三个元素表示向上偏移的距离，单位米
Type:
  • Array

origin :Array.<Number>

图层原点在地球上的位置，用经纬度表示，例：[106.689936, 29.559434, 500.0]
Type:
  • Array.<Number>

pickable :Boolean

pickable
Type:
  • Boolean
Inherited From:
Overrides:

<readonly> ready :Boolean

数据是否已经加载
Type:
  • Boolean
Inherited From:
Overrides:

rotation :Array.<Number>

旋转参数（右手坐标系，第一个元素绕X轴旋转指定角度，第二个元素绕Y轴旋转指定角度，第三个元素绕Z轴旋转指定角度）
Type:
  • Array.<Number>

rotationPointOffset :Cartesian3

图层指定的旋转点，模型坐标系下基于原点的偏移点，默认是包围盒中心点
Type:
  • Cartesian3
Inherited From:
Overrides:

saturation :Number

饱和度调整
Type:
  • Number

scale :Number

缩放比例系数
Type:
  • Number
Default Value:
  • 1

selectedColor :String

选中颜色
Type:
  • String
Inherited From:
Overrides:

shadowMode :ShadowMode

阴影模式
Type:
  • ShadowMode

show :Boolean

图层是否显示
Type:
  • Boolean
Overrides:

showOrientedBoundingBox :Boolean

显示|隐藏有向包围盒
Type:
  • Boolean

transform :Cesium.Matrix4

模型变换矩阵
Type:
  • Cesium.Matrix4

<readonly> type :String

图层类型
Type:
  • String
Inherited From:
Overrides:

url :String

图层url地址
Type:
  • String
Inherited From:
Overrides:

Methods

addDragHandle(options)

在场景中添加操作句柄
Parameters:
Name Type Description
options Object [optional], 配置参数
Properties
Name Type Description
dragModelTipUI DragModelTipUI [optional], 自定义的tip ui实例
tips String [optional] default:'单击鼠标左键选择需要操作的模型', 提示字符
showTips Boolean [optional] default true, 是否显示提示字符
dragModelUI DragModelUI [optional], 自定义的模型实例；
enableTranslationX Boolean [optional] default: true, // X轴平移
enableTranslationY Boolean [optional] default: true, // Y轴平移
enableTranslationZ Boolean [optional] default: true, // Z轴平移
enableTranslationXY Boolean [optional] default: true, // XOY面平移
enableTranslationYZ Boolean [optional] default: true, // YOZ面平移
enableTranslationXZ Boolean [optional] default: true, // XOZ面平移
enableRotationX Boolean [optional] default: true, // X轴旋转
enableRotationY Boolean [optional] default: true, // X轴旋转
enableRotationZ Boolean [optional] default: true, // X轴旋转
enableScaleX Boolean [optional] default: false, // X缩放
enableScaleY Boolean [optional] default: false, // Y缩放
enableScaleZ Boolean [optional] default: false, // Z缩放
targetScaleRange Array.<Number> [optional] default: [0.1, +infinity],
axisTranslationYColor String [optional] default: red
axisTranslationXColor String [optional] default: green
axisTranslationZColor String [optional] default: blue
axisTranslationXYColor String [optional] default: red
axisTranslationYZColor String [optional] default: green
axisTranslationXZColor String [optional] default: blue
axisRotationXColor String [optional] default: red
axisRotationYColor String [optional] default: green
axisRotationZColor String [optional] default: blue
axisScaleXColor String [optional] default: red
axisScaleYColor String [optional] default: green
axisScaleZColor String [optional] default: blue
continueEdit Boolean [optional] default: false, 是否持续编辑，即点击下个对象将会让组件转移到其上；
UIScaling Number [optional] default: 1.0, 缩放UI的系数，engine会忽略小于等于0的数字；
noUI Boolean [optional] default: false, 是否不创建UI
Overrides:
  • Glodon.CIMCube.Layer.BaseLayer#addDragHandle

addTo(map)

将图层添加到图层管理器中
Parameters:
Name Type Description
map Glodon.CIMCube 地图实例
Inherited From:
Overrides:

dispatchEvent(event)

在此事件派发器上派发事件.
Parameters:
Name Type Description
event Object 待派发的事件.
Inherited From:
Overrides:

dispose()

释放资源

enableDynamicPointEffect(enable)

动态点特效
Parameters:
Name Type Description
enable Boolean 是否开启动态点特效

flyTo()

摄像机定位到图层

getOriginWorldCoord()

获取图层原点坐标
Returns:
图层原点坐标
Type
Cartesian3

getParentId()

获取父节点ID
Inherited From:
Overrides:
Returns:
父节点ID
Type
String

localToWorldPosition(localPosition)

通过模型局部坐标获取世界坐标
Parameters:
Name Type Description
localPosition Cartesian3 模型局部坐标
Returns:
模型世界坐标
Type
Cartesian3

move(angle, distance [, mode])

指定角度移动, 顺时针旋转
Parameters:
Name Type Argument Default Description
angle Number 表示指定角度, 单位：度; y-x的0度为正北, z-x的0度为垂直地表向外, z-y的0度为垂直地表向外;
distance Number 移动的距离, 单位：米;
mode String <optional>
 "y-x" 指定平面内进行移动; 枚举值：y-x、z-x、z-y;
Returns:
图层offset
Type
Array

removeDragHandle()

在场景中移除操作句柄
Inherited From:
Overrides:

removeFrom()

将图层从图层管理器中移除
Inherited From:
Overrides:

setDynamicPointEffect(opts)

设置动态点特效参数
Parameters:
Name Type Description
opts Object 特效参数
Properties
Name Type Description
type Number 特效类型,默认"breathe"：呼吸特效
color Color 特效颜色,默认rgba(0,127.5,255,1.0)
duration Number 特效时长(单位秒),默认2.0
delay Number 特效间隔时长(单位秒),默认1.0
radius Number 特效半径，默认1m
points Array 特效点坐标数组,模型坐标,最多支持16个点：[{Cartesian3},Cartesian3,...]

updateModelMatrix()

更新Node的位置

updateWeight(position)

设置图层的位置
Parameters:
Name Type Description
position Cartesian3 位置

worldPositionToLocal(worldPosition)

通过世界坐标获取模型模型局部坐标
Parameters:
Name Type Description
worldPosition Cartesian3 模型世界坐标
Returns:
模型局部坐标
Type
Cartesian3

Events

LOADED

数据加载完成后触发
Example
layer.on(Glodon.CIMCube.Global.Defines.LayerEventType.LOADED, function (event) {
 console.log(event);
})

TRANSFORM_CHANGED

图层变换矩阵发生变化后触发
Example
layer.on(Glodon.CIMCube.Global.Defines.LayerEventType.TRANSFORM_CHANGED, function (event) {
 console.log(event);
})