MovingTargetLayer - Cesium Documentation

MovingTargetLayer

动目标图层类

new Cesium.MovingTargetLayer(options)

Name Type Description

options

Object

对象具有以下属性：

Name	Type	Default	Description
`uri`	String		服务器地址
`name`	String	`"MovingTargetLayer"`	optional 图层名
`interval`	String	`3`	optional 图层update更新的时间间隔，单位是秒。默认为3(每3秒更新一次)
`canDragSign`	Boolean	`true`	optional 动目标上的标牌是否能被拖动

Example:

// 创建动目标图层
let movingTargetLayer3D = new SuperMap3D.MovingTargetLayer({ name: "MovingTargetLayer" });
// 获取动目标图层组
let mGISManager = new SuperMap3D.MGISManager({ scene: scene, serverUrl: serverUrl });
let movingTargetLayers = mGISManager.movingTargetLayers;
// 将动目标图层添加到动目标图层组中
movingTargetLayers.add(movingTargetLayer3D);

Methods

addDetailedSign(targetID, signProperty) → boolean

添加动目标的详细标牌

Name	Type	Description
`targetID`	String	动目标ID
`signProperty`	DomSignProperty \| HtmlTemplateSignProperty \| ImageSignProperty \| ParameterSignProperty	标牌属性

Returns:

成功返回true, 否则返回false

addSign(targetID, signProperty) → boolean

添加动目标的标牌

Name	Type	Description
`targetID`	String	动目标ID
`signProperty`	DomSignProperty \| HtmlTemplateSignProperty \| ImageSignProperty \| ParameterSignProperty	标牌属性

Returns:

成功返回true, 否则返回false

addTarget()

添加动目标

Name	Type	Description
`information.targetID`	String	目标id
`information.position`	MPoint3D	目标位置
`information.rotation`	MPoint3D	目标方向

addTargetClickedEvent(callback)

添加鼠标左键单击事件

Name	Type	Description
`callback`	MovingTargetLayer~callback	回调事件，参数{ targetID: "0", movingTargetPartType: MovingTargetPartType.MovingTarget }

addTargetDoubleClickedEvent(callback)

添加鼠标左键双击事件

Name	Type	Description
`callback`	MovingTargetLayer~callback	回调事件，参数{ targetID: "0", movingTargetPartType: MovingTargetPartType.MovingTarget }

addTargetRightClickedEvent(callback)

添加鼠标右键单击事件

Name	Type	Description
`callback`	MovingTargetLayer~callback	回调事件，参数{ targetID: "0", movingTargetPartType: MovingTargetPartType.MovingTarget }

addTrackLine(targetID) → boolean

添加动目标的轨迹线

Name	Type	Description
`targetID`	String	动目标ID

Returns:

添加成功返回true,否则返回false

clearTargetMode(targetID) → Boolean

清除指定目标的风格，采用图层默认风格

Name	Type	Description
`targetID`	String	目标id

Returns:

是否成功

destroy()

销毁图层对象

getCanDragSign() → Boolean

获取标牌能否被拖动

Returns:

标牌能被拖动返回true,否则返回false

getDefalutMode() → object

获取动目标默认的显示模式

Returns:

显示模式参数（参数详情见: setDefaultMode() 接口）

getDetailedSignParm(targetID) → DomSignProperty|HtmlTemplateSignProperty|ImageSignProperty|ParameterSignProperty

获取动目标的详细标牌参数

Name	Type	Description
`targetID`	String	动目标ID

Returns:

标牌属性类对象，通过该对象的getMovingTargetSignType()接口获取属性类型

getFarViewStateMode() → Object

获取图层远观显示模式

Returns:

显示模式参数（参数详情见: setNearViewStateMode() 接口）

getFirstShowDetailedSign(targetID) → boolean

获取动目标是否优先显示详细标牌

Name	Type	Description
`targetID`	String	动目标ID

Returns:

动目标显示返回true,隐藏返回false,其他返回undefined

getMovingTargetIDs() → Array

获取所有的动目标ID

Returns:

id数组

getName() → String

获取图层名

Returns:

返回图层名

getNearViewStateMode() → Object

获取图层近观显示模式

Returns:

显示模式参数（参数详情见: setNearViewStateMode() 接口）

getSignParm(targetID) → DomSignProperty|HtmlTemplateSignProperty|ImageSignProperty|ParameterSignProperty

获取动目标的标牌参数

