cesium-xs-sdk 1.0.17 → 1.0.18

package/dist/cesium-xs-sdk.cjs.js

@@ -9088,6 +9088,9 @@ class EditorModule {
     this.currentToolName = name;
     this.currentTool.activate();
     this._isActive = true;
+    // 供其他组件（如 Zoom 双击缩放）感知"编辑器工具激活中"，
+    // 工具激活期间双击/右键有工具自身语义，缩放等全局交互应让行
+    this.viewer.xs3dEditorActive = true;
 
     console.log(`工具 ${name} 已激活`);
     return this;
@@ -9104,6 +9107,9 @@ class EditorModule {
     this.currentTool = null;
     this.currentToolName = null;
     this._isActive = false;
+    if (this.viewer) {
+      this.viewer.xs3dEditorActive = false;
+    }
 
     return this;
   }
@@ -9734,10 +9740,13 @@ class LocationBar extends BaseControl {
     // 鼠标移动：更新鼠标位置信息
     const canvas = this._viewer.scene.canvas;
     this._addDomEvent(canvas, 'mousemove', this._onMouseMove.bind(this));
-    this._addDomEvent(canvas, 'mouseleave', this._onMouseLeave.bind(this));
+    // 鼠标移出画布不再重置为 '-'：保留最后拾取的坐标（见 _onMouseMove 说明）
 
     // 相机变化：更新方向/俯仰/视高/层级
     this._addCesiumHandler(this._viewer.camera.changed, this._onCameraChanged.bind(this));
+    // flyTo 动画尾段每帧位移小于 percentageChanged 阈值后 changed 不再触发，
+    // 信息栏会滞后一级；相机停止移动时强制刷新一次
+    this._addCesiumHandler(this._viewer.camera.moveEnd, this._onCameraChanged.bind(this));
 
     // FPS
     if (this._showFPS) {
@@ -9776,16 +9785,10 @@ class LocationBar extends BaseControl {
         lat: Cesium$6.Math.toDegrees(cartographic.latitude).toFixed(this._latDecimal),
         alt: cartographic.height.toFixed(2)
       };
-    } else {
-      this._lastMouseData = { lng: '-', lat: '-', alt: '-' };
+      this._updateContent();
     }
-
-    this._updateContent();
-  }
-
-  _onMouseLeave() {
-    this._lastMouseData = { lng: '-', lat: '-', alt: '-' };
-    this._updateContent();
+    // 拾取不到（鼠标指向太空/地球未加载等）时不刷新，
+    // 保留最后一次成功拾取的坐标，避免信息栏闪现"-"
   }
 
   _onCameraChanged() {
@@ -9867,6 +9870,8 @@ class Zoom extends BaseControl {
   /**
    * @param {object} options
    * @param {number} [options.duration=0.5] 缩放动画时长（秒）
+   * @param {boolean} [options.doubleClickZoomIn=false] 左键双击放大一级（桌面端）
+   * @param {boolean} [options.doubleClickZoomOut=false] 右键双击缩小一级（桌面端）
    */
   constructor(options = {}) {
     super({
@@ -9875,6 +9880,19 @@ class Zoom extends BaseControl {
     });
 
     this._duration = options.duration ?? 0.5;
+    // 本控件发起的缩放飞行目标层级；飞行进行中（含动画尾段）点击按钮时，
+    // 以它而不是相机瞬时位置作为基准层级
+    this._pendingLevel = null;
+    // 双击缩放（默认关闭；开启后会替换 Cesium Viewer 默认的左键双击动作）
+    this._doubleClickZoomIn = options.doubleClickZoomIn ?? false;
+    this._doubleClickZoomOut = options.doubleClickZoomOut ?? false;
+    this._doubleClickEnabled = this._doubleClickZoomIn || this._doubleClickZoomOut;
+    this._doubleClickInstalled = false;
+    this._savedDoubleClickActions = null;
+    // 右键双击判定器：Cesium 的 RIGHT_DOUBLE_CLICK 在桌面端没有任何触发源
+    // （ScreenSpaceEventHandler 的 dblclick 监听只映射左键），
+    // 因此右键双击在 RIGHT_CLICK 流水上自维护（复用工具的 DoubleClickDetector）
+    this._rightDoubleClickDetector = new DoubleClickDetector();
   }
 
   _createContainer() {
@@ -9935,6 +9953,118 @@ class Zoom extends BaseControl {
       e.stopPropagation();
       this._zoomOut();
     });
+
+    // 双击缩放注册到 viewer.screenSpaceEventHandler（而不是 DOM 事件）：
+    // 绘制/量测工具激活时会保存-移除-恢复当前的左键双击动作，
+    // 注册在这里可以让工具自动接管，无需额外协调
+    if (this._doubleClickEnabled) {
+      this._installDoubleClickZoom();
+    }
+  }
+
+  /**
+   * 开启双击缩放（运行期可随时调用，只切换内部开关，不重建事件）
+   * 若初始化时未指定任何方向（两个选项均 false），默认只开左键双击放大
+   * @returns {Zoom}
+   */
+  enableDoubleClickZoom() {
+    this._doubleClickEnabled = true;
+    if (!this._doubleClickZoomIn && !this._doubleClickZoomOut) {
+      this._doubleClickZoomIn = true;
+    }
+    // 初始化时未安装过（选项均为 false）则补注册；
+    // 编辑器工具激活期间不抢占工具的左键双击，等工具结束恢复动作后即可用
+    if (!this._doubleClickInstalled && this._viewer && !this._viewer.xs3dEditorActive) {
+      this._installDoubleClickZoom();
+    }
+    return this;
+  }
+
+  /**
+   * 关闭双击缩放（运行期可随时调用；放大/缩小按钮不受影响）
+   * @returns {Zoom}
+   */
+  disableDoubleClickZoom() {
+    this._doubleClickEnabled = false;
+    return this;
+  }
+
+  /**
+   * 安装左键双击 / 右键双击缩放的输入动作，并保存被替换的原始动作供移除时恢复。
+   * 左键走 Cesium 的 LEFT_DOUBLE_CLICK（桌面端 DOM dblclick）；
+   * 右键 Cesium 无 RIGHT_DOUBLE_CLICK 触发源，改在 RIGHT_CLICK 上用
+   * DoubleClickDetector 自维护判定（连续两次右键间隔 < 300ms 且位移 < 10px）。
+   */
+  _installDoubleClickZoom() {
+    if (this._doubleClickInstalled || !this._viewer) return;
+    const handler = this._viewer.screenSpaceEventHandler;
+    if (!handler) return;
+
+    const EventType = Cesium$5.ScreenSpaceEventType;
+    const saved = {};
+    if (this._doubleClickZoomIn) {
+      saved.left = handler.getInputAction(EventType.LEFT_DOUBLE_CLICK);
+      handler.setInputAction(
+        (movement) => this._onDoubleClickZoom(1, movement),
+        EventType.LEFT_DOUBLE_CLICK
+      );
+    }
+    if (this._doubleClickZoomOut) {
+      saved.right = handler.getInputAction(EventType.RIGHT_CLICK);
+      handler.setInputAction(
+        (movement) => this._onRightClickForDoubleClick(movement),
+        EventType.RIGHT_CLICK
+      );
+    }
+    this._savedDoubleClickActions = saved;
+    this._doubleClickInstalled = true;
+  }
+
+  /**
+   * 右键单击喂入双击判定器，构成双击时缩小一级
+   * @param {object} movement Cesium 右键事件对象
+   */
+  _onRightClickForDoubleClick(movement) {
+    if (!this._doubleClickEnabled || !this._viewer) return;
+    // 编辑器工具激活期间：右键是工具的撤销/结束语义，清状态不喂入，
+    // 避免把两次撤销误判成双击缩放，或把脏状态带到工具结束后
+    if (this._viewer.xs3dEditorActive) {
+      this._rightDoubleClickDetector.reset();
+      return;
+    }
+    const pos = movement?.position;
+    if (!pos) return;
+    if (this._rightDoubleClickDetector.feed(performance.now(), { x: pos.x, y: pos.y })) {
+      this._rightDoubleClickDetector.reset();
+      this._onDoubleClickZoom(-1, movement);
+    }
+  }
+
+  /**
+   * 双击缩放处理：以双击拾取位置为中心步进一级
+   * @param {number} levelDelta +1 放大一级，-1 缩小一级
+   * @param {object} movement Cesium 双击事件对象
+   */
+  _onDoubleClickZoom(levelDelta, movement) {
+    if (!this._doubleClickEnabled || !this._viewer) return;
+    // 绘制/量测/编辑工具激活期间禁用：左键双击是工具的收尾语义，
+    // 右键单击是工具的撤销/结束语义，右键双击不能叠加缩放
+    if (this._viewer.xs3dEditorActive) return;
+
+    const camera = this._viewer.camera;
+    // 以双击位置拾取到的地表点为缩放中心；拾取不到退回相机正下方
+    let cartographic = camera.positionCartographic;
+    if (movement?.position && this._viewer.scene?.globe) {
+      const ray = camera.getPickRay(movement.position);
+      const cartesian = ray ? this._viewer.scene.globe.pick(ray, this._viewer.scene) : null;
+      if (cartesian) {
+        cartographic = Cesium$5.Cartographic.fromCartesian(cartesian);
+      }
+    }
+
+    const currentLevel = this._pendingLevel ?? this._getZoomLevel();
+    const targetLevel = Math.max(0, Math.min(24, currentLevel + levelDelta));
+    this._flyToLevel(targetLevel, cartographic);
   }
 
   _zoomIn() {
@@ -9950,12 +10080,21 @@ class Zoom extends BaseControl {
    * @param {number} levelDelta 层级变化量，+1 放大一级，-1 缩小一级
    */
   _zoomBy(levelDelta) {
-    const camera = this._viewer.camera;
-    const cartographic = camera.positionCartographic;
-    const currentLevel = this._getZoomLevel();
+    const currentLevel = this._pendingLevel ?? this._getZoomLevel();
     const targetLevel = Math.max(0, Math.min(24, currentLevel + levelDelta));
+    this._flyToLevel(targetLevel, this._viewer.camera.positionCartographic);
+  }
+
+  /**
+   * 飞到指定层级（以给定经纬度为中心），并记录 _pendingLevel
+   * @param {number} targetLevel 目标层级
+   * @param {Cesium.Cartographic} cartographic 目的地中心
+   */
+  _flyToLevel(targetLevel, cartographic) {
+    const camera = this._viewer.camera;
     const targetHeight = this._getHeightByZoomLevel(targetLevel);
 
+    this._pendingLevel = targetLevel;
     camera.flyTo({
       destination: Cesium$5.Cartesian3.fromRadians(
         cartographic.longitude,
@@ -9967,7 +10106,13 @@ class Zoom extends BaseControl {
         pitch: camera.pitch,
         roll: camera.roll
       },
-      duration: this._duration
+      duration: this._duration,
+      complete: () => {
+        if (this._pendingLevel === targetLevel) this._pendingLevel = null;
+      },
+      cancel: () => {
+        if (this._pendingLevel === targetLevel) this._pendingLevel = null;
+      }
     });
   }
 
@@ -9986,7 +10131,36 @@ class Zoom extends BaseControl {
 
   _getHeightByZoomLevel(level) {
     const equatorCircumference = 6378137 * 2 * Math.PI;
-    return equatorCircumference / Math.pow(2, Math.max(0, level - 1));
+    // 取层级几何带中心（C / 2^(L-0.5)），而不是分界线高度 C / 2^(L-1)：
+    // 分界线上浮点误差会导致层级反推差一级（实测约 1/3 经纬度位置），
+    // 且动画尾段相机 changed 事件不再触发，信息栏会滞后一级显示。
+    return equatorCircumference / Math.pow(2, Math.max(0, level - 0.5));
+  }
+
+  /**
+   * 销毁：恢复安装双击缩放前的输入动作
+   * 编辑器工具激活期间不恢复（当前动作归工具所有，由工具的恢复链处理；
+   * 工具结束后会放回本控件的 handler，其中 _viewer 已置空，调用即 no-op）
+   */
+  _destroy() {
+    if (this._doubleClickInstalled && this._viewer?.screenSpaceEventHandler) {
+      const handler = this._viewer.screenSpaceEventHandler;
+      const EventType = Cesium$5.ScreenSpaceEventType;
+      const saved = this._savedDoubleClickActions || {};
+      [
+        ['left', EventType.LEFT_DOUBLE_CLICK],
+        ['right', EventType.RIGHT_CLICK]
+      ].forEach(([key, eventType]) => {
+        if (!(key in saved)) return;
+        if (typeof saved[key] === 'function') {
+          handler.setInputAction(saved[key], eventType);
+        } else {
+          handler.removeInputAction(eventType);
+        }
+      });
+    }
+    this._doubleClickInstalled = false;
+    this._savedDoubleClickActions = null;
   }
 }