mars3d 3.7.23 → 3.7.25

package/dist/mars3d.css

@@ -1,8 +1,8 @@
 /**
  * Mars3D三维可视化平台  mars3d
  *
- * 版本信息：v3.7.23
- * 编译日期：2024-07-23 21:10:10
+ * 版本信息：v3.7.25
+ * 编译日期：2024-08-16 09:41:21
  * 版权所有：Copyright by 火星科技  http://mars3d.cn
  * 使用单位：免费公开版 ，2024-01-15
  */

package/dist/mars3d.d.ts

@@ -2,8 +2,8 @@
 /**
  * Mars3D三维可视化平台  mars3d
  *
- * 版本信息：v3.7.23
- * 编译日期：2024-07-23 21:10:10
+ * 版本信息：v3.7.25
+ * 编译日期：2024-08-16 09:41:20
  * 版权所有：Copyright by 火星科技  http://mars3d.cn
  * 使用单位：免费公开版 ，2024-01-15
  */
@@ -6577,6 +6577,7 @@ declare namespace ParticleSystem {
      * @property [transX = 0] - 粒子在X轴方向上的偏离距离（单位：米）
      * @property [transY = 0] - 粒子在Y轴方向上的偏离距离（单位：米）
      * @property [transZ = 0] - 粒子离地高度（单位：米），粒子在Z轴方向上的偏离距离
+     * @property [maxHeight] - 最大视角高度（单位：米），超出该高度不显示粒子
      * @property [particleSize = 25] - 粒子大小(px)，粒子图片的Size大小（单位：像素）
      * @property [imageSize] - 粒子图片的Size大小,可以设置高宽不同（单位：像素），与particleSize二选一
      * @property [minimumImageSize] - 最小大小，设置最小边界，宽度和高度，在此之上随机缩放粒子图像的像素尺寸
@@ -6600,7 +6601,10 @@ declare namespace ParticleSystem {
      * @property [bursts] - 周期性发射粒子爆发数组
      * @property [sizeInMeters] - 大小模式，设置粒子的大小是米还是像素。true以米为单位设置粒子的大小;否则，大小以像素为单位。
      * @property [lifetime = number.MAX_VALUE] - 释放粒子的时间(秒)
-     * @property [maxHeight] - 最大视角高度（单位：米），超出该高度不显示粒子
+     *
+     * //以下是Billboard参数（ParticleSystem底层是很多Billboard构成）
+     * @property [visibleDepth = true] - 是否被遮挡
+     * @property [disableDepthTestDistance] - 指定从相机到禁用深度测试的距离。
      */
     type StyleOptions = any | {
         image?: string;
@@ -6613,6 +6617,7 @@ declare namespace ParticleSystem {
         transX?: number;
         transY?: number;
         transZ?: number;
+        maxHeight?: number;
         particleSize?: number;
         imageSize?: Cesium.Cartesian2;
         minimumImageSize?: Cesium.Cartesian2;
@@ -6636,7 +6641,8 @@ declare namespace ParticleSystem {
         bursts?: Cesium.ParticleBurst[];
         sizeInMeters?: boolean;
         lifetime?: number;
-        maxHeight?: number;
+        visibleDepth?: boolean;
+        disableDepthTestDistance?: number;
     };
 }
 
@@ -12699,6 +12705,7 @@ declare namespace PolylineEntity {
      * @property [depthFail] - 是否显示遮挡
      * @property [depthFailColor] - 遮挡处颜色
      * @property [depthFailOpacity] - 遮挡处透明度
+     * @property [snakeAnimation] - 执行贪吃蛇动画的时长秒数，内部执行startSnakeAnimation方法
      * @property [distanceDisplayCondition = false] - 是否按视距显示 或 指定此框将显示在与摄像机的多大距离。
      * @property [distanceDisplayCondition_far = number.MAX_VALUE] - 最大距离
      * @property [distanceDisplayCondition_near = 0] - 最小距离
@@ -12735,6 +12742,7 @@ declare namespace PolylineEntity {
         depthFail?: boolean;
         depthFailColor?: string;
         depthFailOpacity?: number;
+        snakeAnimation?: number;
         distanceDisplayCondition?: boolean | Cesium.DistanceDisplayCondition;
         distanceDisplayCondition_far?: number;
         distanceDisplayCondition_near?: number;
@@ -12825,6 +12833,21 @@ declare class PolylineEntity extends BasePolyEntity {
      * 矢量数据对应的 Cesium内部对象的具体类型对象
      */
     readonly entityGraphic: Cesium.PolylineGraphics;
+    /**
+     * 开始播放 流动生长动画
+     * @param options - 参数
+     * @param [opts.duration = 8] - 总时长(秒)
+     * @param [options.callback] - 完成后动画
+     * @returns 无
+     */
+    startSnakeAnimation(options: {
+        callback?: (...params: any[]) => any;
+    }): void;
+    /**
+     * 停止 流动生长动画
+     * @returns 无
+     */
+    stopSnakeAnimation(): void;
 }
 
 declare namespace PolylineVolumeEntity {
@@ -18604,6 +18627,7 @@ declare namespace PointPrimitive {
      * @property [disableDepthTestDistance] - 指定从相机到禁用深度测试的距离。
      * @property [translucencyByDistance] - 用于基于与相机的距离设置半透明度。
      * @property [clampToGround = false] - 是否贴地, 仅限普通坐标. 提示：Cesium默认不支持贴地，是内部计算了贴地高度值。【大量数据时可能卡死，注意大数据下不用为ture】
+     * @property [clampToGroundExact = false] - clampToGround的贴地高度，是否进行精确计算
      * @property [setHeight] - 指定坐标高度值（对编辑时无效，仅初始化传入有效，常用于图层中配置）,也支持字符串模版配置
      * @property [addHeight] - 在现有坐标基础上增加的高度值（对编辑时无效，仅初始化传入有效，常用于图层中配置）,也支持字符串模版配置
      * @property [label] - 支持附带文字的显示
@@ -18628,6 +18652,7 @@ declare namespace PointPrimitive {
         disableDepthTestDistance?: number;
         translucencyByDistance?: Cesium.NearFarScalar;
         clampToGround?: boolean;
+        clampToGroundExact?: boolean;
         setHeight?: number | string;
         addHeight?: number | string;
         label?: LabelEntity.StyleOptions | any;
@@ -19686,6 +19711,7 @@ declare namespace VideoPrimitive {
  * @param options.positions - 坐标位置
  * @param options.style - 样式信息
  * @param [options.attr] - 附件的属性信息，可以任意附加属性，导出geojson或json时会自动处理导出。
+ * @param [options.positions_grid] - 历史编辑的网格坐标点，用于json导出导入
  * @param [options.appearance] - [cesium原生]用于渲染图元的外观。
  * @param [options.attributes] - [cesium原生]每个实例的属性。
  * @param [options.depthFailAppearance] - 当深度测试失败时，用于为该图元着色的外观。
@@ -19717,6 +19743,7 @@ declare class VideoPrimitive extends BasePolyPrimitive {
         positions: LngLatPoint[] | Cesium.Cartesian3[] | any[];
         style: VideoPrimitive.StyleOptions | any;
         attr?: any | BaseGraphic.AjaxAttr;
+        positions_grid?: Cesium.Cartesian3[];
         appearance?: Cesium.Appearance;
         attributes?: Cesium.Appearance;
         depthFailAppearance?: Cesium.Appearance;
@@ -22666,6 +22693,14 @@ declare class GraphicLayer extends BaseGraphicLayer {
      * @returns 当前对象本身,可以链式调用
      */
     stopEditing(): GraphicLayer;
+    /**
+     * 获取图层完成解析加载完成的Promise承诺, 等价于load事件(区别在于load事件必须在load完成前绑定才能监听)。
+     * @example
+     * tiles3dLayer.readyPromise.then(function(layer) {
+     *     console.log("load完成", layer)
+     *   })
+     */
+    readonly readyPromise: Promise<BaseLayer | any>;
 }
 
 /**
@@ -31597,9 +31632,10 @@ declare class Tle {
      * @param tle1 - 卫星TLE的第一行
      * @param tle2 - 卫星TLE的第二行
      * @param datetime - 指定的时间
+     * @param [isFixed] - 是否返回Cesium.ReferenceFrame.FIXED地固系坐标
      * @returns 卫星当前经纬度位置
      */
-    static getPoint(tle1: string, tle2: string, datetime: Date | Cesium.JulianDate | number): LngLatPoint | undefined;
+    static getPoint(tle1: string, tle2: string, datetime: Date | Cesium.JulianDate | number, isFixed?: boolean): LngLatPoint | undefined;
     /**
      * 获取卫星指定时间所在的 ECI地固系坐标
      * @param tle1 - 卫星TLE的第一行
@@ -34781,31 +34817,37 @@ declare namespace MatrixMove {
         change: string;
         stop: string;
     };
-}
-
-/**
- * 坐标点按XYZ轴平移图上编辑处理类
- * @param [options] - 参数对象，包括以下：
- * @param [options.position] - 坐标位置
- * @param [options.radius = 200] - 半径
- * @param [options.onChange] - 编辑移动了坐标后的回调方法
- * @param [options.id = createGuid()] - 对象的id标识
- * @param [options.enabled = true] - 对象的启用状态
- * @param [options.eventParent] - 指定的事件冒泡对象，默认为所加入的map对象，false时不冒泡事件
- * @param [options.pid = -1] - 量算对应的图层父级的id，一般图层管理中使用
- * @param [options.name = ''] - 量算对应的图层名称
- */
-declare class MatrixMove extends BaseThing {
-    constructor(options?: {
+    /**
+     * 按轴平移类 构造参数
+     * @property [position] - 坐标位置
+     * @property [radius = 200] - 半径
+     * @property [onChange] - 编辑移动了坐标后的回调方法
+     * @property [hasMiddle = true] - 是否绑定中键单击事件进行修改坐标位置
+     * @property [id = createGuid()] - 对象的id标识
+     * @property [enabled = true] - 对象的启用状态
+     * @property [eventParent] - 指定的事件冒泡对象，默认为所加入的map对象，false时不冒泡事件
+     * @property [pid = -1] - 对应的图层父级的id，一般图层管理中使用
+     * @property [name = ''] - 对应的图层名称
+     */
+    type Options = {
         position?: LngLatPoint | Cesium.Cartesian3 | number[];
         radius?: number;
         onChange?: (...params: any[]) => any;
+        hasMiddle?: boolean;
         id?: string | number;
         enabled?: boolean;
         eventParent?: BaseClass | boolean;
         pid?: string | number;
         name?: string;
-    });
+    };
+}
+
+/**
+ * 按轴平移 坐标点编辑处理类
+ * @param [options] - 参数对象
+ */
+declare class MatrixMove extends BaseThing {
+    constructor(options?: MatrixMove.Options);
     /**
      * 位置坐标 （笛卡尔坐标）, 赋值时可以传入LatLngPoint对象
      */
@@ -34825,8 +34867,8 @@ declare class MatrixMove extends BaseThing {
  * @param [options.id = createGuid()] - 对象的id标识
  * @param [options.enabled = true] - 对象的启用状态
  * @param [options.eventParent] - 指定的事件冒泡对象，默认为所加入的map对象，false时不冒泡事件
- * @param [options.pid = -1] - 量算对应的图层父级的id，一般图层管理中使用
- * @param [options.name = ''] - 量算对应的图层名称
+ * @param [options.pid = -1] - 对应的图层父级的id，一般图层管理中使用
+ * @param [options.name = ''] - 对应的图层名称
  */
 declare class MatrixMove2 extends BaseThing {
     constructor(options?: {
@@ -34853,23 +34895,22 @@ declare class MatrixMove2 extends BaseThing {
     readonly isMoveing: boolean;
 }
 
-/**
- * 按XYZ轴旋转方向图上编辑处理类
- * @param [options] - 参数对象，包括以下：
- * @param [options.position] - 坐标位置
- * @param [options.heading = 0] - 方向角 （度数值，0-360度）
- * @param [options.pitch = 0] - 俯仰角（度数值，0-360度）
- * @param [options.roll = 0] - 翻滚角（度数值，0-360度）
- * @param [options.radius = 200] - 半径
- * @param [options.onChange] - 旋转了方向后的回调方法
- * @param [options.id = createGuid()] - 对象的id标识
- * @param [options.enabled = true] - 对象的启用状态
- * @param [options.eventParent] - 指定的事件冒泡对象，默认为所加入的map对象，false时不冒泡事件
- * @param [options.pid = -1] - 量算对应的图层父级的id，一般图层管理中使用
- * @param [options.name = ''] - 量算对应的图层名称
- */
-declare class MatrixRotate extends MatrixMove {
-    constructor(options?: {
+declare namespace MatrixRotate {
+    /**
+     * 按轴轴旋类 构造参数
+     * @property [position] - 坐标位置
+     * @property [heading = 0] - 方向角 （度数值，0-360度）
+     * @property [pitch = 0] - 俯仰角（度数值，0-360度）
+     * @property [roll = 0] - 翻滚角（度数值，0-360度）
+     * @property [radius = 200] - 半径
+     * @property [onChange] - 旋转了方向后的回调方法
+     * @property [id = createGuid()] - 对象的id标识
+     * @property [enabled = true] - 对象的启用状态
+     * @property [eventParent] - 指定的事件冒泡对象，默认为所加入的map对象，false时不冒泡事件
+     * @property [pid = -1] - 对应的图层父级的id，一般图层管理中使用
+     * @property [name = ''] - 对应的图层名称
+     */
+    type Options = {
         position?: LngLatPoint | Cesium.Cartesian3 | number[];
         heading?: number;
         pitch?: number;
@@ -34881,7 +34922,15 @@ declare class MatrixRotate extends MatrixMove {
         eventParent?: BaseClass | boolean;
         pid?: string | number;
         name?: string;
-    });
+    };
+}
+
+/**
+ * 按轴轴旋 坐标点编辑处理类
+ * @param [options] - 参数对象
+ */
+declare class MatrixRotate extends MatrixMove {
+    constructor(options?: MatrixRotate.Options);
     /**
      * 四周方向角，0-360度角度值
      */