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

package/dist/PanoTagPlugin/controller/Tag/MaskTag.d.ts

@@ -5,6 +5,7 @@ import * as THREE from 'three';
 import type { PartialObjectDeep } from '../../../typings/typings';
 import type { Tag } from '../..';
 import type { State as FiveState } from '@realsee/five';
+import type { AnimeParams } from 'animejs';
 export type MaskTagInterface<C extends TagContentType = TagContentType> = TagInstance<C, 'Mask'>;
 /**
  * Mask 类型的标签
@@ -20,6 +21,8 @@ export declare class MaskTag<C extends TagContentType = TagContentType> extends
      * Canvas 到 Symbol 的映射（用于缓存 canvas 纹理）
      */
     private static canvasSymbolMap;
+    /** 同点位共用 mesh：key = meshKey(panoIndex + maskKey), value = 共享数据 */
+    private static sharedMeshRegistry;
     /**
      * mask 图片 URL 或 Canvas 元素（2:1 全景图格式）
      */
@@ -52,21 +55,48 @@ export declare class MaskTag<C extends TagContentType = TagContentType> extends
      * 点击事件清理函数
      */
     private clickEventDispose?;
+    /** 当前 tag 在共享 style 纹理中的下标（color 即 id） */
+    private sharedStyleIndex;
+    /** 共享 mesh 的 registry key，用于 updateMaskStyle / dispose 查找 entry */
+    private _sharedMeshKey;
     constructor(plugin: PanoTagPluginController, tagData: TagData);
+    private getColorKey;
+    /** 同点位共用一个 mesh，key 仅用 panoIndex（string/canvas 切换时不会因 key 不同而重复创建） */
+    private static getMeshKey;
+    /**
+     * 初始化/挂载到同点位共享 mesh，用 appendStyleToMaterial 注册本 tag 的 style（color 即 id）
+     */
+    private initializeMaskMesh;
+    /** 构建用于 mergedTexture 的 style 对象（color 作 id），tolerance 0–255 */
+    private buildStyleForMaterial;
+    private static createSharedMesh;
+    /** 仅更新材质中某一 slot 的 style（用于 enable/disable/updateMaskStyle） */
+    private updateStyleSlotInMaterial;
+    private setupSharedMeshRaycast;
     /**
      * 计算法向量
      * Mask 标签返回向上的法向量（因为是贴在 cube 面上）
      */
     computeNormal(): THREE.Vector3;
     /**
-     * 获取额外的闪烁目标
-     * 返回 maskMesh 用于 blink 动画
+     * 不把共享 mesh 作为 blink 目标，闪烁通过本 tag 的 style opacity 动画实现
      */
     protected getAdditionalBlinkTargets(): any | any[] | null;
+    /**
+     * 闪烁仅针对本 tag：通过改变本 tag 在 merged texture 中的 opacity 实现
+     */
+    blink(animeConfig?: Partial<AnimeParams>): Promise<void>;
     /**
      * 更新标签数据
      */
     set(tag: PartialObjectDeep<Tag<C, 'Mask'>>, deepMerge?: boolean): void;
+    /** 供 rebuildEntryMaterial 使用：返回当前 tag 的 style 对象 */
+    getStyleForMaterial(): {
+        color: number[];
+        tolerance: number;
+        highlightColor: number[];
+        opacity: number;
+    };
     /**
      * 重写 getVisible 方法
      * Mask 标签仅在当前点位可见
@@ -105,7 +135,7 @@ export declare class MaskTag<C extends TagContentType = TagContentType> extends
      */
     updateScreenPosition(): void;
     /**
-     * 应用可见性变化
+     * 应用可见性变化（通过 style opacity 控制展示，共享 mesh 保持 visible）
      */
     applyVisible(): void;
     /**
@@ -114,19 +144,23 @@ export declare class MaskTag<C extends TagContentType = TagContentType> extends
      */
     private updateMeshTransform;
     /**
-     * 初始化 Mask Mesh（使用 Sphere）
+     * 步骤1：从材质中解析出 styleList
+     * @param {THREE.ShaderMaterial} material - 目标材质
+     * @returns {Array} 解析后的 styleList
      */
