mars3d 3.6.7 → 3.6.8

package/dist/mars3d.css

@@ -1,8 +1,8 @@
 /**
  * Mars3D三维可视化平台  mars3d
  *
- * 版本信息：v3.6.7
- * 编译日期：2023-09-26 10:49:46
+ * 版本信息：v3.6.8
+ * 编译日期：2023-10-09 22:20:19
  * 版权所有：Copyright by 火星科技  http://mars3d.cn
  * 使用单位：免费公开版 ，2023-03-17
  */

package/dist/mars3d.d.ts

@@ -2,8 +2,8 @@
 /**
  * Mars3D三维可视化平台  mars3d
  *
- * 版本信息：v3.6.7
- * 编译日期：2023-09-26 10:49:46
+ * 版本信息：v3.6.8
+ * 编译日期：2023-10-09 22:20:19
  * 版权所有：Copyright by 火星科技  http://mars3d.cn
  * 使用单位：免费公开版 ，2023-03-17
  */
@@ -8366,6 +8366,38 @@ declare class BasePointEntity extends BaseEntity {
      * 显示隐藏状态
      */
     show: boolean;
+    /**
+     * 指定时间范围内显示该对象 [提示：仅部分子类实现，非所有对象都支持]
+     * @example
+     * // cesium原生写法,单个
+     * graphic.availability = new Cesium.TimeInterval({
+     *   start: Cesium.JulianDate.fromDate(new Date("2017-08-25 08:00:00")),
+     *   stop: Cesium.JulianDate.fromDate(new Date("2017-08-25 08:00:20")),
+     *   isStartIncluded: true,
+     *   isStopIncluded: false
+     * })
+     *
+     * // cesium原生写法, 多个
+     * graphic.availability = new Cesium.TimeIntervalCollection([
+     *   new Cesium.TimeInterval({
+     *     start: Cesium.JulianDate.fromDate(new Date("2017-08-25 08:00:00")),
+     *     stop: Cesium.JulianDate.fromDate(new Date("2017-08-25 08:00:20")),
+     *     isStartIncluded: true,
+     *     isStopIncluded: false
+     *   }),
+     *
+     * ])
+     *
+     * // 普通传值方式，多个
+     * graphic.availability = [
+     *   { start: "2017-08-25 08:00:00", stop: "2017-08-25 08:01:20", isStartIncluded: true, isStopIncluded: false },
+     *   { start: "2017-08-25 09:00:00", stop: "2017-08-25 09:02:30" }
+     * ]
+     *
+     * // 普通传值方式，单个
+     * graphic.availability = { start: "2017-08-25 08:00:00", stop: "2017-08-25 08:01:20", isStartIncluded: true, isStopIncluded: false }
+     */
+    availability: Cesium.TimeIntervalCollection;
 }
 
 /**
@@ -8712,38 +8744,6 @@ declare class BillboardEntity extends BasePointEntity {
      * @returns 无
      */
     stopBounce(): void;
