@d5techs/3dgs-lib 1.4.35 → 1.4.37

package/dist/3dgs-lib.js

@@ -628,6 +628,9 @@ const _OrbitControls = class _OrbitControls {
     // 移动端触摸灵敏度
     __publicField(this, "touchZoomSpeed", 0.01);
     __publicField(this, "touchPanSpeed", 3e-3);
+    // 缩放步长上限：用 min(distance, zoomDistanceCap) 计算每步的绝对位移，
+    // 使远距离时缩放速度由模型尺寸而非 target 位置决定。frameModel 会自动设置为 radius。
+    __publicField(this, "zoomDistanceCap", Infinity);
     // 阻尼：每帧应用全量 delta，然后 delta *= (1 - dampingFactor) 实现惯性
     __publicField(this, "enableDamping", true);
     __publicField(this, "dampingFactor", 0.1);
@@ -791,7 +794,9 @@ const _OrbitControls = class _OrbitControls {
       const maxAccum = 120 * this.zoomSpeed * this.dampingFactor * 3;
       this.deltaDistance = Math.sign(this.deltaDistance) * Math.min(Math.abs(this.deltaDistance), maxAccum);
     } else {
-      this.distance *= Math.exp(zoomDelta);
+      const factor = Math.exp(zoomDelta);
+      const effectiveDist = Math.min(this.distance, this.zoomDistanceCap);
+      this.distance -= effectiveDist * (1 - factor);
       this.distance = Math.max(
         this.minDistance,
         Math.min(this.maxDistance, this.distance)
@@ -940,7 +945,9 @@ const _OrbitControls = class _OrbitControls {
         if (this.enableDamping) {
           this.deltaDistance += -Math.log(ratio) * this.dampingFactor;
         } else {
-          this.distance /= ratio;
+          const factor = 1 / ratio;
+          const effectiveDist = Math.min(this.distance, this.zoomDistanceCap);
+          this.distance -= effectiveDist * (1 - factor);
           this.distance = Math.max(
             this.minDistance,
             Math.min(this.maxDistance, this.distance)
@@ -1020,7 +1027,9 @@ const _OrbitControls = class _OrbitControls {
       if (Math.abs(this.deltaTheta) < EPS) this.deltaTheta = 0;
       if (Math.abs(this.deltaPhi) < EPS) this.deltaPhi = 0;
       if (Math.abs(this.deltaDistance) > EPS) {
-        this.distance *= Math.exp(this.deltaDistance);
+        const factor = Math.exp(this.deltaDistance);
+        const effectiveDist = Math.min(this.distance, this.zoomDistanceCap);
+        this.distance -= effectiveDist * (1 - factor);
         this.distance = Math.max(
           this.minDistance,
           Math.min(this.maxDistance, this.distance)
@@ -1120,6 +1129,7 @@ const _OrbitControls = class _OrbitControls {
   }
   frameModel(center, radius, animate = true) {
     this.clearVelocity();
+    this.zoomDistanceCap = radius;
     const fovRad = this.camera.fov;
     const halfFov = fovRad / 2;
     const marginFactor = 1.5;
@@ -18807,7 +18817,7 @@ class App {
   }
   /**
    * 将 orbit target 吸附到视口中心的模型表面点，保持相机位置不变。
-   * 用于相机初始化完成后改善缩放手感（target 在表面而非包围盒中心）。
+   * 调用方可在相机初始化完毕后主动调用以改善缩放手感。
    */
   snapTargetToSurface() {
     const rect = this.canvas.getBoundingClientRect();