@ridp/threejs 1.5.1 → 1.5.2

package/dist/threejs.js

@@ -1,13 +1,13 @@
 var H = Object.defineProperty;
-var A = (g, t, e) => t in g ? H(g, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : g[t] = e;
-var n = (g, t, e) => A(g, typeof t != "symbol" ? t + "" : t, e);
-import { i as se, o as oe, c as ie, b as ne, a as re, u as ae } from "./useBatchGLTFLoader-C1C8R5Ss.js";
-import { d as P, S as j, s as X, j as Y } from "./PredictiveLoader-C9zJlZEQ.js";
-import { C as ce, E as de, I as he, M as me, P as xe, q as fe, R as ge, n as ue, h as pe, g as Fe, b as Re, c as Me, a as ze, e as be, f as Ee, i as Le, l as Oe, m as we, o as Ce, k as ye, p as Te, r as Se, u as De } from "./PredictiveLoader-C9zJlZEQ.js";
-import { I as Ie, c as He, a as Ae, g as Pe, b as je, d as Xe, i as Ye } from "./objectQuery-BfHUGPET.js";
-import { ModelOptimizer as Ze, modelOptimizer as qe } from "./modelOptimizer-D6fRg-DF.js";
-import { MathUtils as R, Scene as V, PerspectiveCamera as Z, WebGLRenderer as q, Box3 as B, Vector3 as l, Box3Helper as _ } from "three";
-const G = "1.5.0", N = 50, W = 20, $ = 20, T = {
+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",
@@ -16,15 +16,15 @@ const G = "1.5.0", N = 50, W = 20, $ = 20, T = {
   // 左侧视
   ISO: "iso"
   // 正斜视（等轴测视角）
-}, k = {
+}, $ = {
   enableDamping: !0,
   dampingFactor: 0.25,
   screenSpacePanning: !1,
   minDistance: 0.1,
   maxDistance: 1e3,
-  maxPolarAngle: R.degToRad(60)
+  maxPolarAngle: F.degToRad(60)
 };
-class U {
+class J {
   /**
    * 构造函数
    * @param {string} selector - DOM 容器选择器
@@ -38,22 +38,22 @@ class U {
    * @param {boolean} [option.control.init=true] - 是否初始化控制器
    * @param {Object} [option.control.options={}] - 控制器选项
    */
-  constructor(t, e) {
-    n(this, "isReady", !1);
-    n(this, "scene", null);
-    n(this, "camera", null);
-    n(this, "renderer", null);
-    n(this, "control", null);
-    n(this, "css3dRenderer", null);
-    n(this, "el", null);
-    n(this, "renderRequested", !1);
-    n(this, "selector", null);
-    n(this, "eventsListener", {});
-    n(this, "stats", null);
-    n(this, "isDispose", !1);
-    n(this, "version", "0.0.0");
-    n(this, "boxHelper", null);
-    n(this, "initOpt", {
+  constructor(e, t) {
+    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,25 +70,25 @@ class U {
      * 初始化场景
      * @param {string} selector - DOM 容器选择器
      */
-    n(this, "setup", (t) => {
-      if (this.isDispose = !1, this.selector = t, this.el = document.querySelector(t), !this.el) {
-        console.error(`ThreeIns: 找不到元素 ${t}`);
+    o(this, "setup", (e) => {
+      if (this.isDispose = !1, this.selector = e, this.el = document.querySelector(e), !this.el) {
+        console.error(`ThreeIns: 找不到元素 ${e}`);
         return;
       }
-      const [e, h] = this.getTargetSize();
-      if (this.updateCameraFOV(e, 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(e, h), this.el.appendChild(this.renderer.domElement), this.initOpt.control && this.initOpt.control.init) {
-        this.control = P(this.camera, this.renderer.domElement);
+      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(
-          k,
+          $,
           this.initOpt.control.options || {}
         );
-        Object.keys(s).forEach((u) => {
-          this.control[u] = s[u];
+        Object.keys(s).forEach((f) => {
+          this.control[f] = s[f];
         });
       }
       setTimeout(() => {
         this.isReady = !0;
-      }, W), this.initOpt.stats && this.initStats(), this.initOpt.css3d && this.initCss3dRenderer(), this.initOpt.renderType === "loop" ? this.animate() : this.initOpt.renderType === "change" && this.control && this.control.addEventListener(
+      }, k), this.initOpt.stats && this.initStats(), this.initOpt.css3d && this.initCss3dRenderer(), this.initOpt.renderType === "loop" ? this.animate() : this.initOpt.renderType === "change" && this.control && this.control.addEventListener(
         "change",
         this.requestRenderIfNotRequested
       ), this.initListener();
@@ -97,22 +97,22 @@ class U {
      * WebGL 上下文丢失处理
      * @param {Event} e - 事件对象
      */
-    n(this, "onContextLost", (t) => {
-      t.preventDefault(), this.animationFrameId && cancelAnimationFrame(this.animationFrameId);
+    o(this, "onContextLost", (e) => {
+      e.preventDefault(), this.animationFrameId && cancelAnimationFrame(this.animationFrameId);
     });
     /**
      * WebGL 上下文恢复处理
      * @param {Event} e - 事件对象
      */
-    n(this, "onContextRestored", (t) => {
-      t.preventDefault(), this.dispose(), setTimeout(() => {
+    o(this, "onContextRestored", (e) => {
+      e.preventDefault(), this.dispose(), setTimeout(() => {
         this.setup(this.selector);
-      }, $);
+      }, U);
     });
     /**
      * 初始化事件监听器
      */
-    n(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 U {
     /**
      * 移除事件监听器
      */
-    n(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 U {
     /**
      * 渲染循环（loop 模式）
      */
-    n(this, "animate", () => {
+    o(this, "animate", () => {
       this.isDispose || (this.initOpt.renderType === "loop" && this.onRender(), this.animationFrameId = requestAnimationFrame(this.animate));
     });
     /**
      * 执行渲染
      */
-    n(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((t) => t()));
+    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，可能存在性能问题`);
+      }
     });
     /**
      * 请求渲染（如果尚未请求）
      */
-    n(this, "requestRenderIfNotRequested", () => {
+    o(this, "requestRenderIfNotRequested", () => {
       this.renderRequested || (this.renderRequested = !0, requestAnimationFrame(() => {
         this.onRender();
       }));
@@ -160,10 +176,10 @@ class U {
     /**
      * 处理窗口大小变化（带防抖）
      */
-    n(this, "onResize", () => {
+    o(this, "onResize", () => {
       this.resizeTimer && clearTimeout(this.resizeTimer), this.resizeTimer = setTimeout(() => {
-        const [t, e] = this.getTargetSize();
-        this.updateCameraFOV(t, e), this.camera.lookAt(this.scene.position), this.renderer.setSize(t, e), this.css3dRenderer && this.css3dRenderer.setSize(t, e), this.onRender();
+        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();
       }, N);
     });
     /**
@@ -181,25 +197,21 @@ class U {
      * @param {number} [scale=0.8] - 缩放比例，1=占满画布，0.5=50%，2.0=200%
      * @returns {Object} 返回 setView 的结果
      */
-    n(this, "frameArea", (t, e) => (console.warn(
+    o(this, "frameArea", (e, t) => (console.warn(
       `[ThreeIns] frameArea() 已弃用，建议使用 setView() 方法。
 旧用法: threeIns.frameArea(model, scale)
 新用法: threeIns.setView(model, ViewType.ISO, { scale })`
-    ), this.setView(t, T.ISO, { scale: e, animate: !1, showBox: !1 })));
+    ), this.setView(e, v.ISO, { scale: t, animate: !1, showBox: !1 })));
     /**
      * 切换到指定视角
      * 根据视角类型自动调整相机位置和朝向，支持缩放比例控制
      *
      * @param {Object3D} model - 3D 物体对象
-     * @param {string|Vector3} viewType - 视角类型，可以使用 ViewType 枚举或自定义 Vector3 方向向量
-     *   - ViewType 枚举：
-     *     - 'top': 俯视（从上往下看 Y 轴正方向）
-     *     - 'right': 侧视（从右往左看 X 轴正方向）
-     *     - 'left': 左侧视（从左往右看 X 轴负方向）
-     *     - 'iso': 正斜视（等轴测视角，45°角）
-     *   - Vector3 自定义方向：
-     *     - 任意方向向量，如 Vector3(1, 1, 1)、Vector3(2, 0, 1)
-     *     - 向量会被自动归一化，相对模型中心的任意角度
+     * @param {string} viewType - 视角类型，使用 ViewType 枚举
+     *                          - 'top': 俯视（从上往下看 Y 轴正方向）
+     *                          - 'right': 侧视（从右往左看 X 轴正方向）
+     *                          - 'left': 左侧视（从左往右看 X 轴负方向）
+     *                          - 'iso': 正斜视（等轴测视角，45°角）
      * @param {Object} [options] - 可选配置
      * @param {number} [options.scale=1] - 缩放比例，控制模型在画布中的占比
      * @param {string|Vector3} [options.position='center'] - 模型在画布中的位置
@@ -219,8 +231,6 @@ class U {
      * // 导入 ViewType 枚举
      * import { ThreeIns, ViewType } from 'threejs';
      *
-     * // ============ 使用预设 ViewType ============
-     *
      * // 切换到俯视，模型占满画布，居中显示
      * threeIns.setView(model, ViewType.TOP);
      *
@@ -250,114 +260,77 @@ class U {
      *   scale: 0.8
      * });
      *
-     * // ============ 使用自定义 Vector3 方向 ============
-     *
-     * // 从对角线方向查看模型（类似等轴测）
-     * threeIns.setView(model, new THREE.Vector3(1, 1, 1));
-     *
-     * // 从右前方查看模型
-     * threeIns.setView(model, new THREE.Vector3(2, 1, 1));
-     *
-     * // 从左侧平视模型
-     * threeIns.setView(model, new THREE.Vector3(0, 0, 1));
-     *
-     * // 从下方仰视模型
-     * threeIns.setView(model, new THREE.Vector3(0, -1, 1));
-     *
-     * // 自定义方向 + 其他选项
-     * threeIns.setView(model, new THREE.Vector3(1, 2, 1), {
-     *   scale: 0.6,
-     *   position: 'center',
-     *   showBox: true,
-     *   animate: true,
-     *   duration: 1500
-     * });
-     *
      * // 或者使用类静态属性（向后兼容）
      * threeIns.setView(model, ThreeIns.ViewType.TOP);
      */
-    n(this, "setView", (t, e, h = {}) => {
-      let s = h.scale || 0.8, u = h.offset || null, M = h.position || "center", z = h.showBox || !1, S = h.boxColor || 16776960, E = h.animate !== void 0 ? h.animate : !0, L = h.duration || 1e3;
-      const p = new B().setFromObject(t);
-      let d = p.getCenter(new l());
-      if (typeof M == "string") {
-        const i = p.getSize(new l()), r = {
+    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 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)
-        }, c = r[M] || r.center;
-        typeof e == "string" ? e === "top" ? d.add(new l(c.x, 0, c.z)) : e === "right" || e === "left" ? d.add(new l(c.x, c.y, c.z)) : d.add(c) : d.add(c);
-      } else M instanceof l && d.add(M);
-      u && d.add(u);
-      const o = p.getSize(new l());
-      let F;
-      if (e instanceof l)
-        F = e.clone().normalize();
-      else {
-        const i = {
-          top: new l(0, 1, 0),
-          // 从上往下：Y 轴正方向
-          right: new l(1, 1, 1).normalize(),
-          // 从右往左：X 轴正方向
-          left: new l(-1, 1, 1).normalize(),
-          // 从左往右：X 轴负方向
-          iso: new l(0, 1, 1).normalize()
-          // 等轴测：从对角线上方俯视
-        };
-        F = i[e] || i.iso;
-      }
-      const O = this.camera.aspect, a = R.degToRad(this.camera.fov * 0.5), D = R.degToRad(80), m = Math.min(Math.atan(Math.tan(a) * O), D);
-      let x;
-      if (e instanceof l) {
-        const i = o.x * 0.5 / (Math.tan(m) * s), r = o.y * 0.5 / (Math.tan(a) * s), c = o.z * 0.5 / (Math.tan(a) * s);
-        x = Math.max(i, r, c);
-      } else if (e === "top") {
-        const i = o.x * 0.5 / (Math.tan(m) * s), r = o.z * 0.5 / (Math.tan(a) * s);
-        x = Math.max(i, r);
-      } else if (e === "right" || e === "left") {
-        const i = o.y * 0.5 / (Math.tan(a) * s), r = o.z * 0.5 / (Math.tan(a) * s);
-        x = Math.max(i, r);
+        }, 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 l(1, 1, 1).normalize(),
+        // 从右往左：X 轴正方向
+        left: new l(-1, 1, 1).normalize(),
+        // 从左往右：X 轴负方向
+        iso: new l(0, 1, 1).normalize()
+        // 等轴测：从对角线上方俯视
+      }, 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 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 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 i = o.x * 0.5 / (Math.tan(m) * s), r = o.y * 0.5 / (Math.tan(a) * s), c = o.z * 0.5 / (Math.tan(a) * s);
-        x = Math.max(i, r, c);
+        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 f = F.clone().multiplyScalar(x).add(d);
-      if (z && (console.log("📍 相机位置验证:"), console.log("  - 方向向量:", F), console.log("  - 距离:", x.toFixed(2)), console.log("  - 包围盒中心:", d), console.log("  - 计算公式: direction * distance + boxCenter"), console.log("  - 目标位置:", f), console.log("  - 实际相机与中心的距离:", f.clone().sub(d).length().toFixed(2))), z ? (this.boxHelper && (this.scene.remove(this.boxHelper), this.boxHelper = null), this.boxHelper = new _(p, S), this.scene.add(this.boxHelper)) : this.boxHelper && (this.scene.remove(this.boxHelper), this.boxHelper = null), E) {
-        const i = this.camera.position.clone(), r = this.control ? this.control.target.clone() : new l(0, 0, 0), c = d, v = Date.now(), w = () => {
-          const I = Date.now() - v, C = Math.min(I / L, 1), y = 1 - Math.pow(1 - C, 3);
-          if (this.camera.position.lerpVectors(i, f, y), this.control) {
-            const b = new l();
-            b.lerpVectors(r, c, y), this.control.target.copy(b), this.camera.lookAt(b);
+      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(d);
-          this.camera.updateProjectionMatrix(), C < 1 ? requestAnimationFrame(w) : (this.camera.position.copy(f), this.camera.lookAt(d), this.camera.updateProjectionMatrix(), this.control && (this.control.target.copy(d), 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());
         };
-        w();
+        O();
       } else
-        this.camera.position.copy(f), this.camera.lookAt(d), this.camera.updateProjectionMatrix(), this.control && (this.control.target.copy(d), this.control.update()), this.onRender();
-      if (z) {
-        if (console.log("🎥 视角切换信息:"), console.log("  - 视角类型:", e instanceof l ? `自定义 Vector3(${e.x.toFixed(2)}, ${e.y.toFixed(2)}, ${e.z.toFixed(2)})` : e), console.log("  - 相机位置:", f), console.log("  - 观察目标:", d), console.log("  - 方向向量:", F), console.log("  - 包围盒尺寸:", o), console.log("  - 包围盒中心:", p.getCenter(new l())), console.log("  - 水平 FOV:", R.radToDeg(m * 2).toFixed(2) + "°"), console.log("  - 垂直 FOV:", R.radToDeg(a * 2).toFixed(2) + "°"), console.log("  - 宽高比:", O.toFixed(4)), console.log("  - 模型宽度:", o.x.toFixed(2)), console.log("  - 模型高度:", o.y.toFixed(2)), console.log("  - 模型深度:", o.z.toFixed(2)), console.log("  - 传入的 scale 参数:", s), e instanceof l) {
-          const i = o.x * 0.5 / (Math.tan(m) * s), r = o.y * 0.5 / (Math.tan(a) * s), c = o.z * 0.5 / (Math.tan(a) * s);
-          console.log("  - 模型 X 尺寸 (宽度):", o.x.toFixed(2)), console.log("  - 模型 Y 尺寸 (高度):", o.y.toFixed(2)), console.log("  - 模型 Z 尺寸 (深度):", o.z.toFixed(2)), console.log("  - tan(halfFovX):", Math.tan(m).toFixed(4)), console.log("  - tan(halfFovY):", Math.tan(a).toFixed(4)), console.log("  - X方向距离计算: (", (o.x * 0.5).toFixed(2), ") / (", Math.tan(m).toFixed(4), " *", s, ") =", i.toFixed(2)), console.log("  - Y方向距离计算: (", (o.y * 0.5).toFixed(2), ") / (", Math.tan(a).toFixed(4), " *", s, ") =", r.toFixed(2)), console.log("  - Z方向距离计算: (", (o.z * 0.5).toFixed(2), ") / (", Math.tan(a).toFixed(4), " *", s, ") =", c.toFixed(2)), console.log("  - X方向距离 (scale=" + s + "):", i.toFixed(2)), console.log("  - Y方向距离 (scale=" + s + "):", r.toFixed(2)), console.log("  - Z方向距离 (scale=" + s + "):", c.toFixed(2)), console.log("  - 最大距离 (Max):", Math.max(i, r, c).toFixed(2));
-        } else if (e === "top") {
-          const i = o.x * 0.5 / (Math.tan(m) * s), r = o.z * 0.5 / (Math.tan(a) * s);
-          console.log("  - 模型 X 尺寸 (宽度):", o.x.toFixed(2)), console.log("  - 模型 Z 尺寸 (深度):", o.z.toFixed(2)), console.log("  - tan(halfFovX):", Math.tan(m).toFixed(4)), console.log("  - tan(halfFovY):", Math.tan(a).toFixed(4)), console.log("  - X方向距离计算: (", (o.x * 0.5).toFixed(2), ") / (", Math.tan(m).toFixed(4), " *", s, ") =", i.toFixed(2)), console.log("  - Z方向距离计算: (", (o.z * 0.5).toFixed(2), ") / (", Math.tan(a).toFixed(4), " *", s, ") =", r.toFixed(2)), console.log("  - X方向距离 (scale=" + s + "):", i.toFixed(2)), console.log("  - Z方向距离 (scale=" + s + "):", r.toFixed(2));
-        } else if (e === "right" || e === "left") {
-          const i = o.y * 0.5 / (Math.tan(a) * s), r = o.z * 0.5 / (Math.tan(a) * s);
-          console.log("  - Y方向距离 (scale=" + s + "):", i.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 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 i = o.x * 0.5 / (Math.tan(m) * s), r = o.y * 0.5 / (Math.tan(a) * s), c = o.z * 0.5 / (Math.tan(a) * s);
-          console.log("  - 模型 X 尺寸 (宽度):", o.x.toFixed(2)), console.log("  - 模型 Y 尺寸 (高度):", o.y.toFixed(2)), console.log("  - 模型 Z 尺寸 (深度):", o.z.toFixed(2)), console.log("  - tan(halfFovX):", Math.tan(m).toFixed(4)), console.log("  - tan(halfFovY):", Math.tan(a).toFixed(4)), console.log("  - X方向距离计算: (", (o.x * 0.5).toFixed(2), ") / (", Math.tan(m).toFixed(4), " *", s, ") =", i.toFixed(2)), console.log("  - Y方向距离计算: (", (o.y * 0.5).toFixed(2), ") / (", Math.tan(a).toFixed(4), " *", s, ") =", r.toFixed(2)), console.log("  - Z方向距离计算: (", (o.z * 0.5).toFixed(2), ") / (", Math.tan(a).toFixed(4), " *", s, ") =", c.toFixed(2)), console.log("  - X方向距离 (scale=" + s + "):", i.toFixed(2)), console.log("  - Y方向距离 (scale=" + s + "):", r.toFixed(2)), console.log("  - Z方向距离 (scale=" + s + "):", c.toFixed(2)), console.log("  - 最大距离 (Max):", Math.max(i, r, c).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("  - 最终距离:", x.toFixed(2)), console.log("  - 缩放比例:", s), console.log("  - 动画:", E ? "是 (" + L + "ms)" : "否");
+        console.log("  - 最终距离:", u.toFixed(2)), console.log("  - 缩放比例:", s), console.log("  - 动画:", M ? "是 (" + T + "ms)" : "否");
       }
       return {
-        position: f,
-        target: d,
-        distance: x,
-        viewType: e
+        position: p,
+        target: h,
+        distance: u,
+        viewType: t
       };
     });
     /**
@@ -366,14 +339,32 @@ class U {
      * @param {Function} callback - 回调函数
      * @returns {Function} 返回取消监听的函数
      */
-    n(this, "on", (t, e) => !t || !e || typeof e != "function" ? (console.warn("ThreeIns.on: 无效的参数"), () => {
-    }) : (this.eventsListener[t] || (this.eventsListener[t] = []), this.eventsListener[t].push(e), () => this.off(t, e)));
-    this.isReady = !1, this.scene = new V({}), this.camera = new Z(50, 1, 0.1, 2e3), this.renderer = new q({
+    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 = G, 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, e && (this.initOpt = Object.assign(this.initOpt, e)), t && this.setup(t);
+    }), 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 以适应容器尺寸
@@ -381,23 +372,23 @@ class U {
    * @param {number} domW - 容器宽度
    * @param {number} domH - 容器高度
    */
-  updateCameraFOV(t, e) {
-    const h = this.initOpt.initialFov || 50, s = Math.tan(Math.PI / 180 * h / 2);
-    this.camera.aspect = t / e, this.camera.fov = 360 / Math.PI * Math.atan(s * (e / t)), this.camera.updateProjectionMatrix();
+  updateCameraFOV(e, t) {
+    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();
   }
   /**
    * 初始化性能统计
    */
   initStats() {
-    this.stats = new j(), this.stats.dom.style.cssText = "position:absolute;top:0;left:0;cursor:pointer;opacity:0.9;z-index:10000", this.el.appendChild(this.stats.dom);
+    this.stats = new V(), this.stats.dom.style.cssText = "position:absolute;top:0;left:0;cursor:pointer;opacity:0.9;z-index:10000", this.el.appendChild(this.stats.dom);
   }
   /**
    * 初始化 CSS3D 渲染器
    */
   initCss3dRenderer() {
-    this.css3dRenderer = new X();
-    const [t, e] = this.getTargetSize();
-    this.css3dRenderer.setSize(t, e), this.css3dRenderer.domElement.style.position = "absolute", this.css3dRenderer.domElement.style.pointerEvents = "none", this.css3dRenderer.domElement.style.top = 0, this.css3dRenderer.domElement.style.left = 0, this.el.appendChild(this.css3dRenderer.domElement);
+    this.css3dRenderer = new q();
+    const [e, t] = this.getTargetSize();
+    this.css3dRenderer.setSize(e, t), this.css3dRenderer.domElement.style.position = "absolute", this.css3dRenderer.domElement.style.pointerEvents = "none", this.css3dRenderer.domElement.style.top = 0, this.css3dRenderer.domElement.style.left = 0, this.el.appendChild(this.css3dRenderer.domElement);
   }
   /**
    * 获取目标容器尺寸
@@ -412,64 +403,73 @@ class U {
    * @param {string} event - 事件名称
    * @param {Function} [callback] - 可选的回调函数，如果不提供则移除该事件的所有监听器
    */
-  off(t, e) {
-    if (!t) {
+  off(e, t) {
+    if (!e) {
       this.eventsListener = {};
       return;
     }
-    this.eventsListener[t] && (e ? this.eventsListener[t] = this.eventsListener[t].filter((h) => h !== e) : this.eventsListener[t] = []);
+    this.eventsListener[e] && (t ? this.eventsListener[e] = this.eventsListener[e].filter((r) => r !== t) : this.eventsListener[e] = []);
   }
   /**
    * 清理所有资源
    */
   dispose() {
-    this.isDispose || (this.isDispose = !0, this.animationFrameId && (cancelAnimationFrame(this.animationFrameId), this.animationFrameId = null), this.resizeTimer && (clearTimeout(this.resizeTimer), this.resizeTimer = null), this.removeListener(), this.eventsListener = {}, this.stats && this.stats.dom && (this.stats.dom.remove(), this.stats = null), this.css3dRenderer && (this.css3dRenderer.domElement.remove(), this.css3dRenderer = null), this.boxHelper && (this.scene.remove(this.boxHelper), this.boxHelper = null), this.scene && (Y(this.scene), this.scene = null), this.renderer && (this.renderer.dispose(), this.renderer.domElement && this.renderer.domElement.remove(), this.renderer = null), this.control && (this.control.dispose(), this.control = null), this.camera = null, this.el = null, this.selector = null, console.log("ThreeIns: 资源已清理完成"));
+    this.isDispose || (this.isDispose = !0, this.animationFrameId && (cancelAnimationFrame(this.animationFrameId), this.animationFrameId = null), this.resizeTimer && (clearTimeout(this.resizeTimer), this.resizeTimer = null), this.removeListener(), this.eventsListener = {}, this.stats && this.stats.dom && (this.stats.dom.remove(), this.stats = null), this.css3dRenderer && (this.css3dRenderer.domElement.remove(), this.css3dRenderer = null), this.boxHelper && (this.scene.remove(this.boxHelper), this.boxHelper = null), this.scene && (X(this.scene), this.scene = null), this.renderer && (this.renderer.dispose(), this.renderer.domElement && this.renderer.domElement.remove(), this.renderer = null), this.control && (this.control.dispose(), this.control = null), this.camera = null, this.el = null, this.selector = null, console.log("ThreeIns: 资源已清理完成"));
   }
 }
 // 存储包围盒辅助器
 // 视角类型枚举（作为类静态属性引用，保持向后兼容）
-n(U, "ViewType", T);
+o(J, "ViewType", v);
 export {
-  ce as CacheMonitor,
+  he as CacheMonitor,
   de as ErrorType,
-  he as IDBCache,
-  Ie as ImageLoader,
-  me as ModelLoadError,
-  Ze as ModelOptimizer,
-  xe as PredictiveLoader,
-  fe as ProgressiveSceneBuilder,
-  ge as RetryHelper,
-  U as ThreeIns,
-  T as ViewType,
-  ue as cacheMonitor,
-  pe as createArrowHelper,
-  Fe as createAxesHelper,
-  Re as createBox3Helper,
+  me as IDBCache,
+  qe as ImageLoader,
+  fe as ModelLoadError,
+  Je as ModelOptimizer,
+  ue as PredictiveLoader,
+  pe as ProgressiveSceneBuilder,
+  xe as RetryHelper,
+  J as ThreeIns,
+  v as ViewType,
+  ge as cacheMonitor,
+  Xe as cancelIdleTask,
+  Fe as clearGeometryCache,
+  Re as clearMaterialCache,
+  we as createArrowHelper,
+  be as createAxesHelper,
+  ze as createBox3Helper,
   Me as createCameraHelper,
-  ze as createGridHelper,
-  He as createInfoPlane,
-  be as createMapControls,
-  P as createOrbitControl,
-  Ee as createRaycaster,
-  Le as createStats,
-  Ae as createTagPlane,
-  Oe as dataToObject3D,
-  we as dataToObject3DSync,
-  Y as disposeThreeObject,
-  Pe as getCommonParent,
-  je as getObjectByUserData,
-  Xe as getRootObj,
-  Ye as initEnvImage,
-  se as intersectColor,
-  qe as modelOptimizer,
-  oe as obbObjects,
-  Ce as object3DToData,
-  ye as object3DToDataSync,
-  Te as predictiveLoader,
-  Se as rebuildScene,
-  ie as useBatchGLTFLoader,
-  De as useGLTFLoader,
-  ne as useObb,
-  re as useRaycaster,
-  ae as useThreeJs
+  Te as createGridHelper,
+  Ye as createInfoPlane,
+  Ee as createMapControls,
+  j as createOrbitControl,
+  Le as createRaycaster,
+  Oe as createStats,
+  Be as createTagPlane,
+  Ce as dataToObject3D,
+  ye as dataToObject3DSync,
+  X as disposeThreeObject,
+  Ze as getCommonParent,
+  ve as getGeometryCacheStats,
+  Ie as getMaterialCacheStats,
+  Ge as getObjectByUserData,
+  We as getRootObj,
+  _e as initEnvImage,
+  oe as intersectColor,
+  Ke as modelOptimizer,
+  ie as obbObjects,
+  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,
+  je as useGLTFLoader,
+  re as useObb,
+  ae as useRaycaster,
+  le as useThreeJs
 };