mars3d 3.10.7 → 3.10.9

package/mars3d.css

@@ -1,8 +1,8 @@
 /**
  * Mars3D三维可视化平台  mars3d
  *
- * 版本信息：v3.10.7
- * 编译日期：2025-10-24 21:04
+ * 版本信息：v3.10.9
+ * 编译日期：2025-11-28 10:57
  * 版权所有：Copyright by 火星科技  http://mars3d.cn
  * 使用单位：火星科技免费公开版 ，2025-07-01
  */
@@ -143,7 +143,7 @@
   min-width: 100px;
   padding: 2px 5px;
   font-size: 11px;
-  z-index: 1000;
+  z-index: 20170825;
   opacity: 0.8;
   -khtml-opacity: 0.8;
   -moz-opacity: 0.8;
@@ -906,7 +906,6 @@
 }
 .mars3d-popup-content {
   margin: 10px;
-  line-height: 1.4;
   font-size: 13px;
   max-width: 700px;
   min-width: 50px;

package/mars3d.d.ts

@@ -2,8 +2,8 @@
 /**
  * Mars3D三维可视化平台  mars3d
  *
- * 版本信息：v3.10.7
- * 编译日期：2025-10-24 21:04
+ * 版本信息：v3.10.9
+ * 编译日期：2025-11-28 10:57
  * 版权所有：Copyright by 火星科技  http://mars3d.cn
  * 使用单位：火星科技免费公开版 ，2025-07-01
  */
@@ -4132,6 +4132,88 @@ declare class TaskItem extends BaseClass {
     toJSON(): any;
 }
 
+/**
+ * 计算GeoJSON要素的面积
+ * @param geojson - 需要计算面积的GeoJSON要素
+ * @returns 面积值，如果计算出错则返回0
+ */
+declare function area(geojson: any): number;
+
+/**
+ * 计算GeoJSON要素的边界框(Bounding Box)
+ * @param geojson - 需要计算边界框的GeoJSON要素
+ * @returns 包含[minX, minY, maxX, maxY]的数组
+ */
+declare function bbox(geojson: any): any[];
+
+/**
+ * 创建贝塞尔曲线
+ * @param line - 输入的线要素
+ * @param options - 可选配置参数
+ * @returns 贝塞尔曲线要素，如果出错则返回原始线要素
+ */
+declare function bezierSpline(line: any, options: any): any;
+
+/**
+ * 对线要素进行偏移
+ * @param coordinates - 坐标数组
+ * @param distance - 偏移距离
+ * @param options - 可选配置参数
+ * @returns 偏移后的坐标数组，如果出错则返回原始坐标数组
+ */
+declare function lineOffset(coordinates: any[], distance: number, options: any): any[];
+
+/**
+ * 创建缓冲区
+ * @param feature - 输入要素
+ * @param radius - 缓冲区半径
+ * @param options - 可选配置参数
+ * @returns 带缓冲区的要素，如果出错则返回原始要素
+ */
+declare function buffer(feature: any, radius: number, options: any): any;
+
+/**
+ * 创建凸包
+ * @param geojson - 输入要素
+ * @param options - 可选配置参数
+ * @returns 凸包要素，如果出错则返回原始要素
+ */
+declare function convex(geojson: any, options: any): any;
+
+/**
+ * 在指定边界框内创建点网格
+ * @param bbox - 边界框 [minX, minY, maxX, maxY]
+ * @param cellSide - 网格单元边长
+ * @param options - 可选配置参数
+ * @returns 点网格要素集合，如果出错则返回空要素集合
+ */
+declare function pointGrid(bbox: any[], cellSide: number, options: any): any;
+
+/**
+ * 判断点是否在多边形内
+ * @param point - 点要素
+ * @param polygon - 多边形要素
+ * @param options - 可选配置参数
+ * @returns 点在多边形内返回true，否则返回false，出错时返回false
+ */
+declare function booleanPointInPolygon(point: any, polygon: any, options: any): boolean;
+
+/**
+ * 计算面要素的质心中心点
+ * @param coordinates - 面要素的坐标数组
+ * @param height - 可选的高度值，默认为0
+ * @returns 质心坐标[x, y, z]，如果出错或坐标数少于3则返回null
+ */
+declare function centerOfMass(coordinates: any[], height: number): any[] | null;
+
+/**
+ * 简化GeoJSON坐标
+ * @param coords - 坐标数组
+ * @param options - 简化选项，包括tolerance等参数
+ * @returns 简化后的坐标数组，如果出错则返回原始坐标数组
+ */
+declare function simplify(coords: any[], options: any): any[];
+
 /**
  * 特效（后处理） 基类
  * @param [options] - 参数对象，包括以下：
@@ -8448,9 +8530,13 @@ declare namespace VolumeCloud {
  * @param [options.steps] - 色带对应的数值数组
  * @param [options.threshold = 100/255] - 筛选值，超出该数值的不展示
  * @param [options.detail = 1000] - 精细度
- * @param [options.xCut = -0.5] - X轴裁剪,取值范围：-0.5至0.5
- * @param [options.yCut = -0.5] - Y轴裁剪,取值范围：-0.5至0.5
- * @param [options.zCut = 0.5] - Z轴裁剪,取值范围：-0.5至0.5
+ * @param [options.clip] - 裁剪区
+ * @param [options.clip.xmin = -0.5] - 裁掉X轴方向小于该比例的值，取值范围：-0.5至0.5
+ * @param [options.clip.xmax = 0.5] - 裁掉X轴方向大于该比例的值，取值范围：-0.5至0.5
+ * @param [options.clip.ymin = -0.5] - 裁掉Y轴方向小于该比例的值，取值范围：-0.5至0.5
+ * @param [options.clip.ymax = 0.5] - 裁掉Y轴方向大于该比例的值，取值范围：-0.5至0.5
+ * @param [options.clip.zmin = -0.5] - 裁掉Z轴方向小于该比例的值，取值范围：-0.5至0.5
+ * @param [options.clip.zmax = 0.5] - 裁掉Z轴方向大于该比例的值，取值范围：-0.5至0.5
  * @param [options.id = createGuid()] - 矢量数据id标识
  * @param [options.name] - 矢量数据名称
  * @param [options.show = true] - 矢量数据是否显示
@@ -8463,14 +8549,23 @@ declare class VolumeCloud extends BasePrimitive {
         steps?: number[];
         threshold?: number;
         detail?: number;
-        xCut?: number;
-        yCut?: number;
-        zCut?: number;
+        clip?: {
+            xmin?: number;
+            xmax?: number;
+            ymin?: number;
+            ymax?: number;
+            zmin?: number;
+            zmax?: number;
+        };
         id?: string | number;
         name?: string;
         show?: boolean;
         eventParent?: BaseClass | boolean;
     });
+    /**
+     * 裁剪区
+     */
+    clip: any;
 }
 
 declare namespace DivBoderLabel {
@@ -12248,6 +12343,10 @@ declare class EllipsoidEntity extends BasePointEntity {
      * @returns 矢量对象
      */
     addScanPlane(planeOptions: EllipsoidEntity.ScanPlaneOptions): Cesium.Entity;
+    /**
+     * 扫描面Entity对象数组
+     */
+    readonly scanPlane: Cesium.Entity[];
     /**
      * 移除单个指定的扫描面
      * @param entity - addScanPlane返回的矢量对象
@@ -23706,6 +23805,7 @@ declare namespace GraphicLayer {
  * @param [options.contextmenuItems] - 绑定的右键菜单值，也可以bindContextMenu方法绑定
  * @param [options.attr] - 图层级对所有矢量数据的 属性信息做统一配置，常用于动态属性
  * @param [options.availability] - 指定时间范围内显示该对象
+ * @param [options.plotScale] - 设置JB基准比例尺，决定了标号的在这个比例尺下显示为基准进行缩放 （依赖 mars3d-plot 插件）
  * @param [options.id = mars3d.Util.createGuid()] - 图层id标识
  * @param [options.pid] - 图层父级的id，一般图层管理中使用
  * @param [options.name] - 图层名称
@@ -23779,6 +23879,7 @@ declare class GraphicLayer extends BaseGraphicLayer {
         contextmenuItems?: any;
         attr?: any | BaseGraphic.AjaxAttr;
         availability?: Cesium.TimeIntervalCollection | Cesium.TimeInterval | any[] | any;
+        plotScale?: number;
         id?: string | number;
         pid?: string | number;
         name?: string;
@@ -23802,6 +23903,17 @@ declare class GraphicLayer extends BaseGraphicLayer {
         flyTo?: boolean;
         flyToOptions?: any;
     });
+    /**
+     * 设置JB基准比例尺（依赖 mars3d-plot 插件）
+     * @param scale - 基准比例尺值
+     * @param [redraw = true] - 是否按新基准比例尺重绘所有标号
+     */
+    setPlotScale(scale: number, redraw?: number): void;
+    /**
+     * 获取当前图层的JB基准比例尺
+     * @returns 比例尺值
+     */
+    getPlotScale(): number;
     /**
      * 是否连续标绘
      */
@@ -25553,6 +25665,11 @@ declare class TilesetLayer extends BaseGraphicLayer {
     readonly position: Cesium.Cartesian3;
     /**
      * 模型当前中心点坐标
+     * @example
+     * tiles3dLayer.readyPromise.then(() => {
+     *   console.log("模型加载完成", tiles3dLayer)
+     *   const center = tiles3dLayer.center
+     * })
      */
     center: LngLatPoint;
     /**
@@ -33754,7 +33871,7 @@ declare namespace PointPlot {
      * @property [text.color = "#ff0000"] - 颜色
      * @property [text.font_size] - 文字大小
      * @property [text.font_family] - 字体
-     * @property [text.direction] - 注记位置
+     * @property [text.direction] - 注记位置, 可选值： 正下方: 0、 正右方: 1、 正上方: 2、 正左方: 3、 右上: 4、右下: 5、 左上: 6、 左下: 7、 居中: 8
      * @property [text.offset] - 注记与符号距离
      * @property [text.bold] - 是否粗体
      * @property [text.underline] - 是否带有下划线
@@ -34075,6 +34192,22 @@ declare namespace PlotUtil {
      *   })
      */
     const readyPromise: Promise<any>;
+    /**
+     * 标号列表清单
+     * @example
+     * mars3d.PlotUtil.readyPromise.then(() => {
+     *   console.log("标号列表", mars3d.PlotUtil.symbolTree)
+     *
+     *   mars3d.Util.downloadFile("标号列表.json", JSON.stringify(mars3d.PlotUtil.symbolTree))
+     * })
+     */
+    const symbolTree: any;
+    /**
+     * 获取当前地图所在视域的比例尺值（可以用于设置JB基准比例尺）
+     * @param scene - 地图场景对象
+     * @returns 比例尺
+     */
+    function getMapScale(scene: Cesium.Scene): number;
 }
 
 /**
@@ -38270,6 +38403,72 @@ declare class FloodByMaterial extends TerrainEditBase {
     clear(): void;
 }
 
+declare namespace ShortestPath {
+    /**
+     * 当前类支持的{@link EventType}事件类型
+     * @example
+     * //绑定监听事件
+     * thing.on(mars3d.EventType.change, function (event) {
+     *   console.log('发送了变化', event)
+     * })
+     * @property endItem - 多个数据异步分析时，完成其中一个时的回调事件
+     * @property end - 多个数据异步分析时，完成所有的回调事件
+     */
+    type EventType = {
+        endItem: string;
+        end: string;
+    };
+}
+
+/**
+ * 根据地形和最大坡度限制，进行最短路径分析
+ * @param [options] - 参数对象，包括以下：
+ * @param [options.tooltip] - 可以指定绑定tooltip
+ * @param [options.tooltipOptions] - tooltip弹窗时的配置参数，也支持如pointerEvents等{@link Tooltip}构造参数
+ * @param [options.popup] - 可以指定绑定popup
+ * @param [options.popupOptions] - popup弹窗时的配置参数，也支持如pointerEvents等{@link Popup}构造参数
+ * @param [options.id = createGuid()] - 对象的id标识
+ * @param [options.enabled = true] - 对象的启用状态
+ * @param [options.eventParent] - 指定的事件冒泡对象，默认为所加入的map对象，false时不冒泡事件
+ */
+declare class ShortestPath extends BaseThing {
+    constructor(options?: {
+        tooltip?: (...params: any[]) => any;
+        tooltipOptions?: Tooltip.StyleOptions | any;
+        popup?: (...params: any[]) => any;
+        popupOptions?: Popup.StyleOptions | any;
+        id?: string | number;
+        enabled?: boolean;
+        eventParent?: BaseClass | boolean;
+    });
+    /**
+     * 添加计算的 位置
+     * @param startPoint - 起点坐标
+     * @param endPoint - 终点坐标
+     * @param [options = {}] - 控制参数，包括：
+     * @param [options.splitNum = 100] - 插值数，横纵等比分割的网格个数(概略值，有经纬网网格来插值)
+     * @param [options.maxSlope = 20] - 最大坡度, 路线走低于该坡度值的地方
+     * @param [options.scale = 1.1] - 包围圆圈范围扩大搜寻范围倍数
+     * @returns 异步计算完成的 最短路径坐标集合
+     */
+    analyze(startPoint: LngLatPoint | Cesium.Cartesian3 | any[], endPoint: LngLatPoint | Cesium.Cartesian3 | any[], options?: {
+        splitNum?: number;
+        maxSlope?: number;
+        scale?: number;
+    }): Promise<LngLatPoint[]>;
+    /**
+     * 异步计算最短路径
+     * @param options - 参数对象，具有以下属性:
+     * @param options.map - Map地图对象
+     * @param [options.splitNum = 8] - 插值数，横纵等比分割的网格个数(概略值，有经纬网网格来插值)
+     * @returns 异步计算完成的 最短路径坐标集合
+     */
+    static getShortestPath(options: {
+        map: Map;
+        splitNum?: number;
+    }): Promise<LngLatPoint[]>;
+}
+
 declare namespace Slope {
     /**
      * 当前类支持的{@link EventType}事件类型
@@ -41589,6 +41788,12 @@ declare namespace Util {
      * @returns 是否为简单类型（包括：String\Boolean\number\Array）
      */
     function isSimpleType(value: any): boolean;
+    /**
+     * 延迟承诺函数，同setTimeout
+     * @param ms - 毫秒数
+     * @returns 返回承诺对象
+     */
+    function sleep(ms: number): Promise<void>;
     /**
      * 判断当前Cesium库 是否mars3d修改后的版本(mars3d-cesium库)
      */
@@ -42590,6 +42795,7 @@ declare namespace thing {
 
   export { FloodByGraphic }
   export { Slope }
+  export { ShortestPath }
   export { TerrainPlanClip }
 
   export { FloodByMaterial }