mars3d 3.4.16 → 3.4.18

package/dist/mars3d.css

@@ -1,8 +1,8 @@
 /**
  * Mars3D三维可视化平台  mars3d
  *
- * 版本信息：v3.4.16
- * 编译日期：2022-12-05 21:53:28
+ * 版本信息：v3.4.18
+ * 编译日期：2022-12-19 13:25:56
  * 版权所有：Copyright by 火星科技  http://mars3d.cn
  * 使用单位：免费公开版 ，2022-06-01
  */

package/dist/mars3d.d.ts

@@ -2,8 +2,8 @@
 /**
  * Mars3D三维可视化平台  mars3d
  *
- * 版本信息：v3.4.16
- * 编译日期：2022-12-05 21:53:27
+ * 版本信息：v3.4.18
+ * 编译日期：2022-12-19 13:25:56
  * 版权所有：Copyright by 火星科技  http://mars3d.cn
  * 使用单位：免费公开版 ，2022-06-01
  */
@@ -183,6 +183,10 @@ declare enum EventType {
      * 从地图上移除控件
      */
     removeControl = "removeControl",
+    /**
+     * 更新了控件（比如show变化）
+     */
+    updateControl = "updateControl",
     /**
      * 地图上添加Effect特效
      */
@@ -909,7 +913,7 @@ declare enum Lang {
     "_纬度" = "[\"\u7EAC\u5EA6\",\"\u7DEF\u5EA6\",\"Lat\"]",
     "_海拔" = "[\"\u9AD8\u7A0B\",\"\u9AD8\u7A0B\",\"Alt\"]",
     "_横坐标" = "[\"\u6A2A\u5750\u6807\",\"\u6A6B\u5750\u6A19\",\"X\"]",
-    "_纵坐标" = "[\"\u7EB5\u5750\u6807\uFF1A\",\"\u7E31\u5750\u6A19\",\"Y\"]",
+    "_纵坐标" = "[\"\u7EB5\u5750\u6807\",\"\u7E31\u5750\u6A19\",\"Y\"]",
     "_查看当前视角" = "[\"\u67E5\u770B\u5F53\u524D\u89C6\u89D2\",\"\u67E5\u770B\u7576\u524D\u8996\u89D2\",\"Camera info\"]",
     "_当前视角信息" = "[\"\u5F53\u524D\u89C6\u89D2\u4FE1\u606F\",\"\u7576\u524D\u8996\u89D2\u4FE1\u606F\",\"Current Camera Information\"]",
     "_视角切换" = "[\"\u89C6\u89D2\u5207\u6362\",\"\u8996\u89D2\u5207\u63DB\",\"Camera\"]",
@@ -1003,6 +1007,14 @@ declare enum Lang {
     "_单击后激活编辑" = "[\"\u5355\u51FB\u540E\u6FC0\u6D3B\u7F16\u8F91\",\"\u55AE\u64CA\u5F8C \u6FC0\u6D3B\u7DE8\u8F2F\",\"Click to activate editing\"]",
     "_右击菜单删除" = "[\"\u53F3\u51FB\u83DC\u5355\u5220\u9664\",\"\u53F3\u64CA\u83DC\u55AE\u522A\u9664\",\"Right click menu to delete\"]",
     "_更多功能请右击" = "[\"\u66F4\u591A\u529F\u80FD\u8BF7\u53F3\u51FB\",\"\u66F4\u591A\u529F\u80FD\u8ACB\u53F3\u64CA\",\"For more functions, right click\"]",
+    "_停止编辑" = "[\"\u505C\u6B62\u7F16\u8F91\",\"\u505C\u6B62\u7DE8\u8F2F\",\"Stop editing\"]",
+    "_删除该点" = "[\"\u5220\u9664\u8BE5\u70B9\",\"\u522A\u9664\u8A72\u9EDE\",\"Delete that point\"]",
+    "_按轴平移" = "[\"\u6309\u8F74\u5E73\u79FB\",\"\u6309\u8EF8\u5E73\u79FB\",\"Translation by axis\"]",
+    "_停止按轴平移" = "[\"\u505C\u6B62\u6309\u8F74\u5E73\u79FB\",\"\u505C\u6B62\u6309\u8EF8\u5E73\u79FB\",\"Stop translation along axis\"]",
+    "_按轴旋转" = "[\"\u6309\u8F74\u65CB\u8F6C\",\"\u6309\u8EF8\u65CB\u8F49\",\"Rotation on axis\"]",
+    "_停止按轴旋转" = "[\"\u505C\u6B62\u6309\u8F74\u65CB\u8F6C\",\"\u505C\u6B62\u6309\u8EF8\u65CB\u8F49\",\"Stop rotation on axis\"]",
+    "_调整比例" = "[\"\u8C03\u6574\u6BD4\u4F8B\",\"\u8ABF\u6574\u6BD4\u4F8B\",\"Edit Scale\"]",
+    "_停止调整比例" = "[\"\u505C\u6B62\u8C03\u6574\u6BD4\u4F8B\",\"\u505C\u6B62\u8ABF\u6574\u6BD4\u4F8B\",\"Stop edit scale\"]",
     "_释放后完成修改" = "[\"\u91CA\u653E\u540E\u5B8C\u6210\u4FEE\u6539\",\"\u91CB\u653E\u5F8C\u5B8C\u6210\u4FEE\u6539\",\"Complete the modification after release\"]",
     "_该对象不允许编辑" = "[\"\u8BE5\u5BF9\u8C61\u4E0D\u5141\u8BB8\u7F16\u8F91\",\"\u8A72\u5C0D\u8C61\u4E0D\u5141\u8A31\u7DE8\u8F2F\",\"This object does not allow editing\"]",
     "_拖动该点后" = "[\"\u62D6\u52A8\u8BE5\u70B9\u540E\",\"\u62D6\u52D5\u8A72\u9EDE\u5F8C\",\"Drag that point\"]",
@@ -3752,6 +3764,11 @@ declare class BaseGraphic extends BaseClass {
      * @returns 当前对象本身，可以链式调用
      */
     closePopup(): BaseGraphic | any;
+    /**
+     * 获取当前对象打开的Popup对象
+     * @returns 当前对象打开的Popup对象
+     */
+    getPopup(): Popup;
     /**
      * 是否绑定了tooltip
      * @param [hasLayer = true] - 是否判断图层上的tooltip
@@ -3783,6 +3800,11 @@ declare class BaseGraphic extends BaseClass {
      * @returns 当前对象本身，可以链式调用
      */
     closeTooltip(): BaseGraphic | any;
+    /**
+     * 获取当前对象打开的Tooltip对象
+     * @returns 当前对象打开的Tooltip对象
+     */
+    getTooltip(): Tooltip;
     /**
      * 是否有绑定的右键菜单
      * @param [hasLayer = true] - 是否判断图层上的右键菜单
@@ -5228,6 +5250,9 @@ declare class ArcFrustum extends BasePointPrimitive {
  * @param [options.backwardExtrapolationType = Cesium.ExtrapolationType.HOLD] - 在任何可用坐标之前一次请求值时要执行的推断类型，默认为第一个坐标位置。
  * @param [options.fixedFrameTransform = Cesium.Transforms.eastNorthUpToFixedFrame] - 参考系
  * @param [options.orientation] - 自定义实体方向, 默认内部根据轨迹自动的
+ * @param [options.clampToTileset] - 是否进行贴模型。
+ * @param [options.frameRateHeight = 30] - clampToTileset：true时，多少帧计算一次贴模型高度
+ * @param [options.objectsToExclude] - clampToTileset：true时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
  * @param [options.camera] - 视角模式设置，包括：
  * @param [options.camera.type] - 视角模式类型，包括：'':无、'gs':跟随视角、'dy':第一视角、'sd':上帝视角
  * @param [options.camera.radius] - 'gs'跟随视角时的 初始俯仰距离值（单位：米）
@@ -5279,6 +5304,9 @@ declare class FixedRoute extends Route {
         backwardExtrapolationType?: Cesium.ExtrapolationType;
         fixedFrameTransform?: Cesium.Transforms.LocalFrameToFixedFrame;
         orientation?: Cesium.Property | any;
+        clampToTileset?: boolean;
+        frameRateHeight?: number;
+        objectsToExclude?: any;
         camera?: {
             type?: string;
             radius?: number;
@@ -5566,6 +5594,7 @@ declare namespace Route {
  * 使用 {@link Route#addDynamicPosition} 方法来添加动画轨迹点位置。
  * 如果只是显示单个模型等对象，建议直接使用对应的矢量对象，效率更高。
  * @param options - 参数对象，包括以下：
+ * @param [options.position] - 自定义外部构造好的传入动态坐标位置（含时序的点集合）
  * @param [options.attr] - 矢量数据的 属性信息，可以任意附加属性。
  * @param [options.label] - 使用 文本 对象，及其对应的样式
  * @param [options.billboard] - 使用 图标 对象，及其对应的样式
@@ -5585,6 +5614,9 @@ declare namespace Route {
  * @param [options.backwardExtrapolationType = Cesium.ExtrapolationType.HOLD] - 在任何可用坐标之前一次请求值时要执行的推断类型，默认为第一个坐标位置。
  * @param [options.fixedFrameTransform = Cesium.Transforms.eastNorthUpToFixedFrame] - 参考系
  * @param [options.orientation] - 自定义实体方向, 默认内部根据轨迹自动的
+ * @param [options.clampToTileset] - 是否进行贴模型。
+ * @param [options.frameRateHeight = 30] - clampToTileset：true时，多少帧计算一次贴模型高度
+ * @param [options.objectsToExclude] - clampToTileset：true时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
  * @param [options.camera] - 视角模式设置，包括：
  * @param [options.camera.type] - 视角模式类型，包括：'':无、'gs':跟随视角、'dy':第一视角、'sd':上帝视角
  * @param [options.camera.radius] - 'gs'跟随视角时的 初始俯仰距离值（单位：米）
@@ -5608,6 +5640,7 @@ declare namespace Route {
  */
 declare class Route extends BasePointPrimitive {
     constructor(options: {
+        position?: Cesium.SampledPositionProperty;
         attr?: any;
         label?: LabelPrimitive.StyleOptions | any;
         billboard?: BillboardEntity.StyleOptions | any;
@@ -5624,6 +5657,9 @@ declare class Route extends BasePointPrimitive {
         backwardExtrapolationType?: Cesium.ExtrapolationType;
         fixedFrameTransform?: Cesium.Transforms.LocalFrameToFixedFrame;
         orientation?: Cesium.Property | any;
+        clampToTileset?: boolean;
+        frameRateHeight?: number;
+        objectsToExclude?: any;
         camera?: {
             type?: string;
             radius?: number;
@@ -5704,9 +5740,13 @@ declare class Route extends BasePointPrimitive {
      */
     multiplier: number;
     /**
-     * 是否暂停状态
+     * 是否暂停状态 【针对全局时钟的，即 map.clock.shouldAnimate】
      */
     isPause: boolean;
+    /**
+     * 贴模型分析时，排除的不进行贴模型计算的模型对象，默认是当前本身，可以是： primitives, entities 等
+     */
+    objectsToExclude: any | undefined;
     /**
      * 遍历所有矢量数据并将其作为参数传递给回调函数
      * @param method - 回调方法
@@ -5796,12 +5836,12 @@ declare class Route extends BasePointPrimitive {
         followedZ?: number;
     }): void;
     /**
-     * 暂停
+     * 暂停 【针对全局时钟的，即 map.clock.shouldAnimate】
      * @returns 无
      */
     pause(): void;
     /**
-     * 继续
+     * 继续 【针对全局时钟的，即 map.clock.shouldAnimate】
      * @returns 无
      */
     proceed(): void;
@@ -5809,6 +5849,17 @@ declare class Route extends BasePointPrimitive {
      * 动态位置坐标
      */
     property: Cesium.SampledPositionProperty | Cesium.CallbackProperty;
+    /**
+     * 异步计算更新坐标高度进行贴地(或贴模型)，内部自动调用{@link PointUtil#getSurfaceHeight}方法处理。
+     * @param [options = {}] - 参数对象:
+     * @param [options.has3dtiles = auto] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
+     * @param [options.objectsToExclude] - 贴模型分析时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
+     * @returns 异步计算完成的Promise
+     */
+    autoSurfaceHeight(options?: {
+        has3dtiles?: boolean;
+        objectsToExclude?: any;
+    }): Promise<any>;
 }
 
 declare namespace Tetrahedron {
@@ -6096,6 +6147,7 @@ declare namespace DivBoderLabel {
      * @property [timeRender] - 是否实时刷新全部HTML，此时需要绑定html需传入回调方法。
      * @property [setHeight] - 指定坐标高度值（常用于图层中配置）,也支持字符串模版配置
      * @property [addHeight] - 在现有坐标基础上增加的高度值（常用于图层中配置）,也支持字符串模版配置
+     * @property [templateEmptyStr = ""] - 当text存在模版字符串配置时，空值时显示的内容
      */
     type StyleOptions = any | {
         text: string;
@@ -6123,6 +6175,7 @@ declare namespace DivBoderLabel {
         timeRender?: boolean;
         setHeight?: number | string;
         addHeight?: number | string;
+        templateEmptyStr?: string;
     };
 }
 
@@ -6447,6 +6500,7 @@ declare namespace DivLightPoint {
      * @property [label] - 文本
      * @property [label.text] - 文本内容
      * @property [label.color] - 文本颜色
+     * @property [label.templateEmptyStr = ""] - 当text存在模版字符串配置时，空值时显示的内容
      * @property [offsetX] - 用于非规则div时，横向偏移的px像素值
      * @property [offsetY] - 用于非规则div时，垂直方向偏移的px像素值
      * @property [scaleByDistance = false] - 是否按视距缩放
@@ -6470,6 +6524,7 @@ declare namespace DivLightPoint {
         label?: {
             text?: string;
             color?: string;
+            templateEmptyStr?: string;
         };
         offsetX?: number;
         offsetY?: number;
@@ -9274,6 +9329,7 @@ declare namespace LabelEntity {
      * @property [translucencyByDistance] - 用于基于与相机的距离设置半透明度。
      * @property [setHeight] - 指定坐标高度值（常用于图层中配置）,也支持字符串模版配置
      * @property [addHeight] - 在现有坐标基础上增加的高度值（常用于图层中配置）,也支持字符串模版配置
+     * @property [templateEmptyStr = ""] - 当text存在模版字符串配置时，空值时显示的内容
      */
     type StyleOptions = any | {
         text?: string;
@@ -9317,6 +9373,7 @@ declare namespace LabelEntity {
         translucencyByDistance?: Cesium.NearFarScalar;
         setHeight?: number | string;
         addHeight?: number | string;
+        templateEmptyStr?: string;
     };
 }
 
@@ -12763,6 +12820,10 @@ declare class BasePointPrimitive extends BasePrimitive {
      * 坐标对应的高度值（单位：米）
      */
     height: number;
+    /**
+     * 三维空间中的旋转 【仅部分对象支持】
+     */
+    readonly orientation: Cesium.Quaternion;
     /**
      * 将图元(所有几何实例)从模型转换为世界坐标的4x4变换矩阵。
      * <br/>提示：父类属性，非所有子类都具备
@@ -23460,7 +23521,7 @@ declare namespace Map {
      * @property [fullscreenButton = false] - 全屏按钮，是否显示
      * @property [fullscreenElement = document.body] - 当按下全屏按钮时，要置于全屏模式的元素或id
      * @property [vrButton = false] - VR效果按钮，是否显示
-     * @property [geocoder = false] - 是否显示 地名查找控件按钮，是Cesium原生控件
+     * @property [geocoder = false] - 是否显示 地名查找按钮 控件，是Cesium原生控件
      * @property [navigationHelpButton = false] - 帮助按钮，是否显示
      * @property [navigationInstructionsInitiallyVisible = true] - 帮助按钮 在用户明确单击按钮之前是否自动显示
      * @property [baseLayerPicker = false] - 是否显示 底图切换 按钮，是Cesium原生控件, 如果true底图是Cesium机制控制，Map内的basemaps相关获取和控制将会无效。
@@ -23659,6 +23720,7 @@ declare namespace Map {
      * map.on(mars3d.EventType.click, function (event) {
      *   console.log('单击了地图对象', event)
      * })
+     * @property load - 地图初始化完成事件(地形、所有图层完成初始化)
      * @property addLayer - 添加图层
      * @property removeLayer - 移除图层
      * @property terrainChange - 地形变化
@@ -23708,6 +23770,7 @@ declare namespace Map {
      * @property contextMenuClick - 右键菜单 单击某一项后
      */
     type EventType = {
+        load: string;
         addLayer: string;
         removeLayer: string;
         terrainChange: string;
@@ -24127,7 +24190,7 @@ declare class Map extends BaseClass {
     /**
      * 根据指定属性获取控件
      * @param attrValue - 属性值
-     * @param [attrName = 'id'] - 属性键
+     * @param [attrName = 'type'] - 属性键
      * @returns 控件对象
      */
     getControl(attrValue: string | number | boolean, attrName?: string): BaseControl;
@@ -24147,7 +24210,7 @@ declare class Map extends BaseClass {
     /**
      * 根据指定属性获取Thing对象
      * @param key - 属性值（如id、name值）
-     * @param [attrName = 'id'] - 属性名称
+     * @param [attrName = 'type'] - 属性名称
      * @returns Thing对象
      */
     getEffect(key: string | any, attrName?: string): BaseEffect;
@@ -26391,13 +26454,14 @@ declare class EchartsLayer extends BaseLayer {
  * @param [options.heatStyle.radius = 25] - 每个数据点将具有的半径（如果未在数据点本身上指定）
  * @param [options.heatStyle.gradient] - 色带，表示渐变的对象，示例：{ 0.4: 'blue', 0.6: 'green',0.8: 'yellow',0.9: 'red' }
  * @param [options.style] - 矢量对象样式参数，还包括：
+ * @param [options.style.type] - 渲染类型，支持："image"：ImageLayer图片展示, "graphic"：普通RectanglePrimitive矢量矩形展示, "arc"：曲面RectanglePrimitive矢量矩形展示
  * @param [options.style.opacity = 1] - 透明度
- * @param [options.style.arc = false] - 是否显示曲面热力图
+ * @param [options.style.height = 0] - 高度，相对于椭球面的高度。
+ * @param [options.style.arc = false] - 是否显示曲面热力图，同 type:"arc"
  * @param [options.style.arcRadiusScale = 1.5] - 曲面热力图时，radius扩大比例
  * @param [options.style.arcBlurScale = 1.5] - 曲面热力图时，blur扩大比例
  * @param [options.style.arcDirection = 1] - 曲面热力图时，凹陷的方向，1向上，-1向下，0双面
- * @param [options.style.height = 0] - 高度，相对于椭球面的高度。
- * @param [options.style.diffHeight] - 曲面的起伏差值高，默认根据数据范围的比例自动计算。
+ * @param [options.style.diffHeight] - 曲面热力图时，曲面的起伏差值高，默认根据数据范围的比例自动计算。
  * @param [options.style.多个参数] - rectangle矩形支持的样式
  * @param [options.maxCanvasSize = 5000] - Canvas最大尺寸（单位：像素），调大精度更高，但过大容易内存溢出
  * @param [options.minCanvasSize = 700] - Canvas最小尺寸（单位：像素）
@@ -26435,12 +26499,13 @@ declare class HeatLayer extends BaseLayer {
             gradient?: any;
         };
         style?: {
+            type?: string;
             opacity?: number;
+            height?: number;
             arc?: boolean;
             arcRadiusScale?: number;
             arcBlurScale?: number;
             arcDirection?: number;
-            height?: number;
             diffHeight?: number;
             多个参数?: RectanglePrimitive.StyleOptions | any;
         };
@@ -29983,6 +30048,7 @@ declare class Measure extends BaseThing {
      * @param [options.splitNum = 10] - 插值数，将面分割的网格数
      * @param [options.has3dtiles = auto] - 是否在3dtiles模型上分析（模型分析较慢，按需开启）,默认内部根据点的位置自动判断（但可能不准）
      * @param [options.decimal = 2] - 显示的文本中保留的小数位
+     * @param [options.exact = true] - 是否进行精确计算， 传false时是否快速概略计算方式，该方式计算精度较低，但计算速度快，仅能计算在当前视域内坐标的高度
      * @returns 绘制创建完成的Promise，返回 面积测量控制类 对象
      */
     areaSurface(options?: {
@@ -29991,6 +30057,7 @@ declare class Measure extends BaseThing {
         splitNum?: number;
         has3dtiles?: boolean;
         decimal?: number;
+        exact?: boolean;
     }): Promise<AreaSurfaceMeasure | any>;
     /**
      * 体积测量（方量分析）
@@ -30156,7 +30223,7 @@ declare class Shadows extends BaseThing {
      */
     time: Date;
     /**
-     * 是否在播放
+     * 是否在播放 【针对全局时钟的，即 map.clock.shouldAnimate】
      */
     readonly isStart: boolean;
     /**
@@ -30172,17 +30239,17 @@ declare class Shadows extends BaseThing {
      */
     start(startDate: Date, endDate: Date, currentTime?: Date): void;
     /**
-     * 暂停
+     * 暂停 【针对全局时钟的，即 map.clock.shouldAnimate】
      * @returns 无
      */
     pause(): void;
     /**
-     * 继续
+     * 继续 【针对全局时钟的，即 map.clock.shouldAnimate】
      * @returns 无
      */
     proceed(): void;
     /**
-     * 停止
+     * 停止 【针对全局时钟的，即 map.clock.shouldAnimate】
      * @returns 无
      */
     stop(): void;