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

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

@@ -1,34 +1,34 @@
-var E = Object.defineProperty;
-var w = Object.getOwnPropertySymbols;
-var F = Object.prototype.hasOwnProperty, A = Object.prototype.propertyIsEnumerable;
-var T = (p, o, t) => o in p ? E(p, o, { enumerable: !0, configurable: !0, writable: !0, value: t }) : p[o] = t, M = (p, o) => {
-  for (var t in o || (o = {}))
-    F.call(o, t) && T(p, t, o[t]);
-  if (w)
-    for (var t of w(o))
-      A.call(o, t) && T(p, t, o[t]);
-  return p;
+var S = Object.defineProperty;
+var E = Object.getOwnPropertySymbols;
+var I = Object.prototype.hasOwnProperty, F = Object.prototype.propertyIsEnumerable;
+var w = (o, r, e) => r in o ? S(o, r, { enumerable: !0, configurable: !0, writable: !0, value: e }) : o[r] = e, M = (o, r) => {
+  for (var e in r || (r = {}))
+    I.call(r, e) && w(o, e, r[e]);
+  if (E)
+    for (var e of E(r))
+      F.call(r, e) && w(o, e, r[e]);
+  return o;
 };
-var u = (p, o, t) => (T(p, typeof o != "symbol" ? o + "" : o, t), t);
-var C = (p, o, t) => new Promise((e, i) => {
-  var s = (a) => {
+var c = (o, r, e) => (w(o, typeof r != "symbol" ? r + "" : r, e), e);
+var v = (o, r, e) => new Promise((t, s) => {
+  var a = (l) => {
     try {
-      r(t.next(a));
-    } catch (c) {
-      i(c);
+      i(e.next(l));
+    } catch (u) {
+      s(u);
     }
-  }, h = (a) => {
+  }, n = (l) => {
     try {
-      r(t.throw(a));
-    } catch (c) {
-      i(c);
+      i(e.throw(l));
+    } catch (u) {
+      s(u);
     }
-  }, r = (a) => a.done ? e(a.value) : Promise.resolve(a.value).then(s, h);
-  r((t = t.apply(p, o)).next());
+  }, i = (l) => l.done ? t(l.value) : Promise.resolve(l.value).then(a, n);
+  i((e = e.apply(o, r)).next());
 });
 import { BaseTag as P } from "./BaseTag.js";
-import * as n from "three";
-import { maskVertexShader as V, maskFragmentShader as z } from "./MaskTag.shaders.js";
+import * as m from "three";
+import { maskVertexShader as V, maskFragmentShader as R } from "./MaskTag.shaders.js";
 import "../../../shared-utils/Subscribe.js";
 import "../../utils/tag/calculateTagConfig.js";
 import "../../../vendor/object-assign-deep/objectAssignDeep.js";
@@ -114,73 +114,126 @@ import "../../../shared-utils/five/getFloorIndex.js";
 import "../../../shared-utils/safeObj.js";
 import "../../utils/Cache.js";
 import "../../../shared-utils/promise/withResolvers.js";
-const l = class extends P {
-  constructor(t, e) {
-    super(t, e);
+function C(o) {
+  if (Array.isArray(o))
+    return o;
+  if (typeof o == "number")
+    return [o >> 16 & 255, o >> 8 & 255, o & 255];
+  if (typeof o == "string") {
+    let r = o.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:", o);
+  }
+  return [0, 0, 0];
+}
+const h = class extends P {
+  constructor(e, t) {
+    super(e, t);
     /**
-     * mask 图片 URL（2:1 全景图格式）
+     * mask 图片 URL 或 Canvas 元素（2:1 全景图格式）
      */
-    u(this, "maskUrl");
+    c(this, "maskUrl");
     /**
      * 目标颜色（RGB 格式）
      */
-    u(this, "targetColor");
+    c(this, "targetColor");
     /**
      * mask 渲染的 mesh 对象（使用 Sphere）
      */
-    u(this, "maskMesh");
+    c(this, "maskMesh");
     /**
      * mask 纹理对象
      */
-    u(this, "maskTexture");
+    c(this, "maskTexture");
     /**
      * 是否正在加载 mask
      */
-    u(this, "loadingMask", !1);
+    c(this, "loadingMask", !1);
+    /**
+     * 资源是否已释放
+     */
+    c(this, "_disposed", !1);
     /**
      * 标签样式配置
      */
-    u(this, "tagStyle");
+    c(this, "tagStyle");
     /**
      * 点击事件清理函数
      */
-    u(this, "clickEventDispose");
-    this.maskUrl = e.mask || "";
-    const i = e.color;
-    Array.isArray(i) ? this.targetColor = i : typeof i == "number" ? this.targetColor = [i >> 16 & 255, i >> 8 & 255, i & 255] : this.targetColor = [0, 0, 0], this.tagStyle = e.style, this.updateVisible(), this.currentVisible && this.initializeMaskMesh();
+    c(this, "clickEventDispose");
+    const s = t.mask;
+    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 n.Vector3(0, 1, 0);
+    return new m.Vector3(0, 1, 0);
+  }
+  /**
+   * 获取额外的闪烁目标
+   * 返回 maskMesh 用于 blink 动画
+   */
+  getAdditionalBlinkTargets() {
+    return this.maskMesh || null;
   }
   /**
    * 更新标签数据
    */
-  set(t, e = !0) {
-    if (super.set(t, e), t.style && (this.tagStyle = M(M({}, this.tagStyle), t.style)), t.mask && (this.maskUrl = t.mask, this.reloadMask()), t.color) {
-      const i = t.color;
-      Array.isArray(i) ? this.targetColor = i : typeof i == "number" && (this.targetColor = [i >> 16 & 255, i >> 8 & 255, i & 255]), this.updateMaskStyle();
-    }
+  set(e, t = !0) {
+    super.set(e, t), e.style && (this.tagStyle = M(M({}, this.tagStyle), e.style)), e.mask && (this.maskUrl = e.mask, this.reloadMask()), e.color !== void 0 && (this.targetColor = C(e.color), this.updateMaskStyle());
   }
   /**
    * 重写 getVisible 方法
    * Mask 标签仅在当前点位可见
    */
-  getVisible(t) {
-    var s;
-    if (!this.enabled || !this.plugin.state.enabled || !this.fiveUtil.model)
+  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;
-    const e = M(M({}, this.five.getCurrentState()), t), { panoIndex: i } = e;
-    return i !== ((s = this.fiveState) == null ? void 0 : s.panoIndex) ? !1 : super.getVisible(e);
+    }
+  }
+  /**
+   * 重写 computeVisible 方法
+   * 增加 Mask 特有的可见性检查逻辑，用于 whyHide 功能
+   */
+  computeVisible(e) {
+    var a, n, 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}, 标签点位: ${(n = this.fiveState) == null ? void 0 : n.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(t) {
-    t.target === "TagMaskModel" && this.unfoldAndFoldOthers();
+  onClick(e) {
+    e.target === "TagMaskModel" && this.unfoldAndFoldOthers();
   }
   /**
    * 展开自己，收起其他标签
@@ -188,9 +241,9 @@ const l = class extends P {
   unfoldAndFoldOthers() {
     if (this.isPopoverConfigEnabled())
       return;
-    const t = this.can("fold"), e = this.can("unfold");
-    t && e && (this.state.unfolded = !this.state.unfolded, this.manuallyOperated = !0, this.plugin.addRenderQueue({ type: "TagContainerSvelte", keys: ["tags"] }), this.state.unfolded && this.plugin.tags.forEach((i) => {
-      i.id !== this.id && i.fold();
+    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();
     }));
   }
   /**
@@ -208,11 +261,11 @@ const l = class extends P {
   /**
    * 设置展开/折叠状态
    */
-  setUnfold(t) {
+  setUnfold(e) {
     if (this.isPopoverConfigEnabled())
       return;
-    const e = this.can("fold"), i = this.can("unfold");
-    e && i && (this.state.unfolded = t, this.hooks.emit(t ? "unfolded" : "folded"), this.plugin.addRenderQueue({ type: "TagContainerSvelte", keys: ["tags"] }));
+    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"] }));
   }
   /**
    * 更新屏幕位置
@@ -222,12 +275,12 @@ const l = class extends P {
       this.screenPosition = null, this.plugin.addRenderQueue({ type: "TagContainerSvelte", keys: ["tags"] });
       return;
     }
-    const e = new n.Vector3(...this.position).clone().project(this.five.camera);
+    const t = new m.Vector3(...this.position).clone().project(this.five.camera);
     if (this.five.renderer) {
-      const i = this.five.renderer.getSize(new n.Vector2());
+      const s = this.five.renderer.getSize(new m.Vector2());
       this.screenPosition = {
-        leftPx: (e.x + 1) / 2 * i.x,
-        topPx: (-e.y + 1) / 2 * i.y,
+        leftPx: (t.x + 1) / 2 * s.x,
+        topPx: (-t.y + 1) / 2 * s.y,
         scale: 1
       };
     }
@@ -237,37 +290,45 @@ const l = class extends P {
    * 应用可见性变化
    */
   applyVisible() {
-    this.visible && !this.maskMesh && !this.loadingMask && this.initializeMaskMesh(), this.maskMesh && (this.maskMesh.visible = this.visible, this.updateMeshTransform()), this.updateScreenPosition();
+    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 i;
+    var s;
     if (!this.maskMesh)
       return;
-    const t = (i = this.fiveState) == null ? void 0 : i.panoIndex;
-    if (t === void 0)
+    const e = (s = this.fiveState) == null ? void 0 : s.panoIndex;
+    if (e === void 0)
       return;
-    const e = this.workUtil.getObserver(t);
-    e && (this.maskMesh.position.copy(e.position), this.maskMesh.quaternion.copy(e.quaternion), this.five.needsRender = !0);
+    const t = this.workUtil.getObserver(e);
+    t && (this.maskMesh.position.copy(t.position), this.maskMesh.quaternion.copy(t.quaternion), this.five.needsRender = !0);
   }
   /**
    * 初始化 Mask Mesh（使用 Sphere）
    */
   initializeMaskMesh() {
-    return C(this, null, function* () {
+    return v(this, null, function* () {
       if (this.maskMesh || this.loadingMask || !this.maskUrl)
         return;
       this.loadingMask = !0;
-      const t = performance.now();
+      const e = performance.now();
       try {
-        this.maskTexture = yield l.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 e = performance.now() - t;
-        console.log(`[MaskTag Performance] Mesh initialized in ${e.toFixed(2)}ms for tag ${this.id}`);
-      } catch (e) {
-        console.error("[MaskTag] Failed to initialize mask mesh:", e);
+        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;
       }
@@ -276,69 +337,69 @@ const l = class extends P {
   /**
    * 创建 Sphere mesh（参考 itemMask 实现）
    */
-  createSphereMesh(t) {
-    const e = this.getMaskStyle(), i = new n.Vector4(this.targetColor[0] / 255, this.targetColor[1] / 255, this.targetColor[2] / 255, 1), s = new n.ShaderMaterial({
+  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: z,
+      fragmentShader: R,
       uniforms: {
-        map: { value: t },
-        color: { value: i },
-        tolerance: { value: e.tolerance / 255 },
+        map: { value: e },
+        color: { value: s },
+        tolerance: { value: t.tolerance / 255 },
         // 归一化容差
         highlightColor: {
-          value: new n.Vector3(e.highlightColor[0] / 255, e.highlightColor[1] / 255, e.highlightColor[2] / 255)
+          value: new m.Vector3(t.highlightColor[0] / 255, t.highlightColor[1] / 255, t.highlightColor[2] / 255)
         },
-        opacity: { value: e.opacity }
+        opacity: { value: t.opacity }
       },
       depthWrite: !1,
       depthTest: !1,
       transparent: !0
-    }), h = new n.SphereGeometry(1, 60, 40);
-    h.rotateY(-Math.PI / 2), h.scale(-1, 1, 1);
-    const r = new n.Mesh(h, s);
-    r.renderOrder = -1e3;
-    let a = null;
-    const c = () => {
-      if (a)
-        return a;
-      if (!t.image)
+    }), n = new m.SphereGeometry(1, 60, 40);
+    n.rotateY(-Math.PI / 2), n.scale(-1, 1, 1);
+    const i = new m.Mesh(n, a);
+    i.renderOrder = -1e3;
+    let l = null;
+    const u = () => {
+      if (l)
+        return l;
+      if (!e.image)
         return null;
       try {
-        const m = document.createElement("canvas"), k = m.getContext("2d");
-        if (!k)
+        const f = document.createElement("canvas"), d = f.getContext("2d");
+        if (!d)
           return null;
-        const d = t.image;
-        return m.width = d.width, m.height = d.height, k.drawImage(d, 0, 0), a = k.getImageData(0, 0, d.width, d.height), a;
-      } catch (m) {
-        return console.error("[MaskTag] Failed to get image data:", m), 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 = r.raycast.bind(r);
-    return r.raycast = (m, k) => {
-      const d = [];
-      if (g(m, d), d.length > 0) {
-        const y = d[0];
-        if (y.uv && t.image) {
-          const f = c();
-          if (f) {
-            const S = Math.floor(y.uv.x * f.width), v = (Math.floor((1 - y.uv.y) * f.height) * f.width + S) * 4, x = [f.data[v], f.data[v + 1], f.data[v + 2]];
-            Math.abs(x[0] / 255 - this.targetColor[0] / 255) + Math.abs(x[1] / 255 - this.targetColor[1] / 255) + Math.abs(x[2] / 255 - this.targetColor[2] / 255) < e.tolerance && k.push(y);
+    }, 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 U = Math.floor(y.uv.x * k.width), T = (Math.floor((1 - y.uv.y) * k.height) * k.width + U) * 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);
           }
         }
       }
-    }, r.__maskTag = this.id, r.__maskMesh = !0, r;
+    }, i.__maskTag = this.id, i.__maskMesh = !0, i;
   }
   /**
    * 获取 Mask 样式配置（合并用户配置和默认值）
    */
   getMaskStyle() {
-    var i, s, h;
-    const t = ((i = this.tagStyle) == null ? void 0 : i.mask) || {};
-    let e = [86, 134, 253];
-    return t.color ? Array.isArray(t.color) ? e = t.color : typeof t.color == "number" && (e = [t.color >> 16 & 255, t.color >> 8 & 255, t.color & 255]) : t.highlightColor && (Array.isArray(t.highlightColor) ? e = t.highlightColor : typeof t.highlightColor == "number" && (e = [t.highlightColor >> 16 & 255, t.highlightColor >> 8 & 255, t.highlightColor & 255])), {
-      tolerance: (s = t.tolerance) != null ? s : 1e-3,
+    var s, a, n;
+    const e = ((s = this.tagStyle) == null ? void 0 : s.mask) || {};
+    let t = [86, 134, 253];
+    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: e,
-      opacity: (h = t.opacity) != null ? h : 0.6
+      highlightColor: t,
+      opacity: (n = e.opacity) != null ? n : 0.6
       // 默认 0.6（用于填充区域）
     };
   }
@@ -349,11 +410,11 @@ const l = class extends P {
     if (!this.maskMesh || this.config.clickable === !1)
       return;
     this.cleanupClickEvents();
-    const t = (e) => {
-      this.plugin.hooks.emit("click", { event: e, target: "TagMaskModel", tag: this });
+    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, t));
+      !this.maskMesh || !this.plugin.domEvents || (this.clickEventDispose = this.addObjectClickHandler(this, this.maskMesh, e));
     });
   }
   /**
@@ -366,8 +427,8 @@ const l = class extends P {
    * 重新加载 mask 图
    */
   reloadMask() {
-    return C(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((t) => t.dispose()) : this.maskMesh.material.dispose()), this.maskMesh = void 0), this.maskTexture && this.maskUrl && (l.releaseMaskTexture(this.maskUrl), this.maskTexture = void 0), yield this.initializeMaskMesh();
+    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((e) => e.dispose()) : this.maskMesh.material.dispose()), this.maskMesh = void 0), this.maskTexture && this.maskUrl && (h.releaseMaskTexture(this.maskUrl), this.maskTexture = void 0), yield this.initializeMaskMesh();
     });
   }
   /**
@@ -376,98 +437,149 @@ const l = class extends P {
   updateMaskStyle() {
     if (!this.maskMesh)
       return;
-    const t = this.getMaskStyle(), e = this.maskMesh.material;
-    e.uniforms && (e.uniforms.color.value.set(this.targetColor[0] / 255, this.targetColor[1] / 255, this.targetColor[2] / 255, 1), e.uniforms.tolerance.value = t.tolerance / 255, e.uniforms.highlightColor.value.set(
-      t.highlightColor[0] / 255,
-      t.highlightColor[1] / 255,
-      t.highlightColor[2] / 255
-    ), e.uniforms.opacity.value = t.opacity), this.five.needsRender = !0;
+    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.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((t) => t.dispose()) : this.maskMesh.material.dispose()), this.maskMesh = void 0), this.maskTexture && this.maskUrl && (l.releaseMaskTexture(this.maskUrl), this.maskTexture = void 0);
+    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 maskUrl mask 图片 URL
+   * @param maskSource mask 图片 URL 或 Canvas 元素
    * @returns Promise<THREE.Texture>
    */
-  static loadMaskTexture(t) {
-    return C(this, null, function* () {
-      const e = l.maskTextureCache.get(t);
-      if (e)
-        return e.refCount++, e.texture;
-      const i = performance.now(), s = new AbortController(), h = new n.TextureLoader();
+  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(), n = new AbortController();
       try {
-        const r = yield new Promise((c, g) => {
-          if (s.signal.aborted) {
-            g(new Error("Load aborted"));
-            return;
-          }
-          h.load(
-            t,
-            (m) => {
-              s.signal.aborted ? (m.dispose(), g(new Error("Load aborted"))) : c(m);
-            },
-            void 0,
-            (m) => {
-              g(m);
+        let i;
+        if (typeof e == "string") {
+          const g = new m.TextureLoader();
+          i = yield new Promise((f, d) => {
+            if (n.signal.aborted) {
+              d(new Error("Load aborted"));
+              return;
             }
-          ), s.signal.addEventListener("abort", () => {
-            g(new Error("Load aborted"));
+            g.load(
+              e,
+              (p) => {
+                n.signal.aborted ? (p.dispose(), d(new Error("Load aborted"))) : f(p);
+              },
+              void 0,
+              (p) => {
+                d(p);
+              }
+            ), n.signal.addEventListener("abort", () => {
+              d(new Error("Load aborted"));
+            });
           });
-        });
-        r.wrapS = n.ClampToEdgeWrapping, r.wrapT = n.ClampToEdgeWrapping, r.minFilter = n.LinearFilter, r.magFilter = n.LinearFilter, r.anisotropy = 4, l.maskTextureCache.set(t, {
-          texture: r,
+        } 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: s
+          abortController: n
         });
-        const a = performance.now() - i;
-        if (console.log(`[MaskTag Performance] Texture loaded in ${a.toFixed(2)}ms, URL: ${t.substring(0, 50)}...`), r.image) {
-          const c = (r.image.width * r.image.height * 4 / 1048576).toFixed(2);
-          console.log(`[MaskTag Memory] Texture size: ${r.image.width}x${r.image.height}, estimated memory: ${c}MB`);
+        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 r;
-      } catch (r) {
-        throw console.error("[MaskTag] Failed to load mask texture:", t, r), r;
+        return i;
+      } catch (i) {
+        throw console.error("[MaskTag] Failed to load mask texture:", typeof e == "string" ? e : "Canvas", i), i;
       }
     });
   }
   /**
    * 释放 Mask 纹理（静态方法）
-   * @param maskUrl mask 图片 URL
+   * @param maskSource mask 图片 URL 或 Canvas 元素
    */
-  static releaseMaskTexture(t) {
-    var i;
-    const e = l.maskTextureCache.get(t);
-    e && (e.refCount--, e.refCount <= 0 && (console.log(`[MaskTag Memory] Releasing texture (refCount=0): ${t.substring(0, 50)}...`), (i = e.abortController) == null || i.abort(), e.texture.dispose(), l.maskTextureCache.delete(t)));
+  static releaseMaskTexture(e) {
+    var a;
+    const t = h.getMaskCacheKey(e), s = h.maskTextureCache.get(t);
+    if (s && (s.refCount--, s.refCount <= 0)) {
+      const n = typeof e == "string" ? e.substring(0, 50) : "Canvas";
+      console.log(`[MaskTag Memory] Releasing texture (refCount=0): ${n}`), (a = s.abortController) == null || a.abort(), s.texture.dispose(), h.maskTextureCache.delete(t);
+    }
   }
   /**
    * 获取当前缓存的纹理统计信息（用于性能监控和调试）
    * @returns 缓存统计信息
    */
   static getCacheStats() {
-    let t = 0, e = 0;
-    const i = [];
-    return l.maskTextureCache.forEach((s, h) => {
-      t += s.refCount;
-      let r = 0;
-      if (s.texture.image) {
-        const a = s.texture.image.width || 0, c = s.texture.image.height || 0;
-        r = a * c * 4 / (1024 * 1024), e += r;
+    let e = 0, t = 0;
+    const s = [];
+    return h.maskTextureCache.forEach((a, n) => {
+      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;
       }
-      i.push({
-        url: h.substring(0, 80),
-        refCount: s.refCount,
-        sizeMB: parseFloat(r.toFixed(2))
+      const l = typeof n == "string" ? n.substring(0, 80) : "[Canvas]";
+      s.push({
+        source: l,
+        refCount: a.refCount,
+        sizeMB: parseFloat(i.toFixed(2))
       });
     }), {
-      totalCached: l.maskTextureCache.size,
-      totalRefCount: t,
-      estimatedMemoryMB: parseFloat(e.toFixed(2)),
-      cacheEntries: i
+      totalCached: h.maskTextureCache.size,
+      totalRefCount: e,
+      estimatedMemoryMB: parseFloat(t.toFixed(2)),
+      cacheEntries: s
     };
   }
   /**
@@ -475,18 +587,21 @@ const l = class extends P {
    * 注意：这会释放所有纹理，即使它们仍在使用中
    */
   static clearAllCache() {
-    console.warn("[MaskTag] Clearing all texture cache"), l.maskTextureCache.forEach((t) => {
-      var e;
-      (e = t.abortController) == null || e.abort(), t.texture.dispose();
-    }), l.maskTextureCache.clear();
+    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 b = l;
+let x = h;
 /**
  * Mask 纹理缓存（静态，所有 MaskTag 实例共享）
- * key: mask URL, value: { texture: THREE.Texture, refCount: number, abortController?: AbortController }
+ * key: mask URL 或 canvas 的 symbol, value: { texture: THREE.Texture, refCount: number, abortController?: AbortController }
+ */
+c(x, "maskTextureCache", /* @__PURE__ */ new Map()), /**
+ * Canvas 到 Symbol 的映射（用于缓存 canvas 纹理）
  */
-u(b, "maskTextureCache", /* @__PURE__ */ new Map());
+c(x, "canvasSymbolMap", /* @__PURE__ */ new WeakMap());
 export {
-  b as MaskTag
+  x as MaskTag
 };