mars3d 3.4.2 → 3.4.5

package/dist/mars3d.css

@@ -1,8 +1,8 @@
 /**
  * Mars3D三维可视化平台  mars3d
  *
- * 版本信息：v3.4.2
- * 编译日期：2022-08-01 18:16:31
+ * 版本信息：v3.4.5
+ * 编译日期：2022-08-21 17:07:13
  * 版权所有：Copyright by 火星科技  http://mars3d.cn
  * 使用单位：免费公开版 ，2022-06-01
  */

package/dist/mars3d.d.ts

@@ -2,8 +2,8 @@
 /**
  * Mars3D三维可视化平台  mars3d
  *
- * 版本信息：v3.4.2
- * 编译日期：2022-08-01 18:16:31
+ * 版本信息：v3.4.5
+ * 编译日期：2022-08-21 17:07:13
  * 版权所有：Copyright by 火星科技  http://mars3d.cn
  * 使用单位：免费公开版 ，2022-06-01
  */
@@ -1971,8 +1971,8 @@ declare class MapCompare extends BaseControl {
  */
 declare class MapSplit extends BaseControl {
     constructor(options?: {
-        leftLayer?: BaseTileLayer;
-        rightLayer?: BaseTileLayer;
+        leftLayer?: BaseTileLayer | BaseTileLayer[] | any;
+        rightLayer?: BaseTileLayer | BaseTileLayer[] | any;
         id?: string | number;
         enabled?: boolean;
         parentContainer?: HTMLElement;
@@ -8978,8 +8978,9 @@ declare namespace FontBillboardEntity {
     /**
      * Font CSS字体点转图片后的图标点  Entity 支持的样式信息
      * @property [iconClass = ""] - 字体css样式
-     * @property [iconSize = 50] - 字体大小
      * @property [color = '#ff0000'] - 字体颜色
+     * @property [iconSize = 50] - 字体大小，单位：像素
+     * @property [iconPadding = 10] - 字体DIV生成时div内的padding值
      * @property [opacity = 1.0] - 透明度，取值范围：0.0-1.0
      * @property [scale = 1] - 图像大小的比例
      * @property [rotation = 0] - 旋转角度（弧度值），正北为0，逆时针旋转
@@ -9017,8 +9018,9 @@ declare namespace FontBillboardEntity {
      */
     type StyleOptions = any | {
         iconClass?: string;
-        iconSize?: number;
         color?: string;
+        iconSize?: number;
+        iconPadding?: number;
         opacity?: number;
         scale?: number;
         rotation?: number;
@@ -9491,13 +9493,13 @@ declare class ModelEntity extends BasePointEntity {
      * @param options.position - 指定目标位置的坐标
      * @param [options.time = 5] - 移动的时长(单位 秒)，控制速度
      * @param [options.onEnd] - 移动完成的回调方法
-     * @returns 无
+     * @returns 绘制创建完成的Promise,等价于onEnd参数
      */
     moveTo(options?: {
         position: LngLatPoint | Cesium.Cartesian3 | number[];
         time?: number;
         onEnd?: (...params: any[]) => any;
-    }): void;
+    }): Promise<ModelEntity | any>;
     /**
      * 飞行定位至数据所在的视角
      * @param [options = {}] - 参数对象:
@@ -10975,7 +10977,8 @@ declare class Video2D extends PolygonEntity {
 declare namespace WallEntity {
     /**
      * 墙 支持的样式信息
-     * @property [diffHeight = 100] - 墙高
+     * @property [diffHeight = 100] - 墙高，
+     * @property [fixedTop = false] - 墙顶部是否使用统一的水平高度值
      * @property [minimumHeights] - 没有指定diffHeight时，可以指定用于墙壁底部而不是球体表面的高度数组。
      * @property [maximumHeights] - 没有指定diffHeight时，可以指定用于墙顶的高度数组，而不是每个位置的高度。
      * @property [fill = true] - 是否填充
@@ -11004,6 +11007,7 @@ declare namespace WallEntity {
      */
     type StyleOptions = any | {
         diffHeight?: number;
+        fixedTop?: boolean;
         minimumHeights?: number[];
         maximumHeights?: number[];
         fill?: boolean;
@@ -11696,14 +11700,14 @@ declare class Regular extends PolygonEntity {
     readonly EditClass: EditRegular;
     /**
      * 计算当前矢量对象的边界坐标点
-     * @param positions - 坐标位置
+     * @param center - 坐标位置
      * @param options - 控制参数
      * @param [options.border = 3] - 边数量
      * @param options.radius - 区域的半径（单位：米）
      * @param [options.startAngle = 0] - 区域的开始角度(正东方向为0,顺时针到360度)
      * @returns 边界坐标点
      */
-    static getOutlinePositions(positions: Cesium.Cartesian3[], options: {
+    static getOutlinePositions(center: Cesium.Cartesian3, options: {
         border?: number;
         radius: number;
         startAngle?: number;
@@ -11772,14 +11776,14 @@ declare class Sector extends PolygonEntity {
     readonly EditClass: EditSector;
     /**
      * 计算当前矢量对象的边界坐标点
-     * @param positions - 坐标位置
+     * @param center - 中心点坐标位置
      * @param options - 控制参数
      * @param options.radius - 扇形区域的半径（单位：米）
      * @param options.startAngle - 扇形区域的开始角度(正东方向为0,顺时针到360度)
      * @param options.endAngle - 扇形区域的结束角度(正东方向为0,顺时针到360度)
      * @returns 边界坐标点
      */
-    static getOutlinePositions(positions: Cesium.Cartesian3[], options: {
+    static getOutlinePositions(center: Cesium.Cartesian3, options: {
         radius: number;
         startAngle: number;
         endAngle: number;
@@ -12887,7 +12891,7 @@ declare class BasePrimitive extends BaseGraphic {
      */
     readonly uniforms: any | undefined;
     /**
-     * 附加的label文本对象
+     * 附加的label文本对象（仅基础primitive支持，如Combine对象不支持）
      */
     readonly label: Cesium.Label | any;
     /**
@@ -12961,6 +12965,11 @@ declare class BasePrimitive extends BaseGraphic {
  * @param options.position - 坐标位置
  * @param options.style - 样式信息
  * @param [options.attr] - 附件的属性信息，可以任意附加属性，导出geojson或json时会自动处理导出。
+ * @param [options.forwardExtrapolationType = Cesium.ExtrapolationType.HOLD] - 当使用addDynamicPosition设置为动画轨迹位置时，在任何可用坐标之后一次请求值时要执行的推断类型，默认为最后一个坐标位置。
+ * @param [options.backwardExtrapolationType = Cesium.ExtrapolationType.HOLD] - 当使用addDynamicPosition设置为动画轨迹位置时， 在任何可用坐标之前一次请求值时要执行的推断类型，默认为第一个坐标位置。
+ * @param [options.clampToTileset] - 当使用addDynamicPosition设置为动画轨迹位置时，是否进行贴模型。
+ * @param [options.frameRateHeight = 30] - 当使用addDynamicPosition设置为动画轨迹位置时，并clampToTileset：true时，多少帧计算一次贴模型高度
+ * @param [options.objectsToExclude] - 当使用addDynamicPosition设置为动画轨迹位置时，并clampToTileset：true时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
  * @param [options.popup] - 绑定的popup弹窗值，也可以bindPopup方法绑定
  * @param [options.popupOptions] - popup弹窗时的配置参数，也支持如pointerEvents等{@link Popup}构造参数
  * @param [options.tooltip] - 绑定的tooltip弹窗值，也可以bindTooltip方法绑
@@ -12977,6 +12986,11 @@ declare class BillboardPrimitive extends BasePointPrimitive {
         position: LngLatPoint | Cesium.Cartesian3 | number[];
         style: BillboardEntity.StyleOptions | any;
         attr?: any;
+        forwardExtrapolationType?: Cesium.ExtrapolationType;
+        backwardExtrapolationType?: Cesium.ExtrapolationType;
+        clampToTileset?: boolean;
+        frameRateHeight?: number;
+        objectsToExclude?: any;
         popup?: string | any[] | ((...params: any[]) => any);
         popupOptions?: Popup.StyleOptions | any;
         tooltip?: string | any[] | ((...params: any[]) => any);
@@ -14374,6 +14388,11 @@ declare namespace LabelPrimitive {
  * @param options.position - 坐标位置
  * @param options.style - 样式信息
  * @param [options.attr] - 附件的属性信息，可以任意附加属性，导出geojson或json时会自动处理导出。
+ * @param [options.forwardExtrapolationType = Cesium.ExtrapolationType.HOLD] - 当使用addDynamicPosition设置为动画轨迹位置时，在任何可用坐标之后一次请求值时要执行的推断类型，默认为最后一个坐标位置。
+ * @param [options.backwardExtrapolationType = Cesium.ExtrapolationType.HOLD] - 当使用addDynamicPosition设置为动画轨迹位置时， 在任何可用坐标之前一次请求值时要执行的推断类型，默认为第一个坐标位置。
+ * @param [options.clampToTileset] - 当使用addDynamicPosition设置为动画轨迹位置时，是否进行贴模型。
+ * @param [options.frameRateHeight = 30] - 当使用addDynamicPosition设置为动画轨迹位置时，并clampToTileset：true时，多少帧计算一次贴模型高度
+ * @param [options.objectsToExclude] - 当使用addDynamicPosition设置为动画轨迹位置时，并clampToTileset：true时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
  * @param [options.popup] - 绑定的popup弹窗值，也可以bindPopup方法绑定
  * @param [options.popupOptions] - popup弹窗时的配置参数，也支持如pointerEvents等{@link Popup}构造参数
  * @param [options.tooltip] - 绑定的tooltip弹窗值，也可以bindTooltip方法绑
@@ -14390,6 +14409,11 @@ declare class LabelPrimitive extends BasePointPrimitive {
         position: LngLatPoint | Cesium.Cartesian3 | number[];
         style: LabelPrimitive.StyleOptions | any;
         attr?: any;
+        forwardExtrapolationType?: Cesium.ExtrapolationType;
+        backwardExtrapolationType?: Cesium.ExtrapolationType;
+        clampToTileset?: boolean;
+        frameRateHeight?: number;
+        objectsToExclude?: any;
         popup?: string | any[] | ((...params: any[]) => any);
         popupOptions?: Popup.StyleOptions | any;
         tooltip?: string | any[] | ((...params: any[]) => any);
@@ -14955,6 +14979,11 @@ declare namespace PointPrimitive {
  * @param options.style - 样式信息
  * @param [options.attr] - 附件的属性信息，可以任意附加属性，导出geojson或json时会自动处理导出。
  * @param [options.frameRate = 1] - 当postion为CallbackProperty时，多少帧获取一次数据。用于控制效率，如果卡顿就把该数值调大一些。
+ * @param [options.forwardExtrapolationType = Cesium.ExtrapolationType.HOLD] - 当使用addDynamicPosition设置为动画轨迹位置时，在任何可用坐标之后一次请求值时要执行的推断类型，默认为最后一个坐标位置。
+ * @param [options.backwardExtrapolationType = Cesium.ExtrapolationType.HOLD] - 当使用addDynamicPosition设置为动画轨迹位置时， 在任何可用坐标之前一次请求值时要执行的推断类型，默认为第一个坐标位置。
+ * @param [options.clampToTileset] - 当使用addDynamicPosition设置为动画轨迹位置时，是否进行贴模型。
+ * @param [options.frameRateHeight = 30] - 当使用addDynamicPosition设置为动画轨迹位置时，并clampToTileset：true时，多少帧计算一次贴模型高度
+ * @param [options.objectsToExclude] - 当使用addDynamicPosition设置为动画轨迹位置时，并clampToTileset：true时，排除的不进行贴模型计算的模型对象，可以是： primitives, entities, 或 3D Tiles features
  * @param [options.popup] - 绑定的popup弹窗值，也可以bindPopup方法绑定
  * @param [options.popupOptions] - popup弹窗时的配置参数，也支持如pointerEvents等{@link Popup}构造参数
  * @param [options.tooltip] - 绑定的tooltip弹窗值，也可以bindTooltip方法绑
@@ -14972,6 +15001,11 @@ declare class PointPrimitive extends BasePointPrimitive {
         style: PointPrimitive.StyleOptions | any;
         attr?: any;
         frameRate?: number;
+        forwardExtrapolationType?: Cesium.ExtrapolationType;
+        backwardExtrapolationType?: Cesium.ExtrapolationType;
+        clampToTileset?: boolean;
+        frameRateHeight?: number;
+        objectsToExclude?: any;
         popup?: string | any[] | ((...params: any[]) => any);
         popupOptions?: Popup.StyleOptions | any;
         tooltip?: string | any[] | ((...params: any[]) => any);
@@ -17167,7 +17201,7 @@ declare class ArcGisWfsSingleLayer extends GeoJsonLayer {
  * @param [options.lngColumn = "lng"] - 点坐标时，经度值对应的字段名称
  * @param [options.latColumn = "lat"] - 点坐标时，纬度值对应的字段名称
  * @param [options.altColumn = "alt"] - 点坐标时，高度值对应的字段名称
- * @param [options.formatPosition] - 可以对加载的数据进行格式化或转换操作
+ * @param [options.formatPosition] - 可以对加载的坐标进行格式化或转换操作
  * @param [options.onCreateGraphic] - 解析geojson后，外部自定义方法来创建Graphic对象
  * @param [options.allowDrillPick] - 是否允许鼠标穿透拾取
  * @param [options.opacity = 1.0] - 透明度（部分图层），取值范围：0.0-1.0
@@ -32417,6 +32451,13 @@ declare namespace PointUtil {
     }): number;
     /**
      * 异步精确计算坐标的 贴地(或贴模型)高度
+     * @example
+     * const position = graphic.position
+     *   mars3d.PointUtil.getSurfaceHeight(map.scene, graphic.position, { has3dtiles: true }).then((result) => {
+     *     console.log("原始高度为：" + result.height_original.toFixed(2) + ",贴地高度：" + result.height.toFixed(2))
+     *
+     *     graphic.position = result.position
+     *   })
      * @param scene - 三维地图场景对象，一般用map.scene或viewer.scene
      * @param position - 坐标
      * @param [options = {}] - 参数对象: