mars3d 3.7.21 → 3.7.23

package/dist/mars3d.css

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

package/dist/mars3d.d.ts

@@ -2,8 +2,8 @@
 /**
  * Mars3D三维可视化平台  mars3d
  *
- * 版本信息：v3.7.21
- * 编译日期：2024-07-05 15:23:40
+ * 版本信息：v3.7.23
+ * 编译日期：2024-07-23 21:10:10
  * 版权所有：Copyright by 火星科技  http://mars3d.cn
  * 使用单位：免费公开版 ，2024-01-15
  */
@@ -2076,7 +2076,8 @@ declare class BaseControl extends BaseThing {
 }
 
 /**
- * 时钟及其动画的管理控制
+ * 时钟及其动画的管理控制，
+ * 控件界面的相关值取自 map.clock 下相关属性值。
  * @param [options] - 参数对象，包括以下：
  * @param [options.format = "yyyy-MM-dd HH:mm:ss"] - 当前时间格式化字符串
  * @param [options.className] - 样式名称，可以外部自定义样式。
@@ -4599,7 +4600,8 @@ declare class BaseGraphic extends BaseClass {
      */
     setStyle(newStyle: any): BaseGraphic | any;
     /**
-     * 设置透明度, 不是所有类型均支持，主要看数据类型和材质类型决定。
+     * 设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。
+     * 对象本身透明度请用 graphic.setStyle({ opacity: value })
      * @param value - 透明度
      * @returns 无
      */
