@d5techs/3dgs-lib 1.4.85 → 1.4.86

package/dist/3dgs-lib.cjs

@@ -793,6 +793,7 @@ const _OrbitControls = class _OrbitControls {
     // 键盘移动
     __publicField(this, "moveSpeed", 0.015);
     __publicField(this, "pressedKeys", /* @__PURE__ */ new Set());
+    __publicField(this, "_wasKeyboardMoving", false);
     // 触摸手势状态
     __publicField(this, "touchMode", "none");
     __publicField(this, "lastTouchDistance", 0);
@@ -969,7 +970,14 @@ const _OrbitControls = class _OrbitControls {
     this.pressedKeys.delete(e.key.toLowerCase());
   }
   applyKeyboardMovement() {
-    if (this.pressedKeys.size === 0) return;
+    if (this.pressedKeys.size === 0) {
+      if (this._wasKeyboardMoving) {
+        this._wasKeyboardMoving = false;
+        this.recenterOrbitTarget();
+      }
+      return;
+    }
+    this._wasKeyboardMoving = true;
     const m = this.camera.viewMatrix;
     const right = [m[0], m[4], m[8]];
     const forward = [-m[2], -m[6], -m[10]];
@@ -1129,9 +1137,15 @@ const _OrbitControls = class _OrbitControls {
   onTouchEnd(e) {
     if (e.touches.length === 0) {
       this.isDragging = false;
+      if (this.touchMode === "zoom-pan") {
+        this.recenterOrbitTarget();
+      }
       this.touchMode = "none";
       this.lastTouchDistance = 0;
     } else if (e.touches.length === 1) {
+      if (this.touchMode === "zoom-pan") {
+        this.recenterOrbitTarget();
+      }
       this.touchMode = "rotate";
       this.lastX = e.touches[0].clientX;
       this.lastY = e.touches[0].clientY;
@@ -1148,6 +1162,34 @@ const _OrbitControls = class _OrbitControls {
       y: (touches[0].clientY + touches[1].clientY) / 2
     };
   }
+  /**
+   * 将 orbit 目标重新锚定到屏幕中心的模型表面点，
+   * 保持相机世界坐标不变，仅重算 distance/theta/phi。
+   * 用于 WASD 移动或触摸缩放结束后修复旋转中心偏移。
+   */
+  recenterOrbitTarget() {
+    if (!this.pickWorldPosition) return;
+    const rect = this.canvas.getBoundingClientRect();
+    const hit = this.pickWorldPosition(
+      rect.left + rect.width / 2,
+      rect.top + rect.height / 2
+    );
+    if (!hit) return;
+    const dx = this.camera.position[0] - hit[0];
+    const dy = this.camera.position[1] - hit[1];
+    const dz = this.camera.position[2] - hit[2];
+    const newDist = Math.sqrt(dx * dx + dy * dy + dz * dz);
+    if (newDist < this.minDistance) return;
+    this.camera.target[0] = hit[0];
+    this.camera.target[1] = hit[1];
+    this.camera.target[2] = hit[2];
+    this.distance = newDist;
+    this.theta = Math.atan2(dx, dz);
+    this.phi = Math.acos(Math.min(1, Math.max(-1, dy / newDist)));
+    this.deltaPanX = 0;
+    this.deltaPanY = 0;
+    this.deltaPanZ = 0;
+  }
   /**
    * 将球坐标写入相机位置（内部方法，不处理阻尼）
    */
@@ -19249,8 +19291,8 @@ class App {
     __publicField(this, "animationId", 0);
     // 是否使用移动端渲染器
     __publicField(this, "useMobileRenderer", false);
-    // 缓存移动端检测结果，避免每帧调用
-    __publicField(this, "isMobile", false);
+    // 移动端优化开关（默认关闭，由外部显式启用）
+    __publicField(this, "mobileOptimizationsEnabled", false);
     // 移动端可见 splat 硬上限（保证稳定帧率）
     __publicField(this, "mobileMaxVisibleCap", 0);
     // 最近加载的 CompactSplatData（用于编辑器导出）
@@ -19284,7 +19326,6 @@ class App {
    * 初始化应用
    */
   async init() {
-    var _a2;
     this.renderer = new Renderer(this.canvas);
     await this.renderer.init();
     this.camera = new Camera();
@@ -19313,14 +19354,6 @@ class App {
     if (this.renderer.isAppleGPU) {
       this.applyAppleGPUDefaults();
     }
-    this.isMobile = isMobileDevice();
-    if (this.isMobile) {
-      createDebugOverlay();
-      (_a2 = getDebugOverlay()) == null ? void 0 : _a2.info(
-        `Mobile detected. DPR=${window.devicePixelRatio}, canvas=${this.canvas.width}x${this.canvas.height}`
-      );
-      this.applyMobileDefaults();
-    }
   }
   /**
    * Apple GPU (M1/M2/M3 等) 自动优化配置
@@ -19339,12 +19372,26 @@ class App {
     );
   }
   /**
-   * 移动端自动性能优化
-   * 核心策略：降 DPR + 降分辨率 + 激进剔除 + 降排序频率
+   * 启用/禁用移动端性能优化（默认关闭）
+   * 开启后，加载模型时将自动应用：f16 半精度、16-bit 排序、像素剔除、动态分辨率等。
+   * 应在 init() 之后、加载模型之前调用。
    */
-  applyMobileDefaults() {
-    this.dynamicResolutionEnabled = true;
-    console.log(`[3DGS] Mobile: f16, sortBits=16, pixelThreshold=2.5, DPR=1.5, dynamicRes=ON`);
+  enableMobileOptimizations(enabled = true) {
+    var _a2;
+    this.mobileOptimizationsEnabled = enabled;
+    if (enabled) {
+      this.dynamicResolutionEnabled = true;
+      createDebugOverlay();
+      (_a2 = getDebugOverlay()) == null ? void 0 : _a2.info(
+        `Mobile optimizations enabled. DPR=${window.devicePixelRatio}, canvas=${this.canvas.width}x${this.canvas.height}`
+      );
+      console.log(`[3DGS] Mobile optimizations: f16, sortBits=16, pixelThreshold=1.5, dynamicRes=ON`);
+    } else {
+      this.dynamicResolutionEnabled = false;
+    }
+  }
+  isMobileOptimized() {
+    return this.mobileOptimizationsEnabled;
   }
   /**
    * 创建 GSSplatRenderer 并自动应用平台优化
@@ -19407,7 +19454,7 @@ class App {
    */
   async addPLY(urlOrBuffer, onProgress, isLocalFile = false, coordinateSystem = "blender") {
     try {
-      const isMobile = isMobileDevice();
+      const useMobileOpt = this.mobileOptimizationsEnabled;
       let buffer;
       if (typeof urlOrBuffer === "string") {
         buffer = await this.fetchWithProgress(
@@ -19430,16 +19477,16 @@ class App {
           onProgress(50 + parseProgress, "parse");
         }
       };
-      if (isMobile) {
+      if (useMobileOpt) {
         console.log(
-          "[3DGS] Mobile device detected, using unified desktop renderer with SH L0"
+          "[3DGS] Mobile optimizations active, using SH L0"
         );
       }
-      const gsRenderer = this.createGSRendererUnified(isMobile);
+      const gsRenderer = this.createGSRendererUnified(useMobileOpt);
       this.useMobileRenderer = false;
       const compactData = await this.parsePLYBuffer(buffer, {
         maxSplats: Infinity,
-        loadSH: !isMobile,
+        loadSH: !useMobileOpt,
         onProgress: parseProgressCallback,
         coordinateSystem
       });
@@ -19460,7 +19507,7 @@ class App {
    */
   async addSplat(urlOrBuffer, onProgress, isLocalFile = false, coordinateSystem = "blender") {
     try {
-      const isMobile = isMobileDevice();
+      const useMobileOpt = this.mobileOptimizationsEnabled;
       let buffer;
       if (typeof urlOrBuffer === "string") {
         buffer = await this.fetchWithProgress(
@@ -19491,7 +19538,7 @@ class App {
       }
       if (onProgress) onProgress(90, "parse");
       if (onProgress) onProgress(90, "upload");
-      const gsRenderer = this.createGSRendererUnified(isMobile);
+      const gsRenderer = this.createGSRendererUnified(useMobileOpt);
       this.useMobileRenderer = false;
       gsRenderer.setData(splats);
       this.sceneManager.setGSRenderer(gsRenderer);
@@ -19538,7 +19585,7 @@ class App {
    */
   async addSOG(urlOrBuffer, onProgress, isLocalFile = false, coordinateSystem = "blender") {
     try {
-      const isMobile = isMobileDevice();
+      const useMobileOpt = this.mobileOptimizationsEnabled;
       let buffer;
       if (typeof urlOrBuffer === "string") {
         buffer = await this.fetchWithProgress(
@@ -19580,7 +19627,7 @@ class App {
         }
       }
       if (onProgress) onProgress(90, "upload");
-      const gsRenderer = this.createGSRendererUnified(isMobile);
+      const gsRenderer = this.createGSRendererUnified(useMobileOpt);
       this.useMobileRenderer = false;
       gsRenderer.setCompactData(compactData);
       this.lastCompactData = compactData;