mars3d 3.10.2 → 3.10.4

package/mars3d.css

@@ -1,8 +1,8 @@
 /**
  * Mars3D三维可视化平台  mars3d
  *
- * 版本信息：v3.10.2
- * 编译日期：2025-08-11 22:10
+ * 版本信息：v3.10.4
+ * 编译日期：2025-09-05 17:45
  * 版权所有：Copyright by 火星科技  http://mars3d.cn
  * 使用单位：火星科技免费公开版 ，2025-07-01
  */
@@ -80,6 +80,9 @@
   top: 0;
   left: 0;
 }
+.mars3d-contextmenu-ul .mars3d-contextmenu-item ::marker {
+  content: "";
+}
 .mars3d-contextmenu-ul .mars3d-contextmenu-line {
   position: absolute;
   left: 2%;
@@ -1021,6 +1024,10 @@
 .mars3d-template-content textarea::placeholder {
   color: #cdcdcd;
 }
+.mars3d-popup-iframe {
+  overflow: auto;
+  margin: 0;
+}
 /*****tooltip弹出框样式******/
 .mars3d-tooltip {
   padding: 6px;

package/mars3d.d.ts

@@ -2,8 +2,8 @@
 /**
  * Mars3D三维可视化平台  mars3d
  *
- * 版本信息：v3.10.2
- * 编译日期：2025-08-11 22:10
+ * 版本信息：v3.10.4
+ * 编译日期：2025-09-05 17:45
  * 版权所有：Copyright by 火星科技  http://mars3d.cn
  * 使用单位：火星科技免费公开版 ，2025-07-01
  */
@@ -2992,6 +2992,11 @@ declare class MouseDownView extends BaseControl {
         insertIndex?: number;
         insertBefore?: HTMLElement | string;
     });
+    /**
+     * 重新加载
+     * @returns 无
+     */
+    reload(): void;
 }
 
 /**
@@ -5502,6 +5507,7 @@ declare class BaseGraphic extends BaseClass {
      * @param [content.callback] - 菜单项单击后的回调方法
      * @param [content.children] - 当有二级子菜单时，配置数组。
      * @param [options = {}] - 控制参数
+     * @param [options.mergeMap] - 是否合并一起显示map默认右键菜单
      * @param [options.offsetX] - 用于非规则对象时，横向偏移的px像素值
      * @param [options.offsetY] - 用于非规则对象时，垂直方向偏移的px像素值
      * @returns 当前对象本身，可以链式调用
@@ -5513,6 +5519,7 @@ declare class BaseGraphic extends BaseClass {
         callback?: (...params: any[]) => any;
         children?: any;
     }[], options?: {
+        mergeMap?: boolean;
         offsetX?: number;
         offsetY?: number;
     }): BaseGraphic | any;
@@ -14700,6 +14707,8 @@ declare namespace WallEntity {
      * @property [distanceDisplayCondition = false] - 是否按视距显示 或 指定此框将显示在与摄像机的多大距离。
      * @property [distanceDisplayCondition_far = number.MAX_VALUE] - 最大距离
      * @property [distanceDisplayCondition_near = 0] - 最小距离
+     * @property [riseAnimationDelay = 0] - 延迟多少秒执行执行生长动画, 延迟期间不显示
+     * @property [riseAnimationDuration] - 执行生长动画的时长（内部执行startRiseAnimation方法）,单位：秒
      * @property [hasShadows = false] - 是否阴影
      * @property [shadows = Cesium.ShadowMode.DISABLED] - 指定墙壁是投射还是接收来自光源的阴影。
      * @property [granularity = Cesium.Math.RADIANS_PER_DEGREE] - 指定每个纬度点和经度点之间的角距离。
@@ -14732,6 +14741,8 @@ declare namespace WallEntity {
         distanceDisplayCondition?: boolean | Cesium.DistanceDisplayCondition;
         distanceDisplayCondition_far?: number;
         distanceDisplayCondition_near?: number;
+        riseAnimationDelay?: number;
+        riseAnimationDuration?: number;
         hasShadows?: boolean;
         shadows?: Cesium.ShadowMode;
         granularity?: number;
@@ -14819,6 +14830,26 @@ declare class WallEntity extends BasePolyEntity {
      * 编辑处理类
      */
     readonly EditClass: EditWall;
