CIMCubeSDK v3.44.0

Class: USDLayer

Glodon.CIMCube.Layer. USDLayer

USD 图层，用于加载并显示 USD(.usda, .usdc, .usd, .usdz) 模型

new USDLayer(opts)

USD 图层构造函数
Parameters:
Name Type Description
opts Object 图层配置参数
Properties
Name Type Argument Default Description
url String USD 资源地址（.usda / .usdc / .usd / .usdz）
origin Array.<Number> 图层原点 [经度, 纬度, 高度]，例：[106.689936, 29.559434, 500.0]
scale Number <optional>
 1 缩放

Extends

Members

alpha :Number

图层透明度 0.0~1.0
Type:
  • Number
Inherited From:
Overrides:
Default Value:
  • 1.0

cacheable :Boolean

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

canHighlight :Boolean

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

canSelected :Boolean

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

enableMouseMove :Boolean

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

glowColor :String

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

glowTimeInterval :number

闪烁的时间间隔
Type:
  • number
Inherited From:
Overrides:

<readonly> id :String

id
Type:
  • String
Inherited From:
Overrides:

isPipeline :Boolean

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

matrix :Object

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

name :String

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

origin :Array.<Number>

图层原点 [经度, 纬度, 高度]
Type:
  • Array.<Number>

pickable :Boolean

pickable
Type:
  • Boolean
Inherited From:
Overrides:

<readonly> ready :Boolean

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

rotationPointOffset :Cartesian3

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

scale :Number

缩放
Type:
  • Number

selectedColor :String

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

show :Boolean

是否显示
Type:
  • Boolean
Overrides:

<readonly> type :String

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

<readonly> url :String

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

Methods

addAllAnimations(playOpt)

添加所有动画
Parameters:
Name Type Description
playOpt Object 动画选项
Properties
Name Type Argument Default Description
playMode Number <optional>
 Cesium.ModelAnimationLoop.REPEAT 播放模式
multiplier Number <optional>
 1 倍速
delay Number <optional>
 0 延迟
reverse Boolean <optional>
 false 是否反向
Returns:
动画，模型不可用时返回 undefined
Type
Cesium.ModelAnimation | undefined

addAnimation(animationOpt)

添加动画
Parameters:
Name Type Description
animationOpt Object 动画选项
Properties
Name Type Argument Default Description
name String <optional>
 动画名称
index Number <optional>
 动画索引
playMode Number <optional>
 Cesium.ModelAnimationLoop.REPEAT 播放模式
multiplier Number <optional>
 倍速
delay Number <optional>
 延迟
reverse Boolean <optional>
 是否反向
Returns:
动画，模型不可用或未指定 name/index 时返回 undefined
Type
Cesium.ModelAnimation | undefined

addTo(map)

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

dispatchEvent(event)

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

dispose()

释放资源

flyTo()

摄像机定位到图层。需在 Model 加载完成后再执行飞行，内部通过 Model.readyEvent 监听， 在 ready 时根据 Model 的 boundingSphere 飞行。
Returns:
已安排飞行时 resolve(true)，无法飞行时 resolve(false)
Type
Promise.<boolean>

getAllAnimation()

获取所有动画
Returns:
动画列表，模型不可用时返回 undefined
Type
Array.<Cesium.ModelAnimation> | undefined

getAnimationByIndex(index)

根据索引获取动画
Parameters:
Name Type Description
index Number 动画索引
Returns:
Type
Cesium.ModelAnimation | undefined

getAnimationByName(animationName)

根据名称获取动画
Parameters:
Name Type Description
animationName String 动画名称
Returns:
Type
Cesium.ModelAnimation | undefined

getBoundingSphere()

获取模型包围球。仅当内部 Model 已加载完成（ready）时有效，否则返回 undefined。
Returns:
Type
Cesium.BoundingSphere | undefined

getModel()

获取内部 Cesium Model，用于动画等高级操作。仅当图层已加载且未销毁时有效。
Returns:
Type
Cesium.Model | undefined

getParentId()

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

removeAllAnimation()

移除所有动画

removeAnimation(targetAnimation)

移除动画
Parameters:
Name Type Description
targetAnimation Cesium.ModelAnimation 目标动画

removeDragHandle()

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

Events

LOADED

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