@ridp/threejs 1.3.2 → 1.4.0

package/dist/threejs.js

@@ -1,74 +1,119 @@
-var R = Object.defineProperty;
-var g = (a, e, s) => e in a ? R(a, e, { enumerable: !0, configurable: !0, writable: !0, value: s }) : a[e] = s;
-var t = (a, e, s) => g(a, typeof e != "symbol" ? e + "" : e, s);
-import { I as M, i as q, o as F, c as I, b as k, a as H, u as W } from "./useGLTFLoader-C73cebsn.js";
-import { d as x, C as v, j as b } from "./modelSerialize-BybDeWER.js";
-import { I as V, h as _, g as G, b as N, c as J, a as U, e as Y, f as K, i as Q, m as X, n as Z, k as $, o as ee, l as te } from "./modelSerialize-BybDeWER.js";
-import { c as ie, a as ne, g as re } from "./common-C8KE_lHC.js";
-import { MathUtils as m, Scene as L, PerspectiveCamera as O, WebGLRenderer as y, Box3 as S, Vector3 as c } from "three";
-const z = "1.3.1", T = {
+var H = Object.defineProperty;
+var A = (p, e, t) => e in p ? H(p, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : p[e] = t;
+var o = (p, e, t) => A(p, typeof e != "symbol" ? e + "" : e, t);
+import { i as se, o as oe, c as ie, b as ne, a as re, u as ae } from "./useBatchGLTFLoader-Dg-xau9i.js";
+import { d as P, S as j, s as V, j as q } from "./PredictiveLoader--_3bEnce.js";
+import { C as ce, E as he, I as de, M as me, P as ue, q as fe, R as pe, n as xe, h as ge, g as Fe, b as Re, c as Me, a as Ee, e as Te, f as be, i as ze, l as we, m as Le, o as ve, k as Oe, p as Ce, r as ye, u as Se } from "./PredictiveLoader--_3bEnce.js";
+import { I as Ie, c as He, a as Ae, g as Pe, i as je } from "./ImageLoader-DXx88iwh.js";
+import { ModelOptimizer as qe, modelOptimizer as Xe } from "./modelOptimizer-BRPnM2RH.js";
+import { MathUtils as g, Scene as X, PerspectiveCamera as Y, WebGLRenderer as B, Box3 as Z, Vector3 as d, Box3Helper as _ } from "three";
+const G = "1.4.0", N = 50, W = 20, k = 20, C = {
+  TOP: "top",
+  // 俯视（从上往下）
+  RIGHT: "right",
+  // 侧视（从右往左）
+  LEFT: "left",
+  // 左侧视
+  ISO: "iso"
+  // 正斜视（等轴测视角）
+}, U = {
   enableDamping: !0,
   dampingFactor: 0.25,
   screenSpacePanning: !1,
   minDistance: 0.1,
   maxDistance: 1e3,
-  maxPolarAngle: m.degToRad(60)
+  maxPolarAngle: g.degToRad(60)
 };
-class l {
-  constructor(e, s) {
-    t(this, "isReady", !1);
-    t(this, "scene", null);
-    t(this, "camera", null);
-    t(this, "renderer", null);
-    t(this, "control", null);
-    t(this, "css3dRenderer", null);
-    t(this, "el", null);
-    t(this, "renderRequested", !1);
-    t(this, "selector", null);
-    t(this, "eventsListener", {});
-    t(this, "stats", null);
-    t(this, "isDispose", !1);
-    t(this, "version", "0.0.0");
-    t(this, "initOpt", {
+class $ {
+  /**
+   * 构造函数
+   * @param {string} selector - DOM 容器选择器
+   * @param {Object} option - 配置选项
+   * @param {boolean} [option.css3d=false] - 是否启用 CSS3D 渲染器
+   * @param {boolean} [option.stats=false] - 是否显示性能统计
+   * @param {string} [option.renderType='change'] - 渲染类型: 'loop' 或 'change'
+   * @param {boolean} [option.initListener=true] - 是否初始化事件监听器
+   * @param {number} [option.initialFov=50] - 初始相机 FOV 值
+   * @param {Object} [option.control] - 控制器配置
+   * @param {boolean} [option.control.init=true] - 是否初始化控制器
+   * @param {Object} [option.control.options={}] - 控制器选项
+   */
+  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",
-      initListener: "True",
+      initListener: !0,
+      // 使用布尔值代替字符串
+      initialFov: 50,
+      // 初始 FOV 值，用于避免全屏切换时的累积误差
       control: {
         init: !0,
         options: {}
       }
     });
-    t(this, "setup", (e) => {
-      this.isDispose = !1, this.selector = e, this.el = document.querySelector(e);
-      const s = Math.tan(Math.PI / 180 * this.camera.fov / 2), [i, r] = this.getTargetSize();
-      if (this.camera.aspect = i / r, this.camera.position.set(47, 39, 100), this.camera.fov = 360 / Math.PI * Math.atan(s * (r / i)), this.camera.lookAt(0, 0, 0), this.camera.updateProjectionMatrix(), this.renderer.setPixelRatio(window.devicePixelRatio), this.renderer.setSize(i, r), this.el.appendChild(this.renderer.domElement), this.initOpt.control && this.initOpt.control.init) {
-        this.control = x(this.camera, this.renderer.domElement);
-        const d = Object.assign(
-          T,
+    /**
+     * 初始化场景
+     * @param {string} selector - DOM 容器选择器
+     */
+    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, l] = this.getTargetSize();
+      if (this.updateCameraFOV(t, l), 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, l), this.el.appendChild(this.renderer.domElement), this.initOpt.control && this.initOpt.control.init) {
+        this.control = P(this.camera, this.renderer.domElement);
+        const s = Object.assign(
+          U,
           this.initOpt.control.options || {}
         );
-        Object.keys(d).forEach((n) => {
-          this.control[n] = d[n];
+        Object.keys(s).forEach((x) => {
+          this.control[x] = s[x];
         });
       }
       setTimeout(() => {
         this.isReady = !0;
-      }, 20), this.initOpt.stats && this.initStats(), this.initOpt.css3d && this.initCss3dRenderer(), this.initOpt.renderType === "loop" ? requestAnimationFrame(this.animate) : this.initOpt.renderType === "change" && this.control && this.control.addEventListener(
+      }, 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(
         "change",
         this.requestRenderIfNotRequested
       ), this.initListener();
     });
-    t(this, "onContextLost", (e) => {
-      e.preventDefault(), cancelAnimationFrame(this.animate);
+    /**
+     * WebGL 上下文丢失处理
+     * @param {Event} e - 事件对象
+     */
+    o(this, "onContextLost", (e) => {
+      e.preventDefault(), this.animationFrameId && cancelAnimationFrame(this.animationFrameId);
     });
-    t(this, "onContextRestored", (e) => {
+    /**
+     * WebGL 上下文恢复处理
+     * @param {Event} e - 事件对象
+     */
+    o(this, "onContextRestored", (e) => {
       e.preventDefault(), this.dispose(), setTimeout(() => {
         this.setup(this.selector);
-      }, 20);
+      }, k);
     });
-    t(this, "initListener", () => {
-      this.initOpt.initListener == "True" && window && window.addEventListener("resize", () => this.onResize(), !1), this.renderer.domElement.addEventListener(
+    /**
+     * 初始化事件监听器
+     */
+    o(this, "initListener", () => {
+      this.initOpt.initListener && window && window.addEventListener("resize", this.onResize, !1), this.renderer.domElement.addEventListener(
         "webglcontextlost",
         this.onContextLost,
         !1
@@ -78,113 +123,284 @@ class l {
         !1
       );
     });
-    t(this, "removeListener", () => {
-      window && window.removeEventListener("resize", this.onResize, !1), this.renderer.domElement.removeEventListener(
+    /**
+     * 移除事件监听器
+     */
+    o(this, "removeListener", () => {
+      window && window.removeEventListener("resize", this.onResize, !1), this.renderer && this.renderer.domElement && (this.renderer.domElement.removeEventListener(
         "webglcontextlost",
-        this.onContextLost.bind(l),
+        this.onContextLost,
         !1
       ), this.renderer.domElement.removeEventListener(
         "webglcontextrestored",
-        this.onContextRestored.bind(l),
+        this.onContextRestored,
         !1
-      );
+      ));
     });
-    t(this, "animate", () => {
-      this.initOpt.renderType === "loop" && this.onRender(), requestAnimationFrame(this.animate);
+    /**
+     * 渲染循环（loop 模式）
+     */
+    o(this, "animate", () => {
+      this.isDispose || (this.initOpt.renderType === "loop" && this.onRender(), this.animationFrameId = requestAnimationFrame(this.animate));
     });
-    t(this, "onRender", () => {
+    /**
+     * 执行渲染
+     */
+    o(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()));
     });
-    t(this, "requestRenderIfNotRequested", () => {
+    /**
+     * 请求渲染（如果尚未请求）
+     */
+    o(this, "requestRenderIfNotRequested", () => {
       this.renderRequested || (this.renderRequested = !0, requestAnimationFrame(() => {
         this.onRender();
       }));
     });
-    t(this, "onResize", () => {
-      setTimeout(() => {
-        const e = Math.tan(Math.PI / 180 * this.camera.fov / 2), [s, i] = this.getTargetSize();
-        this.camera.aspect = s / i, this.camera.fov = 360 / Math.PI * Math.atan(e * (i / s)), this.camera.updateProjectionMatrix(), this.camera.lookAt(this.scene.position), this.renderer.setSize(s, i), this.css3dRenderer && this.css3dRenderer.setSize(s, i), this.onRender();
-      }, 0);
+    /**
+     * 处理窗口大小变化（带防抖）
+     */
+    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();
+      }, N);
     });
-    /**物体视窗自动适应
+    /**
+     * @deprecated 此方法已弃用，请使用 setView() 方法代替
+     *
+     * frameArea 仅为兼容旧版本保留，功能已被 setView() 完全覆盖
      *
-     * @param {Object3D} model
-     * @param {Number} scale
-     * @param {Vector3} offset
+     * 旧用法:
+     *   threeIns.frameArea(model, 1.0)
+     *
+     * 推荐用法:
+     *   threeIns.setView(model, ViewType.ISO, { scale: 1.0 })
+     *
+     * @param {Object3D} model - 要调整视角的 3D 模型对象
+     * @param {number} [scale=0.8] - 缩放比例，1=占满画布，0.5=50%，2.0=200%
+     * @returns {Object} 返回 setView 的结果
      */
-    t(this, "frameArea", (e, s, i) => {
-      const r = new S().setFromObject(e), d = r.getSize(new c()).length(), n = r.getCenter(new c());
-      i && n.add(i);
-      const p = d * s * 0.5, u = m.degToRad(this.camera.fov * 0.5), f = p / Math.tan(u), h = new c().subVectors(this.camera.position, n).multiply(new c(1, 1, 1)).normalize().multiplyScalar(f).add(n), o = {
-        x: h.x,
-        y: h.y,
-        z: h.z,
-        lookAt_x: n.x,
-        lookAt_y: n.y,
-        lookAt_z: n.z
+    o(this, "frameArea", (e, t) => (console.warn(
+      `[ThreeIns] frameArea() 已弃用，建议使用 setView() 方法。
+旧用法: threeIns.frameArea(model, scale)
+新用法: threeIns.setView(model, ViewType.ISO, { scale })`
+    ), this.setView(e, C.ISO, { scale: t, animate: !1, showBox: !1 })));
+    /**
+     * 切换到指定视角
+     * 根据视角类型自动调整相机位置和朝向，支持缩放比例控制
+     *
+     * @param {Object3D} model - 3D 物体对象
+     * @param {string} viewType - 视角类型，使用 ViewType 枚举
+     *                          - 'top': 俯视（从上往下看 Y 轴正方向）
+     *                          - 'right': 侧视（从右往左看 X 轴正方向）
+     *                          - 'left': 左侧视（从左往右看 X 轴负方向）
+     *                          - 'iso': 正斜视（等轴测视角，45°角）
+     * @param {Object} [options] - 可选配置
+     * @param {number} [options.scale=1] - 缩放比例，控制模型在画布中的占比
+     * @param {Vector3} [options.offset] - 偏移量，调整观察中心点
+     * @param {boolean} [options.showBox=false] - 是否显示包围盒辅助线
+     * @param {number} [options.boxColor=0xffff00] - 包围盒颜色
+     * @param {boolean} [options.animate=true] - 是否使用动画过渡
+     * @param {number} [options.duration=1000] - 动画持续时间（毫秒）
+     * @returns {Object} 返回相机位置和模型信息
+     * @returns {Vector3} return.position - 相机位置
+     * @returns {Vector3} return.target - 相机观察目标点
+     * @returns {number} return.distance - 相机到模型的距离
+     *
+     * @example
+     * // 导入 ViewType 枚举
+     * import { ThreeIns, ViewType } from 'threejs';
+     *
+     * // 切换到俯视，模型占满画布
+     * threeIns.setView(model, ViewType.TOP);
+     *
+     * // 切换到等轴测，模型占画布的 80%
+     * threeIns.setView(model, ViewType.ISO, { scale: 0.8 });
+     *
+     * // 切换到斜视，显示包围盒，无动画
+     * threeIns.setView(model, ViewType.ISO, {
+     *   showBox: true,
+     *   animate: false
+     * });
+     *
+     * // 切换到侧视，自定义观察点
+     * threeIns.setView(model, ViewType.RIGHT, {
+     *   offset: new THREE.Vector3(0, 10, 0),
+     *   scale: 0.8
+     * });
+     *
+     * // 或者使用类静态属性（向后兼容）
+     * threeIns.setView(model, ThreeIns.ViewType.TOP);
+     */
+    o(this, "setView", (e, t, l = {}) => {
+      let s = l.scale || 0.8, x = l.offset || null, R = l.showBox || !1, y = l.boxColor || 16776960, T = l.animate !== void 0 ? l.animate : !0, b = l.duration || 1e3;
+      const F = new Z().setFromObject(e);
+      let c = F.getCenter(new d());
+      x && c.add(x);
+      const z = {
+        top: new d(0, 1, 0),
+        // 从上往下：Y 轴正方向
+        right: new d(2, 1, 1).normalize(),
+        // 从右往左：X 轴正方向
+        left: new d(-2, 1, 1).normalize(),
+        // 从左往右：X 轴负方向
+        iso: new d(0, 1, 1).normalize()
+        // 等轴测：从对角线上方俯视
+      }, M = z[t] || z.iso, i = F.getSize(new d()), w = this.camera.aspect, n = g.degToRad(this.camera.fov * 0.5), S = g.degToRad(80), h = Math.min(Math.atan(Math.tan(n) * w), S);
+      let m;
+      if (t === "top") {
+        const r = i.x * 0.5 / (Math.tan(h) * s), a = i.z * 0.5 / (Math.tan(n) * s);
+        m = Math.max(r, a);
+      } else if (t === "right" || t === "left") {
+        const r = i.y * 0.5 / (Math.tan(n) * s), a = i.z * 0.5 / (Math.tan(n) * s);
+        m = Math.max(r, a);
+      } else {
+        const r = i.x * 0.5 / (Math.tan(h) * s), a = i.y * 0.5 / (Math.tan(n) * s), f = i.z * 0.5 / (Math.tan(n) * s);
+        m = Math.max(r, a, f);
+      }
+      const u = M.clone().multiplyScalar(m).add(c);
+      if (R && (console.log("📍 相机位置验证:"), console.log("  - 方向向量:", M), console.log("  - 距离:", m.toFixed(2)), console.log("  - 包围盒中心:", c), console.log("  - 计算公式: direction * distance + boxCenter"), console.log("  - 目标位置:", u), console.log("  - 实际相机与中心的距离:", u.clone().sub(c).length().toFixed(2))), R ? (this.boxHelper && (this.scene.remove(this.boxHelper), this.boxHelper = null), this.boxHelper = new _(F, y), this.scene.add(this.boxHelper)) : this.boxHelper && (this.scene.remove(this.boxHelper), this.boxHelper = null), T) {
+        const r = this.camera.position.clone(), a = this.control ? this.control.target.clone() : new d(0, 0, 0), f = c, D = Date.now(), L = () => {
+          const I = Date.now() - D, v = Math.min(I / b, 1), O = 1 - Math.pow(1 - v, 3);
+          if (this.camera.position.lerpVectors(r, u, O), this.control) {
+            const E = new d();
+            E.lerpVectors(a, f, O), this.control.target.copy(E), this.camera.lookAt(E);
+          } else
+            this.camera.lookAt(c);
+          this.camera.updateProjectionMatrix(), v < 1 ? requestAnimationFrame(L) : (this.camera.position.copy(u), this.camera.lookAt(c), this.camera.updateProjectionMatrix(), this.control && (this.control.target.copy(c), this.control.update()), this.onRender());
+        };
+        L();
+      } else
+        this.camera.position.copy(u), this.camera.lookAt(c), this.camera.updateProjectionMatrix(), this.control && (this.control.target.copy(c), this.control.update()), this.onRender();
+      if (R) {
+        if (console.log("🎥 视角切换信息:"), console.log("  - 视角类型:", t), console.log("  - 相机位置:", u), console.log("  - 观察目标:", c), console.log("  - 方向向量:", M), console.log("  - 包围盒尺寸:", i), console.log("  - 包围盒中心:", F.getCenter(new d())), console.log("  - 水平 FOV:", g.radToDeg(h * 2).toFixed(2) + "°"), console.log("  - 垂直 FOV:", g.radToDeg(n * 2).toFixed(2) + "°"), console.log("  - 宽高比:", w.toFixed(4)), console.log("  - 模型宽度:", i.x.toFixed(2)), console.log("  - 模型高度:", i.y.toFixed(2)), console.log("  - 模型深度:", i.z.toFixed(2)), console.log("  - 传入的 scale 参数:", s), t === "top") {
+          const r = i.x * 0.5 / (Math.tan(h) * s), a = i.z * 0.5 / (Math.tan(n) * s);
+          console.log("  - 模型 X 尺寸 (宽度):", i.x.toFixed(2)), console.log("  - 模型 Z 尺寸 (深度):", i.z.toFixed(2)), console.log("  - tan(halfFovX):", Math.tan(h).toFixed(4)), console.log("  - tan(halfFovY):", Math.tan(n).toFixed(4)), console.log("  - X方向距离计算: (", (i.x * 0.5).toFixed(2), ") / (", Math.tan(h).toFixed(4), " *", s, ") =", r.toFixed(2)), console.log("  - Z方向距离计算: (", (i.z * 0.5).toFixed(2), ") / (", Math.tan(n).toFixed(4), " *", s, ") =", a.toFixed(2)), console.log("  - X方向距离 (scale=" + s + "):", r.toFixed(2)), console.log("  - Z方向距离 (scale=" + s + "):", a.toFixed(2));
+        } else if (t === "right" || t === "left") {
+          const r = i.y * 0.5 / (Math.tan(n) * s), a = i.z * 0.5 / (Math.tan(n) * s);
+          console.log("  - Y方向距离 (scale=" + s + "):", r.toFixed(2)), console.log("  - Z方向距离 (scale=" + s + "):", a.toFixed(2));
+        } else {
+          const r = i.x * 0.5 / (Math.tan(h) * s), a = i.y * 0.5 / (Math.tan(n) * s), f = i.z * 0.5 / (Math.tan(n) * s);
+          console.log("  - 模型 X 尺寸 (宽度):", i.x.toFixed(2)), console.log("  - 模型 Y 尺寸 (高度):", i.y.toFixed(2)), console.log("  - 模型 Z 尺寸 (深度):", i.z.toFixed(2)), console.log("  - tan(halfFovX):", Math.tan(h).toFixed(4)), console.log("  - tan(halfFovY):", Math.tan(n).toFixed(4)), console.log("  - X方向距离计算: (", (i.x * 0.5).toFixed(2), ") / (", Math.tan(h).toFixed(4), " *", s, ") =", r.toFixed(2)), console.log("  - Y方向距离计算: (", (i.y * 0.5).toFixed(2), ") / (", Math.tan(n).toFixed(4), " *", s, ") =", a.toFixed(2)), console.log("  - Z方向距离计算: (", (i.z * 0.5).toFixed(2), ") / (", Math.tan(n).toFixed(4), " *", s, ") =", f.toFixed(2)), console.log("  - X方向距离 (scale=" + s + "):", r.toFixed(2)), console.log("  - Y方向距离 (scale=" + s + "):", a.toFixed(2)), console.log("  - Z方向距离 (scale=" + s + "):", f.toFixed(2)), console.log("  - 最大距离 (Max):", Math.max(r, a, f).toFixed(2));
+        }
+        console.log("  - 最终距离:", m.toFixed(2)), console.log("  - 缩放比例:", s), console.log("  - 动画:", T ? "是 (" + b + "ms)" : "否");
+      }
+      return {
+        position: u,
+        target: c,
+        distance: m,
+        viewType: t
       };
-      return this.camera.position.set(o.x, o.y, o.z), this.camera.lookAt(
-        o.lookAt_x,
-        o.lookAt_y,
-        o.lookAt_z
-      ), this.camera.updateProjectionMatrix(), this.control.target.copy(n), this.control.update(), d;
     });
-    t(this, "on", (e, s) => {
-      !e || !s || (this.eventsListener[e] || (this.eventsListener[e] = []), this.eventsListener[e].push(s));
-    });
-    this.isReady = !1, this.scene = new L({}), this.camera = new O(50, 1, 0.1, 2e3), this.renderer = new y({
+    /**
+     * 注册事件监听器
+     * @param {string} event - 事件名称
+     * @param {Function} callback - 回调函数
+     * @returns {Function} 返回取消监听的函数
+     */
+    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)));
+    this.isReady = !1, this.scene = new X({}), this.camera = new Y(50, 1, 0.1, 2e3), this.renderer = new B({
       antialias: !0,
       alpha: !0,
       precision: "mediump",
       logarithmicDepthBuffer: !0
-    }), this.version = z, s && (this.initOpt = Object.assign(this.initOpt, s)), e && this.setup(e);
+    }), 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, t && (this.initOpt = Object.assign(this.initOpt, t)), e && this.setup(e);
+  }
+  /**
+   * 更新相机 FOV 以适应容器尺寸
+   * @private
+   * @param {number} domW - 容器宽度
+   * @param {number} domH - 容器高度
+   */
+  updateCameraFOV(e, t) {
+    const l = this.initOpt.initialFov || 50, s = Math.tan(Math.PI / 180 * l / 2);
+    this.camera.aspect = e / t, this.camera.fov = 360 / Math.PI * Math.atan(s * (t / e)), this.camera.updateProjectionMatrix();
   }
+  /**
+   * 初始化性能统计
+   */
   initStats() {
-    const e = new Stats();
-    e.dom.style.cssText = "position:absolute;top:0;left:0;cursor:pointer;opacity:0.9;z-index:10000", this.el.appendChild(e.dom);
+    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);
   }
+  /**
+   * 初始化 CSS3D 渲染器
+   */
   initCss3dRenderer() {
-    this.css3dRenderer = new v();
-    const [e, s] = this.getTargetSize();
-    this.css3dRenderer.setSize(e, s), 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 V();
+    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);
   }
+  /**
+   * 获取目标容器尺寸
+   * 使用智能缓存策略：全屏时使用窗口尺寸，非全屏时使用元素尺寸
+   * @returns {[number, number]} [width, height]
+   */
   getTargetSize() {
-    const e = document.querySelector(this.selector);
-    return e ? [e.clientWidth, e.clientHeight] : [0, 0];
+    return document.fullscreenElement || document.webkitFullscreenElement || document.mozFullScreenElement || document.msFullscreenElement ? [window.innerWidth, window.innerHeight] : this.el ? !document.body.contains(this.el) && (console.warn(`ThreeIns: 缓存的元素已失效，重新查询 ${this.selector}`), this.el = document.querySelector(this.selector), !this.el) ? [0, 0] : [this.el.clientWidth, this.el.clientHeight] : [0, 0];
   }
-  off(e) {
-    e || (this.eventsListener = {}), this.eventsListener[e] && (this.eventsListener[e] = []);
+  /**
+   * 移除事件监听器
+   * @param {string} event - 事件名称
+   * @param {Function} [callback] - 可选的回调函数，如果不提供则移除该事件的所有监听器
+   */
+  off(e, t) {
+    if (!e) {
+      this.eventsListener = {};
+      return;
+    }
+    this.eventsListener[e] && (t ? this.eventsListener[e] = this.eventsListener[e].filter((l) => l !== t) : this.eventsListener[e] = []);
   }
+  /**
+   * 清理所有资源
+   */
   dispose() {
-    this.isDispose = !0, this.removeListener(), b(this.scene), this.renderer.dispose(), this.renderer.domElement.remove(), this.el = null, this.renderer = null, this.camera = null, this.scene = null, this.control = null, this.css3dRenderer = null;
+    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 && (q(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: 资源已清理完成"));
   }
 }
+// 存储包围盒辅助器
+// 视角类型枚举（作为类静态属性引用，保持向后兼容）
+o($, "ViewType", C);
 export {
-  M as IDBCache,
-  V as ImageLoader,
-  l as ThreeIns,
-  _ as createArrowHelper,
-  G as createAxesHelper,
-  N as createBox3Helper,
-  J as createCameraHelper,
-  U as createGridHelper,
-  ie as createInfoPlane,
-  Y as createMapControls,
-  x as createOrbitControl,
-  K as createRaycaster,
-  Q as createStats,
-  ne as createTagPlane,
-  X as dataToObject3D,
-  Z as dataToObject3DSync,
-  b as disposeThreeObject,
-  re as getCommonParent,
-  $ as initEnvImage,
-  q as intersectColor,
-  F as obbObjects,
-  ee as object3DToData,
-  te as object3DToDataSync,
-  I as useGLTFLoader,
-  k as useObb,
-  H as useRaycaster,
-  W as useThreeJs
+  ce as CacheMonitor,
+  he as ErrorType,
+  de as IDBCache,
+  Ie as ImageLoader,
+  me as ModelLoadError,
+  qe as ModelOptimizer,
+  ue as PredictiveLoader,
+  fe as ProgressiveSceneBuilder,
+  pe as RetryHelper,
+  $ as ThreeIns,
+  C as ViewType,
+  xe as cacheMonitor,
+  ge as createArrowHelper,
+  Fe as createAxesHelper,
+  Re as createBox3Helper,
+  Me as createCameraHelper,
+  Ee as createGridHelper,
+  He as createInfoPlane,
+  Te as createMapControls,
+  P as createOrbitControl,
+  be as createRaycaster,
+  ze as createStats,
+  Ae as createTagPlane,
+  we as dataToObject3D,
+  Le as dataToObject3DSync,
+  q as disposeThreeObject,
+  Pe as getCommonParent,
+  je as initEnvImage,
+  se as intersectColor,
+  Xe as modelOptimizer,
+  oe as obbObjects,
+  ve as object3DToData,
+  Oe as object3DToDataSync,
+  Ce as predictiveLoader,
+  ye as rebuildScene,
+  ie as useBatchGLTFLoader,
+  Se as useGLTFLoader,
+  ne as useObb,
+  re as useRaycaster,
+  ae as useThreeJs
 };

package/dist/useBatchGLTFLoader-CDNvTMtt.cjs

@@ -0,0 +1,5 @@
+"use strict";const c=require("three"),C=require("vue"),I=require("./PredictiveLoader-CpRi-ULa.cjs"),u={c:null,u:[new c.Vector3,new c.Vector3,new c.Vector3],e:[]},h={c:null,u:[new c.Vector3,new c.Vector3,new c.Vector3],e:[]},b=[[],[],[]],a=[[],[],[]],y=[],V=new c.Vector3,B=new c.Vector3,j=new c.Vector3,x=new c.Vector3,Z=new c.Vector3,K=new c.Vector3,v=new c.Matrix3,ee=new c.Box3,_=new c.Matrix4,te=new c.Matrix4,ne=new c.Ray;class G{constructor(e=new c.Vector3,r=new c.Vector3,s=new c.Matrix3){this.center=e,this.halfSize=r,this.rotation=s}set(e,r,s){return this.center=e,this.halfSize=r,this.rotation=s,this}copy(e){return this.center.copy(e.center),this.halfSize.copy(e.halfSize),this.rotation.copy(e.rotation),this}clone(){return new this.constructor().copy(this)}getSize(e){return e.copy(this.halfSize).multiplyScalar(2)}clampPoint(e,r){const s=this.halfSize;x.subVectors(e,this.center),this.rotation.extractBasis(V,B,j),r.copy(this.center);const o=c.MathUtils.clamp(x.dot(V),-s.x,s.x);r.add(V.multiplyScalar(o));const t=c.MathUtils.clamp(x.dot(B),-s.y,s.y);r.add(B.multiplyScalar(t));const f=c.MathUtils.clamp(x.dot(j),-s.z,s.z);return r.add(j.multiplyScalar(f)),r}containsPoint(e){return x.subVectors(e,this.center),this.rotation.extractBasis(V,B,j),Math.abs(x.dot(V))<=this.halfSize.x&&Math.abs(x.dot(B))<=this.halfSize.y&&Math.abs(x.dot(j))<=this.halfSize.z}intersectsBox3(e){return this.intersectsOBB(le.fromBox3(e))}intersectsSphere(e){return this.clampPoint(e.center,K),K.distanceToSquared(e.center)<=e.radius*e.radius}intersectsOBB(e,r=Number.EPSILON){u.c=this.center,u.e[0]=this.halfSize.x,u.e[1]=this.halfSize.y,u.e[2]=this.halfSize.z,this.rotation.extractBasis(u.u[0],u.u[1],u.u[2]),h.c=e.center,h.e[0]=e.halfSize.x,h.e[1]=e.halfSize.y,h.e[2]=e.halfSize.z,e.rotation.extractBasis(h.u[0],h.u[1],h.u[2]);for(let t=0;t<3;t++)for(let f=0;f<3;f++)b[t][f]=u.u[t].dot(h.u[f]);x.subVectors(h.c,u.c),y[0]=x.dot(u.u[0]),y[1]=x.dot(u.u[1]),y[2]=x.dot(u.u[2]);for(let t=0;t<3;t++)for(let f=0;f<3;f++)a[t][f]=Math.abs(b[t][f])+r;let s,o;for(let t=0;t<3;t++)if(s=u.e[t],o=h.e[0]*a[t][0]+h.e[1]*a[t][1]+h.e[2]*a[t][2],Math.abs(y[t])>s+o)return!1;for(let t=0;t<3;t++)if(s=u.e[0]*a[0][t]+u.e[1]*a[1][t]+u.e[2]*a[2][t],o=h.e[t],Math.abs(y[0]*b[0][t]+y[1]*b[1][t]+y[2]*b[2][t])>s+o)return!1;return s=u.e[1]*a[2][0]+u.e[2]*a[1][0],o=h.e[1]*a[0][2]+h.e[2]*a[0][1],!(Math.abs(y[2]*b[1][0]-y[1]*b[2][0])>s+o||(s=u.e[1]*a[2][1]+u.e[2]*a[1][1],o=h.e[0]*a[0][2]+h.e[2]*a[0][0],Math.abs(y[2]*b[1][1]-y[1]*b[2][1])>s+o)||(s=u.e[1]*a[2][2]+u.e[2]*a[1][2],o=h.e[0]*a[0][1]+h.e[1]*a[0][0],Math.abs(y[2]*b[1][2]-y[1]*b[2][2])>s+o)||(s=u.e[0]*a[2][0]+u.e[2]*a[0][0],o=h.e[1]*a[1][2]+h.e[2]*a[1][1],Math.abs(y[0]*b[2][0]-y[2]*b[0][0])>s+o)||(s=u.e[0]*a[2][1]+u.e[2]*a[0][1],o=h.e[0]*a[1][2]+h.e[2]*a[1][0],Math.abs(y[0]*b[2][1]-y[2]*b[0][1])>s+o)||(s=u.e[0]*a[2][2]+u.e[2]*a[0][2],o=h.e[0]*a[1][1]+h.e[1]*a[1][0],Math.abs(y[0]*b[2][2]-y[2]*b[0][2])>s+o)||(s=u.e[0]*a[1][0]+u.e[1]*a[0][0],o=h.e[1]*a[2][2]+h.e[2]*a[2][1],Math.abs(y[1]*b[0][0]-y[0]*b[1][0])>s+o)||(s=u.e[0]*a[1][1]+u.e[1]*a[0][1],o=h.e[0]*a[2][2]+h.e[2]*a[2][0],Math.abs(y[1]*b[0][1]-y[0]*b[1][1])>s+o)||(s=u.e[0]*a[1][2]+u.e[1]*a[0][2],o=h.e[0]*a[2][1]+h.e[1]*a[2][0],Math.abs(y[1]*b[0][2]-y[0]*b[1][2])>s+o))}intersectsPlane(e){this.rotation.extractBasis(V,B,j);const r=this.halfSize.x*Math.abs(e.normal.dot(V))+this.halfSize.y*Math.abs(e.normal.dot(B))+this.halfSize.z*Math.abs(e.normal.dot(j)),s=e.normal.dot(this.center)-e.constant;return Math.abs(s)<=r}intersectRay(e,r){return this.getSize(Z),ee.setFromCenterAndSize(x.set(0,0,0),Z),_.setFromMatrix3(this.rotation),_.setPosition(this.center),te.copy(_).invert(),ne.copy(e).applyMatrix4(te),ne.intersectBox(ee,r)?r.applyMatrix4(_):null}intersectsRay(e){return this.intersectRay(e,x)!==null}fromBox3(e){return e.getCenter(this.center),e.getSize(this.halfSize).multiplyScalar(.5),this.rotation.identity(),this}equals(e){return e.center.equals(this.center)&&e.halfSize.equals(this.halfSize)&&e.rotation.equals(this.rotation)}applyMatrix4(e){const r=e.elements;let s=x.set(r[0],r[1],r[2]).length();const o=x.set(r[4],r[5],r[6]).length(),t=x.set(r[8],r[9],r[10]).length();e.determinant()<0&&(s=-s),v.setFromMatrix4(e);const l=1/s,n=1/o,i=1/t;return v.elements[0]*=l,v.elements[1]*=l,v.elements[2]*=l,v.elements[3]*=n,v.elements[4]*=n,v.elements[5]*=n,v.elements[6]*=i,v.elements[7]*=i,v.elements[8]*=i,this.rotation.multiply(v),this.halfSize.x*=s,this.halfSize.y*=o,this.halfSize.z*=t,x.setFromMatrixPosition(e),this.center.add(x),this}}const le=new G,ue={enableDamping:!0,dampingFactor:.25,screenSpacePanning:!1,minDistance:.1,maxDistance:1e3,maxPolarAngle:c.MathUtils.degToRad(60)};function he(F,e){typeof console<"u"&&console.warn&&console.warn(`[ThreeIns] useThreeJs() Hook 已弃用，建议使用 ThreeIns 类代替。
+旧用法: const { scene, camera } = useThreeJs(selector, options)
+新用法: const threeIns = new ThreeIns(selector, options)
+
+ThreeIns 类提供更完整的 API 和更好的性能。`);const r=Object.assign({css3d:!1,stats:!1,renderType:"change",control:{init:!0,options:{}}},e||{});let s,o,t,f=[];const l=C.ref(!1),n=C.shallowRef(),i=C.ref(0),d=C.ref(0),m=new c.WebGLRenderer({antialias:!0,alpha:!0,precision:"mediump",logarithmicDepthBuffer:!0}),z=new c.Scene({}),p=new c.PerspectiveCamera(50,1,.1,2e3),M=Math.tan(Math.PI/180*p.fov/2);let R=!1;m.setPixelRatio(window.devicePixelRatio);function L(){l.value=!1;const w=Y();i.value=w[0],d.value=w[1],p.aspect=i.value/d.value,p.position.set(47,39,100),p.fov=360/Math.PI*Math.atan(M*(d.value/i.value)),p.lookAt(0,0,0),p.updateProjectionMatrix(),m.setSize(i.value,d.value),s.appendChild(m.domElement),r.stats&&W(),r.css3d&&oe();let P;if(r.control&&r.control.init){P=I.createOrbitControl(p,m.domElement);const A=Object.assign(ue,r.control.options||{});Object.keys(A).forEach(k=>{P[k]=A[k]})}return C.nextTick(()=>l.value=!0),P}function D(w){w.preventDefault(),cancelAnimationFrame(T)}function U(w){w.preventDefault(),L(),T()}function $(w){f.push(w)}function T(w){f&&f.length&&f.forEach(P=>{typeof P=="function"&&P()}),r.renderType==="loop"&&S(),requestAnimationFrame(T)}function S(){R=!1,o&&o.update(),n.value&&n.value.update(),m.render(z,p),t&&t.render(z,p)}function H(){R||(R=!0,requestAnimationFrame(S))}function g(){C.nextTick(()=>{const w=Y();i.value=w[0],d.value=w[1],p.aspect=i.value/d.value,p.fov=360/Math.PI*Math.atan(M*(d.value/i.value)),p.updateProjectionMatrix(),p.lookAt(z.position),m.setSize(i.value,d.value),t&&t.setSize(i.value,d.value),S()})}function Y(){return s=document.querySelector(F),s?[s.clientWidth,s.clientHeight]:[0,0]}function W(){o=new I.Stats,o.dom.style.cssText="position:absolute;top:0;left:0;cursor:pointer;opacity:0.9;z-index:10000",s.appendChild(o.dom)}function se(w,P,A,k,J){const N=new c.Box3().setFromObject(w),Q=N.getSize(new c.Vector3).length(),E=N.getCenter(new c.Vector3);J&&E.add(J);const ae=Q*P*.5,ie=c.MathUtils.degToRad(A.fov*.5),ce=ae/Math.tan(ie),X=new c.Vector3().subVectors(A.position,E).multiply(new c.Vector3(1,1,1)).normalize().multiplyScalar(ce).add(E),q={x:X.x,y:X.y,z:X.z,lookAt_x:E.x,lookAt_y:E.y,lookAt_z:E.z};return A.position.set(q.x,q.y,q.z),A.lookAt(q.lookAt_x,q.lookAt_y,q.lookAt_z),A.updateProjectionMatrix(),k.target.copy(E),k.update(),Q}function oe(){t=new I.CSS3DRenderer,t.setSize(i.value,d.value),t.domElement.style.position="absolute",t.domElement.style.top=0,t.domElement.style.left=0,t.domElement.style.pointerEvents="none",s.appendChild(t.domElement)}function re(){I.disposeThreeObject(z)}return C.onMounted(()=>{n.value=L(),window.addEventListener("resize",g,!1),m.domElement.addEventListener("webglcontextlost",D,!1),m.domElement.addEventListener("webglcontextrestored",U,!1),r.renderType==="loop"?requestAnimationFrame(T):r.renderType==="change"&&n.value&&n.value.addEventListener("change",H)}),C.onUnmounted(()=>{cancelAnimationFrame(T),m.domElement.removeEventListener("resize",g,!1),m.domElement.removeEventListener("webglcontextlost",D,!1),m.domElement.removeEventListener("webglcontextrestored",U,!1),re()}),{addAnimate:$,frameArea:se,onRender:S,css3dRenderer:t,scene:z,camera:p,control:n,renderer:m,domWidth:i,domHeight:d,isReady:l}}const fe=(F="app")=>{const e=new c.Raycaster;e.params.Line.threshold=8;const r=new c.Vector2,s=document.getElementById(F);function o(l,n){const{scaleX:i,scaleY:d}=f(s),{clientWidth:m,clientHeight:z}=n,p=n.getBoundingClientRect(),M=m*i,R=z*d,L=l.clientX-p.left,D=l.clientY-p.top;return r.x=(l.clientX-p.left)/M*2-1,r.y=-((l.clientY-p.top)/R)*2+1,{pointer:r,x:L,y:D}}function t(l,n,i,d){const{pointer:m,x:z,y:p}=o(l,n);return e.setFromCamera(m,i),{intersects:e.intersectObjects(d),pointer:m,x:z,y:p}}function f(l){const n=window.getComputedStyle(l),i=n.transform||n.webkitTransform||n.mozTransform;if(i&&i!=="none"){const d=i.match(/^matrix\((.+)\)$/);if(d){const m=d[1].split(", "),z=parseFloat(m[0]),p=parseFloat(m[3]);return{scaleX:z,scaleY:p}}}return{scaleX:1,scaleY:1}}return{raycaster:e,pointer:r,getPointer:o,getScale:f,getIntersects:t}},O=[],de=new c.Color(16711680),me=()=>{const F=()=>{O.splice(0)},e=(l,n)=>{n.traverse(i=>{i&&r(l,i)})},r=(l,n)=>{if(n.userData.needCheck&&(n.autoUpdateMatrix=!1,n.updateMatrix(),n.updateMatrixWorld(),n.isMesh)){const i=new c.Box3(new c.Vector3).setFromObject(n);n.geometry.userData.obb=new G,n.geometry.userData.obb.halfSize.copy(i.getSize(new c.Vector3)).multiplyScalar(.5).multiplyScalar(.88),n.userData.obb=new G,n.userData.originColor=n.material.color.clone(),n.userData.parentUid=l,O.push({object:n,parentUid:l})}};return{resetObbs:F,initObb:e,getObbObjectByParentUid:l=>O.filter(n=>n.parentUid===l),addObbFromArray:(l,n)=>{for(let i=0,d=n.length;i<d;i++)r(l,n[i])},removeObbFromArray:l=>{const n=O.filter(i=>!l.includes(i.object));O.splice(0,O.length,...n)},removeUidObb:l=>{for(let n=O.length-1;n>=0;n--)O[n].parentUid===l&&O.splice(n,1)}}};function pe(){const{asyncFetch:F}=I.useGLTFLoader();async function e(o,t={}){const{maxConcurrent:f=3,maxRetries:l=3,onProgress:n,onModelLoad:i,onModelError:d}=t,m=new Map,z=new Map,p=[...o];let M=0,R=0;return new Promise((L,D)=>{const U=async T=>{const{path:S,version:H}=T;R++;try{const g=await F(S,H,Y=>{const W=M/o.length*100+Y/o.length;n==null||n(Math.round(W))},{maxRetries:l});if(g)m.set(S,g),i==null||i(S,g);else throw new Error(`模型加载返回空结果: ${S}`)}catch(g){console.error(`[ 批量加载 ] 加载失败: ${S}`,g),z.set(S,g),d==null||d(S,g)}finally{R--,M++;const g=M/o.length*100;n==null||n(Math.round(g)),$()}},$=()=>{if(M>=o.length){z.size>0&&console.warn(`[ 批量加载 ] 完成,但有 ${z.size} 个模型加载失败`),L(m);return}for(;p.length>0&&R<f;){const T=p.shift();U(T)}};$()})}async function r(o,t={}){console.log(`[ 批量预加载 ] 开始预加载 ${o.length} 个模型`);const f=await e(o,{...t,maxConcurrent:t.maxConcurrent||2});return console.log(`[ 批量预加载 ] 完成,成功加载 ${f.size} 个模型`),f}async function s(o,t={}){const f=new Map;for(let l=0;l<o.length;l++)console.log(`[ 分组批量加载 ] 加载第 ${l+1}/${o.length} 组`),(await e(o[l],{...t,onProgress:i=>{var m;const d=l/o.length*100+i/o.length;(m=t.onProgress)==null||m.call(t,Math.round(d))}})).forEach((i,d)=>{f.set(d,i)});return f}return{batchLoad:e,preload:r,batchLoadGroups:s}}exports.intersectColor=de;exports.obbObjects=O;exports.useBatchGLTFLoader=pe;exports.useObb=me;exports.useRaycaster=fe;exports.useThreeJs=he;