ViewShed

new mars3d.graphic.ViewShed(options)

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

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

参数对象,包括以下:

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

相机位置

targetPosition LngLatPoint | Cesium.Cartesian3 | Array.<number> 可选

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

style ViewShed.StyleOptions

样式信息

attr object 可选

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

terrain boolean true 可选

是否启用地形的阴影效果,在平原地区或无地形时可以关闭

id string | number createGuid() 可选

矢量数据id标识

name string '' 可选

矢量数据名称

show boolean true 可选

矢量数据是否显示

eventParent BaseClass | boolean 可选

指定的事件冒泡对象,默认为所加入的图层对象,false时不冒泡事件

flyTo boolean 可选

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

flyToOptions object 可选

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

参考:

继承

成员(属性)

angle : number

水平张角,半场角度

angle2 : number

垂直张角,半场角度

readonly camera : Cesium.Camera

相机对象

readonly center : Cesium.Cartesian3

中心点坐标 (笛卡尔坐标)

继承自:

readonly centerPoint : LngLatPoint

中心点坐标

继承自:

readonly coordinate : Array

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

继承自:

debugAxis : boolean

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

继承自:

debugAxisLength : number

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

继承自:

distance : number

距离,单位:米

heading : number

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

继承自:

height : number

坐标对应的高度值(单位:米)

继承自:

hiddenAreaColor : Cesium.Color

不可视区域颜色

readonly modelMatrix : Cesium.Matrix4

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

继承自:

objectsToExclude : Array.<object>|undefined

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

继承自:

opacity : number

混合系数0-1

readonly orientation : Cesium.Quaternion

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

继承自:

pitch : number

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

继承自:

readonly point : LngLatPoint

位置坐标

继承自:

position : Cesium.Cartesian3|LngLatPoint

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

继承自:

readonly positionShow : Cesium.Cartesian3

当前实时位置坐标(笛卡尔坐标)

继承自:

readonly positionsShow : Array.<Cesium.Cartesian3>

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

继承自:

property : Cesium.SampledPositionProperty|Cesium.CallbackProperty

动态位置坐标

继承自:

roll : number

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

继承自:

readonly shadowMap : Cesium.ShadowMap

场景的ShadowMap阴影图

showFrustum : boolean

是否显示视椎体框线

targetPosition : Cesium.Cartesian3|LngLatPoint

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

readonly trackedEntity : Cesium.Entity|*

用于 map.trackedEntity 追踪的

继承自:

visibleAreaColor : Cesium.Color

可视区域颜色

方法

addDynamicPosition(point, currTime)BasePointPrimitive

设置并添加动画轨迹位置,按“指定时间”运动到达“指定位置”。 【仅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>

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

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

参数对象:

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

是否在3dtiles模型上分析(模型分析较慢,按需开启),默认内部根据点的位置自动判断(但可能不准)

objectsToExclude Array.<object> 可选

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

返回值:

异步计算完成的Promise

继承自:

getCoordinate(noAlt)Array

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

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

true时不导出高度值

返回值:

位置坐标(数组对象)

继承自:

setOpacity(value)void

设置透明度

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

透明度

返回值:

setView()void

定位至相机的第一视角

返回值:

startDraw(layer)void

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

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

图层

返回值:

stopDraw()void

停止绘制

返回值:

定义的类型

mars3d.graphic.ViewShed.StyleOptions

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

属性:
属性名称 类型 可选 默认值 描述信息
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

是否显示视椎体框线