Name	Type	Description
`targetID`	String	动目标ID

Returns:

标牌属性类对象，通过该对象的getMovingTargetSignType()接口获取属性类型

getSignVisible(targetID) → boolean

获取动目标标牌显隐(包含标牌和详细标牌)

Name	Type	Description
`targetID`	String	动目标ID

Returns:

动目标显示返回true,隐藏返回false,其他返回undefined

getTargetByBounds(left, up, right, bottom) → Array.<String>

根据经纬度范围获取动目标ID

Name	Type	Description
`left`	Number	左
`up`	Number	下
`right`	Number	右
`bottom`	Number	上

Returns:

返回范围内的动目标ID数组

getTargetMode(targetID) → Object

获取指定ID动目标的风格

Name	Type	Description
`targetID`	String	目标id

Returns:

目标风格

getTargetPositionAndRotation(targetID) → Object

获取目标当前位置方向

Name	Type	Description
`targetID`	String	动目标ID

Returns:

options.position 和 options.rotation 目标位置和方向

getTargetVisible(targetID) → boolean

获取动目标的显隐

Name	Type	Description
`targetID`	String	动目标ID

Returns:

显示返回true, 隐藏返回false，其他返回undefined

getTrackLineStyle() → Obejct

获取图层的轨迹样式

Name	Type	Description
`options.trajectoryLengt`	Number	轨迹线显示长度,单位：个
`options.intervalDistance`	Number	轨迹最小取点间距,单位：米
`options.lineWidth`	Number	尾迹最小取点间距, 单位：像素
`options.aryGradientColors`	Array.<Color>	渐变色颜色数组(最多支持5个)

Returns:

options 轨迹线样式参数,参数包含如下：

getTrackLineVisible(targetID) → boolean

获取动目标轨迹线的显隐

Name	Type	Description
`targetID`	String	动目标ID

Returns:

显示返回true,隐藏返回false,其他返回undefined

getUpdateInterval() → Number

获取更新的时间间隔，单位秒

Returns:

时间间隔

getURI() → String

获取服务器地址

Returns:

服务器地址

isVisible() → boolean

获取图层显隐

Returns:

显示返回true,否则返回false

removeAllTarget()

移除所有动目标

removeDetailedSign(targetID) → boolean

移除动目标的详细标牌

Name	Type	Description
`targetID`	String	动目标ID

Returns:

成功返回true, 否则返回false

removeSign(targetID) → boolean

移除动目标的标牌

Name	Type	Description
`targetID`	String	动目标ID

Returns:

成功返回true, 否则返回false

removeTarget(targetID)

根据id移除动目标

Name	Type	Description
`targetID`	String	动目标id

removeTargetClickedEvent(callback)

移除鼠标左键单击事件

Name	Type	Description
`callback`	MovingTargetLayer~callback	回调事件

removeTargetDoubleClickedEvent(callback)

移除鼠标左键双击事件

Name	Type	Description
`callback`	MovingTargetLayer~callback	回调事件

removeTargetRightClickedEvent(callback)

移除鼠标右键单击事件

Name	Type	Description
`callback`	MovingTargetLayer~callback	回调事件

removeTrackLine(targetID)

移除动目标的尾迹线

Name	Type	Description
`targetID`	Stirng	动目标ID

setCanDragSign(canDrag)

设置标牌是否能被拖动

Name	Type	Description
`canDrag`	Boolean	是否能被拖动

setDefaultMode(options)

设置动目标默认的显示模式

Name Type Description

options

object

显示模式及风格

Name	Type	Description
`showMode`	DotMode	显示模式
`libID`	Number	标号库id
`code`	Number	标号code
`gridSymbolSize`	Cartesian2	标号大小
`picturePath`	String	图片路径
`pictureSymbolSize`	Cartesian2	图片大小
`modelPath`	String	模型路径
`modelScale`	Number	模型缩放
`vectorScale`	Number	矢量缩放

setDetailedSignParm(targetID, signProperty) → boolean

更新动目标的详细标牌

Name	Type	Description
`targetID`	String	动目标ID
`signProperty`	DomSignProperty \| HtmlTemplateSignProperty \| ImageSignProperty \| ParameterSignProperty	标牌属性

Returns:

成功返回true, 否则返回false

setFarViewStateMode(height, options)

设置图层远观显示模式

Name	Type	Description
`height`	Number	大于该高度时显示
`options`	Object	显示模式参数（参数详情见: setNearViewStateMode() 接口）