-    private initializeMaskMesh;
+    private parseStyleListFromMaterial;
     /**
-     * 创建 Sphere mesh（参考 itemMask 实现）
+     * 步骤2：更新材质的样式纹理（追加新元素后）
+     * @param {THREE.ShaderMaterial} material - 目标材质
+     * @param {Array} newStyle - 要追加的新样式对象
      */
-    private createSphereMesh;
+    private appendStyleToMaterial;
     /**
      * 获取 Mask 样式配置（合并用户配置和默认值）
      */
     private getMaskStyle;
     /**
-     * 设置点击事件
+     * 设置点击事件（仅当 raycast 命中本 tag 的 color 时触发）
      */
     private setupClickEvents;
     /**
@@ -134,20 +168,26 @@ export declare class MaskTag<C extends TagContentType = TagContentType> extends
      */
     private cleanupClickEvents;
     /**
-     * 重新加载 mask 图
+     * 重新加载 mask 图：从旧点位 mesh 注销，再按新 maskUrl 初始化
      */
     private reloadMask;
     /**
-     * 更新 mask 样式
+     * changeTagById 改 mask 时：只更新共享 mesh 的 texture，不 unregister
+     * 有 entry 则换图；无 entry 则走完整初始化
+     */
+    private updateSharedMeshTexture;
+    /**
+     * 更新当前 tag 在共享材质中的 style slot（color/style 控制展示）
      */
-    private updateMaskStyle;
+    updateMaskStyle(): void;
     /**
      * 更新 Canvas 纹理（仅当 maskUrl 为 Canvas 时有效）
      * 当 canvas 内容发生变化时，调用此方法更新渲染
      */
     updateCanvasTexture(): void;
     /**
-     * 清理 MaskTag 特有的资源（内部方法，避免重复调用）
+     * 清理当前标签：从共享材质中删除本 tag 的样式槽，并更新材质；
+     * 若该点位已无其他 tag 则销毁 mesh 并释放纹理。
      */
     private disposeMaskResources;
     /**
@@ -155,13 +195,29 @@ export declare class MaskTag<C extends TagContentType = TagContentType> extends
      */
     dispose(): void;
     /**
-     * 禁用标签（重写父类方法）
+     * 禁用标签（通过 style opacity=0 隐藏，不拆 mesh）
      */
     disable(): void;
+    /**
+     * 启用标签（恢复 style 展示）
+     */
+    enable(): void;
     /**
      * 销毁标签（重写父类方法）
      */
     destroy(): void;
+    /**
+     * 清除所有点位共享 mesh（重新 load 数据前调用）
+     */
+    static clearSharedMeshRegistry(): void;
+    /**
+     * 将 style 列表写入材质（用于重建材质）
+     */
+    private static writeStyleListToMaterial;
+    /**
+     * destroy 后重建该点位材质，更新剩余 tag 的 styleIndex
+     */
+    private static rebuildEntryMaterial;
     /**
      * 获取 mask 的缓存 key
      * @param maskSource mask URL 或 Canvas

package/dist/PanoTagPlugin/controller/Tag/MaskTag.shaders.d.ts

@@ -11,4 +11,6 @@ export declare const maskVertexShader = "\nvarying vec2 vUv;\nvoid main() {\n  v
  * 实现颜色匹配和高亮渲染逻辑
  * 参考 MosaicPlugin 的边缘检测实现
  */