+    /**
+     * 开始播放 升高动画
+     * @param options - 参数
+     * @param [options.delay = 0] - 延迟多少秒后执行(秒) , 延迟期间不显示
+     * @param [options.duration = 8] - 总时长(秒)
+     * @param [options.autoStop] - 完成后自动调用
+     * @param [options.callback] - 完成后回调stopRiseAnimation
+     * @returns 无
+     */
+    startRiseAnimation(options: {
+        delay?: number;
+        duration?: number;
+        autoStop?: boolean;
+        callback?: (...params: any[]) => any;
+    }): void;
+    /**
+     * 停止 升高动画
+     * @returns 无
+     */
+    stopRiseAnimation(): void;
 }
 
 /**
@@ -19695,7 +19726,7 @@ declare namespace ModelPrimitive {
      * @property [enableDebugWireframe = false] - 仅供调试。是否可以通过debugWireframe来切换查看模型的三角网线框图。
      * @property [debugWireframe = false] - 仅供调试。是否打开模型的三角网线框图。
      * @property [cull = true] - Whether or not to cull the model using frustum/horizon culling. If the model is part of a 3D Tiles tileset, this property will always be false, since the 3D Tiles culling system is used.
-     * @property [opaquePass = Cesium.Pass.OPAQUE] - The pass to use in the {@link DrawCommand} for the opaque portions of the model.
+     * @property [opaquePass = Cesium.Pass.OPAQUE] - 设置渲染通道，在实际使用中，对于模型的不透明部分，应该将DrawCommand的pass属性设置为Cesium.Pass.OPAQUE，这样 Cesium 的渲染器就会在处理不透明物体的阶段渲染该部分，保证渲染顺序和深度检测等机制正常工作。
      * @property [upAxis = Cesium.Axis.Y] - The up-axis of the glTF model.
      * @property [forwardAxis = Cesium.Axis.Z] - The forward-axis of the glTF model.
      * @property [customShader] - A custom shader. This will add user-defined GLSL code to the vertex and fragment shaders. Using custom shaders with a {@link Cesium3DTileStyle} may lead to undefined behavior.
@@ -19779,7 +19810,7 @@ declare namespace ModelPrimitive {
         enableDebugWireframe?: boolean;
         debugWireframe?: boolean;
         cull?: boolean;
-        opaquePass?: boolean;
+        opaquePass?: any | number;
         upAxis?: Cesium.Axis;
         forwardAxis?: Cesium.Axis;
         customShader?: Cesium.CustomShader;
@@ -21997,6 +22028,7 @@ declare class BaseGraphicLayer extends BaseLayer {
      * @param [content.callback] - 菜单项单击后的回调方法
      * @param [content.children] - 当有二级子菜单时，配置数组。
      * @param [options = {}] - 控制参数
+     * @param [options.mergeMap] - 是否合并一起显示map默认右键菜单
      * @param [options.offsetX] - 用于非规则对象时，横向偏移的px像素值
      * @param [options.offsetY] - 用于非规则对象时，垂直方向偏移的px像素值
      * @returns 当前对象本身，可以链式调用
@@ -22008,6 +22040,7 @@ declare class BaseGraphicLayer extends BaseLayer {
         callback?: (...params: any[]) => any;
         children?: any;
     }[], options?: {
+        mergeMap?: boolean;
         offsetX?: number;
         offsetY?: number;
     }): BaseGraphicLayer;
@@ -25244,6 +25277,8 @@ declare namespace TilesetLayer {
  * @param [options.environmentMapManager] - 使用PBR时更新了默认的3D瓷砖和模型照明，以创建更逼真的外观。Cesium.DynamicEnvironmentMapManager
  * @param [options.backFaceCulling = true] - 是否剔除面向背面的几何图形。当为真时，背面剔除由glTF材质的双面属性决定;当为false时，禁用背面剔除。
  * @param [options.enableCollision = false] - 是否启用picking碰撞拾取，贴模型时需要开启。如果<code> map.scene.screenSpaceCameraController.enableCollisionDetection</code>为true，则相机将被阻止低于模型表面。
+ * @param [options.opaquePass = Cesium.Pass.OPAQUE] - 设置渲染通道，在实际使用中，对于Model模型的不透明部分，应该将DrawCommand的pass属性设置为Cesium.Pass.OPAQUE，这样 Cesium 的渲染器就会在处理不透明物体的阶段渲染该部分，保证渲染顺序和深度检测等机制正常工作。
+ * @param [options.renderState] - 可选渲染状态，以覆盖Model模型内部默认渲染状态。
  * @param [options.enableShowOutline = true] - 是否启用模型的轮廓 {@link https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Vendor/CESIUM_primitive_outline|CESIUM_primitive_outline} 扩展. 可以将其设置为false，以避免在加载时对几何图形进行额外处理。如果为false，则会忽略showOutlines和outlineColor选项。
  * @param [options.showOutline = true] - 是否显示模型的轮廓 {@link https://github.com/KhronosGroup/glTF/tree/master/extensions/2.0/Vendor/CESIUM_primitive_outline|CESIUM_primitive_outline} 扩展. 当为true时，将显示轮廓。当为false时，不显示轮廓。
  * @param [options.outlineColor = Color.BLACK] - 渲染outline轮廓时要使用的颜色。
@@ -25388,6 +25423,8 @@ declare class TilesetLayer extends BaseGraphicLayer {
         environmentMapManager?: any;
         backFaceCulling?: boolean;
         enableCollision?: boolean;
+        opaquePass?: any | number;
+        renderState?: any;
         enableShowOutline?: boolean;
         showOutline?: boolean;
         outlineColor?: Cesium.Color;
@@ -29029,6 +29066,8 @@ declare class WmsLayer extends BaseTileLayer {
  * @param [options.tileMatrixSetID] - 同tileMatrixSet，Cesium原生参数
  * @param [options.tileMatrixLabels] - 瓦片矩阵中用于WMTS请求的标识符列表，每个瓦片矩阵级别一个。
  * @param [options.tileMatrixBefore] - 用于WMTS请求的tilematrix，当tileMatrixLabels是有规律的前缀+层级时，可以用tilematrixBefore配置前缀字符串即可。
+ * @param [options.parameters] - 要在URL中额外增加的请求参数
+ * @param [options.parameters.version = "1.0.0"] - 服务版本
  * @param [options.clock] - 一个时钟实例，用于确定时间维度的值。指定' times '时需要。
  * @param [options.times] - TimeIntervalCollection 的数据属性是一个包含时间动态维度及其值的对象。
  * @param [options.getCapabilities = true] - 是否通过服务本身的GetCapabilities来读取一些参数，减少options配置项
@@ -29103,6 +29142,9 @@ declare class WmtsLayer extends BaseTileLayer {
         tileMatrixSetID?: string;
         tileMatrixLabels?: string[];
         tileMatrixBefore?: string;
+        parameters?: {
+            version?: string;
+        };
         clock?: Cesium.Clock;
         times?: Cesium.TimeIntervalCollection;
         getCapabilities?: boolean;
@@ -30238,6 +30280,14 @@ declare class Map extends BaseClass {
      * 获取或设置当前的地形服务
      */
     terrainProvider: Cesium.TerrainProvider | any;
