@d5techs/3dgs-lib 1.4.33 → 1.4.35

package/dist/3dgs-lib.cjs

@@ -625,7 +625,7 @@ const _OrbitControls = class _OrbitControls {
     __publicField(this, "maxPhi", Math.PI - 0.01);
     // 灵敏度
     __publicField(this, "rotateSpeed", 5e-3);
-    __publicField(this, "zoomSpeed", 5e-4);
+    __publicField(this, "zoomSpeed", 1e-3);
     __publicField(this, "panSpeed", 5e-3);
     // 移动端触摸灵敏度
     __publicField(this, "touchZoomSpeed", 0.01);
@@ -1095,6 +1095,24 @@ const _OrbitControls = class _OrbitControls {
     this.camera.target[2] = z;
     this.applySpherical();
   }
+  /**
+   * 将 target 移到新位置，但保持相机世界坐标不变（重算 distance/theta/phi）
+   */
+  setTargetKeepPosition(x, y, z) {
+    this.clearVelocity();
+    const dx = this.camera.position[0] - x;
+    const dy = this.camera.position[1] - y;
+    const dz = this.camera.position[2] - z;
+    const newDist = Math.sqrt(dx * dx + dy * dy + dz * dz);
+    if (newDist < this.minDistance) return;
+    this.camera.target[0] = x;
+    this.camera.target[1] = y;
+    this.camera.target[2] = z;
+    this.distance = newDist;
+    this.theta = Math.atan2(dx, dz);
+    this.phi = Math.acos(Math.min(1, Math.max(-1, dy / newDist)));
+    this.applySpherical();
+  }
   getTarget() {
     return [
       this.camera.target[0],
@@ -18789,6 +18807,22 @@ class App {
     this.controls.frameModel(bbox.center, bbox.radius, animate);
     return true;
   }
+  /**
+   * 将 orbit target 吸附到视口中心的模型表面点，保持相机位置不变。
+   * 用于相机初始化完成后改善缩放手感（target 在表面而非包围盒中心）。
+   */
+  snapTargetToSurface() {
+    const rect = this.canvas.getBoundingClientRect();
+    const hit = this.pickSplatPosition(
+      rect.left + rect.width / 2,
+      rect.top + rect.height / 2
+    );
+    if (hit) {
+      this.controls.setTargetKeepPosition(hit[0], hit[1], hit[2]);
+      return true;
+    }
+    return false;
+  }
   // ============================================
   // Gizmo（委托给 GizmoManager）
   // ============================================