-export declare const maskFragmentShader = "\n#define RESOLUTION 2048.0\n\nvarying vec2 vUv;\nuniform sampler2D map;\nuniform vec4 color;\nuniform float tolerance;\nuniform vec3 highlightColor;\nuniform float opacity;\n\nfloat colorGap(vec3 color1, vec3 color2) {\n  float gap = abs(color1.r - color2.r) + abs(color1.g - color2.g) + abs(color1.b - color2.b);\n  return gap;\n}\n\n// \u5224\u65AD\u50CF\u7D20\u662F\u5426\u5339\u914D\u76EE\u6807\u989C\u8272\nbool isMatchingColor(vec3 pixelColor) {\n  // \u6392\u9664\u9ED1\u8272\u50CF\u7D20\n  if (pixelColor.r == 0.0 && pixelColor.g == 0.0 && pixelColor.b == 0.0) {\n    return false;\n  }\n  return colorGap(pixelColor, color.rgb) < tolerance;\n}\n\n// \u8FB9\u7F18\u68C0\u6D4B\u51FD\u6570\uFF1A\u53C2\u8003 MosaicPlugin \u5B9E\u73B0\nfloat detectEdge(sampler2D map, vec2 uv) {\n  vec4 centerColor = texture2D(map, uv);\n  \n  // \u5F53\u524D\u50CF\u7D20\u5FC5\u987B\u5339\u914D\u76EE\u6807\u989C\u8272\n  if (!isMatchingColor(centerColor.rgb)) {\n    return 0.0;\n  }\n  \n  float step = 1.0 / RESOLUTION;\n  \n  // \u68C0\u67E54\u4E2A\u4E3B\u8981\u65B9\u5411\u7684\u90BB\u5C45\u50CF\u7D20\n  vec4 upColor = texture2D(map, uv + vec2(0.0, -step));\n  vec4 leftColor = texture2D(map, uv + vec2(-step, 0.0));\n  vec4 rightColor = texture2D(map, uv + vec2(step, 0.0));\n  vec4 downColor = texture2D(map, uv + vec2(0.0, step));\n  \n  // \u53EA\u6709\u5F53\u524D\u50CF\u7D20\u5339\u914D\u989C\u8272\uFF0C\u4E14\u81F3\u5C11\u6709\u4E00\u4E2A\u90BB\u5C45\u4E0D\u5339\u914D\u65F6\uFF0C\u624D\u662F\u8FB9\u7F18\n  bool hasNonMatchingNeighbor = \n    !isMatchingColor(upColor.rgb) || \n    !isMatchingColor(leftColor.rgb) || \n    !isMatchingColor(rightColor.rgb) || \n    !isMatchingColor(downColor.rgb);\n  \n  return hasNonMatchingNeighbor ? 1.0 : 0.0;\n}\n\nvoid main() {\n  vec4 image = texture2D(map, vUv);\n  \n  // \u6392\u9664\u9ED1\u8272\u50CF\u7D20\n  if (image.r == 0.0 && image.g == 0.0 && image.b == 0.0) {\n    discard;\n  }\n  \n  // \u8BA1\u7B97\u5F53\u524D\u50CF\u7D20\u4E0E\u76EE\u6807\u989C\u8272\u7684\u5DEE\u5F02\n  float gap = colorGap(image.rgb, color.rgb);\n  \n  // \u4F7F\u7528\u56FA\u5B9A\u5E73\u6ED1\u8303\u56F4\u5B9E\u73B0\u989C\u8272\u5339\u914D\u8FB9\u754C\n  float smoothRange = 0.01;\n  \n  // \u5E73\u6ED1\u7684\u989C\u8272\u5339\u914D\u56E0\u5B50\uFF080-1\uFF09\n  float matchFactor = 1.0 - smoothstep(tolerance - smoothRange, tolerance + smoothRange, gap);\n  \n  if (matchFactor > 0.0) {\n    // \u4F7F\u7528\u65B0\u7684\u8FB9\u7F18\u68C0\u6D4B\u65B9\u6CD5\n    float isEdge = detectEdge(map, vUv);\n    \n    // \u8FB9\u7F18\u4F7F\u7528\u5B8C\u5168\u4E0D\u900F\u660E\uFF0C\u5185\u90E8\u4F7F\u7528\u8BBE\u5B9A\u7684\u900F\u660E\u5EA6\n    float alpha = mix(opacity, 1.0, isEdge);\n    \n    // \u5E94\u7528\u5339\u914D\u56E0\u5B50\uFF08\u5E73\u6ED1\u989C\u8272\u8FB9\u754C\uFF09\n    alpha *= matchFactor;\n    \n    gl_FragColor = vec4(highlightColor, alpha);\n  } else {\n    discard;\n  }\n}\n";
+export declare const maskFragmentShader = "\n#define RESOLUTION 2048.0\n\nvarying vec2 vUv;\nuniform sampler2D map;\nuniform vec4 color;\nuniform float tolerance;\nuniform vec3 highlightColor;\nuniform float opacity;\n\nfloat colorGap(vec3 color1, vec3 color2) {\n  float gap = abs(color1.r - color2.r) + abs(color1.g - color2.g) + abs(color1.b - color2.b);\n  return gap;\n}\n\n// \u5224\u65AD\u50CF\u7D20\u662F\u5426\u5339\u914D\u76EE\u6807\u989C\u8272\nbool isMatchingColor(vec3 pixelColor) {\n  // \u6392\u9664\u9ED1\u8272\u50CF\u7D20\n  if (pixelColor.r == 0.0 && pixelColor.g == 0.0 && pixelColor.b == 0.0) {\n    return false;\n  }\n  return colorGap(pixelColor, color.rgb) < tolerance;\n}\n\n// \u8FB9\u7F18\u68C0\u6D4B\u51FD\u6570\uFF1A\u53C2\u8003 MosaicPlugin \u5B9E\u73B0\nfloat detectEdge(sampler2D map, vec2 uv) {\n  vec4 centerColor = texture2D(map, uv);\n  \n  // \u5F53\u524D\u50CF\u7D20\u5FC5\u987B\u5339\u914D\u76EE\u6807\u989C\u8272\n  if (!isMatchingColor(centerColor.rgb)) {\n    return 0.0;\n  }\n  \n  float step = 1.0 / RESOLUTION;\n  \n  // \u68C0\u67E54\u4E2A\u4E3B\u8981\u65B9\u5411\u7684\u90BB\u5C45\u50CF\u7D20\n  vec4 upColor = texture2D(map, uv + vec2(0.0, -step));\n  vec4 leftColor = texture2D(map, uv + vec2(-step, 0.0));\n  vec4 rightColor = texture2D(map, uv + vec2(step, 0.0));\n  vec4 downColor = texture2D(map, uv + vec2(0.0, step));\n  \n  // \u53EA\u6709\u5F53\u524D\u50CF\u7D20\u5339\u914D\u989C\u8272\uFF0C\u4E14\u81F3\u5C11\u6709\u4E00\u4E2A\u90BB\u5C45\u4E0D\u5339\u914D\u65F6\uFF0C\u624D\u662F\u8FB9\u7F18\n  bool hasNonMatchingNeighbor = \n    !isMatchingColor(upColor.rgb) || \n    !isMatchingColor(leftColor.rgb) || \n    !isMatchingColor(rightColor.rgb) || \n    !isMatchingColor(downColor.rgb);\n  \n  return hasNonMatchingNeighbor ? 1.0 : 0.0;\n}\n\nvoid main() {\n  vec4 image = texture2D(map, vUv);\n  \n  // \u6392\u9664\u9ED1\u8272\u50CF\u7D20\n  if (image.r == 0.0 && image.g == 0.0 && image.b == 0.0) {\n    discard;\n  }\n  \n  // \u8BA1\u7B97\u5F53\u524D\u50CF\u7D20\u4E0E\u76EE\u6807\u989C\u8272\u7684\u5DEE\u5F02\n  float gap = colorGap(image.rgb, color.rgb);\n  \n  // \u4F7F\u7528\u56FA\u5B9A\u5E73\u6ED1\u8303\u56F4\u5B9E\u73B0\u989C\u8272\u5339\u914D\u8FB9\u754C\n  float smoothRange = 0.01;\n  \n  // \u5E73\u6ED1\u7684\u989C\u8272\u5339\u914D\u56E0\u5B50\uFF080-1\uFF09\n  float matchFactor = 1.0 - smoothstep(tolerance - smoothRange, tolerance + smoothRange, gap);\n  \n  if (matchFactor > 0.0) {\n    // \u4F7F\u7528\u65B0\u7684\u8FB9\u7F18\u68C0\u6D4B\u65B9\u6CD5\n    float isEdge = detectEdge(map, vUv);\n    \n    // \u8FB9\u7F18\u4F7F\u7528\u5B8C\u5168\u4E0D\u900F\u660E\uFF0C\u5185\u90E8\u4F7F\u7528\u8BBE\u5B9A\u7684\u900F\u660E\u5EA6\n    float alpha = mix(opacity, 1.0, isEdge);\n    \n    // \u5E94\u7528\u5339\u914D\u56E0\u5B50\u5B9E\u73B0\u8FB9\u754C\u5E73\u6ED1\uFF0C\u4F46\u4FDD\u7559\u6700\u5C0F 0.9 \u7684\u900F\u660E\u5EA6\n    // \u8FD9\u6837\u5373\u4F7F\u5728\u8FB9\u754C\u5904\u4E5F\u4E0D\u4F1A\u5B8C\u5168\u900F\u660E\uFF0C\u540C\u65F6\u5B8C\u5168\u5339\u914D\u533A\u57DF\u4FDD\u6301\u8BBE\u5B9A\u7684\u900F\u660E\u5EA6\n    alpha *= max(matchFactor, 0.9);\n    \n    gl_FragColor = vec4(highlightColor, alpha);\n  } else {\n    discard;\n  }\n}\n";
+/** 多 style：mergedTexture 中每组 3 像素为 color(id)/tolerance+highlight/opacity，用 color 作 id 匹配 */
+export declare const maskFragmentShaderMulti = "\n#define RESOLUTION 2048.0\n#define MAX_GROUPS 64\n#define STRICT_MATCH 0.5/255.0\n\nvarying vec2 vUv;\nuniform sampler2D map;\nuniform sampler2D mergedTexture;\nuniform float groupCount;\nuniform float textureWidth;\nuniform float pixelsPerGroup;\n\nfloat colorGap(vec3 a, vec3 b) {\n  return abs(a.r - b.r) + abs(a.g - b.g) + abs(a.b - b.b);\n}\n\nvec4 readStyleColor(float groupIndex) {\n  float px = groupIndex * pixelsPerGroup;\n  float texX = (px + 0.5) / textureWidth;\n  return texture2D(mergedTexture, vec2(texX, 0.5));\n}\n\nvec4 readStyleToleranceHighlight(float groupIndex) {\n  float px = groupIndex * pixelsPerGroup + 1.0;\n  float texX = (px + 0.5) / textureWidth;\n  return texture2D(mergedTexture, vec2(texX, 0.5));\n}\n\nfloat readStyleOpacity(float groupIndex) {\n  float px = groupIndex * pixelsPerGroup + 2.0;\n  float texX = (px + 0.5) / textureWidth;\n  return texture2D(mergedTexture, vec2(texX, 0.5)).r;\n}\n\nfloat detectEdge(sampler2D map, vec2 uv, vec3 matchColor, float tolerance) {\n  vec4 centerColor = texture2D(map, uv);\n  if (colorGap(centerColor.rgb, matchColor) >= tolerance) return 0.0;\n  float step = 1.0 / RESOLUTION;\n  vec4 u = texture2D(map, uv + vec2(0.0, -step));\n  vec4 l = texture2D(map, uv + vec2(-step, 0.0));\n  vec4 r = texture2D(map, uv + vec2(step, 0.0));\n  vec4 d = texture2D(map, uv + vec2(0.0, step));\n  bool edge = colorGap(u.rgb, matchColor) >= tolerance || colorGap(l.rgb, matchColor) >= tolerance\n    || colorGap(r.rgb, matchColor) >= tolerance || colorGap(d.rgb, matchColor) >= tolerance;\n  return edge ? 1.0 : 0.0;\n}\n\nvoid main() {\n  vec4 image = texture2D(map, vUv);\n  if (image.r == 0.0 && image.g == 0.0 && image.b == 0.0) discard;\n\n  // WebGL 1.0 \u8981\u6C42\u5FAA\u73AF\u7EC8\u6B62\u6761\u4EF6\u5FC5\u987B\u662F\u7F16\u8BD1\u65F6\u5E38\u91CF\uFF0C\u6240\u4EE5\u7528 MAX_GROUPS\uFF0C\u5FAA\u73AF\u5185\u68C0\u67E5 groupCount\n  for (float i = 0.0; i < float(MAX_GROUPS); i += 1.0) {\n    if (i < groupCount) {\n      vec4 styleColor = readStyleColor(i);\n      vec3 colorRgb = styleColor.rgb;\n      float tol = readStyleToleranceHighlight(i).r * 3.0;\n      vec3 highlight = readStyleToleranceHighlight(i).gba;\n      float opacity = readStyleOpacity(i);\n      \n      if (opacity > 0.0) {\n        float gap = colorGap(image.rgb, colorRgb);\n        if (gap > STRICT_MATCH) continue;\n        float smoothRange = 0.01;\n        float matchFactor = 1.0 - smoothstep(tol - smoothRange, tol + smoothRange, gap);\n        if (matchFactor > 0.0) {\n          float isEdge = detectEdge(map, vUv, colorRgb, tol);\n          float alpha = mix(opacity, 1.0, isEdge);\n          alpha *= max(matchFactor, 0.9);\n          gl_FragColor = vec4(highlight, alpha);\n          return;\n        }\n      }\n    }\n  }\n  discard;\n}\n";

