mars3d 3.9.0 → 3.9.2

package/mars3d.css

@@ -1,8 +1,8 @@
 /**
  * Mars3D三维可视化平台  mars3d
  *
- * 版本信息：v3.9.0
- * 编译日期：2025-02-15 11:56
+ * 版本信息：v3.9.2
+ * 编译日期：2025-03-11 22:36
  * 版权所有：Copyright by 火星科技  http://mars3d.cn
  * 使用单位：火星科技免费公开版 ，2025-02-01
  */

package/mars3d.d.ts

@@ -2,8 +2,8 @@
 /**
  * Mars3D三维可视化平台  mars3d
  *
- * 版本信息：v3.9.0
- * 编译日期：2025-02-15 11:56
+ * 版本信息：v3.9.2
+ * 编译日期：2025-03-11 22:36
  * 版权所有：Copyright by 火星科技  http://mars3d.cn
  * 使用单位：火星科技免费公开版 ，2025-02-01
  */
@@ -17,7 +17,7 @@ declare const name: string
 
 declare const proj4: any
 declare const provider: any
-
+declare const turf: any
 
 /**
  * 国内偏移坐标系 枚举
@@ -3153,6 +3153,10 @@ declare class Subtitles extends BaseControl {
      * @returns 是否成功
      */
     removeItem(id: number | string): boolean;