@@ -5587,7 +5589,8 @@ declare class FlatBillboard extends BaseCombine {
      */
     clear(): void;
     /**
-     * 设置透明度
+     * 设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。
+     * 对象本身透明度请用 graphic.setStyle({ opacity: value })
      * @param value - 透明度
      * @returns 无
      */
@@ -7390,7 +7393,8 @@ declare class Tetrahedron extends BasePointPrimitive {
      */
     readonly modelMatrix: Cesium.Matrix4;
     /**
-     * 设置透明度
+     * 设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。
+     * 对象本身透明度请用 graphic.setStyle({ opacity: value })
      * @param value - 透明度
      * @returns 无
      */
@@ -7403,8 +7407,8 @@ declare namespace Video3D {
      * @property [container] - video视频DOM容器
      * @property [url] - 视频的URL路径,与DOM二选一
      * @property [maskImage] - 遮盖融合的图片url地址，可以用于视频的四周羽化效果。
-     * @property angle - 水平张角(度数)
-     * @property angle2 - 垂直张角(度数)
+     * @property angle - 水平张角(度数)，半场角度
+     * @property angle2 - 垂直张角(度数)，半场角度
      * @property [distance] - 投射最远距离，单位：米
      * @property [heading = 0] - 方向角 （度数值，0-360度）
      * @property [pitch = 0] - 俯仰角（度数值，0-360度）
@@ -7414,6 +7418,9 @@ declare namespace Video3D {
      * @property [flipy = false] - 是否Y方向翻转图片
      * @property [hiddenAreaColor = new Cesium.Color(0, 0, 0, 0.5)] - 无视频投影区域的颜色
      * @property [showFrustum = false] - 是否显示视椎体框线
+     * @property [distanceDisplayCondition = false] - 是否按视距显示 或 指定此框将显示在与摄像机的多大距离。
+     * @property [distanceDisplayCondition_far = number.MAX_VALUE] - 最大距离
+     * @property [distanceDisplayCondition_near = 0] - 最小距离
      */
     type StyleOptions = any | {
         container?: HTMLVideoElement;
@@ -7430,6 +7437,9 @@ declare namespace Video3D {
         flipy?: boolean;
         hiddenAreaColor?: Cesium.Color | string;
         showFrustum?: boolean;
+        distanceDisplayCondition?: boolean | Cesium.DistanceDisplayCondition;
+        distanceDisplayCondition_far?: number;
+        distanceDisplayCondition_near?: number;
     };
 }
 
@@ -7536,7 +7546,8 @@ declare class ViewDome extends BasePointPrimitive {
      */
     hiddenColor: string | Cesium.Color;
     /**
-     * 设置透明度
+     * 设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。
+     * 对象本身透明度请用 graphic.setStyle({ opacity: value })
      * @param value - 透明度
      * @returns 无
      */
@@ -7546,8 +7557,8 @@ declare class ViewDome extends BasePointPrimitive {
 declare namespace ViewShed {
     /**
      * 可视域矢量对象 支持的样式信息
-     * @property [angle = 60] - 水平张角(度数)，取值范围 0-60
-     * @property [angle2 = 45] - 垂直张角(度数)，取值范围 0-45
+     * @property [angle = 60] - 水平张角(度数)，半场角度，取值范围 0-60
+     * @property [angle2 = 45] - 垂直张角(度数)，半场角度，取值范围 0-45
      * @property [distance] - 投射最远距离，单位：米
      * @property [heading = 0] - 方向角 （度数值，0-360度）
      * @property [pitch = 0] - 俯仰角（度数值，0-360度）
@@ -7650,7 +7661,8 @@ declare class ViewShed extends BasePointPrimitive {
      */
     setView(): void;
     /**
-     * 设置透明度
+     * 设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。
+     * 对象本身透明度请用 graphic.setStyle({ opacity: value })
      * @param value - 透明度
      * @returns 无
      */
@@ -8039,7 +8051,8 @@ declare class DivGraphic extends BaseGraphic {
      */
     html: string | HTMLDivElement;
     /**
-     * 设置透明度
+     * 设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。
+     * 对象本身透明度请用 graphic.setStyle({ opacity: value })
      * @param value - 透明度
      * @returns 无
      */
@@ -8525,6 +8538,16 @@ declare class EditDivGraphic extends EditBase {
      * @returns 当前对象本身，可以链式调用
      */
     disable(): EditBase;
+    /**
+     * 开启 平移矩阵
+     * @param [graphic] - 矢量对象
+     * @param [eventRM] - 事件对象，仅用于传递
+     */
+    startMoveMatrix(graphic?: BaseGraphic, eventRM?: any): void;
+    /**
+     * 停止 平移矩阵
+     */
+    stopMoveMatrix(): void;
 }
 
 declare namespace Popup {
@@ -8843,7 +8866,8 @@ declare class BaseEntity extends BaseGraphic {
      */
     closeHighlight(): void;
     /**
-     * 设置透明度
+     * 设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。
+     * 对象本身透明度请用 graphic.setStyle({ opacity: value })
      * @param value - 透明度
      * @returns 无
      */
@@ -9456,7 +9480,8 @@ declare class BillboardEntity extends BasePointEntity {
      */
     image: string | HTMLCanvasElement;
     /**
-     * 设置透明度
+     * 设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。
+     * 对象本身透明度请用 graphic.setStyle({ opacity: value })
      * @param value - 透明度
      * @returns 无
      */
@@ -11573,7 +11598,8 @@ declare class LabelEntity {
      */
     stopBounce(): void;
     /**
-     * 设置透明度
+     * 设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。
+     * 对象本身透明度请用 graphic.setStyle({ opacity: value })
      * @param value - 透明度
      * @returns 无
      */
@@ -11824,48 +11850,8 @@ declare class ModelEntity extends BasePointEntity {
      */
     cancelMoveTo(): void;
     /**
-     * 飞行定位至数据所在的视角
-     * @param [options = {}] - 参数对象:
-     * @param [options.scale = 1.2] - 缩放比例，可以根据控制视角比模型大小略大一些，这样效果更友好。
-     * @param options.radius - 相机距离目标点的距离（单位：米），与scale二选一
-     * @param [options.minHeight] - 定位时相机的最小高度值，用于控制避免异常数据
-     * @param [options.maxHeight] - 定位时相机的最大高度值，用于控制避免异常数据
-     * @param [options.heading] - 方向角度值，绕垂直于地心的轴旋转角度, 0至360
-     * @param [options.pitch] - 俯仰角度值，绕纬度线旋转角度, -90至90
-     * @param [options.roll] - 翻滚角度值，绕经度线旋转角度,-90至90
-     * @param [options.duration] - 飞行时间（单位：秒）。如果省略，SDK内部会根据飞行距离计算出理想的飞行时间。
-     * @param [options.complete] - 飞行完成后要执行的函数。
-     * @param [options.cancel] - 飞行取消时要执行的函数。
-     * @param [options.endTransform] - 变换矩阵表示飞行结束时相机所处的参照系。
-     * @param [options.maximumHeight] - 飞行高峰时的最大高度。
-     * @param [options.pitchAdjustHeight] - 如果相机飞得比这个值高，在飞行过程中调整俯仰以向下看，并保持地球在视口。
-     * @param [options.flyOverLongitude] - 地球上的两点之间总有两条路。这个选项迫使相机选择战斗方向飞过那个经度。
-     * @param [options.flyOverLongitudeWeight] - 仅在通过flyOverLongitude指定的lon上空飞行，只要该方式的时间不超过flyOverLongitudeWeight的短途时间。
-     * @param [options.convert = true] - 是否将目的地从世界坐标转换为场景坐标（仅在不使用3D时相关）。
-     * @param [options.easingFunction] - 控制在飞行过程中如何插值时间。
-     * @returns 如果飞行成功则解析为true的承诺，如果当前未在场景中可视化目标或取消飞行，则为false的Promise
-     */
-    flyTo(options?: {
-        scale?: number;
-        radius: number;
-        minHeight?: number;
-        maxHeight?: number;
-        heading?: number;
-        pitch?: number;
-        roll?: number;
-        duration?: number;
-        complete?: Cesium.Camera.FlightCompleteCallback;
-        cancel?: Cesium.Camera.FlightCancelledCallback;
-        endTransform?: Cesium.Matrix4;
-        maximumHeight?: number;
-        pitchAdjustHeight?: number;
-        flyOverLongitude?: number;
-        flyOverLongitudeWeight?: number;
-        convert?: boolean;
-        easingFunction?: Cesium.EasingFunction.Callback;
-    }): Promise<boolean>;
-    /**
-     * 设置透明度
+     * 设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。
+     * 对象本身透明度请用 graphic.setStyle({ opacity: value })
      * @param value - 透明度
      * @returns 无
      */
@@ -13546,7 +13532,8 @@ declare class Video2D extends PolygonEntity {
      */
     play: boolean;
     /**
-     * 设置透明度
+     * 设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。
+     * 对象本身透明度请用 graphic.setStyle({ opacity: value })
      * @param value - 透明度
      * @returns 无
      */
@@ -15445,8 +15432,8 @@ declare class VolumeDepthMeasure extends AreaMeasure {
      */
     minHeight: number;
     /**
-     * 最高高度，对应墙的高度，
-     * 不影响测量结果，只是显示效果的区别。
+     * 最高高度，
+     * 会影响 挖方量：高于“最高高度”的挖方被忽略
      */
     maxHeight: number;
     /**
@@ -16025,7 +16012,8 @@ declare class BasePrimitive extends BaseGraphic {
      */
     setOffsetHeight(height?: number, index?: number | undefined): void;
     /**
-     * 设置透明度, 不是所有类型均支持调整透明度，主要看数据类型和材质类型决定。
+     * 设置整体透明度(globalAlpha值) , 非全部矢量数据都支持，具体需要对应Graphic支持才有效
+     * 对象本身透明度请修改 graphic.setStyle({ opacity: value })
      * @param value - 透明度
      * @returns 无
      */
@@ -16145,7 +16133,8 @@ declare class BillboardPrimitive extends BasePointPrimitive {
      */
     image: string | HTMLCanvasElement;
     /**
-     * 设置透明度
+     * 设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。
+     * 对象本身透明度请用 graphic.setStyle({ opacity: value })
      * @param value - 透明度
      * @returns 无
      */
@@ -17537,7 +17526,8 @@ declare class DynamicRiver extends BasePolyPrimitive {
      */
     setOffsetHeight(height: number, time: number): void;
     /**
-     * 设置透明度
+     * 设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。
+     * 对象本身透明度请用 graphic.setStyle({ opacity: value })
      * @param value - 透明度
      * @returns 无
      */
@@ -17927,7 +17917,8 @@ declare class LabelPrimitive extends BasePointPrimitive {
      */
     readonly text: string;
     /**
-     * 设置透明度
+     * 设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。
+     * 对象本身透明度请用 graphic.setStyle({ opacity: value })
      * @param value - 透明度
      * @returns 无
      */
@@ -17998,7 +17989,8 @@ declare class LightCone extends BasePointPrimitive {
      */
     color: Cesium.Color;
     /**
-     * 设置透明度
+     * 设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。
+     * 对象本身透明度请用 graphic.setStyle({ opacity: value })
      * @param value - 透明度
      * @returns 无
      */
@@ -18333,7 +18325,8 @@ declare class ModelPrimitive extends BasePointPrimitive {
      */
     readonly readyPromise: Promise<Cesium.Model>;
     /**
-     * 设置透明度
+     * 设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。
+     * 对象本身透明度请用 graphic.setStyle({ opacity: value })
      * @param value - 透明度
      * @returns 无
      */
@@ -20789,7 +20782,8 @@ declare class CzmGeoJsonLayer extends BaseGraphicLayer {
      */
     lblAddFun(position: Cesium.Cartesian3 | Cesium.SampledPositionProperty | any, labelattr: any, attr: any): Cesium.Label;
     /**
-     * 设置透明度
+     * 设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。
+     * 对象本身透明度请用 graphic.setStyle({ opacity: value })
      * @param value - 透明度
      * @returns 无
      */
@@ -22487,7 +22481,8 @@ declare class GraphicLayer extends BaseGraphicLayer {
      */
     getClusterList(): any[];
     /**
-     * 设置透明度 , 非全部矢量数据都支持，具体需要对应Graphic支持才有效
+     * 设置整体透明度(globalAlpha值) , 非全部矢量数据都支持，具体需要对应Graphic支持才有效
+     * 对象本身透明度请修改 graphic.setStyle({ opacity: value })
      * @param value - 透明度
      * @returns 无
      */
@@ -31177,9 +31172,7 @@ declare class EchartsLayer extends BaseLayer {
  * @param [options.style.arcBlurScale = 1.5] - 曲面热力图时，blur扩大比例
  * @param [options.style.arcDirection = 1] - 曲面热力图时，凹陷的方向，1向上，-1向下，0双面
  * @param [options.style.diffHeight] - 曲面热力图时，曲面的起伏差值高，默认根据数据范围的比例自动计算。
- * @param [options.maxCanvasSize = 5000] - Canvas最大尺寸（单位：像素），调大精度更高，但过大容易内存溢出
- * @param [options.minCanvasSize = 700] - Canvas最小尺寸（单位：像素）
- * @param [options.delayTime = 2] - 显示数据时的过渡动画时长（单位：秒）
+ * @param [options.canvasWidth = document.body.clientWidth] - Canvas的宽度尺寸（单位：像素），调大精度更高，但过大容易内存溢出
  * @param [options.id = mars3d.Util.createGuid()] - 图层id标识
  * @param [options.pid = -1] - 图层父级的id，一般图层管理中使用
  * @param [options.name = ''] - 图层名称
@@ -31225,9 +31218,7 @@ declare class HeatLayer extends BaseLayer {
             arcDirection?: number;
             diffHeight?: number;
         };
-        maxCanvasSize?: number;
-        minCanvasSize?: number;
-        delayTime?: number;
+        canvasWidth?: number;
         id?: string | number;
         pid?: string | number;
         name?: string;
@@ -31272,17 +31263,15 @@ declare class HeatLayer extends BaseLayer {
     /**
      * 添加新的坐标点（含热力值）
      * @param item - 坐标点（含热力值），示例: {lat:31.123,lng:103.568,value:1.2}
-     * @param [isGD] - 是否固定区域坐标，true时可以平滑更新
      * @returns 无
      */
-    addPosition(item: Cesium.Cartesian3 | LngLatPoint, isGD?: boolean): void;
+    addPosition(item: Cesium.Cartesian3 | LngLatPoint): void;
     /**
      * 更新所有坐标点（含热力值）数据
      * @param arr - 坐标点（含热力值），示例:[{lat:31.123,lng:103.568,value:1.2},{lat:31.233,lng:103.938,value:2.3}]
-     * @param [isGD] - 是否固定区域坐标，true时可以平滑更新
      * @returns 无
      */
-    setPositions(arr: Cesium.Cartesian3[] | LngLatPoint[], isGD?: boolean): void;
+    setPositions(arr: Cesium.Cartesian3[] | LngLatPoint[]): void;
     /**
      * 清除矢量对象
      * @returns 无
@@ -31297,6 +31286,12 @@ declare class HeatLayer extends BaseLayer {
     getRectangle(options?: {
         isFormat?: boolean;
     }): Cesium.Rectangle | any;
+    /**
+     * 按新的radius进行渲染
+     * @param radius - 每个数据点将具有的半径
+     * @returns 无
+     */
+    updateRadius(radius: number): void;
     /**
      * 根据坐标点获取其对应的value值和颜色值
      * @param item - 坐标点
@@ -31769,7 +31764,8 @@ declare class CamberRadar extends BasePointPrimitive {
      */
     color: Cesium.Color;
     /**
-     * 设置透明度
+     * 设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。
+     * 对象本身透明度请用 graphic.setStyle({ opacity: value })
      * @param value - 透明度
      * @returns 无
      */
@@ -31929,7 +31925,8 @@ declare class ConicSensor extends BasePointPrimitive {
      */
     readonly intersectEllipsoid: boolean;
     /**
-     * 设置透明度
+     * 设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。
+     * 对象本身透明度请用 graphic.setStyle({ opacity: value })
      * @param value - 透明度
      * @returns 无
      */
@@ -32299,7 +32296,8 @@ declare class RectSensor extends BasePointPrimitive {
      */
     readonly intersectEllipsoid: boolean;
     /**
-     * 设置透明度
+     * 设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。
+     * 对象本身透明度请用 graphic.setStyle({ opacity: value })
      * @param value - 透明度
      * @returns 无
      */
@@ -32475,7 +32473,7 @@ declare namespace SatelliteSensor {
      * @property [angle1 = 5] - 圆锥的角度或者四棱锥的第一个角度，半场角度，取值范围 0.1-89.9
      * @property [angle2 = 5] - 四棱锥的第二个角度，半场角度，取值范围 0.1-89.9
      * @property [angle = 5] - 夹角1和夹角2相同时，可以传入angle一个属性
-     * @property [length] - 指定的半径长度（米），默认与地球进行相交运算
+     * @property [length] - 默认按与地球相交的距离展示，传值时按传入值的半径长度显示（米）
      * @property [heading = 0] - 方向角 （角度值 0-360）
      * @property [pitch = 0] - 俯仰角（角度值 0-360）
      * @property [roll = 0] - 翻滚角（角度值 0-360）
@@ -32607,7 +32605,8 @@ declare class SatelliteSensor extends BasePointPrimitive {
      */
     readonly intersectEllipsoid: number;
     /**
-     * 设置透明度
+     * 设置整体透明度(globalAlpha值), 不是所有类型均支持，主要看数据类型和材质类型决定。
+     * 对象本身透明度请用 graphic.setStyle({ opacity: value })
      * @param value - 透明度
      * @returns 无
      */
@@ -34400,10 +34399,14 @@ declare class Sightline extends BaseThing {
      * @param target - 终点（目标点位置）
      * @param [options = {}] - 控制参数，包括：
      * @param [options.offsetHeight = 0] - 在起点增加的高度值，比如加上人的身高
+     * @param [options.objectsToExclude] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features,也可以传入图层的 graphicLayer.objectsToExclude
+     * @param [options.width = 0.1] - 分析的交叉处体的宽度，单位为米
      * @returns 分析结果
      */
     add(origin: Cesium.Cartesian3, target: Cesium.Cartesian3, options?: {
         offsetHeight?: number;
+        objectsToExclude?: any;
+        width?: number;
     }): any;
     /**
      * 添加通视分析，插值异步分析
@@ -37429,7 +37432,15 @@ declare namespace PointTrans {
      * @param [toProjParams = 'EPSG:4326'] - 转为返回的结果坐标系
      * @returns 返回结果坐标系的对应坐标数组,示例：[[115.866936, 35.062583],[115.866923, 35.062565]]
      */
-    function proj4TransArr(coords: number[], fromProjParams: string, toProjParams?: string): number[];
+    function proj4TransArr(coords: number[], fromProjParams: string | CRS, toProjParams?: string | CRS): number[];
+    /**
+     * 笛卡尔坐标 转 当前屏幕像素坐标
+     * @param scene - 场景对象，传入map.scene
+     * @param position - 笛卡尔坐标
+     * @param [result] - 用于返回转换后的当前屏幕像素坐标，可以提高效率（避免多次实例化）
+     * @returns 当前屏幕像素坐标
+     */
+    function toWindowCoordinates(scene: Cesium.Scene, position: Cesium.Cartesian3, result?: Cesium.Cartesian2): Cesium.Cartesian2;
     /**
      * Cesium笛卡尔空间坐标 转 经纬度坐标 ,等价于 LngLatPoint.toArray
      * 常用于转换geojson
@@ -37714,6 +37725,14 @@ declare namespace PointUtil {
      * @returns 计算得到的新坐标
      */
     function getOnLinePointByLen(p1: Cesium.Cartesian3, p2: Cesium.Cartesian3, len: number, addBS?: boolean): Cesium.Cartesian3;
+    /**
+     * 求 p1指向p2方向线上，距离p1指定比例的 新的点
+     * @param p1 - 起点坐标
+     * @param p2 - 终点坐标
+     * @param ratio - 指定的比例，0-1的时候在P1-P2之间，大于1在P2后面
+     * @returns 计算得到的新坐标
+     */
+    function getOnLinePointByRatio(p1: Cesium.Cartesian3, p2: Cesium.Cartesian3, ratio: number): Cesium.Cartesian3;
     /**
      * 根据 坐标位置、hpr方向、偏移距离，计算目标点坐标
      * @param position - 坐标位置