setFirstShowDetailedSign(targetID, isFirst)

设置动目标是否优先显示详细标牌

Name	Type	Description
`targetID`	String	动目标ID
`isFirst`	boolean	是否优先显示详细标牌

setName(name)

设置图层名

Name	Type	Description
`name`	String	图层名称

setNearViewStateMode(height, options)

设置图层近观显示模式

Name Type Description

height Number 大于该高度时显示

options

Object

显示模式参数

Name	Type	Description
`showMode`	DotMode	显示模式
`libID`	Number	标号库id
`code`	Number	标号code
`gridSymbolSize`	Cartesian2	标号大小
`picturePath`	String	图片路径
`pictureSymbolSize`	Cartesian2	图片大小
`pictureColor`	Color	图片颜色(注意：最终颜色为图片颜色和图片纹理相乘的颜色，如果只想使用图片颜色建议将图片纹理改为白色背景)
`modelPath`	String	模型路径
`modelScale`	Number	模型缩放
`modelColor`	Color	模型颜色
`vectorScale`	Number	矢量缩放

setSignParm(targetID, signProperty) → boolean

更新动目标的标牌参数

Name	Type	Description
`targetID`	String	动目标ID
`signProperty`	DomSignProperty \| HtmlTemplateSignProperty \| ImageSignProperty \| ParameterSignProperty	标牌属性

Returns:

成功返回true, 否则返回false

setSignVisible(targetID)

设置动目标标牌显隐(包含标牌和详细标牌)

Name	Type	Description
`targetID`	String	动目标ID

setTargetMode(targetID, modeJson)

设置指定ID动目标风格

Name Type Description

targetID String 目标id

modeJson

Object

风格

Name	Type	Description
`showMode`	DotMode	显示模式及风格
`libID`	Number	标号库id
`code`	Number	标号code
`gridSymbolSize`	Cartesian2	标号大小
`picturePath`	String	图片路径
`pictureSymbolSize`	Cartesian2	图片大小
`modelPath`	String	模型路径
`modelScale`	Number	模型缩放
`vectorScale`	Number	矢量缩放

setTargetVisible(targetID, isVisible)

设置动目标的显隐

Name	Type	Description
`targetID`	String	动目标ID
`isVisible`	boolean	动目标的显隐

setTrackLineStyle(options)

设置图层的轨迹样式

Name Type Description

options

Obejct

轨迹线参数

Name	Type	Default	Description
`trajectoryLength`	Number	`15`	optional 轨迹线显示长度,单位：个，默认显示15个，-1为全部显示
`intervalDistance`	Number	`1.0`	optional 轨迹最小取点间距,单位：米
`lineWidth`	Number	`1`	optional 尾迹最小取点间距, 单位：像素
`aryGradientColors`	Array	`[Color.RED]`	optional 渐变色颜色数组(最多支持5个)

setTrackLineVisible(targetID, isVisible)

设置动目标轨迹线的显隐

Name	Type	Description
`targetID`	String	动目标ID
`isVisible`	boolean	是否显示

setUpdateInterval(interval)

设置更新的时间间隔。注意：如果参数小于0.1，则实时更新；否则按间隔插值更新。

Name	Type	Description
`interval`	Number	时间间隔(一位小数，默认值是3, 单位秒)

setURI(uri)

设置服务器地址，默认为"http://localhost:8090"

Name	Type	Description
`uri`	String	服务器地址

setVisible(isVisible)

设置图层显隐

Name	Type	Description
`isVisible`	boolean	显隐

updateTarget()

更新指定ID的动目标待执行的姿态

说明如下：

1、定义了位置，未定义方向，则根据动目标上一姿态位置点和当前姿态位置点自动计算运动方向

2、定义了方向，未定义位置，则把方向设置到动目标上（如果动目标还未运动到插值终点，则将动目标移动到插值终点）

3、给图片动目标设置方向时，information.rotation.z代表图片的方向，默认图片在屏幕竖中直向上为0度

Name	Type	Description
`information.targetID`	String	目标id
`information.position`	MPoint3D	目标位置
`information.rotation`	MPoint3D	目标方向

Type Definitions

callback(params)

鼠标点击事件回调函数

Name Type Description

params

Object

返回参数对象

Name	Type	Description
`targetID`	String	动目标ID
`movingTargetPartType`	Object	动目标选中部位枚举，请参见`MovingTargetPartType`