mars3d 3.3.14 → 3.3.17

package/dist/mars3d.d.ts

@@ -2,8 +2,8 @@
 /**
  * Mars3D三维可视化平台  mars3d
  *
- * 版本信息：v3.3.14
- * 编译日期：2022-06-14 10:26:40
+ * 版本信息：v3.3.17
+ * 编译日期：2022-07-04 20:20:28
  * 版权所有：Copyright by 火星科技  http://mars3d.cn
  * 使用单位：免费公开版 ，2022-02-01
  */
@@ -144,11 +144,11 @@ declare enum EffectType {
  */
 declare enum EventType {
     /**
-     * 添加对象
+     * 添加对象(本身)
      */
     add = "add",
     /**
-     * 移除对象
+     * 移除对象(本身)
      */
     remove = "remove",
     /**
@@ -1907,10 +1907,10 @@ declare class MapSplit extends BaseControl {
     /**
      * 对瓦片图层设置卷帘方向
      * @param layer - 图层
-     * @param splitDirection - 图层显示的方向
+     * @param [splitDirection] - 图层显示的方向
      * @returns 无
      */
-    setLayerSplitDirection(layer: BaseTileLayer | GroupLayer, splitDirection: Cesium.SplitDirection): void;
+    setLayerSplitDirection(layer: BaseTileLayer | GroupLayer, splitDirection?: Cesium.SplitDirection): void;
     /**
      * 控件类型
      */
@@ -2174,14 +2174,14 @@ declare class BaseClass {
      * 触发指定类型的事件。
      * @param type - 事件类型
      * @param [data] - 传输的数据或对象，可在事件回调方法中event对象中获取进行使用
-     * @param [propagate = null] - 将事件传播给父类 (用addEventParent设置)
+     * @param [propagate] - 将事件传播给父类 (用addEventParent设置)
      * @returns 当前对象本身,可以链式调用
      */
     fire(type: EventType | string, data?: any, propagate?: BaseClass): BaseClass;
     /**
      * 是否有绑定指定的事件
      * @param type - 事件类型
-     * @param [propagate = null] - 是否判断指定的父类 (用addEventParent设置的)
+     * @param [propagate] - 是否判断指定的父类 (用addEventParent设置的)
      * @returns 是否存在
      */
     listens(type: EventType | string, propagate?: BaseClass): boolean;
@@ -2548,6 +2548,11 @@ declare class LngLatPoint {
      * @returns 地理坐标(弧度制)
      */
     toCartographic(): Cesium.Cartographic;
+    /**
+     * 转换为 WebMercator投影平面坐标
+     * @returns WebMercator投影平面坐标,示例：[13048882.06,3741659.72]
+     */
+    toMercator(): number[];
     /**
      * 将此属性与提供的属性进行比较并返回, 如果两者相等返回true，否则为false
      * @param [other] - 比较的对象
@@ -2565,7 +2570,7 @@ declare class LngLatPoint {
      * @param [time = Cesium.JulianDate.now()] - Cesium坐标时，getValue传入的时间值
      * @returns 转换返回的LatLngPoint对象
      */
-    static parse(position: string | any[] | any | Cesium.Cartesian3 | any, time?: Cesium.JulianDate): LngLatPoint;
+    static parse(position: string | any[] | LngLatPoint | Cesium.Cartesian3 | any, time?: Cesium.JulianDate): LngLatPoint;
     /**
      * 根据数组数据，转换返回LatLngPoint对象
      * 示例：[113.123456,31.123456,30.1]
@@ -2593,20 +2598,33 @@ declare class LngLatPoint {
      * @returns 转换返回的LatLngPoint对象
      */
     static fromCartographic(cartographic: Cesium.Cartographic): LngLatPoint;
+    /**
+     * 根据传入的 WebMercator投影平面坐标，转换返回LatLngPoint对象
+     * @param arrdata - WebMercator投影平面坐标，示例：[13048882.06,3741659.72]
+     * @returns 转换返回的LatLngPoint对象
+     */
+    static fromMercator(arrdata: number[]): LngLatPoint;
     /**
      * 根据传入的各种对象数据，转换返回Cartesian3对象
      * @param position - 坐标位置
      * @param [time = Cesium.JulianDate.now()] - Cesium坐标时，getValue传入的时间值
      * @returns 转换返回的Cartesian3对象
      */
-    static toCartesian(position: string | any[] | any | Cesium.Cartesian3 | any, time?: Cesium.JulianDate): Cesium.Cartesian3;
+    static toCartesian(position: string | any[] | LngLatPoint | Cesium.Cartesian3 | any, time?: Cesium.JulianDate): Cesium.Cartesian3;
     /**
      * 根据传入的各种对象数据，转换返回Cartographic对象
      * @param position - 坐标位置
      * @param [time = Cesium.JulianDate.now()] - Cesium坐标时，getValue传入的时间值
      * @returns 转换返回的Cartographic对象
      */
-    static toCartographic(position: string | any[] | any | Cesium.Cartesian3 | any, time?: Cesium.JulianDate): Cesium.Cartographic;
+    static toCartographic(position: string | any[] | LngLatPoint | Cesium.Cartesian3 | any, time?: Cesium.JulianDate): Cesium.Cartographic;
+    /**
+     * 转换返回经纬度坐标数组
+     * @param value - 坐标位置数组
+     * @param [noAlt] - 是否包含高度值
+     * @returns 经纬度坐标数组,示例： [123.123456,32.654321,198.7]
+     */
+    static toArray(value: string | any[] | Cesium.Cartesian3 | any, noAlt?: boolean): any[][];
     /**
      * 经度纬度的格式化时的长度，默认为6
      */
@@ -2780,7 +2798,7 @@ declare class BaseEffect extends BaseThing {
      * 触发指定类型的事件。
      * @param type - 事件类型
      * @param [data] - 传输的数据或对象，可在事件回调方法中event对象中获取进行使用
-     * @param [propagate = null] - 将事件传播给父类 (用addEventParent设置)
+     * @param [propagate] - 将事件传播给父类 (用addEventParent设置)
      * @returns 当前对象本身,可以链式调用
      */
     fire(type: EventType | string, data?: any, propagate?: BaseClass): BaseClass;
@@ -3568,7 +3586,7 @@ declare class BaseGraphic extends BaseClass {
      * 触发指定类型的事件。
      * @param type - 事件类型
      * @param [data] - 传输的数据或对象，可在事件回调方法中event对象中获取进行使用
-     * @param [propagate = null] - 将事件传播给父类 (用addEventParent设置)
+     * @param [propagate] - 将事件传播给父类 (用addEventParent设置)
      * @returns 当前对象本身,可以链式调用
      */
     fire(type: EventType | string, data?: any, propagate?: BaseClass): BaseClass;
@@ -4955,8 +4973,8 @@ declare class ParticleSystem extends BasePointPrimitive {
 declare namespace Tetrahedron {
     /**
      * 四面体（顶部正方形+倒立的三角椎体） 支持的样式信息
-     * @property [width = 20] - 顶部正方形长宽，单位：米
-     * @property [height = 30] - 倒立的三角椎体部分高度，单位：米
+     * @property [width = 20] - 顶部大小，顶部正方形长宽，单位：米
+     * @property [height = 30] - 椎体高度，倒立的三角椎体部分高度，单位：米
      * @property [color = new Cesium.Color(0.8, 0.8, 0, 0.8)] - 颜色
      * @property [animation = true] - 是否动画
      * @property [moveHeight = 30] - 动画时，上下移动的单程总高度，单位：米
@@ -4975,7 +4993,7 @@ declare namespace Tetrahedron {
 }
 
 /**
- * 四面体（顶部正方形+倒立的三角椎体），该对象暂不支持鼠标交互和拾取
+ * 四面体（顶部正方形+倒立的三角椎体）
  * @param options - 参数对象，包括以下：
  * @param options.position - 坐标位置
  * @param [options.modelMatrix] - 将图元(所有几何实例)从模型转换为世界坐标的4x4变换矩阵,可以替代position。
@@ -5571,7 +5589,7 @@ declare class DivGraphic extends BaseGraphic {
      * 异步计算更新坐标高度进行贴地(或贴模型)，内部自动调用{@link PointUtil#getSurfaceHeight}方法处理。
      * @param [options = {}] - 参数对象:
      * @param [options.has3dtiles = auto] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
-     * @param [options.objectsToExclude = null] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
+     * @param [options.objectsToExclude] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
      * @param options.callback - 异步计算高度完成后 的回调方法
      * @returns 当前对象本身，可以链式调用
      */
@@ -5639,9 +5657,11 @@ declare class DivGraphic extends BaseGraphic {
 declare namespace DivLightPoint {
     /**
      * 动画的扩散div点 支持的样式信息
-     * @property [color = '#f33349'] - CSS颜色
-     * @property [horizontalOrigin] - 横向方向的定位
-     * @property [verticalOrigin] - 垂直方向的定位
+     * @property [color = '#f33349'] - 点的颜色
+     * @property [size = 10] - 高宽大小，单位:像素
+     * @property [label] - 文本
+     * @property [label.text] - 文本内容
+     * @property [label.color] - 文本颜色
      * @property [offsetX] - 用于非规则div时，横向偏移的px像素值
      * @property [offsetY] - 用于非规则div时，垂直方向偏移的px像素值
      * @property [scaleByDistance = false] - 是否按视距缩放
@@ -5661,8 +5681,11 @@ declare namespace DivLightPoint {
      */
     type StyleOptions = any | {
         color?: string;
-        horizontalOrigin?: Cesium.HorizontalOrigin;
-        verticalOrigin?: Cesium.VerticalOrigin;
+        size?: number;
+        label?: {
+            text?: string;
+            color?: string;
+        };
         offsetX?: number;
         offsetY?: number;
         scaleByDistance?: boolean;
@@ -6208,10 +6231,10 @@ declare class BaseEntity extends BaseGraphic {
     /**
      * 高亮闪烁 Enity实体对象
      * @param options - 参数
-     * @param [options.time = null] - 闪烁的时长(秒)，未设置时不自动停止。
+     * @param [options.time] - 闪烁的时长(秒)，未设置时不自动停止。
      * @param [options.color = Cesium.Color.YELLOW] - 高亮的颜色
      * @param [options.maxAlpha = 0.3] - 闪烁的最大透明度，从 0 到 maxAlpha 渐变
-     * @param [options.onEnd = null] - 播放完成后的回调方法
+     * @param [options.onEnd] - 播放完成后的回调方法
      * @returns 高亮闪烁控制 对象
      */
     startFlicker(options: {
@@ -6417,7 +6440,7 @@ declare class BasePointEntity extends BaseEntity {
      * 异步计算更新坐标高度进行贴地(或贴模型)，内部自动调用{@link PointUtil#getSurfaceHeight}方法处理。
      * @param [options = {}] - 参数对象:
      * @param [options.has3dtiles = auto] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
-     * @param [options.objectsToExclude = null] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
+     * @param [options.objectsToExclude] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
      * @param options.callback - 异步计算高度完成后 的回调方法
      * @returns 当前对象本身，可以链式调用
      */
@@ -6566,7 +6589,7 @@ declare class BasePolyEntity extends BaseEntity {
      * 异步计算更新坐标高度进行贴地(或贴模型)，内部自动调用{@link PolyUtil#computeSurfacePoints}方法处理。
      * @param [options = {}] - 参数对象:
      * @param [options.has3dtiles = auto] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
-     * @param [options.objectsToExclude = null] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
+     * @param [options.objectsToExclude] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
      * @param [options.offset = 0] - 可以按需增加偏移高度（单位：米），便于可视
      * @returns 异步计算完成的Promise
      */
@@ -7416,10 +7439,10 @@ declare class FlickerEntity {
      * 高亮闪烁 Enity实体对象
      * @param entitys - entity对象或对象数组
      * @param [opts = {}] - 控制参数
-     * @param [opts.time = null] - 闪烁的时长(秒)，未设置时不自动停止。
+     * @param [opts.time] - 闪烁的时长(秒)，未设置时不自动停止。
      * @param [opts.color = Cesium.Color.YELLOW] - 高亮的颜色
      * @param [opts.maxAlpha = 0.3] - 闪烁的最大透明度，从 0 到 maxAlpha 渐变
-     * @param [opts.onEnd = null] - 播放完成后的回调方法
+     * @param [opts.onEnd] - 播放完成后的回调方法
      * @returns 高亮闪烁控制 对象
      */
     startFlicker(entitys: Cesium.Entity | Cesium.Entity[], opts?: {
@@ -12247,7 +12270,7 @@ declare class BasePointPrimitive extends BasePrimitive {
      * 异步计算更新坐标高度进行贴地(或贴模型)，内部自动调用{@link PointUtil#getSurfaceHeight}方法处理。
      * @param [options = {}] - 参数对象:
      * @param [options.has3dtiles = auto] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
-     * @param [options.objectsToExclude = null] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
+     * @param [options.objectsToExclude] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
      * @param options.callback - 异步计算高度完成后 的回调方法
      * @returns 当前对象本身，可以链式调用
      */
@@ -12377,7 +12400,7 @@ declare class BasePolyPrimitive extends BasePrimitive {
      * 异步计算更新坐标高度进行贴地(或贴模型)，内部自动调用{@link PolyUtil#computeSurfacePoints}方法处理。
      * @param [options = {}] - 参数对象:
      * @param [options.has3dtiles = auto] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
-     * @param [options.objectsToExclude = null] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
+     * @param [options.objectsToExclude] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
      * @param [options.offset = 0] - 可以按需增加偏移高度（单位：米），便于可视
      * @returns 异步计算完成的Promise
      */
@@ -12934,7 +12957,7 @@ declare namespace CloudPrimitive {
      * 积云 Primitive矢量数据 支持的样式信息
      * @property scale - 积云的比例（以米为单位）。该scale属性会影响广告牌的大小，但不会影响云的实际外观。
      * @property maximumSize - 积云的最大尺寸。这定义了云可以出现的最大椭球体积。这不是保证特定的大小，而是指定了云出现的边界，改变它可以影响云的形状。
-     * @property slice - 云的“切片”，即为广告牌外观选择的云的特定横截面。给定一个介于 0 和 1 之间的值，切片根据其在 z 方向上的最大尺寸指定与云相交的深度。
+     * @property slice - 切片，即为广告牌外观选择的云的特定横截面。给定一个介于 0 和 1 之间的值，切片根据其在 z 方向上的最大尺寸指定与云相交的深度。
      * @property [brightness = 1.0] - 亮度
      */
     type StyleOptions = any | {
@@ -16154,7 +16177,7 @@ declare namespace RoamLine {
  * @param [options.fixedFrameTransform = Cesium.Transforms.eastNorthUpToFixedFrame] - 参考系
  * @param [options.clampToTileset = false] - 是否贴3dtiles模型上（贴模型效率较慢，按需开启）
  * @param [options.frameRateHeight = 30] - 当clampToTileset：true时，控制贴模型的效率，多少帧计算一次贴模型高度,
- * @param [options.objectsToExclude = null] - 贴模型分析时，排除的不进行贴模型计算的模型对象，默认是当前本身，可以是： primitives, entities, 或 3D Tiles features
+ * @param [options.objectsToExclude] - 贴模型分析时，排除的不进行贴模型计算的模型对象，默认是当前本身，可以是： primitives, entities, 或 3D Tiles features
  * @param [options.shadow] - 设置投影或附加的对象，支持类型：
  * @param [options.shadow.wall] - wall类型所支持的参数
  * @param [options.shadow.cylinder] - cylinder类型所支持的参数
@@ -16295,9 +16318,9 @@ declare class RoamLine extends BaseRoamLine {
      * 计算贴地线
      * @param [options] - 控制参数
      * @param [options.splitNum = 100] - 插值数，等比分割的个数
-     * @param [options.minDistance = null] - 插值最小间隔(单位：米)，优先级高于splitNum
+     * @param [options.minDistance] - 插值最小间隔(单位：米)，优先级高于splitNum
      * @param [options.has3dtiles = auto] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
-     * @param [options.objectsToExclude = null] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
+     * @param [options.objectsToExclude] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
      * @param [options.offset = 0] - 可以按需增加偏移高度（单位：米），便于可视
      * @param [options.callback] - 计算完成的回调方法
      * @returns 异步计算完成的Promise
@@ -16789,7 +16812,7 @@ declare class BaseLayer extends BaseClass {
      * 触发指定类型的事件。
      * @param type - 事件类型
      * @param [data] - 传输的数据或对象，可在事件回调方法中event对象中获取进行使用
-     * @param [propagate = null] - 将事件传播给父类 (用addEventParent设置)
+     * @param [propagate] - 将事件传播给父类 (用addEventParent设置)
      * @returns 当前对象本身,可以链式调用
      */
     fire(type: EventType | string, data?: any, propagate?: BaseClass): BaseClass;
@@ -18104,7 +18127,7 @@ declare namespace GraphicLayer {
 /**
  * 矢量数据图层
  * @param [options] - 参数对象，包括以下：
- * @param [options.data = null] - 需要自动加载的数据，内部自动生成Graphic对象。{@link GraphicUtil#.create}
+ * @param [options.data] - 需要自动加载的数据，内部自动生成Graphic对象。{@link GraphicUtil#.create}
  * @param [options.hasEdit = false] - 是否自动激活编辑（true时，单击后自动激活编辑）
  * @param [options.isAutoEditing = true] - 完成标绘时是否自动启动编辑(需要hasEdit:true时)
  * @param [options.isContinued = false] - 是否连续标绘,联系标绘状态下无法编辑已有对象。
@@ -18383,7 +18406,7 @@ declare class GraphicLayer extends BaseGraphicLayer {
      * 异步计算更新坐标进行贴地(或贴模型)
      * @param [options = {}] - 参数对象:
      * @param [options.has3dtiles = auto] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
-     * @param [options.objectsToExclude = null] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
+     * @param [options.objectsToExclude] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
      * @param options.callback - 异步计算高度完成后 的回调方法
      * @param options.endItem - 异步计算高度完成后 的回调方法
      * @returns 绘制创建完成的Promise,等价于callback参数
@@ -19764,7 +19787,7 @@ declare class GroupLayer extends BaseGraphicLayer {
     /**
      * 是否有同名的子图层，一般用于新增时判断
      * @param name - 图层名称
-     * @param [excludedLayer = null] - 可以指定不进行判断的图层，比如当前图层本身
+     * @param [excludedLayer] - 可以指定不进行判断的图层，比如当前图层本身
      * @returns 是否同名
      */
     hasLayer(name: string, excludedLayer?: BaseLayer): boolean;
@@ -23235,18 +23258,27 @@ declare namespace Map {
      * 以下是Cesium.Viewer所支持的options【控件相关的写在另外的control属性中】
      * @property [sceneMode = Cesium.SceneMode.SCENE3D] - 初始场景模式。可以设置进入场景后初始是2D、2.5D、3D 模式。
      * @property [scene3DOnly = false] - 为 true 时，每个几何实例将仅以3D渲染以节省GPU内存。
-     * @property [mapProjection = new Cesium.GeographicProjection()] - 在二维模式下地图的呈现坐标系，默认为EPSG4326坐标系，如果需要EPSG3857墨卡托坐标系展示，传 new Cesium.WebMercatorProjection() 即可
+     * @property [mapProjection = new Cesium.GeographicProjection()] - 在二维模式下时，地图的呈现坐标系，默认为EPSG4326坐标系，如果需要EPSG3857墨卡托坐标系展示，传 new Cesium.WebMercatorProjection() 即可
+     * @property [mapMode2D = Cesium.MapMode2D.INFINITE_SCROLL] - 在二维模式下时，地图是可旋转的还是可以在水平方向无限滚动。
      * @property [shouldAnimate = true] - 是否开启时钟动画
      * @property [shadows = false] - 是否启用日照阴影
      * @property [useDefaultRenderLoop = true] - 如果此小部件应控制渲染循环，则为true，否则为false。
      * @property [targetFrameRate] - 使用默认渲染循环时的目标帧速率。
      * @property [useBrowserRecommendedResolution = true] - 如果为true，则以浏览器建议的分辨率渲染，并忽略 window.devicePixelRatio 。
      * @property [automaticallyTrackDataSourceClocks = true] - 如果为true，则此小部件将自动跟踪新添加的数据源的时钟设置，并在数据源的时钟发生更改时进行更新。如果要独立配置时钟，请将其设置为false。
-     * @property [contextOptions] - WebGL创建属性 传递给 Cesium.Scene 的 options 。{@link Cesium.Scene}.
+     * @property [contextOptions = {}] - WebGL创建属性 传递给 Cesium.Scene 的 options 。{@link Cesium.Scene}
+     * @property [contextOptions.allowTextureFilterAnisotropic = true] - 允许纹理过滤各向异性
+     * @property [contextOptions.requestWebgl2 = false] - 是否启用webgl2
+     * @property [contextOptions.webgl] - WebGL画布,用于 canvas.getContext("webgl", webglOptions)
+     * @property [contextOptions.webgl.alpha = false] - 是否包含alpha缓冲区，如果需要DIV透明时，需要改为true
+     * @property [contextOptions.webgl.antialias] - 是否执行抗锯齿
+     * @property [contextOptions.webgl.failIfMajorPerformanceCaveat] - 如果系统性能较低，是否创建上下文
+     * @property [contextOptions.webgl.depth] - 绘图缓冲区的深度缓冲区至少为16位
+     * @property [contextOptions.webgl.stencil = true] - 绘图缓冲区具有至少8位的模板缓冲区
+     * @property [contextOptions.webgl.powerPreference = "high-performance"] - 对用户代理的提示，指示GPU的哪种配置适合WebGL上下文
      * @property [orderIndependentTranslucency = true] - 如果为true，并且配置支持它，则使用顺序无关的半透明性。
      * @property [terrainShadows = Cesium.ShadowMode.RECEIVE_ONLY] - 确定地形是否投射或接收来自光源的阴影。
-     * @property [mapMode2D = Cesium.MapMode2D.INFINITE_SCROLL] - 确定2D地图是可旋转的还是可以在水平方向无限滚动。
-     * @property [requestRenderMode = false] - 是否显示渲染，如果为真，渲染帧只会在需要时发生，这是由场景中的变化决定的。启用可以减少你的应用程序的CPU/GPU使用量，并且在移动设备上使用更少的电池，但是需要使用 {@link Scene#requestRender} 在这种模式下显式地渲染一个新帧。在许多情况下，在API的其他部分更改场景后，这是必要的。参见 {@link https://cesium.com/blog/2018/01/24/cesium-scene-rendering-performance/|Improving Performance with Explicit Rendering}.
+     * @property [requestRenderMode = false] - 是否显式渲染，如果为真，渲染帧只会在需要时发生，这是由场景中的变化决定的。启用可以减少你的应用程序的CPU/GPU使用量，并且在移动设备上使用更少的电池，但是需要使用 {@link Scene#requestRender} 在这种模式下显式地渲染一个新帧。在许多情况下，在API的其他部分更改场景后，这是必要的。参见 {@link https://cesium.com/blog/2018/01/24/cesium-scene-rendering-performance/|Improving Performance with Explicit Rendering}.
      * @property [maximumRenderTimeChange = 0.0] - 如果requestRenderMode为true，这个值定义了在请求渲染之前允许的模拟时间的最大变化。参见 {@link https://cesium.com/blog/2018/01/24/cesium-scene-rendering-performance/|Improving Performance with Explicit Rendering}.
      *
      * 以下是Cesium.Globe对象相关参数
@@ -23255,7 +23287,7 @@ declare namespace Map {
      * @property [globe.baseColor = '#546a53'] - 地球背景色 ，css颜色值
      * @property [globe.depthTestAgainstTerrain = false] - 是否启用深度监测,可以开启来测试矢量对象是否在地形下面或被遮挡。
      * @property [globe.showGroundAtmosphere = true] - 是否在地球上绘制的地面大气
-     * @property [globe.enableLighting = false] - 是否显示昼夜区域
+     * @property [globe.enableLighting = false] - 是否显示晨昏线，可以看到地球的昼夜区域
      * @property [globe.tileCacheSize = 100] - 地形图块缓存的大小，表示为图块数。任何其他只要不需要渲染，就会释放超出此数目的图块这个框架。较大的数字将消耗更多的内存，但显示细节更快例如，当缩小然后再放大时。
      * @property [globe.terrainExaggeration = 1.0] - 地形夸张倍率，用于放大地形的标量。请注意，地形夸张不会修改其他相对于椭球的图元。
      * @property [globe.realAlt = false] - 地形夸张倍率，在测量高度和下侧提示的高度信息中是否转换为实际真实高度值。
@@ -23263,11 +23295,11 @@ declare namespace Map {
      *
      * 以下是Cesium.ScreenSpaceCameraController对象相关参数
      * @property [cameraController] - 相机操作相关参数
-     * @property [cameraController.zoomFactor = 3.0] - 鼠标滚轮放大的步长参数
-     * @property [cameraController.constrainedAxis = true] - 为false时 解除在南北极区域鼠标操作限制
-     * @property [cameraController.minimumZoomDistance = 1.0] - 变焦时相机位置的最小量级（以米为单位），默认为1。该值是相机与地表(含地形)的相对距离。
-     * @property [cameraController.maximumZoomDistance = 50000000.0] - 变焦时相机位置的最大值（以米为单位）。该值是相机与地表(含地形)的相对距离。
-     * @property [cameraController.minimumCollisionTerrainHeight = 80000] - 低于此高度时绕鼠标键绕圈，大于时绕视图中心点绕圈。
+     * @property [cameraController.minimumZoomDistance = 1.0] - 相机最近视距，变焦时相机位置的最小量级（以米为单位），默认为1。该值是相机与地表(含地形)的相对距离。
+     * @property [cameraController.maximumZoomDistance = 50000000.0] - 相机最远视距，变焦时相机位置的最大值（以米为单位）。该值是相机与地表(含地形)的相对距离。
+     * @property [cameraController.zoomFactor = 3.0] - 滚轮放大倍数，控制鼠标滚轮操作的步长
+     * @property [cameraController.minimumCollisionTerrainHeight = 80000] - 最小碰撞高度，低于此高度时绕鼠标键绕圈，大于时绕视图中心点绕圈。
+     * @property [cameraController.constrainedAxis = true] - 南北极绕轴心旋转，为false时 解除在南北极区域鼠标操作限制
      * @property [cameraController.enableRotate = true] - 2D和3D视图下，是否允许用户旋转相机
      * @property [cameraController.enableTranslate = true] - 2D和哥伦布视图下，是否允许用户平移地图
      * @property [cameraController.enableTilt = true] - 3D和哥伦布视图下，是否允许用户倾斜相机
@@ -23276,7 +23308,7 @@ declare namespace Map {
      *
      * 以下是Cesium.Clock时钟相关参数
      * @property [clock] - 时钟相关参数
-     * @property [clock.currentTime = null] - 当前的时间
+     * @property [clock.currentTime] - 当前的时间
      * @property [clock.multiplier = 1.0] - 当前的速度
      */
     type sceneOptions = {
@@ -23308,16 +23340,27 @@ declare namespace Map {
         sceneMode?: Cesium.SceneMode;
         scene3DOnly?: boolean;
         mapProjection?: Cesium.MapProjection;
+        mapMode2D?: Cesium.MapMode2D;
         shouldAnimate?: boolean;
         shadows?: boolean;
         useDefaultRenderLoop?: boolean;
         targetFrameRate?: number;
         useBrowserRecommendedResolution?: boolean;
         automaticallyTrackDataSourceClocks?: boolean;
-        contextOptions?: any;
+        contextOptions?: {
+            allowTextureFilterAnisotropic?: boolean;
+            requestWebgl2?: boolean;
+            webgl?: {
+                alpha?: boolean;
+                antialias?: boolean;
+                failIfMajorPerformanceCaveat?: boolean;
+                depth?: boolean;
+                stencil?: boolean;
+                powerPreference?: string;
+            };
+        };
         orderIndependentTranslucency?: boolean;
         terrainShadows?: Cesium.ShadowMode;
-        mapMode2D?: Cesium.MapMode2D;
         requestRenderMode?: boolean;
         maximumRenderTimeChange?: number;
         globe?: {
@@ -23332,11 +23375,11 @@ declare namespace Map {
             terrainExaggerationRelativeHeight?: number;
         };
         cameraController?: {
-            zoomFactor?: number;
-            constrainedAxis?: boolean;
             minimumZoomDistance?: number;
             maximumZoomDistance?: number;
+            zoomFactor?: number;
             minimumCollisionTerrainHeight?: number;
+            constrainedAxis?: boolean;
             enableRotate?: boolean;
             enableTranslate?: boolean;
             enableTilt?: boolean;
@@ -23366,7 +23409,6 @@ declare namespace Map {
      * @property [contextmenu.preventDefault = true] - 是否取消右键菜单
      * @property [contextmenu.hasDefault = true] - 是否绑定默认的地图右键菜单
      * @property [popup] - 内置 Popup 控制参数
-     * @property [popup.isOnly = true] - 是否单个显示模式
      * @property [popup.depthTest = true] - 是否打开深度判断（true时判断是否在球背面）
      * @property [tooltip] - 内置 Tooltip 控制参数
      * @property [tooltip.cacheTime = 20] - 延迟缓存的时间，单位：毫秒
@@ -23413,7 +23455,6 @@ declare namespace Map {
             hasDefault?: boolean;
         };
         popup?: {
-            isOnly?: boolean;
             depthTest?: boolean;
         };
         tooltip?: {
@@ -24185,7 +24226,7 @@ declare class Map extends BaseClass {
      * 飞行到默认视角，
      * 一般为config.json中的center参数配置的视角。
      * @param [options = {}] - 参数对象:
-     * @param [options.duration = null] - 飞行时间（单位：秒）。如果省略，SDK内部会根据飞行距离计算出理想的飞行时间。
+     * @param [options.duration] - 飞行时间（单位：秒）。如果省略，SDK内部会根据飞行距离计算出理想的飞行时间。
      * @returns 无
      */
     flyHome(options?: {
@@ -24200,7 +24241,7 @@ declare class Map extends BaseClass {
      * @param arr.heading - 方向角度值，绕垂直于地心的轴旋转角度, 0至360
      * @param arr.pitch - 俯仰角度值，绕纬度线旋转角度, 0至360
      * @param arr.roll - 翻滚角度值，绕经度线旋转角度, 0至360
-     * @param [arr.duration = null] - 飞行时间（单位：秒）。如果省略，SDK内部会根据飞行距离计算出理想的飞行时间。
+     * @param [arr.duration] - 飞行时间（单位：秒）。如果省略，SDK内部会根据飞行距离计算出理想的飞行时间。
      * @param [arr.stop = 1] - 该步骤飞行结束的停留时间（单位：秒）。
      * @param [arr.onStart] - 该步骤飞行开始前的回调方法
      * @param [arr.onEnd] - 该步骤飞行开始结束后的回调方法
@@ -24437,7 +24478,7 @@ declare class Map extends BaseClass {
      * 执行开场动画，动画播放地球飞行定位到指定区域
      * @param [options = {}] - 参数对象:
      * @param [options.center = getCameraView()] - 飞行到的指定区域视角参数
-     * @param [options.callback = null] - 飞行结束的回调方法
+     * @param [options.callback] - 飞行结束的回调方法
      * @returns 飞行结束的Promise
      */
     openFlyAnimation(options?: {
@@ -24449,7 +24490,7 @@ declare class Map extends BaseClass {
      * @param [options = {}] - 参数对象:
      * @param [options.duration = 10] - 动画时长（单位：秒）
      * @param [options.center = getCameraView()] - 飞行到的指定区域视角参数
-     * @param [options.callback = null] - 飞行结束的回调方法
+     * @param [options.callback] - 飞行结束的回调方法
      * @returns 无
      */
     rotateAnimation(options?: {
@@ -27836,7 +27877,7 @@ declare namespace widget {
      * 触发指定类型的事件。
      * @param type - 事件类型
      * @param data - 传输的数据或对象，可在事件回调方法中event对象中获取进行使用
-     * @param [propagate = null] - 将事件传播给父类 (用addEventParent设置)
+     * @param [propagate] - 将事件传播给父类 (用addEventParent设置)
      * @returns 无
      */
     function fire(type: WidgetEventType, data: any, propagate?: BaseClass | any): void;
@@ -27852,7 +27893,7 @@ declare namespace widget {
     /**
      * 是否有绑定指定的事件
      * @param type - 事件类型
-     * @param [propagate = null] - 是否判断指定的父类 (用addEventParent设置的)
+     * @param [propagate] - 是否判断指定的父类 (用addEventParent设置的)
      * @returns 是否存在
      */
     function listens(type: WidgetEventType, propagate?: BaseClass): boolean;
@@ -28210,7 +28251,7 @@ declare class BaiduPOI {
      * @param [queryOptions.location = null] - 圆形区域检索中心点，不支持多个点
      * @param queryOptions.location.lat - 纬度
      * @param queryOptions.location.lng - 经度
-     * @param [queryOptions.radius = null] - 圆形区域检索半径，单位为米。（增加区域内数据召回权重，如需严格限制召回数据在区域内，请搭配使用radiuslimit参数），当半径过大，超过中心点所在城市边界时，会变为城市范围检索，检索范围为中心点所在城市
+     * @param [queryOptions.radius] - 圆形区域检索半径，单位为米。（增加区域内数据召回权重，如需严格限制召回数据在区域内，请搭配使用radiuslimit参数），当半径过大，超过中心点所在城市边界时，会变为城市范围检索，检索范围为中心点所在城市
      * @param [queryOptions.radiuslimit = false] - 是否严格限定召回结果在设置检索半径范围内。true（是），false（否）。设置为true时会影响返回结果中total准确性及每页召回poi数量， 设置为false时可能会召回检索半径外的poi。
      * @param [queryOptions.city = null] - 可以重新限定查询的区域，默认为类构造时传入的city
      * @param [queryOptions.citylimit = false] - 取值为"true"，仅返回city中指定城市检索结果
@@ -29105,7 +29146,7 @@ declare namespace Shadows {
  * @param [options.multiplier = 1600] - 时钟倍率，控制速度
  * @param [options.time] - 当前时间
  * @param [options.terrain = true] - 是否启用地形的阴影效果，在平原地区或无地形时可以关闭
- * @param [options.lighting = true] - 是否启用地球昼夜区域的覆盖效果
+ * @param [options.lighting = true] - 是否显示晨昏线，可以看到地球的昼夜区域
  * @param [options.id = uuid()] - 对象的id标识
  * @param [options.enabled = true] - 对象的启用状态
  * @param [options.eventParent] - 指定的事件冒泡对象，默认为所加入的map对象，false时不冒泡事件
@@ -30436,6 +30477,11 @@ declare class TilesetFlat extends TilesetEditBase {
      * 压平高度 (单位：米)，基于压平区域最低点高度的偏移量
      */
     height: number;
+    /**
+     * 更新压平高度 (单位：米)
+     * @param height - 高度值（单位：米）
+     */
+    updateHeight(height: number): void;
 }
 
 declare namespace TilesetFlood {
@@ -31359,7 +31405,7 @@ declare namespace GraphicUtil {
      * @param options - Graphic构造参数,包含：
      * @param options.type - 类型
      * @param options.style - 样式,按{@link GraphicType}对应的类的style配置
-     * @param [options.attr = null] - 属性
+     * @param [options.attr] - 属性
      * @returns 创建完成的矢量数据对象
      */
     function fromEntity(entity: Cesium.Entity, options: {
@@ -31952,7 +31998,7 @@ declare namespace PointUtil {
      * @param [options = {}] - 参数对象:
      * @param options.asyn - 是否进行异步精确计算
      * @param [options.has3dtiles = auto] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
-     * @param [options.objectsToExclude = null] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
+     * @param [options.objectsToExclude] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
      * @param options.callback - 异步计算高度完成后 的回调方法
      * @returns 仅 asyn:false 时返回高度值
      */
@@ -31968,7 +32014,7 @@ declare namespace PointUtil {
      * @param position - 坐标
      * @param [options = {}] - 参数对象:
      * @param options.asyn - 是否进行异步精确计算
-     * @param [options.objectsToExclude = null] - 排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
+     * @param [options.objectsToExclude] - 排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
      * @param options.callback - 异步计算高度完成后 的回调方法
      * @returns 仅 asyn:false 时返回高度值
      */
@@ -32008,7 +32054,7 @@ declare namespace PointUtil {
      * @param [options.relativeHeight = fasle] - 是否在地形上侧的高度，在对象具备Cesium.HeightReference.RELATIVE_TO_GROUND时，可以设置为ture
      * @param [options.maxHeight] - 可以限定最高高度，当计算的结果大于maxHeight时，原样返回，可以屏蔽计算误差的数据。
      * @param [options.has3dtiles = auto] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
-     * @param [options.objectsToExclude = null] - 贴模型分析时，排除的不进行贴模型计算的模型对象，
+     * @param [options.objectsToExclude] - 贴模型分析时，排除的不进行贴模型计算的模型对象，
      * @returns 贴地坐标
      */
     function getSurfacePosition(scene: Cesium.Scene, position: Cesium.Cartesian3, options?: {
@@ -32199,7 +32245,7 @@ declare namespace PolyUtil {
      * @param [options.splitNum = 10] - 插值数，横纵等比分割的网格个数
      * @param [options.asyn = false] - 是否进行异步精确计算
      * @param [options.has3dtiles] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
-     * @param [options.objectsToExclude = null] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
+     * @param [options.objectsToExclude] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
      * @param [options.onlyPoint = false] - truea时，返回结果中只返回点，不返回三角网
      * @returns 仅 asyn:false 时返回计算结果值
      */
@@ -32220,7 +32266,7 @@ declare namespace PolyUtil {
      * @param [options = {}] - 参数对象:
      * @param [options.splitNum = 10] - 插值数，横纵等比分割的网格个数
      * @param [options.has3dtiles = auto] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
-     * @param [options.objectsToExclude = null] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
+     * @param [options.objectsToExclude] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
      * @returns 计算面内最大、最小高度值对象，结果示例：{ maxHeight: 100, minHeight: 21 }
      */
     function getHeightRange(positions: LngLatPoint[] | Cesium.Cartesian3[] | any[], scene: Cesium.Scene, options?: {
@@ -32237,7 +32283,7 @@ declare namespace PolyUtil {
      * @param [options.splitNum = 10] - 插值数，横纵等比分割的网格个数
      * @param [options.asyn = false] - 是否进行异步精确计算
      * @param [options.has3dtiles = auto] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
-     * @param [options.objectsToExclude = null] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
+     * @param [options.objectsToExclude] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
      * @returns 仅 asyn:false 时返回计算结果值
      */
     function computeVolume(options?: {
@@ -32312,6 +32358,12 @@ declare namespace PolyUtil {
      * @returns 返回经纬度值，示例： { xmin: 73.16895, xmax: 134.86816, ymin: 12.2023, ymax: 54.11485 }
      */
     function formatRectangle(rectangle: Cesium.Rectangle, digits?: number): any;
+    /**
+     * 计算geojson的边界范围
+     * @param [geojson] - Geojson对象
+     * @returns 返回经纬度值，示例： { xmin: 73.16895, xmax: 134.86816, ymin: 12.2023, ymax: 54.11485 }
+     */
+    function getExtentByGeoJSON(geojson?: any): any;
     /**
      * 获取 坐标数组 的 矩形边界值
      * @param positions - 坐标数组
@@ -32382,7 +32434,7 @@ declare namespace PolyUtil {
      * @param options.scene - 三维地图场景对象，一般用map.scene或viewer.scene
      * @param options.positions - 坐标数组
      * @param [options.splitNum = 100] - 插值数，等比分割的个数
-     * @param [options.minDistance = null] - 插值最小间隔(单位：米)，优先级高于splitNum
+     * @param [options.minDistance] - 插值最小间隔(单位：米)，优先级高于splitNum
      * @param [options.height = 0] - 坐标的高度
      * @param [options.surfaceHeight = true] - 是否计算贴地高度 （非精确计算，根据当前加载的地形和模型数据情况有关）
      * @returns 插值后的路线坐标数组
@@ -32414,9 +32466,9 @@ declare namespace PolyUtil {
      * @param options.scene - 三维地图场景对象，一般用map.scene或viewer.scene
      * @param options.positions - 坐标数组
      * @param [options.splitNum = 100] - 插值数，等比分割的个数
-     * @param [options.minDistance = null] - 插值最小间隔(单位：米)，优先级高于splitNum
+     * @param [options.minDistance] - 插值最小间隔(单位：米)，优先级高于splitNum
      * @param [options.has3dtiles = auto] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
-     * @param [options.objectsToExclude = null] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
+     * @param [options.objectsToExclude] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
      * @param [options.offset = 0] - 可以按需增加偏移高度（单位：米），便于可视
      * @param options.callback - 异步计算高度完成后 的回调方法
      * @returns 异步计算完成的Promise, 等价于callback
@@ -32437,7 +32489,7 @@ declare namespace PolyUtil {
      * @param options.scene - 三维地图场景对象，一般用map.scene或viewer.scene
      * @param options.positions - 坐标数组
      * @param [options.has3dtiles = auto] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
-     * @param [options.objectsToExclude = null] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
+     * @param [options.objectsToExclude] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
      * @param [options.offset = 0] - 可以按需增加偏移高度（单位：米），便于可视
      * @param options.callback - 异步计算高度完成后 的回调方法
      * @returns 异步计算完成的Promise, 等价于callback
@@ -32468,9 +32520,9 @@ declare namespace PolyUtil {
      * @param options.scene - 三维地图场景对象，一般用map.scene或viewer.scene
      * @param options.positions - 坐标数组
      * @param [options.splitNum = 100] - 插值数，等比分割的个数
-     * @param [options.minDistance = null] - 插值最小间隔(单位：米)，优先级高于splitNum
+     * @param [options.minDistance] - 插值最小间隔(单位：米)，优先级高于splitNum
      * @param [options.has3dtiles = auto] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
-     * @param [options.objectsToExclude = null] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
+     * @param [options.objectsToExclude] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
      * @param [options.offset = 0] - 可以按需增加偏移高度（单位：米），便于可视
      * @param options.endItem - 异步计算高度完成后 的回调方法
      * @param options.end - 异步计算高度完成后 的回调方法
@@ -32680,7 +32732,7 @@ declare namespace Util {
      * @param [options = {}] - 参数对象:
      * @param options.attr - 属性值
      * @param options.template - 模版配置，支持：'all'、数组、字符串模板
-     * @param options.title - 标题
+     * @param [options.title] - 标题
      * @param [options.edit = false] - 是否返回编辑输入框
      * @param [options.width = 190] - edit:true时的，编辑输入框宽度值
      * @returns Html字符串
@@ -32688,7 +32740,7 @@ declare namespace Util {
     function getTemplateHtml(options?: {
         attr: any;
         template: string | Globe.getTemplateHtml_template[] | ((...params: any[]) => any) | any;
-        title: string;
+        title?: string;
         edit?: boolean;
         width?: number;
     }): string;
@@ -32696,7 +32748,7 @@ declare namespace Util {
      * 获取Cesium对象值的最终value值，
      * 因为cesium经常属性或绑定一层，通过本方法可以内部去判断是否有getValue或_value进行取最终value值。
      * @param obj - Cesium对象值
-     * @param [ClasName = null] - Cesium的类名，方便识别判断
+     * @param [ClasName] - Cesium的类名，方便识别判断
      * @param [time = Cesium.JulianDate.now()] - 如果具有时间属于时，取指定的时间的值
      * @returns 最终value值
      */
@@ -32883,6 +32935,7 @@ declare namespace Util {
      * @param [textStyle.stroke = false] - 是否描边文本。
      * @param [textStyle.strokeWidth = 1] - 文本描边的宽度。
      * @param [textStyle.strokeColor = Cesium.Color.BLACK] - 文本描边的颜色。
+     * @param [textStyle.background = false] - 是否背景色。
      * @param [textStyle.backgroundColor = Cesium.Color.TRANSPARENT] - 画布的背景色。
      * @param [textStyle.padding = 0] - 要在文本周围添加的填充的像素大小。
      * @param [textStyle.outlineWidth] - 边框的宽度。
@@ -32897,6 +32950,7 @@ declare namespace Util {
         stroke?: boolean;
         strokeWidth?: number;
         strokeColor?: Cesium.Color;
+        background?: boolean;
         backgroundColor?: Cesium.Color;
         padding?: number;
         outlineWidth?: number;