ViewShed
查阅Cesium API

new mars3d.graphic.ViewShed(options)
graphic/custom/ViewShed.js 41

可视域 矢量对象，该对象暂不支持鼠标交互和拾取

参数名称 类型 描述信息
options object

参数对象，包括以下：

参数名称 类型 默认值 描述信息
position LngLatPoint | Cesium.Cartesian3 | Cesium.PositionProperty | BaseGraphic.AjaxPosition | Array.<number> | string 可选

坐标位置
targetPosition LngLatPoint | Cesium.Cartesian3 | Array.<number> 可选

目标视点位置,可以替代style中的相机heading\pitch\roll方向和distance距离参数
style ViewShed.StyleOptions

样式信息
attr object | BaseGraphic.AjaxAttr 可选

附件的属性信息，可以任意附加属性，导出geojson或json时会自动处理导出。
terrain boolean true 可选

是否启用地形的阴影效果，在平原地区或无地形时可以关闭
depthBiasStep number 1 可选

控制准确度和锯齿的参数，如需更精确可以传0.1、如需更平滑传100优化锯齿感（牺牲了一点精度）
id string | number createGuid() 可选

矢量数据id标识
name string 可选

矢量数据名称
show boolean true 可选

矢量数据是否显示
eventParent BaseClass | boolean 可选

指定的事件冒泡对象，默认为所加入的图层对象，false时不冒泡事件
flyTo boolean 可选

加载完成数据后是否自动飞行定位到数据所在的区域。
flyToOptions object 可选

加载完成数据后是否自动飞行定位到数据所在的区域的对应 BaseGraphic#flyTo方法参数。
参考:

继承

成员(属性)

angle : number
graphic/custom/ViewShed.js 91

水平张角，半场角度

angle2 : number
graphic/custom/ViewShed.js 104

垂直张角，半场角度

readonly camera : Cesium.Camera
graphic/custom/ViewShed.js 189

相机对象

readonly center : Cesium.Cartesian3
graphic/primitive/BasePointPrimitive.js 236

中心点坐标 （笛卡尔坐标）

继承自:

readonly centerPoint : LngLatPoint
graphic/primitive/BasePointPrimitive.js 245

中心点坐标

继承自:

readonly coordinate : Array
graphic/primitive/BasePointPrimitive.js 227

位置坐标(数组对象)，示例[113.123456,31.123456,30.1]

继承自:

debugAxis : boolean
graphic/primitive/BasePointPrimitive.js 420

是否显示3个方向轴，用于对比测试

继承自:

debugAxisLength : number
graphic/primitive/BasePointPrimitive.js 457

显示3个方向轴时的对应轴长度，用于对比测试

继承自:

distance : number
graphic/custom/ViewShed.js 166

距离，单位：米

heading : number
graphic/primitive/BasePointPrimitive.js 329

四周方向角，0-360度角度值
提示：父类属性，非所有子类都具备

继承自:

height : number
graphic/primitive/BasePointPrimitive.js 253

坐标对应的高度值（单位：米）

继承自:

hiddenAreaColor : Cesium.Color
graphic/custom/ViewShed.js 129

不可视区域颜色

readonly modelMatrix : Cesium.Matrix4
graphic/primitive/BasePointPrimitive.js 316

将图元(所有几何实例)从模型转换为世界坐标的4x4变换矩阵。
提示：父类属性，非所有子类都具备

继承自:

objectsToExclude : Array.<object>|undefined
graphic/primitive/BasePointPrimitive.js 379

贴模型分析时，排除的不进行贴模型计算的模型对象，默认是当前本身，可以是： primitives, entities 等

继承自:

opacity : number
graphic/custom/ViewShed.js 141

混合系数0-1

readonly orientation : Cesium.Quaternion
graphic/primitive/BasePointPrimitive.js 302

三维空间中的旋转 【仅部分对象支持】

继承自:

pitch : number
graphic/primitive/BasePointPrimitive.js 346

俯仰角，上下摇摆的角度，0-360度角度值
提示：父类属性，非所有子类都具备

继承自:

readonly point : LngLatPoint
graphic/primitive/BasePointPrimitive.js 212

位置坐标

继承自:

position : Cesium.Cartesian3|LngLatPoint
graphic/primitive/BasePointPrimitive.js 122

位置坐标 （笛卡尔坐标）, 赋值时可以传入LatLngPoint对象

继承自:

readonly positionShow : Cesium.Cartesian3
graphic/primitive/BasePointPrimitive.js 197

当前实时位置坐标（笛卡尔坐标）