-    /**
-     * 指定时间范围内显示该对象 [提示：仅部分子类实现，非所有对象都支持]
-     * @example
-     * // cesium原生写法,单个
-     * graphic.availability = new Cesium.TimeInterval({
-     *   start: Cesium.JulianDate.fromDate(new Date("2017-08-25 08:00:00")),
-     *   stop: Cesium.JulianDate.fromDate(new Date("2017-08-25 08:00:20")),
-     *   isStartIncluded: true,
-     *   isStopIncluded: false
-     * })
-     *
-     * // cesium原生写法, 多个
-     * graphic.availability = new Cesium.TimeIntervalCollection([
-     *   new Cesium.TimeInterval({
-     *     start: Cesium.JulianDate.fromDate(new Date("2017-08-25 08:00:00")),
-     *     stop: Cesium.JulianDate.fromDate(new Date("2017-08-25 08:00:20")),
-     *     isStartIncluded: true,
-     *     isStopIncluded: false
-     *   }),
-     *
-     * ])
-     *
-     * // 普通传值方式，多个
-     * graphic.availability = [
-     *   { start: "2017-08-25 08:00:00", stop: "2017-08-25 08:01:20", isStartIncluded: true, isStopIncluded: false },
-     *   { start: "2017-08-25 09:00:00", stop: "2017-08-25 09:02:30" }
-     * ]
-     *
-     * // 普通传值方式，单个
-     * graphic.availability = { start: "2017-08-25 08:00:00", stop: "2017-08-25 08:01:20", isStartIncluded: true, isStopIncluded: false }
-     */
-    availability: Cesium.TimeIntervalCollection;
 }
 
 declare namespace BoxEntity {
@@ -11676,38 +11676,6 @@ declare class PointEntity extends BasePointEntity {
      * 矢量数据对应的 Cesium内部对象的具体类型对象
      */
     readonly entityGraphic: Cesium.PointGraphics;
-    /**
-     * 指定时间范围内显示该对象 [提示：仅部分子类实现，非所有对象都支持]
-     * @example
-     * // cesium原生写法,单个
-     * graphic.availability = new Cesium.TimeInterval({
-     *   start: Cesium.JulianDate.fromDate(new Date("2017-08-25 08:00:00")),
-     *   stop: Cesium.JulianDate.fromDate(new Date("2017-08-25 08:00:20")),
-     *   isStartIncluded: true,
-     *   isStopIncluded: false
-     * })
-     *
-     * // cesium原生写法, 多个
-     * graphic.availability = new Cesium.TimeIntervalCollection([
-     *   new Cesium.TimeInterval({
-     *     start: Cesium.JulianDate.fromDate(new Date("2017-08-25 08:00:00")),
-     *     stop: Cesium.JulianDate.fromDate(new Date("2017-08-25 08:00:20")),
-     *     isStartIncluded: true,
-     *     isStopIncluded: false
-     *   }),
-     *
-     * ])
-     *
-     * // 普通传值方式，多个
-     * graphic.availability = [
-     *   { start: "2017-08-25 08:00:00", stop: "2017-08-25 08:01:20", isStartIncluded: true, isStopIncluded: false },
-     *   { start: "2017-08-25 09:00:00", stop: "2017-08-25 09:02:30" }
-     * ]
-     *
-     * // 普通传值方式，单个
-     * graphic.availability = { start: "2017-08-25 08:00:00", stop: "2017-08-25 08:01:20", isStartIncluded: true, isStopIncluded: false }
-     */
-    availability: Cesium.TimeIntervalCollection;
 }
 
 declare namespace PolygonEntity {
@@ -11818,6 +11786,7 @@ declare namespace PolygonEntity {
  * @param [options.hasEditContextMenu = true] - 编辑时，是否绑定右键编辑菜单
  * @param [options.hasMoveEdit = true] - 编辑时，是否可以整体平移
  * @param [options.hasHeightEdit = true] - 编辑时，当有diffHeight时，是否可以编辑高度
+ * @param [options.midPointFraction = 0.5] - 编辑时，中间点的位置比例
  * @param [options.popup] - 绑定的popup弹窗值，也可以bindPopup方法绑定
  * @param [options.popupOptions] - popup弹窗时的配置参数，也支持如pointerEvents等{@link Popup}构造参数
  * @param [options.tooltip] - 绑定的tooltip弹窗值，也可以bindTooltip方法绑
@@ -11849,6 +11818,7 @@ declare class PolygonEntity extends BasePolyEntity {
         hasEditContextMenu?: boolean;
         hasMoveEdit?: boolean;
         hasHeightEdit?: boolean;
+        midPointFraction?: number;
         popup?: string | any[] | ((...params: any[]) => any);
         popupOptions?: Popup.StyleOptions | any;
         tooltip?: string | any[] | ((...params: any[]) => any);
@@ -12015,6 +11985,7 @@ declare namespace PolylineEntity {
  * @param [options.hasEditContextMenu = true] - 编辑时，是否绑定右键编辑菜单
  * @param [options.hasMoveEdit = true] - 编辑时，是否可以整体平移
  * @param [options.hasHeightEdit = true] - 编辑时，当有diffHeight时，是否可以编辑高度
+ * @param [options.midPointFraction = 0.5] - 编辑时，中间点的位置比例
  * @param [options.popup] - 绑定的popup弹窗值，也可以bindPopup方法绑定
  * @param [options.popupOptions] - popup弹窗时的配置参数，也支持如pointerEvents等{@link Popup}构造参数
  * @param [options.tooltip] - 绑定的tooltip弹窗值，也可以bindTooltip方法绑
@@ -12046,6 +12017,7 @@ declare class PolylineEntity extends BasePolyEntity {
         hasEditContextMenu?: boolean;
         hasMoveEdit?: boolean;
         hasHeightEdit?: boolean;
+        midPointFraction?: number;
         popup?: string | any[] | ((...params: any[]) => any);
         popupOptions?: Popup.StyleOptions | any;
         tooltip?: string | any[] | ((...params: any[]) => any);
@@ -20799,7 +20771,7 @@ declare namespace GraphicLayer {
  * @param [options.data] - 需要自动加载的数据，内部自动生成Graphic对象。{@link GraphicUtil#.create}
  * @param [options.hasEdit = false] - 是否自动激活编辑（true时，单击后自动激活编辑）
  * @param [options.isAutoEditing = true] - 完成标绘时是否自动启动编辑(需要hasEdit:true时)
- * @param [options.isContinued = false] - 是否连续标绘,联系标绘状态下无法编辑已有对象。
+ * @param [options.isContinued = false] - 是否连续标绘,连续标绘状态下无法编辑已有对象。
  * @param [options.isRestorePositions = false] - 在标绘和编辑结束时，是否将坐标还原为普通值，true: 停止编辑时会有闪烁，但效率要好些。
  * @param [options.drawEndEventType = EventType.dblClick] - 绘制时结束的事件，默认双击
  * @param [options.drawDelEventType = EventType.rightClick] - 绘制时删除点的事件，默认右键
@@ -21105,9 +21077,10 @@ declare class GraphicLayer extends BaseGraphicLayer {
      * 遍历所有矢量数据并将其作为参数传递给回调函数
      * @param method - 回调方法
      * @param [context] - 侦听器的上下文(this关键字将指向的对象)。
-     * @returns 当前对象本身,可以链式调用
+     * @param [reverse] - 是否倒序执行
+     * @returns 当前对象本身,可以链式调用。
      */
-    eachGraphic(method: (...params: any[]) => any, context?: any): GraphicLayer;
+    eachGraphic(method: (...params: any[]) => any, context?: any, reverse?: boolean): GraphicLayer;
     /**
      * 获取图层内 所有矢量数据
      * @param [hasPrivate = false] - 是否取私有的graphic
@@ -21353,7 +21326,6 @@ declare namespace I3SLayer {
  * @param [options.cacheBytes = 536870912] - 如果缓存包含当前视图不需要的块，则块缓存将被修剪到的大小(以字节为单位)。
  * @param [options.maximumCacheOverflowBytes = 536870912] - 如果当前视图需要超过{@link Cesium3DTileset#cacheBytes}，则允许缓存净空的最大额外内存(以字节为单位)。
  * @param [options.maximumMemoryUsage = 512] - 【cesium 1.107+弃用】数据集可以使用的最大内存量(以MB计)，这个参数要根据当前客户端显卡显存来配置，如果我们场景只显示这一个模型数据，这个可以设置到显存的50% 左右，比如我的显存是4G，这个可以设置到2048左右。那么既保证不超过显存限制，又可以最大利用显存缓存。<br />
- * *
  * @param [options.style] - 模型样式， 使用{@link https://github.com/CesiumGS/3d-tiles/tree/master/specification/Styling|3D Tiles Styling language}.
  * @param [options.marsJzwStyle = false] - 开启或设置建筑物特效样式。
  * @param [options.customShader] - 自定义shader效果
@@ -26599,6 +26571,10 @@ declare namespace Map {
      * @property [requestVertexNormals = false] - 是否应该从服务器请求额外的光照信息，如果可用，以每个顶点法线的形式。
      * @property [requestWaterMask = false] - 是否应该向服务器请求每个瓦的水掩膜(如果有的话)。
      * @property [requestMetadata = true] - 是否应该从服务器请求每个块元数据(如果可用)。
+     * @property [clip = false] - 是否默认启用地形开挖，如果后续打开，缓存数据不会裁剪
+     * @property [flat = false] - 是否默认启用地形压平
+     * @property [uplift = false] - 是否默认启用地形抬升
+     * @property [flood = false] - 是否默认启用地形区域材质(淹没，等高线)
      */
     type terrainOptions = {
         type?: string | TerrainType;
@@ -26607,6 +26583,10 @@ declare namespace Map {
         requestVertexNormals?: boolean;
         requestWaterMask?: boolean;
         requestMetadata?: boolean;
+        clip?: boolean;
+        flat?: boolean;
+        uplift?: boolean;
+        flood?: boolean;
     };
     /**
      * 底图图层配置
@@ -27065,9 +27045,10 @@ declare class Map extends BaseClass {
      * 遍历每一个图层并将其作为参数传递给回调函数
      * @param method - 回调方法
      * @param [context] - 侦听器的上下文(this关键字将指向的对象)。
+     * @param [reverse] - 是否倒序执行
      * @returns 当前对象本身,可以链式调用
      */
-    eachLayer(method: (...params: any[]) => any, context?: any): Map;
+    eachLayer(method: (...params: any[]) => any, context?: any, reverse?: boolean): Map;
     /**
      * 根据指定属性获取图层，包括config.json配置的图层
      * @param attrValue - 属性值
@@ -27143,9 +27124,10 @@ declare class Map extends BaseClass {
      * 遍历每一个控件并将其作为参数传递给回调函数
      * @param method - 回调方法
      * @param [context] - 侦听器的上下文(this关键字将指向的对象)。
+     * @param [reverse] - 是否倒序执行
      * @returns 当前对象本身,可以链式调用
      */
-    eachControl(method: (...params: any[]) => any, context?: any): Map;
+    eachControl(method: (...params: any[]) => any, context?: any, reverse?: boolean): Map;
     /**
      * 根据指定属性获取控件
      * @param attrValue - 属性值
@@ -27196,9 +27178,10 @@ declare class Map extends BaseClass {
      * 遍历每一个Thing对象并将其作为参数传递给回调函数
      * @param method - 回调方法
      * @param [context] - 侦听器的上下文(this关键字将指向的对象)。
+     * @param [reverse] - 是否倒序执行
      * @returns 当前对象本身,可以链式调用
      */
-    eachThing(method: (...params: any[]) => any, context?: any): Map;
+    eachThing(method: (...params: any[]) => any, context?: any, reverse?: boolean): Map;
     /**
      * 根据指定属性获取Thing对象
      * @param attrValue - 属性值
@@ -27262,7 +27245,7 @@ declare class Map extends BaseClass {
         cancel?: Cesium.Camera.FlightCancelledCallback;
     }): Promise<boolean>;
     /**
-     * 设置相机pitch值，保持地图中心位置不变。
+     * 设置相机heading值，保持地图中心位置不变。
      * @param heading - 方向角度值， 0-360
      * @param [options] - 具有以下属性的对象:
      * @param [options.pitch] - 俯仰角度值，绕垂直于地心的轴旋转角度, -90至90
@@ -32127,6 +32110,7 @@ declare class Measure extends BaseThing {
      * @param [options] - 控制参数
      * @param [options.style] - 路线的样式
      * @param [options.label] - 测量结果文本的样式
+     *   //  * @param {function} [options.label.updateText] 测量结果文本更新的回调方法
      * @param [options.unit = 'auto'] - 计量单位,{@link MeasureUtil#formatDistance}可选值：auto、m、km、wm、mile、zhang 等。auto时根据距离值自动选用k或km
      * @param [options.maxPointNum = 9999] - 绘制时，最多允许点的个数
      * @param [options.addHeight] - 在绘制时，在绘制点的基础上增加的高度值
@@ -32147,7 +32131,8 @@ declare class Measure extends BaseThing {
      * 测量 贴地长度
      * @param [options] - 控制参数
      * @param [options.style] - 路线的样式
-     * @param [options.label] - 测量结果文本的样式
+     * @param [options.label] - 测量结果文本的样式,
+     *   //  * @param {function} [options.label.updateText] 测量结果文本更新的回调方法
      * @param [options.unit = 'auto'] - 计量单位,{@link MeasureUtil#formatDistance}可选值：auto、m、km、wm、mile、zhang 等。auto时根据距离值自动选用k或km
      * @param [options.maxPointNum = 9999] - 绘制时，最多允许点的个数
      * @param [options.addHeight] - 在绘制时，在绘制点的基础上增加的高度值
@@ -32175,6 +32160,7 @@ declare class Measure extends BaseThing {
      * @param [options] - 控制参数
      * @param [options.style] - 路线的样式
      * @param [options.label] - 测量结果文本的样式
+     *   //  * @param {function} [options.label.updateText] 测量结果文本更新的回调方法
      * @param [options.unit = 'auto'] - 计量单位,{@link MeasureUtil#formatDistance}可选值：auto、m、km、wm、mile、zhang 等。auto时根据距离值自动选用k或km
      * @param [options.maxPointNum = 9999] - 绘制时，最多允许点的个数
      * @param [options.addHeight] - 在绘制时，在绘制点的基础上增加的高度值
@@ -32445,16 +32431,20 @@ declare class Shadows extends BaseThing {
      * @param options - 参数
      * @param options.startDate - 开始时间
      * @param options.endDate - 结束时间
-     * @param positions - 分析区域范围坐标
-     * @param step - 间隔（单位米）
-     * @param [minHeight] - 最小高程（单位米）,与maxHeight一起可以设置多层
-     * @param [maxHeight] - 最大高程（单位米）
+     * @param options.positions - 分析区域范围坐标
+     * @param options.step - 间隔（单位米）
+     * @param [options.minHeight] - 最小高程（单位米）,与maxHeight一起可以设置多层
+     * @param [options.maxHeight] - 最大高程（单位米）
      * @returns 分析结果
      */
     startRate(options: {
         startDate: Date;
         endDate: Date;
-    }, positions: Cesium.Cartesian3[] | LngLatPoint[] | any, step: number, minHeight?: number, maxHeight?: number): Promise<any>;
+        positions: Cesium.Cartesian3[] | LngLatPoint[] | any;
+        step: number;
+        minHeight?: number;
+        maxHeight?: number;
+    }): Promise<any>;
 }
 
 declare namespace Sightline {
@@ -33525,7 +33515,8 @@ declare class TerrainEditBase extends BaseThing {
      * 添加单个区域
      * @param positions - 坐标位置数组
      * @param [options = {}] - 控制的参数
-     * @param [options.height] - 高度值
+     * @param [options.height] - 地形压平时，高度值
+     * @param [options.diffHeight] - 地形开挖和抬升时，墙体的高度值
      * @param [options.simplify] - 是否简化坐标点位，为空时不简化
      * @param [options.simplify.tolerance = 0.0001] - 简化的程度，传值是经纬度的小数位
      * @param [options.simplify.highQuality = true] - 是否花更多的时间用不同的算法创建更高质量的简化
@@ -33534,6 +33525,7 @@ declare class TerrainEditBase extends BaseThing {
      */
     addArea(positions: string[] | any[][] | LngLatPoint[] | Cesium.Cartesian3[], options?: {
         height?: any;
+        diffHeight?: any;
         simplify?: {
             tolerance?: number;
             highQuality?: boolean;
@@ -35623,9 +35615,10 @@ declare namespace PointUtil {
      * 求2点的中间点（贴地表）
      * @param mpt1 - 点1坐标
      * @param mpt2 - 点2坐标
+     * @param [fraction = 0.5] - 起始点和终点之间距离的比例
      * @returns 2个点是否为重复的点
      */
-    function getMidpoint(mpt1: Cesium.Cartesian3 | LngLatPoint, mpt2: Cesium.Cartesian3 | LngLatPoint): Cesium.Cartesian3;
+    function getMidpoint(mpt1: Cesium.Cartesian3 | LngLatPoint, mpt2: Cesium.Cartesian3 | LngLatPoint, fraction?: number): Cesium.Cartesian3;
     /**
      * 判断2个点是否为重复的点，比如标绘中的双击会偶尔产生2个重复点
      * @param mpt1 - 点1坐标
@@ -35954,7 +35947,7 @@ declare namespace PolyUtil {
      * @param options.center - 中心坐标
      * @param [options.width] - 矩形的宽度，单位：米
      * @param [options.height] - 矩形的高度，单位：米
-     * @param [options.rotation = 0] - 旋转的角度
+     * @param [options.rotation = 0] - 旋转的角度（弧度值）
      * @param [options.originX = 0.5] - 中心点所在的位置x轴方向比例，取值范围：0.1-1.0
      * @param [options.originY = 0.5] - 中心点所在的位置y轴方向比例，取值范围：0.1-1.0
      * @returns 矩形面的顶点坐标数组
@@ -37029,6 +37022,32 @@ declare namespace graphic {
   export { SatelliteSensor }
 }
 
+/**
+ * 矢量数据编辑类 命名空间
+ */
+declare namespace edit {
+  export { EditBase }
+  export { EditBox }
+  export { EditCircle }
+  export { EditCorridor }
+  export { EditCylinder }
+  export { EditEllipsoid }
+  export { EditModel }
+  export { EditPlane }
+  export { EditPoint }
+  export { EditPoly }
+  export { EditPolygon }
+  export { EditPolygonGrid }
+  export { EditPolylineVolume }
+  export { EditRectangle }
+  export { EditTileset }
+  export { EditVideo2D }
+  export { EditWall }
+
+  export { EditDivGraphic }
+}
+
+
 /**
  * 图层类 命名空间，
  * 教程 http://mars3d.cn/dev/guide/map/layer.html
@@ -37147,6 +37166,6 @@ export {
   BaseClass, BaseThing, LngLatPoint, LngLatArray, GroundSkyBox, MultipleSkyBox, LocalWorldTransform, CRS, ChinaCRS, EventType, State, Token, ColorRamp, MaterialType, GraphicType, LayerType, ControlType, EffectType, Lang, LangType, MoveType, ClipType, Icon,
   DomUtil, MeasureUtil, PointUtil, PolyUtil, PointTrans, Util, Log, MaterialUtil, GraphicUtil, DrawUtil, LayerUtil, ControlUtil, EffectUtil,
   BaseMaterialConver, BaseStyleConver, BillboardStyleConver, CloudStyleConver, BoxStyleConver, CircleStyleConver, CorridorStyleConver, CylinderStyleConver, DivGraphicStyleConver, EllipsoidStyleConver, LabelStyleConver, ModelStyleConver, PathStyleConver, PlaneStyleConver, PointStyleConver, PolygonStyleConver, PolylineStyleConver, PolylineVolumeStyleConver, RectangleStyleConver, RectangularSensorStyleConver, WallStyleConver,
-  material, graphic, provider, layer, thing, effect, control, query,
+  material, graphic, edit, provider, layer, thing, effect, control, query,
   Map,
 };