CIMCubeSDK v3.58.0

Class: TrackRoaming

Glodon.CIMCube.Animation.Effect. TrackRoaming

模型漫游特效仿真

new TrackRoaming(map, opt)

模型漫游特效仿真
Parameters:
Name Type Description
map Glodon.CIMCube CIMCube实例
opt Object 模型漫游轨迹参数
Properties
Name Type Argument Default Description
pathList Array 模型轨迹数据
Properties
Name Type Argument Default Description
modelId string 模型id
url number 模型url
size number <optional>
 1 模型大小
speed number <optional>
 漫游飞行速度(m/s)；使用data中的duration
offset Array 模型漫游偏移,[x,y,z]
usedAnimation object 模型启动的骨骼动画,默认为所有动画启动{enable: true,name: "DoMagic2"}
speedup number <optional>
 2 关键帧动画速度
modelShow bool <optional>
 true 模型显示隐藏
modelRotation Object 模型自转，不影响其视角,默认[0,0,0] [roll,pitch,heading]
phongLighting Boolean <optional>
 false 是否使用一般的光照模型(冯氏光照)
alpha number <optional>
 1 透明度
luminanceAtZenith number <optional>
 0.2 亮度
hue number <optional>
 0.0 颜色的色相 (H)SB；值范围：-PI~PI
saturation number <optional>
 1.0 颜色的饱和度 H(S)B；值范围：0~2
brightness number <optional>
 1.0 颜色的明度 HS(B)；值范围：0~2
gamma number <optional>
 1 伽马值,默认为：1
contrast number <optional>
 1 对比度,默认为：1
metallicRoughnessFactor Array 金属度|粗糙度调整;建议用在白膜上,会替换材质中原本金属度|粗糙度; 例：[0.5,0.5]; 取值范围:0~1
doubleSided Boolean <optional>
 false 图层是否使用双面材质, 会覆盖数据属性
shadowMode ShadowMode 阴影模式,默认为 ShadowMode.ENABLED
silhouetteColor Color 描边颜色,默认为rgba(255,255,255,0.3)
silhouetteSize number <optional>
 1 描边宽度 模型的漫游路径
data Array 轨迹数据
Properties
Name Type Description
lon number 漫游位置经度lon
lat number 漫游位置纬度lat
height number 漫游位置高度height
duration number 漫游时间,非必要值; 如果设置了漫游飞行速度, 此duration将无效
heading number 视角heading,非必要值
pitch number 视角pitch,非必要值
roll number 视角roll,非必要值 全模型的参数
scaleSize number <optional>
 1 全模型等比例放大缩小
silhouetteColor Color 全模型描边颜色, 默认为rgba(255,255,255,0.3)
silhouetteSize number <optional>
 1 全模型描边宽度
showPath Boolean <optional>
 false 显示轨迹
eyeHeight number <optional>
 0 跟随后视线高度,单位米
cameraRange number <optional>
 0.1 相机跟随的距离
bezierCurve Boolean <optional>
 false 使用贝塞尔曲线算法
turnCornerSpeed number <optional>
 0.2 转角速度,度/帧
flyToFollowModelDuration number <optional>
 0 飞行到跟随模型的时间
hprLocking bool <optional>
 true hpr姿态是否锁定
callback function 回调函数 雷达相关参数设置
slices number <optional>
 12 光照面数，(360能整除)
lightBeamAlpha number <optional>
 0.5 光束透明度
lightCirqueAlpha number <optional>
 0.5 圆环透明度
cirqueRadius number <optional>
 10 圆环半径
lightColor number 光颜色
floorLevel number <optional>
 0 地表高度
showDebugger Boolean <optional>
 false 是否显示调试。

Members

cameraFollow :Number

相机跟随
Type:
  • Number

cameraHeading :Number

视角头部左右摆动（单位度）
Type:
  • Number

cameraPitch :Number

视角头部上下摆动（单位度）
Type:
  • Number

cameraRange :Number

相机距离模型（单位米）
Type:
  • Number

eyeHeight :Number