继承自:

readonly positionsShow : Array.<Cesium.Cartesian3>
graphic/primitive/BasePointPrimitive.js 188

同 positions只是为了兼容entity的同名属性

继承自:

property : Cesium.SampledPositionProperty|Cesium.CallbackProperty
graphic/primitive/BasePointPrimitive.js 575

动态位置坐标

继承自:

roll : number
graphic/primitive/BasePointPrimitive.js 363

滚转角，左右摆动的角度，0-360度角度值
提示：父类属性，非所有子类都具备

继承自:

readonly shadowMap : Cesium.ShadowMap
graphic/custom/ViewShed.js 180

场景的ShadowMap阴影图

showFrustum : boolean
graphic/custom/ViewShed.js 153

是否显示视椎体框线

targetPosition : Cesium.Cartesian3|LngLatPoint
graphic/custom/ViewShed.js 197

目标点位置(笛卡尔坐标)

readonly trackedEntity : Cesium.Entity|*
graphic/primitive/BasePointPrimitive.js 398

用于 map.trackedEntity 追踪的

继承自:

visibleAreaColor : Cesium.Color
graphic/custom/ViewShed.js 117

可视区域颜色

方法

addDynamicPosition(point, currTime) → BasePointPrimitive
graphic/primitive/BasePointPrimitive.js 619

设置并添加动画轨迹位置，按“指定时间”运动到达“指定位置”。 【仅LabelPrimitive、PointPrimitive、BillboardPrimitive、ModelPrimitive 等部分子类支持】

参数名称 类型 默认值 描述信息
point LngLatPoint | Cesium.Cartesian3 | Array.<number>

指定位置坐标
currTime Cesium.JulianDate | Date | string | number Cesium.JulianDate.now() 可选

指定时间。当为String时，可以传入'2021-01-01 12:13:00'; 当为Number时，可以传入当前时间延迟的秒数。
返回值:

当前对象本身，可以链式调用

继承自:

autoSurfaceHeight(options) → Promise.<object>
graphic/primitive/BasePointPrimitive.js 740

异步计算更新坐标高度进行贴地(或贴模型)，内部自动调用PointUtil#getSurfaceHeight方法处理。

参数名称 类型 默认值 描述信息
options object {} 可选

参数对象:

参数名称 类型 默认值 描述信息
has3dtiles boolean auto 可选

是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
objectsToExclude Array.<object> 可选

贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
返回值:

异步计算完成的Promise

继承自:

getCoordinate(noAlt) → Array
graphic/primitive/BasePointPrimitive.js 753

位置坐标(数组对象)，示例[113.123456,31.123456,30.1]

参数名称 类型 描述信息
noAlt boolean

true时不导出高度值
返回值:

位置坐标(数组对象)

继承自:

setOpacity(value) → void
graphic/custom/ViewShed.js 592

设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。 对象本身透明度请用 graphic.setStyle({ opacity: value })

参数名称 类型 描述信息
value number

透明度
返回值:

无

setView() → void
graphic/custom/ViewShed.js 570

定位至相机的第一视角

返回值:

无

startDraw(layer) → void
graphic/custom/ViewShed.js 603

开始绘制矢量数据，绘制的数据会加载在layer图层。

参数名称 类型 描述信息
layer GraphicLayer

图层
返回值:

无

stopDraw() → void
graphic/custom/ViewShed.js 628

停止绘制

返回值:

无

定义的类型

mars3d.graphic.ViewShed.StyleOptions
graphic/custom/ViewShed.js 21

可视域矢量对象 支持的样式信息

属性:
属性名称 类型 可选 默认值 描述信息
angle number <可选>
 60

水平张角(度数)，半场角度，取值范围 0-60
angle2 number <可选>
 45

垂直张角(度数)，半场角度，取值范围 0-45
distance number <可选>

投射最远距离，单位：米
heading number <可选>
 0

方向角 （度数值，0-360度）
pitch number <可选>
 0

俯仰角（度数值，0-360度）
roll number <可选>
 0

翻滚角（度数值，0-360度）
opacity number <可选>
 0.6

透明度 0.0 - 1.0
visibleAreaColor Cesium.Color | string <可选>
 new Cesium.Color(0, 1, 0)

可视区域颜色
hiddenAreaColor Cesium.Color | string <可选>
 new Cesium.Color(1, 0, 0)

不可视区域颜色
addHeight number <可选>

在坐标点增加的高度值，规避遮挡，效果更友好
showFrustum boolean <可选>
 false

是否显示视椎体框线