SpotLight
查阅Cesium API

new mars3d.graphic.SpotLight(options)
graphic/custom/SpotLight.js 32

聚光灯 矢量对象，该对象暂不支持鼠标交互和拾取

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

参数对象，包括以下：

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

位置
style SpotLight.StyleOptions

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

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

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

矢量数据id标识
name string 可选

矢量数据名称
show boolean true 可选

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

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

继承

成员(属性)

readonly camera : Cesium.Camera
graphic/custom/PointLight.js 115

相机对象

继承自:

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

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

继承自:

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

中心点坐标

继承自:

color : string|Cesium.Color
graphic/custom/PointLight.js 93

颜色

继承自:

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

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

继承自:

debugAxis : boolean
graphic/primitive/BasePointPrimitive.js 422

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

继承自:

debugAxisLength : number
graphic/primitive/BasePointPrimitive.js 459

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

继承自:

heading : number
graphic/primitive/BasePointPrimitive.js 331

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

继承自:

height : number
graphic/primitive/BasePointPrimitive.js 255

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

继承自:

innerCone : number
graphic/custom/SpotLight.js 86

聚光灯的内圆锥角度，半场角度，取值范围：0-45

intensity : number
graphic/custom/PointLight.js 81

光强度

继承自:

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

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

继承自:

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

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

继承自:

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

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

继承自:

outerCone : number
graphic/custom/SpotLight.js 72

聚光灯的外圆锥角度，半场角度，取值范围：0-45

pitch : number
graphic/primitive/BasePointPrimitive.js 348

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

继承自:

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

位置坐标

继承自:

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

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

继承自:

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

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

继承自:

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

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

继承自:

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

动态位置坐标

继承自:

roll : number
graphic/primitive/BasePointPrimitive.js 365

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

继承自:

readonly shadowMap : Cesium.ShadowMap
graphic/custom/PointLight.js 106

场景的ShadowMap阴影图

继承自:

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

用于 map.trackedEntity 追踪的

继承自:

方法

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

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

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

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

参数对象:

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

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

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

异步计算完成的Promise

继承自:

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

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

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

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

位置坐标(数组对象)

继承自:

定义的类型

mars3d.graphic.SpotLight.StyleOptions
graphic/custom/SpotLight.js 14

聚光灯矢量对象 支持的样式信息

属性:
属性名称 类型 可选 默认值 描述信息
color string | Cesium.Color <可选>
 Cesium.Color.WHITE

光颜色
intensity number <可选>
 10

光强度
radius number <可选>
 1000

聚光灯半径
heading number <可选>
 0

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

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

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

聚光灯的内圆锥角度，半场角度，取值范围：0-45
outerCone number <可选>
 45.0

聚光灯的外圆锥角度，半场角度，取值范围：0-45
addHeight number | string <可选>

偏移高度，在现有坐标基础上增加的高度值,也支持字符串模版配置