@ridp/threejs 1.5.0 → 1.5.2

package/dist/threejs.js

@@ -1,13 +1,13 @@
-var A = Object.defineProperty;
-var P = (u, e, t) => e in u ? A(u, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : u[e] = t;
-var i = (u, e, t) => P(u, typeof e != "symbol" ? e + "" : e, t);
-import { i as oe, o as ie, c as ne, b as re, a as ae, u as le } from "./useBatchGLTFLoader-C1C8R5Ss.js";
-import { d as j, S as V, s as q, j as X } from "./PredictiveLoader-C9zJlZEQ.js";
-import { C as he, E as de, I as me, M as fe, P as pe, q as ue, R as xe, n as ge, h as Fe, g as Re, b as ze, c as be, a as we, e as Me, f as Ee, i as Le, l as Te, m as Oe, o as Ce, k as ye, p as ve, r as Se, u as De } from "./PredictiveLoader-C9zJlZEQ.js";
-import { I as He, c as Ae, a as Pe, g as je, b as Ve, d as qe, i as Xe } from "./objectQuery-BfHUGPET.js";
-import { ModelOptimizer as Be, modelOptimizer as Ze } from "./modelOptimizer-D6fRg-DF.js";
-import { MathUtils as F, Scene as Y, PerspectiveCamera as B, WebGLRenderer as Z, Box3 as _, Vector3 as a, Box3Helper as G } from "three";
-const N = "1.5.0", W = 50, k = 20, U = 20, v = {
+var H = Object.defineProperty;
+var P = (x, e, t) => e in x ? H(x, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : x[e] = t;
+var o = (x, e, t) => P(x, typeof e != "symbol" ? e + "" : e, t);
+import { i as oe, o as ie, c as ne, b as re, a as ae, u as le } from "./useBatchGLTFLoader-BtuzDyHn.js";
+import { d as j, S as V, y as q, j as X } from "./PredictiveLoader-Ce8DXwbW.js";
+import { C as he, E as de, I as me, M as fe, P as ue, x as pe, R as xe, t as ge, q as Fe, n as Re, h as we, g as be, b as ze, c as Me, a as Te, e as Ee, f as Le, i as Oe, l as Ce, m as ye, r as ve, p as Ie, o as Se, k as De, s as Ae, v as He, w as Pe, u as je } from "./PredictiveLoader-Ce8DXwbW.js";
+import { I as qe, b as Xe, c as Ye, a as Be, g as Ze, d as Ge, e as We, i as _e, p as Ne, r as ke, t as Ue } from "./objectQuery-BcL0iGx1.js";
+import { ModelOptimizer as Je, modelOptimizer as Ke } from "./modelOptimizer-B7zPcU53.js";
+import { MathUtils as F, Scene as Y, PerspectiveCamera as B, WebGLRenderer as Z, Box3 as G, Vector3 as l, Box3Helper as W } from "three";
+const _ = "1.5.2", N = 50, k = 20, U = 20, v = {
   TOP: "top",
   // 俯视（从上往下）
   RIGHT: "right",
@@ -39,21 +39,21 @@ class J {
    * @param {Object} [option.control.options={}] - 控制器选项
    */
   constructor(e, t) {
-    i(this, "isReady", !1);
-    i(this, "scene", null);
-    i(this, "camera", null);
-    i(this, "renderer", null);
-    i(this, "control", null);
-    i(this, "css3dRenderer", null);
-    i(this, "el", null);
-    i(this, "renderRequested", !1);
-    i(this, "selector", null);
-    i(this, "eventsListener", {});
-    i(this, "stats", null);
-    i(this, "isDispose", !1);
-    i(this, "version", "0.0.0");
-    i(this, "boxHelper", null);
-    i(this, "initOpt", {
+    o(this, "isReady", !1);
+    o(this, "scene", null);
+    o(this, "camera", null);
+    o(this, "renderer", null);
+    o(this, "control", null);
+    o(this, "css3dRenderer", null);
+    o(this, "el", null);
+    o(this, "renderRequested", !1);
+    o(this, "selector", null);
+    o(this, "eventsListener", {});
+    o(this, "stats", null);
+    o(this, "isDispose", !1);
+    o(this, "version", "0.0.0");
+    o(this, "boxHelper", null);
+    o(this, "initOpt", {
       css3d: !1,
       stats: !1,
       renderType: "change",
@@ -70,20 +70,20 @@ class J {
      * 初始化场景
      * @param {string} selector - DOM 容器选择器
      */
-    i(this, "setup", (e) => {
+    o(this, "setup", (e) => {
       if (this.isDispose = !1, this.selector = e, this.el = document.querySelector(e), !this.el) {
         console.error(`ThreeIns: 找不到元素 ${e}`);
         return;
       }
-      const [t, h] = this.getTargetSize();
-      if (this.updateCameraFOV(t, h), this.camera.position.set(0, 0, 0), this.camera.lookAt(0, 0, 0), this.camera.updateProjectionMatrix(), this.renderer.setPixelRatio(window.devicePixelRatio), this.renderer.setSize(t, h), this.el.appendChild(this.renderer.domElement), this.initOpt.control && this.initOpt.control.init) {
+      const [t, r] = this.getTargetSize();
+      if (this.updateCameraFOV(t, r), this.camera.position.set(0, 0, 0), this.camera.lookAt(0, 0, 0), this.camera.updateProjectionMatrix(), this.renderer.setPixelRatio(window.devicePixelRatio), this.renderer.setSize(t, r), this.el.appendChild(this.renderer.domElement), this.initOpt.control && this.initOpt.control.init) {
         this.control = j(this.camera, this.renderer.domElement);
         const s = Object.assign(
           $,
           this.initOpt.control.options || {}
         );
-        Object.keys(s).forEach((x) => {
-          this.control[x] = s[x];
+        Object.keys(s).forEach((f) => {
+          this.control[f] = s[f];
         });
       }
       setTimeout(() => {
@@ -97,14 +97,14 @@ class J {
      * WebGL 上下文丢失处理
      * @param {Event} e - 事件对象
      */
-    i(this, "onContextLost", (e) => {
+    o(this, "onContextLost", (e) => {
       e.preventDefault(), this.animationFrameId && cancelAnimationFrame(this.animationFrameId);
     });
     /**
      * WebGL 上下文恢复处理
      * @param {Event} e - 事件对象
      */
-    i(this, "onContextRestored", (e) => {
+    o(this, "onContextRestored", (e) => {
       e.preventDefault(), this.dispose(), setTimeout(() => {
         this.setup(this.selector);
       }, U);
@@ -112,7 +112,7 @@ class J {
     /**
      * 初始化事件监听器
      */
-    i(this, "initListener", () => {
+    o(this, "initListener", () => {
       this.initOpt.initListener && window && window.addEventListener("resize", this.onResize, !1), this.renderer.domElement.addEventListener(
         "webglcontextlost",
         this.onContextLost,
@@ -126,7 +126,7 @@ class J {
     /**
      * 移除事件监听器
      */
-    i(this, "removeListener", () => {
+    o(this, "removeListener", () => {
       window && window.removeEventListener("resize", this.onResize, !1), this.renderer && this.renderer.domElement && (this.renderer.domElement.removeEventListener(
         "webglcontextlost",
         this.onContextLost,
@@ -140,19 +140,35 @@ class J {
     /**
      * 渲染循环（loop 模式）
      */
-    i(this, "animate", () => {
+    o(this, "animate", () => {
       this.isDispose || (this.initOpt.renderType === "loop" && this.onRender(), this.animationFrameId = requestAnimationFrame(this.animate));
     });
     /**
      * 执行渲染
      */
-    i(this, "onRender", () => {
-      this.isDispose || (this.renderRequested = !1, this.stats && this.stats.update(), this.control && this.control.update(), this.renderer.render(this.scene, this.camera), this.css3dRenderer && this.css3dRenderer.render(this.scene, this.camera), this.eventsListener.onRender && this.eventsListener.onRender.length && this.eventsListener.onRender.forEach((e) => e()));
+    o(this, "onRender", () => {
+      if (this.isDispose) return;
+      const e = this.debug ? performance.now() : 0;
+      this.renderRequested = !1, this.stats && this.stats.update(), this.control && this.control.update(), this.renderer.render(this.scene, this.camera), this.css3dRenderer && this.css3dRenderer.render(this.scene, this.camera);
+      const t = this.eventsListener.onRender;
+      if (t && t.length) {
+        const r = t.length;
+        for (let s = 0; s < r; s++)
+          try {
+            t[s]();
+          } catch (f) {
+            console.error("[ThreeIns] 渲染回调执行错误:", f);
+          }
+      }
+      if (this.debug) {
+        const r = performance.now() - e;
+        r > 50 && console.warn(`[ThreeIns] 帧耗时 ${r.toFixed(1)}ms，可能存在性能问题`);
+      }
     });
     /**
      * 请求渲染（如果尚未请求）
      */
-    i(this, "requestRenderIfNotRequested", () => {
+    o(this, "requestRenderIfNotRequested", () => {
       this.renderRequested || (this.renderRequested = !0, requestAnimationFrame(() => {
         this.onRender();
       }));
@@ -160,11 +176,11 @@ class J {
     /**
      * 处理窗口大小变化（带防抖）
      */
-    i(this, "onResize", () => {
+    o(this, "onResize", () => {
       this.resizeTimer && clearTimeout(this.resizeTimer), this.resizeTimer = setTimeout(() => {
         const [e, t] = this.getTargetSize();
         this.updateCameraFOV(e, t), this.camera.lookAt(this.scene.position), this.renderer.setSize(e, t), this.css3dRenderer && this.css3dRenderer.setSize(e, t), this.onRender();
-      }, W);
+      }, N);
     });
     /**
      * @deprecated 此方法已弃用，请使用 setView() 方法代替
@@ -181,7 +197,7 @@ class J {
      * @param {number} [scale=0.8] - 缩放比例，1=占满画布，0.5=50%，2.0=200%
      * @returns {Object} 返回 setView 的结果
      */
-    i(this, "frameArea", (e, t) => (console.warn(
+    o(this, "frameArea", (e, t) => (console.warn(
       `[ThreeIns] frameArea() 已弃用，建议使用 setView() 方法。
 旧用法: threeIns.frameArea(model, scale)
 新用法: threeIns.setView(model, ViewType.ISO, { scale })`
@@ -247,73 +263,73 @@ class J {
      * // 或者使用类静态属性（向后兼容）
      * threeIns.setView(model, ThreeIns.ViewType.TOP);
      */
-    i(this, "setView", (e, t, h = {}) => {
-      let s = h.scale || 0.8, x = h.offset || null, R = h.position || "center", z = h.showBox || !1, S = h.boxColor || 16776960, M = h.animate !== void 0 ? h.animate : !0, E = h.duration || 1e3;
-      const g = new _().setFromObject(e);
-      let c = g.getCenter(new a());
+    o(this, "setView", (e, t, r = {}) => {
+      let s = r.scale || 0.8, f = r.offset || null, R = r.position || "center", w = r.showBox || !1, I = r.boxColor || 16776960, M = r.animate !== void 0 ? r.animate : !0, T = r.duration || 1e3;
+      const g = new G().setFromObject(e);
+      let h = g.getCenter(new l());
       if (typeof R == "string") {
-        const o = g.getSize(new a()), r = {
-          center: new a(0, 0, 0),
-          "top-left": new a(-o.x * 0.3, o.y * 0.3, o.z * 0.3),
-          "top-right": new a(o.x * 0.3, o.y * 0.3, o.z * 0.3),
-          "bottom-left": new a(-o.x * 0.3, -o.y * 0.3, o.z * 0.3),
-          "bottom-right": new a(o.x * 0.3, -o.y * 0.3, o.z * 0.3)
-        }, d = r[R] || r.center;
-        t === "top" ? c.add(new a(d.x, 0, d.z)) : t === "right" || t === "left" ? c.add(new a(d.x, d.y, d.z)) : c.add(d);
-      } else R instanceof a && c.add(R);
-      x && c.add(x);
-      const n = g.getSize(new a()), L = {
-        top: new a(0, 1, 0),
+        const i = g.getSize(new l()), a = {
+          center: new l(0, 0, 0),
+          "top-left": new l(-i.x * 0.3, i.y * 0.3, i.z * 0.3),
+          "top-right": new l(i.x * 0.3, i.y * 0.3, i.z * 0.3),
+          "bottom-left": new l(-i.x * 0.3, -i.y * 0.3, i.z * 0.3),
+          "bottom-right": new l(i.x * 0.3, -i.y * 0.3, i.z * 0.3)
+        }, d = a[R] || a.center;
+        t === "top" ? h.add(new l(d.x, 0, d.z)) : t === "right" || t === "left" ? h.add(new l(0, d.y, d.z)) : h.add(d);
+      } else R instanceof l && h.add(R);
+      f && h.add(f);
+      const n = g.getSize(new l()), E = {
+        top: new l(0, 1, 0),
         // 从上往下：Y 轴正方向
-        right: new a(1, 1, 1).normalize(),
+        right: new l(1, 1, 1).normalize(),
         // 从右往左：X 轴正方向
-        left: new a(-1, 1, 1).normalize(),
+        left: new l(-1, 1, 1).normalize(),
         // 从左往右：X 轴负方向
-        iso: new a(0, 1, 1).normalize()
+        iso: new l(0, 1, 1).normalize()
         // 等轴测：从对角线上方俯视
-      }, b = L[t] || L.iso, T = this.camera.aspect, l = F.degToRad(this.camera.fov * 0.5), D = F.degToRad(80), m = Math.min(Math.atan(Math.tan(l) * T), D);
-      let f;
+      }, b = E[t] || E.iso, L = this.camera.aspect, c = F.degToRad(this.camera.fov * 0.5), S = F.degToRad(80), m = Math.min(Math.atan(Math.tan(c) * L), S);
+      let u;
       if (t === "top") {
-        const o = n.x * 0.5 / (Math.tan(m) * s), r = n.z * 0.5 / (Math.tan(l) * s);
-        f = Math.max(o, r);
+        const i = n.x * 0.5 / (Math.tan(m) * s), a = n.z * 0.5 / (Math.tan(c) * s);
+        u = Math.max(i, a);
       } else if (t === "right" || t === "left") {
-        const o = n.y * 0.5 / (Math.tan(l) * s), r = n.z * 0.5 / (Math.tan(l) * s);
-        f = Math.max(o, r);
+        const i = n.y * 0.5 / (Math.tan(c) * s), a = n.z * 0.5 / (Math.tan(c) * s);
+        u = Math.max(i, a);
       } else {
-        const o = n.x * 0.5 / (Math.tan(m) * s), r = n.y * 0.5 / (Math.tan(l) * s), d = n.z * 0.5 / (Math.tan(l) * s);
-        f = Math.max(o, r, d);
+        const i = n.x * 0.5 / (Math.tan(m) * s), a = n.y * 0.5 / (Math.tan(c) * s), d = n.z * 0.5 / (Math.tan(c) * s);
+        u = Math.max(i, a, d);
       }
-      const p = b.clone().multiplyScalar(f).add(c);
-      if (z && (console.log("📍 相机位置验证:"), console.log("  - 方向向量:", b), console.log("  - 距离:", f.toFixed(2)), console.log("  - 包围盒中心:", c), console.log("  - 计算公式: direction * distance + boxCenter"), console.log("  - 目标位置:", p), console.log("  - 实际相机与中心的距离:", p.clone().sub(c).length().toFixed(2))), z ? (this.boxHelper && (this.scene.remove(this.boxHelper), this.boxHelper = null), this.boxHelper = new G(g, S), this.scene.add(this.boxHelper)) : this.boxHelper && (this.scene.remove(this.boxHelper), this.boxHelper = null), M) {
-        const o = this.camera.position.clone(), r = this.control ? this.control.target.clone() : new a(0, 0, 0), d = c, I = Date.now(), O = () => {
-          const H = Date.now() - I, C = Math.min(H / E, 1), y = 1 - Math.pow(1 - C, 3);
-          if (this.camera.position.lerpVectors(o, p, y), this.control) {
-            const w = new a();
-            w.lerpVectors(r, d, y), this.control.target.copy(w), this.camera.lookAt(w);
+      const p = b.clone().multiplyScalar(u).add(h);
+      if (w && (console.log("📍 相机位置验证:"), console.log("  - 方向向量:", b), console.log("  - 距离:", u.toFixed(2)), console.log("  - 包围盒中心:", h), console.log("  - 计算公式: direction * distance + boxCenter"), console.log("  - 目标位置:", p), console.log("  - 实际相机与中心的距离:", p.clone().sub(h).length().toFixed(2))), w ? (this.boxHelper && (this.scene.remove(this.boxHelper), this.boxHelper = null), this.boxHelper = new W(g, I), this.scene.add(this.boxHelper)) : this.boxHelper && (this.scene.remove(this.boxHelper), this.boxHelper = null), M) {
+        const i = this.camera.position.clone(), a = this.control ? this.control.target.clone() : new l(0, 0, 0), d = h, D = Date.now(), O = () => {
+          const A = Date.now() - D, C = Math.min(A / T, 1), y = 1 - Math.pow(1 - C, 3);
+          if (this.camera.position.lerpVectors(i, p, y), this.control) {
+            const z = new l();
+            z.lerpVectors(a, d, y), this.control.target.copy(z), this.camera.lookAt(z);
           } else
-            this.camera.lookAt(c);
-          this.camera.updateProjectionMatrix(), C < 1 ? requestAnimationFrame(O) : (this.camera.position.copy(p), this.camera.lookAt(c), this.camera.updateProjectionMatrix(), this.control && (this.control.target.copy(c), this.control.update()), this.onRender());
+            this.camera.lookAt(h);
+          this.camera.updateProjectionMatrix(), C < 1 ? requestAnimationFrame(O) : (this.camera.position.copy(p), this.camera.lookAt(h), this.camera.updateProjectionMatrix(), this.control && (this.control.target.copy(h), this.control.update()), this.onRender());
         };
         O();
       } else
-        this.camera.position.copy(p), this.camera.lookAt(c), this.camera.updateProjectionMatrix(), this.control && (this.control.target.copy(c), this.control.update()), this.onRender();
-      if (z) {
-        if (console.log("🎥 视角切换信息:"), console.log("  - 视角类型:", t), console.log("  - 相机位置:", p), console.log("  - 观察目标:", c), console.log("  - 方向向量:", b), console.log("  - 包围盒尺寸:", n), console.log("  - 包围盒中心:", g.getCenter(new a())), console.log("  - 水平 FOV:", F.radToDeg(m * 2).toFixed(2) + "°"), console.log("  - 垂直 FOV:", F.radToDeg(l * 2).toFixed(2) + "°"), console.log("  - 宽高比:", T.toFixed(4)), console.log("  - 模型宽度:", n.x.toFixed(2)), console.log("  - 模型高度:", n.y.toFixed(2)), console.log("  - 模型深度:", n.z.toFixed(2)), console.log("  - 传入的 scale 参数:", s), t === "top") {
-          const o = n.x * 0.5 / (Math.tan(m) * s), r = n.z * 0.5 / (Math.tan(l) * s);
-          console.log("  - 模型 X 尺寸 (宽度):", n.x.toFixed(2)), console.log("  - 模型 Z 尺寸 (深度):", n.z.toFixed(2)), console.log("  - tan(halfFovX):", Math.tan(m).toFixed(4)), console.log("  - tan(halfFovY):", Math.tan(l).toFixed(4)), console.log("  - X方向距离计算: (", (n.x * 0.5).toFixed(2), ") / (", Math.tan(m).toFixed(4), " *", s, ") =", o.toFixed(2)), console.log("  - Z方向距离计算: (", (n.z * 0.5).toFixed(2), ") / (", Math.tan(l).toFixed(4), " *", s, ") =", r.toFixed(2)), console.log("  - X方向距离 (scale=" + s + "):", o.toFixed(2)), console.log("  - Z方向距离 (scale=" + s + "):", r.toFixed(2));
+        this.camera.position.copy(p), this.camera.lookAt(h), this.camera.updateProjectionMatrix(), this.control && (this.control.target.copy(h), this.control.update()), this.onRender();
+      if (w) {
+        if (console.log("🎥 视角切换信息:"), console.log("  - 视角类型:", t), console.log("  - 相机位置:", p), console.log("  - 观察目标:", h), console.log("  - 方向向量:", b), console.log("  - 包围盒尺寸:", n), console.log("  - 包围盒中心:", g.getCenter(new l())), console.log("  - 水平 FOV:", F.radToDeg(m * 2).toFixed(2) + "°"), console.log("  - 垂直 FOV:", F.radToDeg(c * 2).toFixed(2) + "°"), console.log("  - 宽高比:", L.toFixed(4)), console.log("  - 模型宽度:", n.x.toFixed(2)), console.log("  - 模型高度:", n.y.toFixed(2)), console.log("  - 模型深度:", n.z.toFixed(2)), console.log("  - 传入的 scale 参数:", s), t === "top") {
+          const i = n.x * 0.5 / (Math.tan(m) * s), a = n.z * 0.5 / (Math.tan(c) * s);
+          console.log("  - 模型 X 尺寸 (宽度):", n.x.toFixed(2)), console.log("  - 模型 Z 尺寸 (深度):", n.z.toFixed(2)), console.log("  - tan(halfFovX):", Math.tan(m).toFixed(4)), console.log("  - tan(halfFovY):", Math.tan(c).toFixed(4)), console.log("  - X方向距离计算: (", (n.x * 0.5).toFixed(2), ") / (", Math.tan(m).toFixed(4), " *", s, ") =", i.toFixed(2)), console.log("  - Z方向距离计算: (", (n.z * 0.5).toFixed(2), ") / (", Math.tan(c).toFixed(4), " *", s, ") =", a.toFixed(2)), console.log("  - X方向距离 (scale=" + s + "):", i.toFixed(2)), console.log("  - Z方向距离 (scale=" + s + "):", a.toFixed(2));
         } else if (t === "right" || t === "left") {
-          const o = n.y * 0.5 / (Math.tan(l) * s), r = n.z * 0.5 / (Math.tan(l) * s);
-          console.log("  - Y方向距离 (scale=" + s + "):", o.toFixed(2)), console.log("  - Z方向距离 (scale=" + s + "):", r.toFixed(2));
+          const i = n.y * 0.5 / (Math.tan(c) * s), a = n.z * 0.5 / (Math.tan(c) * s);
+          console.log("  - Y方向距离 (scale=" + s + "):", i.toFixed(2)), console.log("  - Z方向距离 (scale=" + s + "):", a.toFixed(2));
         } else {
-          const o = n.x * 0.5 / (Math.tan(m) * s), r = n.y * 0.5 / (Math.tan(l) * s), d = n.z * 0.5 / (Math.tan(l) * s);
-          console.log("  - 模型 X 尺寸 (宽度):", n.x.toFixed(2)), console.log("  - 模型 Y 尺寸 (高度):", n.y.toFixed(2)), console.log("  - 模型 Z 尺寸 (深度):", n.z.toFixed(2)), console.log("  - tan(halfFovX):", Math.tan(m).toFixed(4)), console.log("  - tan(halfFovY):", Math.tan(l).toFixed(4)), console.log("  - X方向距离计算: (", (n.x * 0.5).toFixed(2), ") / (", Math.tan(m).toFixed(4), " *", s, ") =", o.toFixed(2)), console.log("  - Y方向距离计算: (", (n.y * 0.5).toFixed(2), ") / (", Math.tan(l).toFixed(4), " *", s, ") =", r.toFixed(2)), console.log("  - Z方向距离计算: (", (n.z * 0.5).toFixed(2), ") / (", Math.tan(l).toFixed(4), " *", s, ") =", d.toFixed(2)), console.log("  - X方向距离 (scale=" + s + "):", o.toFixed(2)), console.log("  - Y方向距离 (scale=" + s + "):", r.toFixed(2)), console.log("  - Z方向距离 (scale=" + s + "):", d.toFixed(2)), console.log("  - 最大距离 (Max):", Math.max(o, r, d).toFixed(2));
+          const i = n.x * 0.5 / (Math.tan(m) * s), a = n.y * 0.5 / (Math.tan(c) * s), d = n.z * 0.5 / (Math.tan(c) * s);
+          console.log("  - 模型 X 尺寸 (宽度):", n.x.toFixed(2)), console.log("  - 模型 Y 尺寸 (高度):", n.y.toFixed(2)), console.log("  - 模型 Z 尺寸 (深度):", n.z.toFixed(2)), console.log("  - tan(halfFovX):", Math.tan(m).toFixed(4)), console.log("  - tan(halfFovY):", Math.tan(c).toFixed(4)), console.log("  - X方向距离计算: (", (n.x * 0.5).toFixed(2), ") / (", Math.tan(m).toFixed(4), " *", s, ") =", i.toFixed(2)), console.log("  - Y方向距离计算: (", (n.y * 0.5).toFixed(2), ") / (", Math.tan(c).toFixed(4), " *", s, ") =", a.toFixed(2)), console.log("  - Z方向距离计算: (", (n.z * 0.5).toFixed(2), ") / (", Math.tan(c).toFixed(4), " *", s, ") =", d.toFixed(2)), console.log("  - X方向距离 (scale=" + s + "):", i.toFixed(2)), console.log("  - Y方向距离 (scale=" + s + "):", a.toFixed(2)), console.log("  - Z方向距离 (scale=" + s + "):", d.toFixed(2)), console.log("  - 最大距离 (Max):", Math.max(i, a, d).toFixed(2));
         }
-        console.log("  - 最终距离:", f.toFixed(2)), console.log("  - 缩放比例:", s), console.log("  - 动画:", M ? "是 (" + E + "ms)" : "否");
+        console.log("  - 最终距离:", u.toFixed(2)), console.log("  - 缩放比例:", s), console.log("  - 动画:", M ? "是 (" + T + "ms)" : "否");
       }
       return {
         position: p,
-        target: c,
-        distance: f,
+        target: h,
+        distance: u,
         viewType: t
       };
     });
@@ -323,14 +339,32 @@ class J {
      * @param {Function} callback - 回调函数
      * @returns {Function} 返回取消监听的函数
      */
-    i(this, "on", (e, t) => !e || !t || typeof t != "function" ? (console.warn("ThreeIns.on: 无效的参数"), () => {
+    o(this, "on", (e, t) => !e || !t || typeof t != "function" ? (console.warn("ThreeIns.on: 无效的参数"), () => {
     }) : (this.eventsListener[e] || (this.eventsListener[e] = []), this.eventsListener[e].push(t), () => this.off(e, t)));
+    /**
+     * 添加动画回调（推荐使用此方法注册动画回调）
+     * @param {Function} callback - 回调函数
+     * @returns {Function} 返回移除回调的函数
+     */
+    o(this, "addAnimate", (e) => !e || typeof e != "function" ? (console.warn("ThreeIns.addAnimate: 无效的回调函数"), () => {
+    }) : (this.eventsListener.onRender || (this.eventsListener.onRender = []), this.eventsListener.onRender.push(e), () => this.removeAnimate(e)));
+    /**
+     * 移除动画回调
+     * @param {Function} callback - 要移除的回调函数
+     */
+    o(this, "removeAnimate", (e) => {
+      if (!e) return;
+      const t = this.eventsListener.onRender;
+      if (!t) return;
+      const r = t.indexOf(e);
+      r > -1 && t.splice(r, 1);
+    });
     this.isReady = !1, this.scene = new Y({}), this.camera = new B(50, 1, 0.1, 2e3), this.renderer = new Z({
       antialias: !0,
       alpha: !0,
       precision: "mediump",
       logarithmicDepthBuffer: !0
-    }), this.version = N, this.onContextLost = this.onContextLost.bind(this), this.onContextRestored = this.onContextRestored.bind(this), this.onResize = this.onResize.bind(this), this.animate = this.animate.bind(this), this.resizeTimer = null, this.animationFrameId = null, t && (this.initOpt = Object.assign(this.initOpt, t)), e && this.setup(e);
+    }), this.version = _, this.onContextLost = this.onContextLost.bind(this), this.onContextRestored = this.onContextRestored.bind(this), this.onResize = this.onResize.bind(this), this.animate = this.animate.bind(this), this.resizeTimer = null, this.animationFrameId = null, t && (this.initOpt = Object.assign(this.initOpt, t)), e && this.setup(e);
   }
   /**
    * 更新相机 FOV 以适应容器尺寸
@@ -339,7 +373,7 @@ class J {
    * @param {number} domH - 容器高度
    */
   updateCameraFOV(e, t) {
-    const h = this.initOpt.initialFov || 50, s = Math.tan(Math.PI / 180 * h / 2);
+    const r = this.initOpt.initialFov || 50, s = Math.tan(Math.PI / 180 * r / 2);
     this.camera.aspect = e / t, this.camera.fov = 360 / Math.PI * Math.atan(s * (t / e)), this.camera.updateProjectionMatrix();
   }
   /**
@@ -374,7 +408,7 @@ class J {
       this.eventsListener = {};
       return;
     }
-    this.eventsListener[e] && (t ? this.eventsListener[e] = this.eventsListener[e].filter((h) => h !== t) : this.eventsListener[e] = []);
+    this.eventsListener[e] && (t ? this.eventsListener[e] = this.eventsListener[e].filter((r) => r !== t) : this.eventsListener[e] = []);
   }
   /**
    * 清理所有资源
@@ -385,47 +419,56 @@ class J {
 }
 // 存储包围盒辅助器
 // 视角类型枚举（作为类静态属性引用，保持向后兼容）
-i(J, "ViewType", v);
+o(J, "ViewType", v);
 export {
   he as CacheMonitor,
   de as ErrorType,
   me as IDBCache,
-  He as ImageLoader,
+  qe as ImageLoader,
   fe as ModelLoadError,
-  Be as ModelOptimizer,
-  pe as PredictiveLoader,
-  ue as ProgressiveSceneBuilder,
+  Je as ModelOptimizer,
+  ue as PredictiveLoader,
+  pe as ProgressiveSceneBuilder,
   xe as RetryHelper,
   J as ThreeIns,
   v as ViewType,
   ge as cacheMonitor,
-  Fe as createArrowHelper,
-  Re as createAxesHelper,
+  Xe as cancelIdleTask,
+  Fe as clearGeometryCache,
+  Re as clearMaterialCache,
+  we as createArrowHelper,
+  be as createAxesHelper,
   ze as createBox3Helper,
-  be as createCameraHelper,
-  we as createGridHelper,
-  Ae as createInfoPlane,
-  Me as createMapControls,
+  Me as createCameraHelper,
+  Te as createGridHelper,
+  Ye as createInfoPlane,
+  Ee as createMapControls,
   j as createOrbitControl,
-  Ee as createRaycaster,
-  Le as createStats,
-  Pe as createTagPlane,
-  Te as dataToObject3D,
-  Oe as dataToObject3DSync,
+  Le as createRaycaster,
+  Oe as createStats,
+  Be as createTagPlane,
+  Ce as dataToObject3D,
+  ye as dataToObject3DSync,
   X as disposeThreeObject,
-  je as getCommonParent,
-  Ve as getObjectByUserData,
-  qe as getRootObj,
-  Xe as initEnvImage,
+  Ze as getCommonParent,
+  ve as getGeometryCacheStats,
+  Ie as getMaterialCacheStats,
+  Ge as getObjectByUserData,
+  We as getRootObj,
+  _e as initEnvImage,
   oe as intersectColor,
-  Ze as modelOptimizer,
+  Ke as modelOptimizer,
   ie as obbObjects,
-  Ce as object3DToData,
-  ye as object3DToDataSync,
-  ve as predictiveLoader,
-  Se as rebuildScene,
+  Se as object3DToData,
+  De as object3DToDataSync,
+  Ae as object3DToTransferable,
+  He as predictiveLoader,
+  Ne as processInChunks,
+  Pe as rebuildScene,
+  ke as runWhenIdle,
+  Ue as throttle,
   ne as useBatchGLTFLoader,
-  De as useGLTFLoader,
+  je as useGLTFLoader,
   re as useObb,
   ae as useRaycaster,
   le as useThreeJs