@realsee/dnalogel 3.78.0-alpha.0 → 3.78.0-alpha.2

package/libs/PanoTagPlugin/controller/Tag/MaskTag1.js

@@ -0,0 +1,617 @@
+var U = Object.defineProperty;
+var E = Object.getOwnPropertySymbols;
+var I = Object.prototype.hasOwnProperty, P = Object.prototype.propertyIsEnumerable;
+var w = (n, r, e) => r in n ? U(n, r, { enumerable: !0, configurable: !0, writable: !0, value: e }) : n[r] = e, M = (n, r) => {
+  for (var e in r || (r = {}))
+    I.call(r, e) && w(n, e, r[e]);
+  if (E)
+    for (var e of E(r))
+      P.call(r, e) && w(n, e, r[e]);
+  return n;
+};
+var c = (n, r, e) => (w(n, typeof r != "symbol" ? r + "" : r, e), e);
+var v = (n, r, e) => new Promise((t, s) => {
+  var a = (l) => {
+    try {
+      i(e.next(l));
+    } catch (u) {
+      s(u);
+    }
+  }, o = (l) => {
+    try {
+      i(e.throw(l));
+    } catch (u) {
+      s(u);
+    }
+  }, i = (l) => l.done ? t(l.value) : Promise.resolve(l.value).then(a, o);
+  i((e = e.apply(n, r)).next());
+});
+import { BaseTag as F } from "./BaseTag.js";
+import * as m from "three";
+import { maskVertexShader as V, maskFragmentShader as R } from "./MaskTag.shaders.js";
+import { transformPosition as $ } from "../../../shared-utils/five/transformPosition.js";
+import "../../../shared-utils/Subscribe.js";
+import "../../utils/tag/calculateTagConfig.js";
+import "../../../vendor/object-assign-deep/objectAssignDeep.js";
+import "../../../shared-utils/typescript/entries.js";
+import "../../utils/tag/adaptConfig.js";
+import "../../typings/tag/TagConfig.js";
+import "@realsee/five";
+import "../../../shared-utils/tag.js";
+import "../../../shared-utils/positionToVector3.js";
+import "../../../shared-utils/five/vector3ToScreen.js";
+import "../../../shared-utils/five/getFiveModel.js";
+import "../../../shared-utils/Utils/FiveUtil.js";
+import "../../../shared-utils/Utils/BaseUtil.js";
+import "../../../shared-utils/Utils/WorkUtil.js";
+import "../../../shared-utils/three/temp.js";
+import "../../../shared-utils/three/core/Raycaster.js";
+import "../../../shared-utils/dom/resizeObserver.js";
+import "../../../shared-utils/five/fiveEveryReadyListener.js";
+import "../../../shared-utils/throttle.js";
+import "../../../vendor/hammerjs/hammer.js";
+import "../../../shared-utils/three/PointSelector/index.js";
+import "../../../shared-utils/three/PointSelector/utils/PointSelectorHelper.js";
+import "../../../shared-utils/three/Magnifier.js";
+import "../../../shared-utils/three/PointSelector/utils/PointHelper.js";
+import "../../../shared-utils/three/Assets/index.js";
+import "../../../CSS3DRenderPlugin/utils/three/CSS3DObject.js";
+import "../../../shared-utils/even.js";
+import "../../../shared-utils/CSS3DRender/OpacityMesh.js";
+import "../../../shared-utils/three/centerPoint.js";
+import "../../../shared-utils/three/getObjectVisible.js";
+import "../../../shared-utils/three/CSS3DRenderer/index.js";
+import "../../../CSS3DRenderPlugin/utils/generateBehindFiveElement.js";
+import "@realsee/five/line";
+import "../../../shared-utils/isNil.js";
+import "../../../shared-utils/three/core/Five_LineMaterial2.js";
+import "../../../shared-utils/three/core/Sphere.js";
+import "../../../shared-utils/three/blink.js";
+import "../../../vendor/animejs/lib/anime.es.js";
+import "../../../shared-utils/util.js";
+import "../../../vendor/@tweenjs/tween/dist/tween.esm.js.js";
+import "../../../CSS3DRenderPlugin/utils/three/CSS3DRender.js";
+import "../../../shared-utils/CSS3DRender/CSS3DRenderer.js";
+import "../../../shared-utils/createResizeObserver.js";
+import "../../../CSS3DRenderPlugin/utils/three/CSS3DScene.js";
+import "../../../CSS3DRenderPlugin/utils/getAllCSS3DObject.js";
+import "../../../CSS3DRenderPlugin/utils/three/CSS3DGroup.js";
+import "../../../shared-utils/three/PointSelector/utils/html.js";
+import "../../../shared-utils/CSS3DRender/index.js";
+import "../../../shared-utils/five/fiveModelLoad.js";
+import "../../../shared-utils/three/PointSelector/utils/PointHelper2.js";
+import "../../../Sculpt/Meshes/Line.js";
+import "../../../Sculpt/typings/style.js";
+import "../../../shared-utils/three/IObject3D.js";
+import "../../../Sculpt/utils/Meshes/getLengthHTML.js";
+import "../../../shared-utils/three/applyObjectMatrixWorld.js";
+import "../../../shared-utils/three/core/LineGeometry.js";
+import "../../../shared-utils/three/core/LineMaterial.js";
+import "../../../shared-utils/three/core/Line2.js";
+import "../../../shared-utils/three/core/LineMaterial2.js";
+import "../../../Sculpt/utils/unit.js";
+import "../../../Sculpt/utils/renderDom.js";
+import "../../../vendor/earcut/src/earcut.js";
+import "../../../shared-utils/five/FivePuppet.js";
+import "../../../CSS3DRenderPlugin/utils/three/CSS3DSprite.js";
+import "../../../shared-utils/isTouchDevice.js";
+import "../../../shared-utils/five/getPosition.js";
+import "../../../shared-utils/five/getRaycasterByNdcPosition.js";
+import "../../../shared-utils/three/PointSelector/utils/contents.js";
+import "../../../Sculpt/utils/three/rayOnLine.js";
+import "../../../shared-utils/five/mode.js";
+import "../../utils/tag/format.js";
+import "../../../shared-utils/url/defaultUrls.js";
+import "../../../shared-utils/vectorToCoordinate.js";
+import "../../../shared-utils/formatRad.js";
+import "../../../shared-utils/five/lookPoint.js";
+import "../../../shared-utils/uuid.js";
+import "../../utils/tagPosition.js";
+import "../../utils/tag/tagCheck.js";
+import "../../utils/checkRange.js";
+import "../../../shared-utils/url/getUrl.js";
+import "../../../shared-utils/five/getFloorIndex.js";
+import "../../../shared-utils/safeObj.js";
+import "../../utils/Cache.js";
+import "../../../shared-utils/promise/withResolvers.js";
+function C(n) {
+  if (Array.isArray(n))
+    return n;
+  if (typeof n == "number")
+    return [n >> 16 & 255, n >> 8 & 255, n & 255];
+  if (typeof n == "string") {
+    let r = n.trim().replace(/^#/, "");
+    if (r.length === 3 && (r = r[0] + r[0] + r[1] + r[1] + r[2] + r[2]), r.length === 6) {
+      const e = parseInt(r.substring(0, 2), 16), t = parseInt(r.substring(2, 4), 16), s = parseInt(r.substring(4, 6), 16);
+      if (!isNaN(e) && !isNaN(t) && !isNaN(s))
+        return [e, t, s];
+    }
+    console.warn("[MaskTag] Invalid hex color string:", n);
+  }
+  return [0, 0, 0];
+}
+const h = class extends F {
+  constructor(e, t) {
+    super(e, t);
+    /**
+     * mask 图片 URL 或 Canvas 元素（2:1 全景图格式）
+     */
+    c(this, "maskUrl");
+    /**
+     * 目标颜色（RGB 格式）
+     */
+    c(this, "targetColor");
+    /**
+     * mask 渲染的 mesh 对象（使用 Sphere）
+     */
+    c(this, "maskMesh");
+    /**
+     * mask 纹理对象
+     */
+    c(this, "maskTexture");
+    /**
+     * 是否正在加载 mask
+     */
+    c(this, "loadingMask", !1);
+    /**
+     * 资源是否已释放
+     */
+    c(this, "_disposed", !1);
+    /**
+     * 标签样式配置
+     */
+    c(this, "tagStyle");
+    /**
+     * 点击事件清理函数
+     */
+    c(this, "clickEventDispose");
+    const s = t.maskUrl;
+    s instanceof HTMLCanvasElement ? this.maskUrl = s : typeof s == "string" && s ? this.maskUrl = s : this.maskUrl = "";
+    const a = t.color;
+    this.targetColor = C(a), a || console.warn(`[MaskTag] No color provided for tag ${t.id}, using default [0, 0, 0]`), this.tagStyle = t.style, this.updateVisible(), this.currentVisible ? this.initializeMaskMesh() : console.log(`[MaskTag] Tag ${t.id} is not visible initially`);
+  }
+  /**
+   * 计算法向量
+   * Mask 标签返回向上的法向量（因为是贴在 cube 面上）
+   */
+  computeNormal() {
+    return new m.Vector3(0, 1, 0);
+  }
+  /**
+   * 获取额外的闪烁目标
+   * 返回 maskMesh 用于 blink 动画
+   */
+  getAdditionalBlinkTargets() {
+    return this.maskMesh || null;
+  }
+  /**
+   * 更新标签数据
+   */
+  set(e, t = !0) {
+    var a, o;
+    super.set(e, t), e.style && (this.tagStyle = M(M({}, this.tagStyle), e.style), (a = e.style) != null && a.mask && this.updateMaskStyle());
+    const s = (o = e.mask) != null ? o : e.maskUrl;
+    if (s) {
+      const i = this.maskUrl;
+      this.maskUrl = s, this.reloadMask(i);
+    }
+    e.color !== void 0 && (this.targetColor = C(e.color), this.updateMaskStyle());
+  }
+  /**
+   * 重写 getVisible 方法
+   * Mask 标签仅在当前点位可见
+   */
+  getVisible(e) {
+    var t;
+    try {
+      if (!this.enabled || !this.plugin.state.enabled || !this.fiveUtil.model || !this.maskUrl)
+        return !1;
+      const s = M(M({}, this.five.getCurrentState()), e), { panoIndex: a } = s;
+      return a !== ((t = this.fiveState) == null ? void 0 : t.panoIndex) ? !1 : super.getVisible(s);
+    } catch (s) {
+      return !1;
+    }
+  }
+  /**
+   * 重写 computeVisible 方法
+   * 增加 Mask 特有的可见性检查逻辑，用于 whyHide 功能
+   */
+  computeVisible(e) {
+    var a, o, i;
+    const t = M(M({}, this.five.getCurrentState()), e), { panoIndex: s } = t;
+    return this.maskUrl ? s !== ((a = this.fiveState) == null ? void 0 : a.panoIndex) ? {
+      value: !1,
+      reason: {
+        type: "panoIndex mismatch",
+        detail: `Mask 标签仅在当前点位可见。当前点位: ${s}, 标签点位: ${(o = this.fiveState) == null ? void 0 : o.panoIndex}`,
+        currentPanoIndex: s,
+        tagPanoIndex: (i = this.fiveState) == null ? void 0 : i.panoIndex
+      }
+    } : super.computeVisible(e) : {
+      value: !1,
+      reason: {
+        type: "maskUrl invalid",
+        detail: `Mask 标签 ${this.id} 的 maskUrl 无效`,
+        maskUrl: this.maskUrl
+      }
+    };
+  }
+  /**
+   * 点击事件处理
+   */
+  onClick(e) {
+    e.target === "TagMaskModel" && this.unfoldAndFoldOthers();
+  }
+  /**
+   * 展开自己，收起其他标签
+   */
+  unfoldAndFoldOthers() {
+    if (this.isPopoverConfigEnabled())
+      return;
+    const e = this.can("fold"), t = this.can("unfold");
+    e && t && (this.state.unfolded = !this.state.unfolded, this.manuallyOperated = !0, this.plugin.addRenderQueue({ type: "TagContainerSvelte", keys: ["tags"] }), this.state.unfolded && this.plugin.tags.forEach((s) => {
+      s.id !== this.id && s.fold();
+    }));
+  }
+  /**
+   * 展开标签详情
+   */
+  unfold() {
+    this.isPopoverConfigEnabled() || this.setUnfold(!0);
+  }
+  /**
+   * 折叠标签详情
+   */
+  fold() {
+    this.isPopoverConfigEnabled() || this.setUnfold(!1);
+  }
+  /**
+   * 设置展开/折叠状态
+   */
+  setUnfold(e) {
+    if (this.isPopoverConfigEnabled())
+      return;
+    const t = this.can("fold"), s = this.can("unfold");
+    t && s && (this.state.unfolded = e, this.hooks.emit(e ? "unfolded" : "folded"), this.plugin.addRenderQueue({ type: "TagContainerSvelte", keys: ["tags"] }));
+  }
+  /**
+   * 更新屏幕位置
+   */
+  updateScreenPosition() {
+    if (!this.currentVisible || !this.position || !Array.isArray(this.position)) {
+      this.screenPosition = null, this.plugin.addRenderQueue({ type: "TagContainerSvelte", keys: ["tags"] });
+      return;
+    }
+    const t = new m.Vector3(...this.position).clone().project(this.five.camera);
+    if (this.five.renderer) {
+      const s = this.five.renderer.getSize(new m.Vector2());
+      this.screenPosition = {
+        leftPx: (t.x + 1) / 2 * s.x,
+        topPx: (-t.y + 1) / 2 * s.y,
+        scale: 1
+      };
+    }
+    this.plugin.addRenderQueue({ type: "TagContainerSvelte", keys: ["tags"] });
+  }
+  /**
+   * 应用可见性变化
+   */
+  applyVisible() {
+    try {
+      if (!this.maskUrl) {
+        console.warn(`[MaskTag] ${this.id} cannot apply visible: maskUrl is invalid`);
+        return;
+      }
+      this.visible && !this.maskMesh && !this.loadingMask && this.initializeMaskMesh(), this.maskMesh && (this.maskMesh.visible = this.visible, this.updateMeshTransform()), this.updateScreenPosition();
+    } catch (e) {
+      console.error(`[MaskTag] Error in applyVisible for tag ${this.id}:`, e);
+    }
+  }
+  /**
+   * 更新 mesh 的位置和旋转（跟随观察者）
+   * 参考 itemMask 实现
+   */
+  updateMeshTransform() {
+    var s;
+    if (!this.maskMesh)
+      return;
+    const e = (s = this.fiveState) == null ? void 0 : s.panoIndex;
+    if (e === void 0)
+      return;
+    const t = this.workUtil.getObserver(e);
+    t && (this.maskMesh.position.copy($(t.position, this.workUtil.transform)), this.maskMesh.quaternion.copy(t.quaternion), this.five.needsRender = !0);
+  }
+  /**
+   * 初始化 Mask Mesh（使用 Sphere）
+   */
+  initializeMaskMesh() {
+    return v(this, null, function* () {
+      if (this.maskMesh || this.loadingMask || !this.maskUrl)
+        return;
+      this.loadingMask = !0;
+      const e = performance.now();
+      try {
+        this.maskTexture = yield h.loadMaskTexture(this.maskUrl), this.maskMesh = this.createSphereMesh(this.maskTexture), this.plugin.imagePlaneGroup.add(this.maskMesh), this.applyVisible(), this.five.needsRender = !0, this.setupClickEvents(), this.updateScreenPosition();
+        const t = performance.now() - e;
+        console.log(`[MaskTag Performance] Mesh initialized in ${t.toFixed(2)}ms for tag ${this.id}`);
+      } catch (t) {
+        console.error("[MaskTag] Failed to initialize mask mesh:", t);
+      } finally {
+        this.loadingMask = !1;
+      }
+    });
+  }
+  /**
+   * 创建 Sphere mesh（参考 itemMask 实现）
+   */
+  createSphereMesh(e) {
+    const t = this.getMaskStyle(), s = new m.Vector4(this.targetColor[0] / 255, this.targetColor[1] / 255, this.targetColor[2] / 255, 1), a = new m.ShaderMaterial({
+      vertexShader: V,
+      fragmentShader: R,
+      uniforms: {
+        map: { value: e },
+        color: { value: s },
+        tolerance: { value: t.tolerance / 255 },
+        // 归一化容差
+        highlightColor: {
+          value: new m.Vector3(t.highlightColor[0] / 255, t.highlightColor[1] / 255, t.highlightColor[2] / 255)
+        },
+        opacity: { value: t.opacity }
+      },
+      depthWrite: !1,
+      depthTest: !1,
+      transparent: !0
+    }), o = new m.SphereGeometry(1, 60, 40);
+    o.rotateY(-Math.PI / 2), o.scale(-1, 1, 1);
+    const i = new m.Mesh(o, a);
+    i.renderOrder = -1e3;
+    let l = null;
+    const u = () => {
+      if (l)
+        return l;
+      if (!e.image)
+        return null;
+      try {
+        const f = document.createElement("canvas"), d = f.getContext("2d");
+        if (!d)
+          return null;
+        const p = e.image;
+        return f.width = p.width, f.height = p.height, d.drawImage(p, 0, 0), l = d.getImageData(0, 0, p.width, p.height), l;
+      } catch (f) {
+        return console.error("[MaskTag] Failed to get image data:", f), null;
+      }
+    }, g = i.raycast.bind(i);
+    return i.raycast = (f, d) => {
+      const p = [];
+      if (g(f, p), p.length > 0) {
+        const y = p[0];
+        if (y.uv && e.image) {
+          const k = u();
+          if (k) {
+            const S = Math.floor(y.uv.x * k.width), T = (Math.floor((1 - y.uv.y) * k.height) * k.width + S) * 4, b = [k.data[T], k.data[T + 1], k.data[T + 2]];
+            Math.abs(b[0] / 255 - this.targetColor[0] / 255) + Math.abs(b[1] / 255 - this.targetColor[1] / 255) + Math.abs(b[2] / 255 - this.targetColor[2] / 255) < t.tolerance && d.push(y);
+          }
+        }
+      }
+    }, i.__maskTag = this.id, i.__maskMesh = !0, i;
+  }
+  /**
+   * 获取 Mask 样式配置（合并用户配置和默认值）
+   */
+  getMaskStyle() {
+    var s, a, o;
+    const e = ((s = this.tagStyle) == null ? void 0 : s.mask) || {};
+    let t = [255, 255, 255];
+    return e.color !== void 0 ? t = C(e.color) : e.highlightColor !== void 0 && (t = C(e.highlightColor)), {
+      tolerance: (a = e.tolerance) != null ? a : 1e-3,
+      // 参考 itemMask 默认 0.001（归一化后的值）
+      highlightColor: t,
+      opacity: (o = e.opacity) != null ? o : 0.6
+      // 默认 0.6（用于填充区域）
+    };
+  }
+  /**
+   * 设置点击事件
+   */
+  setupClickEvents() {
+    if (!this.maskMesh || this.config.clickable === !1)
+      return;
+    this.cleanupClickEvents();
+    const e = (t) => {
+      this.plugin.hooks.emit("click", { event: t, target: "TagMaskModel", tag: this });
+    };
+    requestAnimationFrame(() => {
+      !this.maskMesh || !this.plugin.domEvents || (this.clickEventDispose = this.addObjectClickHandler(this, this.maskMesh, e));
+    });
+  }
+  /**
+   * 清理点击事件
+   */
+  cleanupClickEvents() {
+    this.clickEventDispose && (this.clickEventDispose(), this.clickEventDispose = void 0);
+  }
+  /**
+   * 重新加载 mask 图
+   * @param oldMaskUrl 旧的 mask 源，用于正确释放纹理缓存（调用 set 时已更新 this.maskUrl，需传入旧值）
+   */
+  reloadMask(e) {
+    return v(this, null, function* () {
+      this.maskMesh && (this.maskMesh.parent && this.maskMesh.parent.remove(this.maskMesh), this.maskMesh.geometry.dispose(), this.maskMesh.material && (Array.isArray(this.maskMesh.material) ? this.maskMesh.material.forEach((s) => s.dispose()) : this.maskMesh.material.dispose()), this.maskMesh = void 0);
+      const t = e != null ? e : this.maskUrl;
+      this.maskTexture && t && (h.releaseMaskTexture(t), this.maskTexture = void 0), yield this.initializeMaskMesh();
+    });
+  }
+  /**
+   * 更新 mask 样式
+   */
+  updateMaskStyle() {
+    if (!this.maskMesh)
+      return;
+    const e = this.getMaskStyle(), t = this.maskMesh.material;
+    t.uniforms && (t.uniforms.color.value.set(this.targetColor[0] / 255, this.targetColor[1] / 255, this.targetColor[2] / 255, 1), t.uniforms.tolerance.value = e.tolerance / 255, t.uniforms.highlightColor.value.set(
+      e.highlightColor[0] / 255,
+      e.highlightColor[1] / 255,
+      e.highlightColor[2] / 255
+    ), t.uniforms.opacity.value = e.opacity), this.five.needsRender = !0;
+  }
+  /**
+   * 更新 Canvas 纹理（仅当 maskUrl 为 Canvas 时有效）
+   * 当 canvas 内容发生变化时，调用此方法更新渲染
+   */
+  updateCanvasTexture() {
+    if (!this.maskTexture || typeof this.maskUrl == "string") {
+      console.warn("[MaskTag] updateCanvasTexture only works for Canvas-based masks");
+      return;
+    }
+    this.maskTexture instanceof m.CanvasTexture && (this.maskTexture.needsUpdate = !0, this.five.needsRender = !0, console.log("[MaskTag] Canvas texture updated"));
+  }
+  /**
+   * 清理 MaskTag 特有的资源（内部方法，避免重复调用）
+   */
+  disposeMaskResources() {
+    this._disposed || (this._disposed = !0, this.cleanupClickEvents(), this.maskMesh && (this.maskMesh.parent && this.maskMesh.parent.remove(this.maskMesh), this.maskMesh.geometry.dispose(), this.maskMesh.material && (Array.isArray(this.maskMesh.material) ? this.maskMesh.material.forEach((e) => e.dispose()) : this.maskMesh.material.dispose()), this.maskMesh = void 0), this.maskTexture && this.maskUrl && (h.releaseMaskTexture(this.maskUrl), this.maskTexture = void 0));
+  }
+  /**
+   * 清理 MaskTag 特有的资源（公开方法）
+   */
+  dispose() {
+    this.disposeMaskResources();
+  }
+  /**
+   * 禁用标签（重写父类方法）
+   */
+  disable() {
+    this.maskMesh && (this.maskMesh.visible = !1), super.disable();
+  }
+  /**
+   * 销毁标签（重写父类方法）
+   */
+  destroy() {
+    this.disposeMaskResources(), super.destroy();
+  }
+  /**
+   * 获取 mask 的缓存 key
+   * @param maskSource mask URL 或 Canvas
+   * @returns 缓存 key
+   */
+  static getMaskCacheKey(e) {
+    if (typeof e == "string")
+      return e;
+    {
+      let t = h.canvasSymbolMap.get(e);
+      return t || (t = Symbol("canvas-mask"), h.canvasSymbolMap.set(e, t)), t;
+    }
+  }
+  /**
+   * 加载 Mask 纹理（静态方法，支持缓存和引用计数）
+   * @param maskSource mask 图片 URL 或 Canvas 元素
+   * @returns Promise<THREE.Texture>
+   */
+  static loadMaskTexture(e) {
+    return v(this, null, function* () {
+      const t = h.getMaskCacheKey(e), s = h.maskTextureCache.get(t);
+      if (s)
+        return s.refCount++, s.texture;
+      const a = performance.now(), o = new AbortController();
+      try {
+        let i;
+        if (typeof e == "string") {
+          const g = new m.TextureLoader();
+          i = yield new Promise((f, d) => {
+            if (o.signal.aborted) {
+              d(new Error("Load aborted"));
+              return;
+            }
+            g.load(
+              e,
+              (p) => {
+                o.signal.aborted ? (p.dispose(), d(new Error("Load aborted"))) : f(p);
+              },
+              void 0,
+              (p) => {
+                d(p);
+              }
+            ), o.signal.addEventListener("abort", () => {
+              d(new Error("Load aborted"));
+            });
+          });
+        } else
+          i = new m.CanvasTexture(e), i.needsUpdate = !0, console.log("[MaskTag] Created texture from canvas, size:", e.width, "x", e.height);
+        i.wrapS = m.ClampToEdgeWrapping, i.wrapT = m.ClampToEdgeWrapping, i.minFilter = m.LinearFilter, i.magFilter = m.LinearFilter, i.anisotropy = 4, i instanceof m.CanvasTexture && (i.needsUpdate = !0), h.maskTextureCache.set(t, {
+          texture: i,
+          refCount: 1,
+          abortController: o
+        });
+        const l = performance.now() - a, u = typeof e == "string" ? e.substring(0, 50) : "Canvas";
+        if (console.log(`[MaskTag Performance] Texture loaded in ${l.toFixed(2)}ms, source: ${u}`), i.image) {
+          const g = (i.image.width * i.image.height * 4 / 1048576).toFixed(2);
+          console.log(`[MaskTag Memory] Texture size: ${i.image.width}x${i.image.height}, estimated memory: ${g}MB`);
+        }
+        return i;
+      } catch (i) {
+        throw console.error("[MaskTag] Failed to load mask texture:", typeof e == "string" ? e : "Canvas", i), i;
+      }
+    });
+  }
+  /**
+   * 释放 Mask 纹理（静态方法）
+   * @param maskSource mask 图片 URL 或 Canvas 元素
+   */
+  static releaseMaskTexture(e) {
+    var a;
+    const t = h.getMaskCacheKey(e), s = h.maskTextureCache.get(t);
+    if (s && (s.refCount--, s.refCount <= 0)) {
+      const o = typeof e == "string" ? e.substring(0, 50) : "Canvas";
+      console.log(`[MaskTag Memory] Releasing texture (refCount=0): ${o}`), (a = s.abortController) == null || a.abort(), s.texture.dispose(), h.maskTextureCache.delete(t);
+    }
+  }
+  /**
+   * 获取当前缓存的纹理统计信息（用于性能监控和调试）
+   * @returns 缓存统计信息
+   */
+  static getCacheStats() {
+    let e = 0, t = 0;
+    const s = [];
+    return h.maskTextureCache.forEach((a, o) => {
+      e += a.refCount;
+      let i = 0;
+      if (a.texture.image) {
+        const u = a.texture.image.width || 0, g = a.texture.image.height || 0;
+        i = u * g * 4 / (1024 * 1024), t += i;
+      }
+      const l = typeof o == "string" ? o.substring(0, 80) : "[Canvas]";
+      s.push({
+        source: l,
+        refCount: a.refCount,
+        sizeMB: parseFloat(i.toFixed(2))
+      });
+    }), {
+      totalCached: h.maskTextureCache.size,
+      totalRefCount: e,
+      estimatedMemoryMB: parseFloat(t.toFixed(2)),
+      cacheEntries: s
+    };
+  }
+  /**
+   * 强制清理所有缓存的纹理（用于内存管理，谨慎使用）
+   * 注意：这会释放所有纹理，即使它们仍在使用中
+   */
+  static clearAllCache() {
+    console.warn("[MaskTag] Clearing all texture cache"), h.maskTextureCache.forEach((e) => {
+      var t;
+      (t = e.abortController) == null || t.abort(), e.texture.dispose();
+    }), h.maskTextureCache.clear();
+  }
+};
+let x = h;
+/**
+ * Mask 纹理缓存（静态，所有 MaskTag 实例共享）
+ * key: mask URL 或 canvas 的 symbol, value: { texture: THREE.Texture, refCount: number, abortController?: AbortController }
+ */
+c(x, "maskTextureCache", /* @__PURE__ */ new Map()), /**
+ * Canvas 到 Symbol 的映射（用于缓存 canvas 纹理）
+ */
+c(x, "canvasSymbolMap", /* @__PURE__ */ new WeakMap());
+export {
+  x as MaskTag
+};

package/libs/PanoTagPlugin/controller/TagUtil.js

@@ -38,7 +38,7 @@ import { FiveDomEvents as V } from "../../shared-utils/five/FiveDomEvents.js";
 import "../../shared-utils/five/FivePuppet.js";
 import { Cache as se } from "../utils/Cache.js";
 import { Controller as ce } from "../../base/BasePlugin.js";
-import { objectAssignDeepExports as _ } from "../../vendor/object-assign-deep/objectAssignDeep.js";
+import { objectAssignDeepExports as P } from "../../vendor/object-assign-deep/objectAssignDeep.js";
 import { entries as B } from "../../shared-utils/typescript/entries.js";
 import H from "../utils/tag/adaptConfig.js";
 import "../../vendor/svelte/internal/index.js";
@@ -181,7 +181,7 @@ class Xt extends ce {
   // eslint-disable-next-line accessor-pairs
   set tagsLengthWillUpdate(e) {
     e && (this._cache_pointTag = this.tags.filter(
-      (t) => t.stickType === "2DPoint" || t.stickType === "3DPoint" || t.stickType === "3DBox" || t.stickType === "Polygon"
+      (t) => t.stickType === "2DPoint" || t.stickType === "3DPoint" || t.stickType === "3DBox" || t.stickType === "Polygon" || t.stickType === "Mask"
     ).filter((t) => t.position), this._cache_2DPointTag = this.tags.filter((t) => t.stickType === "2DPoint").filter((t) => t.position), this._cache_css3DTag = this.tags.filter(
       (t) => t.stickType === "3DPoint" || t.stickType === "Plane" || t.stickType === "Model" && t.contentType === "MediaModel"
     ).filter((t) => {
@@ -285,29 +285,29 @@ class Xt extends ce {
           (e.contentType === g || g === "Any") && (M[m] = h);
         }
         if (y.length === 2) {
-          const [g = "Any", P = "Any"] = y;
-          g === "Mixin" && e.contentType === P && (M[m] = h), (e.stickType === g || g === "Any") && (e.contentType === P || P === "Any") && (M[m] = h);
+          const [g = "Any", k = "Any"] = y;
+          g === "Mixin" && e.contentType === k && (M[m] = h), (e.stickType === g || g === "Any") && (e.contentType === k || k === "Any") && (M[m] = h);
         }
         if (y.length === 3) {
-          const [g = "Any", P, R] = y;
-          if (P === "Audio" && e.contentType === "Audio") {
+          const [g = "Any", k, R] = y;
+          if (k === "Audio" && e.contentType === "Audio") {
             const O = e;
             (O.stickType === g || g === "Any") && O.data.appearance === R && (M[m] = h);
           }
         }
       }
     });
-    const l = (F = e.initialConfig) != null ? F : {}, r = _({}, J, this.config.globalConfig, ...Object.values(o)), f = _({}, r, l), T = {}, d = Object.values(ie.Mode);
+    const l = (F = e.initialConfig) != null ? F : {}, r = P({}, J, this.config.globalConfig, ...Object.values(o)), f = P({}, r, l), T = {}, d = Object.values(ie.Mode);
     B(c).forEach(([u, h]) => {
       d.forEach((m) => {
-        (u === "PanoramaLike" && re(m) || u === "ModelLike" && ne(m)) && (T[m] = _({}, r, ...Object.values(h), l, { _isMerged: !0 }));
+        (u === "PanoramaLike" && re(m) || u === "ModelLike" && ne(m)) && (T[m] = P({}, r, ...Object.values(h), l, { _isMerged: !0 }));
       });
     }), B(p).forEach(([u, h]) => {
       const m = T[u];
-      T[u] = _({}, r, m, ...Object.values(h), l, { _isMerged: !0 });
+      T[u] = P({}, r, m, ...Object.values(h), l, { _isMerged: !0 });
     });
-    const k = Q(W({}, f), { configWithFiveMode: T });
-    return H(k), Object.values(T).forEach((u) => H(u)), k._isMerged = !0, k;
+    const _ = Q(W({}, f), { configWithFiveMode: T });
+    return H(_), Object.values(T).forEach((u) => H(u)), _._isMerged = !0, _;
   }
 }
 export {