package/dist/PanoTagPlugin/controller/index.d.ts

@@ -28,8 +28,13 @@ declare class PanoTagPluginController extends TagRender {
     load(data: Tags): Promise<void>;
     /**
      * @description 添加标签
+     * @param tag 标签或标签数组
+     * @param options 可选配置
+     * @param options.updateMaskUrl 是否更新 mask。若为 true 且该 panoIndex 已有 Mask 标签，仅更新其 maskUrl（不变 color、style），并添加新标签
      */
-    addTag(tag: Tag | Tag[]): Promise<void>;
+    addTag(tag: Tag | Tag[], options?: {
+        updateMaskUrl?: boolean;
+    }): Promise<void>;
     /**
      * @description 改变配置
      */
@@ -103,6 +108,19 @@ declare class PanoTagPluginController extends TagRender {
      * @description 改变tag任意属性
      */
     changeTagById<C extends TagContentType = TagContentType>(id: TagId, tag: PartialObjectDeep<Tag<C>>, deepMerge?: boolean): void;
+    /**
+     * @description 批量更新指定点位的 Mask 图
+     * @param maskUpdates 包含点位索引和对应 mask 的数组
+     * @example
+     * changeMask([
+     *   { index: 0, mask: 'https://example.com/mask1.png' },
+     *   { index: 1, mask: canvasElement }
+     * ])
+     */
+    changeMask(maskUpdates: Array<{
+        index: number;
+        mask: string | HTMLCanvasElement;
+    }>): void;
     /**
      * @description 销毁tag
      */