+    /**
+     * 释放所有子任务
+     */
+    disableAll(): void;
     /**
      * 对象添加到地图前创建一些对象的钩子方法，
      * 只会调用一次
@@ -4710,7 +4714,7 @@ declare namespace BaseGraphic {
      */
     type TimePosition = {
         type: string;
-        list: any[][] | LngLatPoint[];
+        list: any | LngLatPoint[];
         timeField?: string;
         speed?: any[][] | number;
         startTime?: string | Date | Cesium.JulianDate;
@@ -4764,7 +4768,7 @@ declare namespace BaseGraphic {
      */
     type TimePolyPositions = {
         type: string;
-        list: BaseGraphic.TimePolyPositionsItem[];
+        list: BaseGraphic.TimePolyPositionsItem[] | any;
         timeField?: string;
         referenceFrame?: Cesium.ReferenceFrame;
         numberOfDerivatives?: number;
@@ -4820,6 +4824,7 @@ declare namespace BaseGraphic {
      * @property [headers] - 一个对象，将发送的其他HTTP标头。比如：headers: { 'X-My-Header': 'valueOfHeader' }
      * @property [dataColumn] - 接口返回数据中，对应的属性数据所在的读取字段名称，支持多级(用.分割)；如果数据直接返回时可以不配置。
      * @property [cacheTime = 1] - 在time秒内再次访问读取时，直接使用上一次历史值，避免高频访问后端。
+     * @property [merge] - 是否合并原有静态属性
      */
     type AjaxAttr = {
         type: string;
@@ -4828,6 +4833,7 @@ declare namespace BaseGraphic {
         headers?: any;
         dataColumn?: string;
         cacheTime?: number;
+        merge?: boolean;
     };
     /**
      * 当前类支持的{@link EventType}事件类型
@@ -4942,7 +4948,7 @@ declare class BaseGraphic extends BaseClass {
         position: LngLatPoint | Cesium.Cartesian3 | number[];
         positions: LngLatPoint[] | Cesium.Cartesian3[] | any[];
         style: any;
-        attr?: any;
+        attr?: any | BaseGraphic.AjaxAttr;
         popup?: string | any[] | ((...params: any[]) => any);
         popupOptions?: Popup.StyleOptions | any;
         tooltip?: string | any[] | ((...params: any[]) => any);
@@ -5068,7 +5074,7 @@ declare class BaseGraphic extends BaseClass {
     /**
      * 属性信息
      */
-    attr: any;
+    attr: any | BaseGraphic.AjaxAttr;
     /**
      * 样式信息
      */
@@ -5449,9 +5455,15 @@ declare class BaseGraphic extends BaseClass {
     readonly hasAjaxAttr: boolean;
     /**
      * 获取后端动态属性，当存在attr是动态属性配置时可用【attr.type === "ajax"】
+     * @param [funOptions] - 参数
+     * @param [funOptions.merge] - 是否合并已有静态属性，优先级高于attr.merge
+     * @param [funOptions.formatData] - 可以对加载的数据进行格式化或转换操作
      * @returns 实时获取当前的动态属性值
      */
-    getAjaxAttr(): any;
+    getAjaxAttr(funOptions?: {
+        merge?: boolean;
+        formatData?: (...params: any[]) => any;
+    }): any;
     /**
      * 当前类的构造参数
      */
@@ -11026,10 +11038,6 @@ declare class ConeTrack extends CylinderEntity {
      * 夹角，半场角度，取值范围 0.01-89.99
      */
     angle: number;
-    /**
-     * 编辑处理类
-     */
-    readonly EditClass: EditCylinder;
 }
 
 /**
@@ -15642,6 +15650,13 @@ declare class GroupGraphic extends BaseGraphic {
     setStyle(newStyle: any, funOptions?: {
         merge?: boolean;
     }): BaseGraphic | any;
+    /**
+     * 设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。
+     * 对象本身透明度请用 graphic.setStyle({ opacity: value })
+     * @param value - 透明度
+     * @returns 无
+     */
+    setOpacity(value: number): void;
     /**
      * 将矢量数据导出为GeoJSON格式规范对象。
      * @param [options] - 参数对象:
@@ -16958,6 +16973,22 @@ declare class BasePolyPrimitive extends BasePrimitive {
         exact?: boolean;
         offset?: number;
     }): Promise<any>;
+    /**
+     * 是否 ajax后端动态坐标
+     */
+    readonly hasAjaxPostions: boolean;
+    /**
+     * 是否 time时序动态坐标
+     */
+    readonly hasTimePostions: boolean;
+    /**
+     * 获取当前时序坐标的开始时间和结束时间,返回的是Cesium.JulianDate格式
+     */
+    readonly timeRange: any;
+    /**
+     * 获取当前时序坐标的开始时间和结束时间,返回的是时间字符串
+     */
+    readonly timeRangeStr: any;
 }
 
 /**
@@ -18100,10 +18131,6 @@ declare class ConeTrackPrimitive extends CylinderPrimitive {
      * 夹角，半场角度，取值范围 0.01-89.99
      */
     angle: number;
-    /**
-     * 是否判断内部是否允许编辑（可外部传入禁用编辑,但不允许编辑的对象传入是无效的）
-     */
-    hasEdit: boolean;
 }
 
 declare namespace CorridorPrimitive {
@@ -19747,6 +19774,10 @@ declare namespace Pit {
      * @property imageBottom - 井底面贴图URL
      * @property diffHeight - 井下深度（单位：米）
      * @property [splitNum = 50] - 井墙面每两点之间插值个数(概略值，有经纬网网格来插值)
+     * @property [repeat] - 四周墙横纵方向重复次数
+     * @property [repeatX = 50] - 四周墙横方向重复次数，同repeat
+     * @property [repeatY = 1] - 四周墙纵方向重复次数，同repeat
+     * @property [repeatBottom = new Cesium.Cartesian2(1.0, 1.0)] - 底部横纵方向重复次数
      * @property [label] - 支持附带文字的显示
      */
     type StyleOptions = any | {
@@ -19754,6 +19785,10 @@ declare namespace Pit {
         imageBottom: string;
         diffHeight: number;
         splitNum?: number;
+        repeat?: Cesium.Cartesian2;
+        repeatX?: number;
+        repeatY?: number;
+        repeatBottom?: Cesium.Cartesian2;
         label?: LabelEntity.StyleOptions | any;
     };
 }
@@ -23363,6 +23398,7 @@ declare namespace GraphicLayer {
  * @param [options.tooltipOptions.noTitle] - 不显示标题
  * @param [options.tooltipOptions.showNull = false] - 是否显示空值
  * @param [options.contextmenuItems] - 绑定的右键菜单值，也可以bindContextMenu方法绑定
+ * @param [options.attr] - 图层级对所有矢量数据的 属性信息做统一配置，常用于动态属性
  * @param [options.id = mars3d.Util.createGuid()] - 图层id标识
  * @param [options.pid] - 图层父级的id，一般图层管理中使用
  * @param [options.name] - 图层名称
@@ -23432,6 +23468,7 @@ declare class GraphicLayer extends BaseGraphicLayer {
             showNull?: string;
         };
         contextmenuItems?: any;
+        attr?: any | BaseGraphic.AjaxAttr;
         id?: string | number;
         pid?: string | number;
         name?: string;
@@ -23538,6 +23575,10 @@ declare class GraphicLayer extends BaseGraphicLayer {
      * 卷帘对比时，设置所在的屏幕，NONE时不分屏[仅对Model小模型矢量数据有效]
      */
     splitDirection: Cesium.SplitDirection;
+    /**
+     * 属性信息 【用于对矢量数据统一绑定动态属性】
+     */
+    attr: any | BaseGraphic.AjaxAttr;
     /**
      * 手动刷新聚合
      * @returns 无
@@ -26298,7 +26339,7 @@ declare class ArcGisTileLayer extends BaseTileLayer {
  * @param options.rectangle.ymax - 最大纬度值, -90 至 90
  * @param [options.bbox] - bbox规范的瓦片数据的矩形区域范围,与rectangle二选一即可。
  * @param [options.zIndex] - 控制图层的叠加层次，默认按加载的顺序进行叠加，但也可以自定义叠加顺序，数字大的在上面(只对同类型图层间有效)。
- * @param [options.chinaCRS = mars3d.ChinaCRS.BAIDU] - 标识瓦片的国内坐标系（用于自动纠偏或加偏），自动将瓦片转为map对应的chinaCRS类型坐标系。
+ * @param [options.chinaCRS = mars3d.ChinaCRS.BAIDU] - 标识瓦片的国内坐标系（用于自动纠偏或加偏），自动将瓦片转为map对应的chinaCRS类型坐标系，如果加载不纠偏的原始瓦片，可以传入map相同的chinaCRS即可，比如 chinaCRS:mars3d.ChinaCRS.WGS84
  * @param [options.proxy] - 加载资源时要使用的代理服务url。
  * @param [options.queryParameters] - 一个对象，其中包含在检索资源时将发送的查询参数。比如：queryParameters: {'access_token': '123-435-456-000'},
  * @param [options.headers] - 一个对象，将发送的其他HTTP标头。比如：headers: { 'X-My-Header': 'valueOfHeader' },
@@ -29004,7 +29045,7 @@ declare namespace Map {
      * @property [showSun] - 是否显示太阳，如修改对象可以用 [map.scene.sun]{@link http://mars3d.cn/api/cesium/Sun.html}
      * @property [showMoon] - 是否显示月亮，如修改对象可以用 [map.scene.moon]{@link http://mars3d.cn/api/cesium/Moon.html}
      * @property [showSkyAtmosphere] - 是否显示地球大气层外光圈，如修改对象可以用 [map.scene.skyAtmosphere]{@link http://mars3d.cn/api/cesium/SkyAtmosphere.html}
-     * @property [fog] - 是否启用雾化效果，如修改对象可以用 [map.scene.fog]{@link http://mars3d.cn/api/cesium/fog.html}
+     * @property [fog] - 是否启用雾化效果，如修改对象可以用 [map.scene.fog]{@link http://mars3d.cn/api/cesium/Fog.html}
      * @property [atmosphere] - 3D贴图和模型用于渲染天空大气、地面大气和雾的常见大气设置。
      * @property [atmosphere.lightIntensity = 10.0] - 用于计算地面大气颜色的光的强度。
      * @property [atmosphere.rayleighScaleHeight = 10000.0] - 地面大气散射方程中使用的瑞利尺度高度，单位为米。
@@ -36876,6 +36917,10 @@ declare class Task extends BaseThing {
      * @returns 是否成功删除
      */
     removeItem(id: number | string): boolean;
+    /**
+     * 释放所有子任务
+     */
+    disableAll(): void;
     /**
      * 根据配置数组获取实例化后的对象数组
      * @param list - 配置数组
@@ -37353,6 +37398,10 @@ declare type getSlope_endItem = (event: {
  * @param [options.imageBottom] - 当显示开挖区域的井时，井底面贴图URL
  * @param [options.diffHeight] - 当显示开挖区域的井时，设置所有区域的挖掘深度（单位：米）
  * @param [options.splitNum = 30] - 当显示开挖区域的井时，井墙面每两点之间插值个数(概略值，有经纬网网格来插值)
+ * @param [options.repeat] - 当显示开挖区域的井时，井四周墙横纵方向重复次数
+ * @param [options.repeatX = 50] - 当显示开挖区域的井时，井四周墙横方向重复次数，同repeat
+ * @param [options.repeatY = 1] - 当显示开挖区域的井时，井四周墙纵方向重复次数，同repeat
+ * @param [options.repeatBottom = new Cesium.Cartesian2(1.0, 1.0)] - 当显示开挖区域的井时，井底部横纵方向重复次数
  * @param [options.exact = false] - 是否进行精确计算， 传false时是否快速概略计算方式，该方式计算精度较低，但计算速度快，仅能计算在当前视域内坐标的高度
  * @param [options.czm = true] - true:使用cesium原生clippingPolygons接口来操作，false：使用mars3d自定义方式操作
  * @param [options.id = createGuid()] - 对象的id标识
@@ -37367,6 +37416,10 @@ declare class TerrainClip extends TerrainEditBase {
         imageBottom?: string;
         diffHeight?: number;
         splitNum?: number;
+        repeat?: Cesium.Cartesian2;
+        repeatX?: number;
+        repeatY?: number;
+        repeatBottom?: Cesium.Cartesian2;
         exact?: boolean;
         czm?: boolean;
         id?: string | number;
@@ -39662,13 +39715,15 @@ declare namespace PointUtil {
      * @param [options = {}] - 参数对象:
      * @param [options.heightReference = Cesium.HeightReference.CLAMP_TO_GROUND] - 高度参考，决定是否仅贴模型、仅贴地形、全部都考虑
      * @param [options.original = false] - 计算失败时是否返回原始高度值
-     * @param [options.min = -999] - 限定最小数,屏蔽异常数
+     * @param [options.min] - 限定最小数,屏蔽异常数
+     * @param [options.max] - 限定最大数,屏蔽异常数
      * @returns 贴地高度
      */
     function getHeight(scene: Cesium.Scene, position: Cesium.Cartesian3 | LngLatPoint, options?: {
         heightReference?: Cesium.HeightReference;
         original?: boolean;
         min?: number;
+        max?: number;
     }): number;
     /**
      * 异步精确计算坐标的 贴地(或贴模型)高度
@@ -39874,6 +39929,13 @@ declare namespace PolyUtil {
      * @returns 缓冲后的新坐标数组
      */
     function bufferPoints(points: LngLatPoint[] | Cesium.Cartesian3[] | any[], width: number, steps?: number): LngLatPoint[];
+    /**
+     * 坐标数组整体移动到新的中心点位置
+     * @param points - 坐标数组
+     * @param centerNew - 新的中心点坐标
+     * @returns 移动后的坐标点数组
+     */
+    function movePoints(points: LngLatPoint[] | Cesium.Cartesian3[] | any[], centerNew: Cesium.Cartesian3): Cesium.Cartesian3[];
     /**
      * 求坐标数组的矩形范围内 按 splitNum网格数插值的 granularity值
      * @param positions - 坐标数组
@@ -40882,6 +40944,13 @@ declare namespace Util {
      * @returns 无
      */
     function webglerror(): void;
+    /**
+     * 处理URL地址中参数，解析传入的 URL 和参数对象，然后将新的参数合并到 URL 中。如果 URL 中已经存在某些参数，则用新的参数覆盖它们。
+     * @param url - 原始URL，其中可能已有参数
+     * @param params - 需要新增的参数，如果url中已有进行覆盖
+     * @returns 新的带参数的URL地址
+     */
+    function buildUrl(url: string, params: any): string;
     /**
      * 获取当前页面的url中的?传入参数对象集合
      * @returns 参数名与参数值的键值对