@realsee/dnalogel 3.77.5 → 3.77.7

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

@@ -1,7 +1,7 @@
 import type { Tag, TagId, Tags, State, ContentTypeConfigKey } from '../typings';
 import type { TagClickParams, TagConfigByKey, TagContentType } from '..';
 import type { ArrayPosition } from '../typings';
-import { type Five } from '@realsee/five';
+import type { Five } from '@realsee/five';
 import { TagRender } from './TagRender';
 import type { PartialObjectDeep } from '../../typings/typings';
 export declare const pluginFlag: (name: string) => string;
@@ -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
      */
@@ -166,6 +184,41 @@ declare class PanoTagPluginController extends TagRender {
      * @returns 是否为有效的 ArrayPosition
      */
     private isValidArrayPosition;
+    /**
+     * 更新当前点位的 Mask 标签
+     * Mask 标签仅在当前点位可见
+     */
+    private updateMaskTagsForCurrentPano;
+    /**
+     * 获取所有 Mask 类型的标签
+     */
+    get filterMaskTag(): (import("./Tag/BaseTag").BaseTag<"Panorama" | "Model" | "Custom" | "Audio" | "Text" | "ImageText" | "Image" | "Video" | "Link" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Unknown", import("..").StickType> & {
+        [key: string]: any;
+    })[];
+    /**
+     * 获取 MaskTag 性能统计信息（用于性能监控和调试）
+     * @returns 性能统计信息
+     */
+    getMaskTagPerformanceStats(): {
+        totalMaskTags: number;
+        visibleMaskTags: number;
+        textureCache: {
+            totalCached: number;
+            totalRefCount: number;
+            estimatedMemoryMB: number;
+            cacheEntries: {
+                source: string;
+                refCount: number;
+                sizeMB: number;
+            }[];
+        };
+        currentPanoIndex: number;
+    };
+    /**
+     * 清理所有 MaskTag 纹理缓存（用于内存管理）
+     * 注意：这会释放所有纹理缓存，谨慎使用
+     */
+    clearMaskTagCache(): void;
 }
 export default PanoTagPluginController;
 export { PanoTagPluginController };