视角高度
Type:
  • Number

flyToFollowModelDuration :Number

飞行到跟随模型的时间
Type:
  • Number

hprLocking :bool

hpr姿态是否锁定
Type:
  • bool

pause :Boolean

动画暂停
Type:
  • Boolean

showPath :Boolean

显示轨迹
Type:
  • Boolean

Methods

activeAnimation(index, animationOpt)

激活指定模型的动画
Parameters:
Name Type Description
index number 指定模型的索引
animationOpt Object 动画相关参数对象

dispose()

释放资源

flyToModel(index, duration)

飞行到指定模型
Parameters:
Name Type Description
index number 模型索引
duration number 飞行时间

getAllAnimation(index)

获取指定模型的所有动画信息
Parameters:
Name Type Description
index number 指定模型的索引
Returns:
所有动画信息的对象
Type
Object

initRoamingStatus()

漫游回到Ready状态

play()

轨迹动画开始

removeAllAnimation(index)

移除指定模型的所有动画
Parameters:
Name Type Description
index number 指定模型的索引
Returns:
Type
Object

removeAnimation(index, animationName)

移除指定模型的特定动画
Parameters:
Name Type Description
index number 指定模型的索引
animationName Object 指定动画名称

removeRadarFollow(index)

删除某个模型的雷达特效
Parameters:
Name Type Description
index number 指定模型Index

replay()

轨迹动画重新开始

setModelDisplay(index, display)

设置指定模型的显示或隐藏状态
Parameters:
Name Type Description
index number 指定模型的索引
display boolean 模型是否显示，true 为显示，false 为隐藏

setRadarFollow(index)

为某个模型增加扩散特效
Parameters:
Name Type Description
index number 指定模型Index

setRoamingData(pathList)

设置漫游数据
Parameters:
Name Type Description
pathList Array 模型轨迹数据
Properties
Name Type Argument Default Description
modelId number 轨迹数据
url number 模型url
size number <optional>
 1 模型大小
speed number <optional>
 漫游飞行速度(m/s)；使用data中的duration
offset Array 模型漫游偏移,[x,y,z]
usedAnimation object 模型启动的骨骼动画,默认为所有动画启动{enable: true,name: "DoMagic2"}
speedup number <optional>
 2 关键帧动画速度
modelShow bool <optional>
 true 模型显示隐藏
modelRotation Object 模型自转，不影响其视角,默认[0,0,0] [roll,pitch,heading]
phongLighting Boolean <optional>
 false 是否使用一般的光照模型(冯氏光照)
alpha number <optional>
 1 透明度
luminanceAtZenith number <optional>
 0.2 亮度
hue number <optional>
 0.0 颜色的色相 (H)SB；值范围：-PI~PI
saturation number <optional>
 1.0 颜色的饱和度 H(S)B；值范围：0~2
brightness number <optional>
 1.0 颜色的明度 HS(B)；值范围：0~2
gamma number <optional>
 1 伽马值,默认为：1
contrast number <optional>
 1 对比度,默认为：1
metallicRoughnessFactor Array 金属度|粗糙度调整;建议用在白膜上,会替换材质中原本金属度|粗糙度; 例：[0.5,0.5]; 取值范围:0~1
doubleSided Boolean <optional>
 false 图层是否使用双面材质, 会覆盖数据属性
shadowMode ShadowMode 阴影模式,默认为 ShadowMode.ENABLED
silhouetteColor Color 描边颜色,默认为rgba(255,255,255,0.3)
silhouetteSize number <optional>
 1 描边宽度 模型的漫游路径
data Array 轨迹数据
Properties
Name Type Description
lon number 漫游位置经度lon
lat number 漫游位置纬度lat
height number 漫游位置高度height
duration number 漫游时间,非必要值; 如果设置了漫游飞行速度, 此duration将无效
heading number 视角heading,非必要值
pitch number 视角pitch,非必要值
roll number 视角roll,非必要值

Events

arrivePoint

Example
trackRoaming.on("arrivePoint", function (event) {
 console.log(event);
})