+    /**
+     * 地形加载是否完成的承诺
+     */
+    terrainPromise: Promise<any>;
+    /**
+     * 当前批次的瓦片加载完成的承诺
+     */
+    tilePromise: Promise<boolean>;
     /**
      * 是否开启地形
      */
@@ -33805,6 +33855,10 @@ declare class PointPlot extends BasePointEntity {
         flyTo?: boolean;
         flyToOptions?: any;
     });
+    /**
+     * 标号编码
+     */
+    readonly code: string | number;
     /**
      * 矢量数据对应的 Cesium内部对象的具体类型对象
      */
@@ -33900,6 +33954,7 @@ declare namespace PolyPlot {
  * @param options.positions - 坐标位置
  * @param options.style - 样式信息
  * @param [options.attr] - 附件的属性信息，可以任意附加属性，导出geojson或json时会自动处理导出。
+ * @param [options.scaleValues] - 参数比例点对应的参数值，用于计算“参数比例点”位置
  * @param [options.availability] - 指定时间范围内显示该对象
  * @param [options.description] - 指定此实体的HTML描述的字符串属性（infoBox中展示）。
  * @param [options.viewFrom] - 观察这个物体时建议的初始偏移量。
@@ -33935,6 +33990,7 @@ declare class PolyPlot extends BasePolyEntity {
         positions: LngLatPoint[] | Cesium.Cartesian3[] | Cesium.PositionProperty | any[] | BaseGraphic.TimePolyPositions;
         style: PolyPlot.StyleOptions | any;
         attr?: any | BaseGraphic.AjaxAttr;
+        scaleValues?: number[];
         availability?: Cesium.TimeIntervalCollection | Cesium.TimeInterval | any[] | any;
         description?: Cesium.Property | string;
         viewFrom?: Cesium.Property;
@@ -33964,6 +34020,10 @@ declare class PolyPlot extends BasePolyEntity {
         flyTo?: boolean;
         flyToOptions?: any;
     });
+    /**
+     * 标号编码
+     */
+    readonly code: string | number;
     /**
      * 矢量数据对应的 Cesium内部对象的具体类型对象
      */
@@ -33988,9 +34048,6 @@ declare namespace PlotUtil {
      * @example
      * mars3d.PlotUtil.readyPromise.then(() => {
      *     console.log("Plot库初始化完成")
-     *
-     *     console.log("支持的标号库（树结构）:", mars3d.PlotUtil.symbolTree)
-     *     console.log("支持的标号库（code键值对）:", mars3d.PlotUtil.symbolObj)
      *   })
      */
     const readyPromise: Promise<any>;
@@ -34132,7 +34189,7 @@ declare class Tle {
      */
     readonly checksum2: number;
     /**
-     * 获取卫星指定时间所在的 ECI地固系坐标
+     * 获取卫星指定时间所在的 ECEF地心地固坐标系
      * @param datetime - 指定的时间
      * @returns ECEF(地心地固坐标系) 坐标
      */
@@ -34174,7 +34231,7 @@ declare class Tle {
      */
     static getPoint(tle1: string, tle2: string, datetime: Date | Cesium.JulianDate | number, isFixed?: boolean): LngLatPoint | undefined;
     /**
-     * 获取卫星指定时间所在的 ECI地固系坐标
+     * 获取卫星指定时间所在的 ECEF地心地固坐标系
      * @param tle1 - 卫星TLE的第一行
      * @param tle2 - 卫星TLE的第二行
      * @param datetime - 指定的时间
@@ -34203,7 +34260,7 @@ declare class Tle {
      */
     static eciToGeodetic(positionEci: Cesium.Cartesian3, datetime: Date | Cesium.JulianDate | number): LngLatPoint;
     /**
-     * ECI惯性系坐标 转换为 ECI地固系坐标
+     * ECI惯性系坐标 转换为 ECEF地心地固坐标系
      * @param positionEci - ECI(地心惯性坐标系)坐标
      * @param datetime - 指定时间, number时请传入格林尼治恒星时(GMST)时间
      * @param [positionEcf] - ECI(地心惯性坐标系)坐标
@@ -34211,7 +34268,7 @@ declare class Tle {
      */
     static eciToEcf(positionEci: Cesium.Cartesian3, datetime: Date | Cesium.JulianDate | number, positionEcf?: Cesium.Cartesian3): Cesium.Cartesian3;
     /**
-     * ECI地固系坐标 转换为 ECI惯性系坐标
+     * ECEF地心地固坐标系 转换为 ECI惯性系坐标
      * @param positionEcf - ECEF(地心地固坐标系) 坐标
      * @param datetime - 指定时间, number时请传入格林尼治恒星时(GMST)时间
      * @returns ECI(地心惯性坐标系)坐标
@@ -38437,6 +38494,11 @@ declare class TerrainEditBase extends BaseThing {
         };
         id?: number | string;
     }): any;
+    /**
+     * 重新加载数据（会重新按当前地形服务计算，如切换地形后可以调用）
+     * @returns 无
+     */
+    reload(): void;
 }
 
 /**
@@ -40094,6 +40156,12 @@ declare namespace LayerUtil {
      * @returns 无
      */
     function registerTerrainProvider(type: string, layerClass: any): void;
+    /**
+     * 取当前subdomains配置的随机1个值，用于URL模板中用于 {s} 占位符的子域
+     * @param subdomains - 可选的子域
+     * @returns 随机取的一个子域
+     */
+    function getSubdomainItem(subdomains: any): string;
     /**
      * 创建地形对象的工厂方法
      * @param options - 地形参数
@@ -40886,8 +40954,8 @@ declare namespace PolyUtil {
      * @param [options.offset] - [方式2] 按移动的变量
      * @returns 移动后的坐标点数组
      */
-    function movePoints(points: LngLatPoint[] | Cesium.Cartesian3[] | any[], options: {
-        center?: Cesium.Cartesian3;
+    function movePoints(points: LngLatPoint[] | Cesium.Cartesian3[] | any[] | any, options: {
+        center?: string | any[] | LngLatPoint | Cesium.Cartesian3 | any;
         offset?: Cesium.Cartesian3;
     }): Cesium.Cartesian3[];
     /**
@@ -42316,6 +42384,9 @@ declare namespace graphic {
   export { RectSensor }
   export { Satellite }
   export { SatelliteSensor }
+
+  export { PointPlot }
+  export { PolyPlot }
 }
 
 /**
@@ -42467,7 +42538,7 @@ declare namespace thing {
 }
 
 export {
-  name, update, version, proj4, Tle, WindUtil,
+  name, update, version, proj4, Tle, WindUtil, PlotUtil,
   BaseClass, BaseThing, LngLatPoint, LngLatArray, GroundSkyBox, MultipleSkyBox, LocalWorldTransform, CRS, ChinaCRS, EventType, State, Token, ColorRamp, TaskItem,
   MaterialType, GraphicType, LayerType, ControlType, EffectType, ThingType, Lang, MoveType, ClipType, Icon, EditPointType, QueryServiceType, QueryRouteType,
   DomUtil, MeasureUtil, PointUtil, PolyUtil, PointTrans, Util, Log, MaterialUtil, GraphicUtil, DrawUtil, LayerUtil, ControlUtil, EffectUtil, ThingUtil,