mars3d 3.4.19 → 3.4.21

package/dist/mars3d.css

@@ -1,8 +1,8 @@
 /**
  * Mars3D三维可视化平台  mars3d
  *
- * 版本信息：v3.4.19
- * 编译日期：2022-12-26 19:58:48
+ * 版本信息：v3.4.21
+ * 编译日期：2023-01-17 20:42:26
  * 版权所有：Copyright by 火星科技  http://mars3d.cn
  * 使用单位：免费公开版 ，2022-06-01
  */

package/dist/mars3d.d.ts

@@ -2,8 +2,8 @@
 /**
  * Mars3D三维可视化平台  mars3d
  *
- * 版本信息：v3.4.19
- * 编译日期：2022-12-26 19:58:48
+ * 版本信息：v3.4.21
+ * 编译日期：2023-01-17 20:42:26
  * 版权所有：Copyright by 火星科技  http://mars3d.cn
  * 使用单位：免费公开版 ，2022-06-01
  */
@@ -5225,6 +5225,7 @@ declare class ArcFrustum extends BasePointPrimitive {
  * @param [options.interpolationAlgorithm = Cesium.HermitePolynomialApproximation] - 当interpolation为true时，使用的插值算法，如：Cesium.HermitePolynomialApproximation、Cesium.LagrangePolynomialApproximation、Cesium.LinearApproximation
  * @param [options.interpolationDegree = 2] - 当interpolation为true时，使用的插值程度。
  * @param [options.showStop = true] - 是否在start前或stop后显示矢量对象
+ * @param [options.updateClock = true] - 是否自动更新时钟，多个FixedRoute时或外部手动控制时钟时建议关闭
  * @param options.speed - 轨迹的 速度( 单位：千米/小时)
  * @param [options.timeField] - 当points数组中已有时间值，请传入该值的字段名称，同时speed将失效，已实际传入时间字段为准。
  * @param [options.startTime] - 轨迹的开始时间，默认当前时间
@@ -5283,6 +5284,7 @@ declare class FixedRoute extends Route {
         interpolationAlgorithm?: number;
         interpolationDegree?: Cesium.InterpolationAlgorithm | number;
         showStop?: boolean;
+        updateClock?: boolean;
         speed: any[][] | number;
         timeField?: string;
         startTime?: string | Date | Cesium.JulianDate;
@@ -5618,6 +5620,8 @@ declare namespace Route {
  * @param [options.clampToTileset] - 是否进行贴模型。
  * @param [options.frameRateHeight = 30] - clampToTileset：true时，多少帧计算一次贴模型高度
  * @param [options.objectsToExclude] - clampToTileset：true时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
+ * @param [options.maxHeight] - 限定最高高度，避免计算异常数据
+ * @param [options.minHeight] - 限定最低高度，避免计算异常数据
  * @param [options.camera] - 视角模式设置，包括：
  * @param [options.camera.type] - 视角模式类型，包括：'':无、'gs':跟随视角、'dy':第一视角、'sd':上帝视角
  * @param [options.camera.radius] - 'gs'跟随视角时的 初始俯仰距离值（单位：米）
@@ -5661,6 +5665,8 @@ declare class Route extends BasePointPrimitive {
         clampToTileset?: boolean;
         frameRateHeight?: number;
         objectsToExclude?: any;
+        maxHeight?: number;
+        minHeight?: number;
         camera?: {
             type?: string;
             radius?: number;
@@ -5703,6 +5709,14 @@ declare class Route extends BasePointPrimitive {
      * 模型 子对象
      */
     model: ModelPrimitive;
+    /**
+     * 获取model模型子对象完成解析加载完成的Promise承诺
+     * @example
+     * route.readyPromise.then(function(graphic) {
+     *     console.log("load完成", graphic)
+     *   })
+     */
+    readonly readyPromise: Promise<ModelEntity | any>;
     /**
      * 圆 子对象
      */
@@ -5732,6 +5746,10 @@ declare class Route extends BasePointPrimitive {
      * 求当前位置射线与地球相交点
      */
     readonly groundPosition: Cesium.Cartesian3;
+    /**
+     * 当前海拔高度值
+     */
+    readonly alt: number;
     /**
      * 开始时间
      */
@@ -16966,6 +16984,7 @@ declare class CzmGeoJsonLayer extends BaseGraphicLayer {
  * @param [options] - 参数对象，包括以下：
  * @param [options.url] - CZML文件或服务url地址
  * @param [options.data] - CZML格式规范数据对象，与url二选一即可。
+ * @param [options.updateClock = true] - 是否自动更新时钟，多个时或外部手动控制时钟时建议关闭
  * @param [options.zIndex] - 控制图层的叠加层次（部分图层），默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面。
  * @param [options.popup] - 绑定的popup弹窗值，也可以bindPopup方法绑定，支持：'all'、数组、字符串模板
  * @param [options.popupOptions] - popup弹窗时的配置参数，也支持如pointerEvents等{@link Popup}构造参数,还包括：
@@ -17003,6 +17022,7 @@ declare class CzmlLayer extends CzmGeoJsonLayer {
     constructor(options?: {
         url?: string;
         data?: any;
+        updateClock?: boolean;
         zIndex?: number;
         popup?: string | Globe.getTemplateHtml_template[] | ((...params: any[]) => any);
         popupOptions?: {
@@ -17040,6 +17060,16 @@ declare class CzmlLayer extends CzmGeoJsonLayer {
         flyTo?: boolean;
         flyToOptions?: any;
     });
+    /**
+     * 更新地图clock时钟 为 当前czml的起止时间
+     * @returns 无
+     */
+    setCzmlTime(): void;
+    /**
+     * 更新地图clock时钟 为 当前时间（还原时间）
+     * @returns 无
+     */
+    setNowTime(): void;
     /**
      * 加载新数据 或 刷新数据
      * @param [newOptions = {}] - 新设定的参数，会与类的构造参数合并。
@@ -18405,6 +18435,10 @@ declare class GraphicLayer extends BaseGraphicLayer {
      * 当加载 DivGraphic 数据的DIV是否可以鼠标交互，为false时可以穿透操作及缩放地图，但无法进行鼠标交互及触发相关事件。
      */
     pointerEvents: boolean;
+    /**
+     * 获取当前图层中所有对象，用于贴模型分析时，排除的不进行贴模型计算的模型对象
+     */
+    readonly objectsToExclude: any | undefined;
     /**
      * 是否可以调整图层顺序（在同类型图层间）
      */
@@ -18414,6 +18448,16 @@ declare class GraphicLayer extends BaseGraphicLayer {
      * 只对 同类型(Entity/Primitive) + 贴地(clampToGround: true) 矢量对象间有效
      */
     zIndex: number;
+    /**
+     * 将当前图层在map中层级进行 置顶
+     * @returns 无
+     */
+    toTop(): void;
+    /**
+     * 将当前图层在map中层级进行 置底
+     * @returns 无
+     */
+    toBottom(): void;
     /**
      * 图层内的Graphic矢量数据个数
      */
@@ -19847,6 +19891,16 @@ declare class GroupLayer extends BaseGraphicLayer {
      * @returns isFormat：true时，返回格式化对象，isFormat：false时返回Cesium.Rectangle对象
      */
     getRectangle(isFormat?: boolean): Cesium.Rectangle | any;
+    /**
+     * 将当前图层在map中层级进行 置顶
+     * @returns 无
+     */
+    toTop(): void;
+    /**
+     * 将当前图层在map中层级进行 置底
+     * @returns 无
+     */
+    toBottom(): void;
 }
 
 /**
@@ -20750,6 +20804,16 @@ declare class BaseTileLayer extends BaseLayer {
      * @returns 无
      */
     setOpacity(value: number): void;
+    /**
+     * 将当前图层在map中层级进行 置顶
+     * @returns 无
+     */
+    toTop(): void;
+    /**
+     * 将当前图层在map中层级进行 置底
+     * @returns 无
+     */
+    toBottom(): void;
     /**
      * 绑定鼠标移入或单击后的 对象高亮
      * @param [options] - 高亮的样式，具体见各{@link GraphicType}矢量数据的style参数。
@@ -24080,9 +24144,10 @@ declare class Map extends BaseClass {
     /**
      * 重新设置basemps底图图层，对options.basemaps重新赋值
      * @param arr - 底图图层配置
+     * @param [reload = true] - 是否重新构造
      * @returns 图层数组
      */
-    setBasemapsOptions(arr: Map.basemapOptions[]): BaseLayer[];
+    setBasemapsOptions(arr: Map.basemapOptions[], reload?: boolean): BaseLayer[];
     /**
      * 重新设置layers图层，对options.layers重新赋值
      * @param arr - 可以叠加显示的图层配置
@@ -28221,7 +28286,7 @@ declare namespace BaseWidget {
      * @property [autoDisable = true] - 激活其他新插件时，是否自动释放本插件
      * @property [disableOther = true] - 激活本插件时，是否释放其它已激活的插件
      * @property [group] - 配置group后，同group下的widget互斥，打开任意一个会自动释放其他的
-     * @property [windowOptions] - 存在弹窗的插件的弹窗相关参数配置，更多参数请参考 [layer弹窗API]{@linkhttps://layui.gitee.io/v2/docs/modules/layer.html} 包括：
+     * @property [windowOptions] - 存在弹窗的插件的弹窗相关参数配置，更多参数请参考 [layer弹窗API]{@link https://layui.gitee.io/v2/docs/modules/layer.html} 包括：
      * @property [windowOptions.width] - 窗口宽度，可以是 像素数字(像素值) 或者 字符串(屏幕宽度百分比)，示例：200 或 "20%"
      * @property [windowOptions.height] - 窗口高度，可以是 像素数字(像素值) 或者 字符串(屏幕高度百分比)，示例：600 或 "50%"
      * @property [windowOptions.position = 'auto'] - 窗口所在位置坐标，配置字符串可选值：auto垂直水平居中，t顶部,b底部,r右边缘,l左边缘,lt左上角,lb左下角,rt右上角,rb右下角；也可以配置对象：