@d5techs/3dgs-lib 1.4.36 → 1.4.37

package/dist/3dgs-lib.cjs

@@ -630,6 +630,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);
@@ -793,7 +796,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)
@@ -942,7 +947,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)
@@ -1022,7 +1029,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)
@@ -1122,6 +1131,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;