@realsee/dnalogel 3.77.5 → 3.77.7

package/dist/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 };

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

@@ -33,6 +33,15 @@ export type TagClickParams = {
 } | {
     target: 'TagPopoverContent';
     tag: TagInstance;
+} | {
+    target: 'TagBoxModel';
+    tag: TagInstance;
+} | {
+    target: 'TagPolygonModel';
+    tag: TagInstance;
+} | {
+    target: 'TagMaskModel';
+    tag: TagInstance;
 });
 export interface PluginEventMap extends BasePlugin.EventMap<State> {
     loaded: () => void;
@@ -79,6 +88,7 @@ export type TagEvents<C extends TagContentType = TagContentType> = {
     }) => void;
     showPopover: () => void;
     hidePopover: () => void;
+    positionChanged: (position: TagInstance<C>['position']) => void;
 };
 export interface TagCacheInterface {
     visible?: boolean;

package/dist/PanoTagPlugin/typings/tag/Tag.d.ts

@@ -1,7 +1,7 @@
 import type { State as FiveState } from '@realsee/five';
 import type { TagConfig } from './TagConfig';
 import type { ContentTypeMap, TagContentType } from './TagData';
-import type { Position, TagId, StickType, TagStyle, ElementRenderer, TagConfigByKey, ContentTypeConfigKey } from './Utils';
+import type { Position, TagId, StickType, TagStyle, ElementRenderer, TagConfigByKey, ContentTypeConfigKey, BoxPosition, PolygonPosition, MaskPosition } from './Utils';
 import type { DeprecatedTagProperty } from '../../Archive/deprecated';
 import type { LiteralUnion } from 'type-fest';
 export interface Tags {
@@ -33,7 +33,7 @@ export type Tag<C extends TagContentType = TagContentType, S extends StickType =
      */
     contentType: LiteralUnion<C, string>;
     /** 点 */
-    position: S extends 'Plane' ? [Position, Position, Position, Position] : S extends '2DPoint' | '3DPoint' | 'Model' ? Position : Position | [Position, Position, Position, Position];
+    position: S extends 'Plane' ? [Position, Position, Position, Position] : S extends '2DPoint' | '3DPoint' | 'Model' ? Position : S extends '3DBox' ? BoxPosition : S extends 'Polygon' ? PolygonPosition : S extends 'Mask' ? MaskPosition : Position | [Position, Position, Position, Position];
     /** 法向量 */
     normal?: Position;
     /** 自定义标签内容 */
@@ -52,8 +52,13 @@ export type Tag<C extends TagContentType = TagContentType, S extends StickType =
     hoverEnabled?: boolean;
 } & (S extends '3DPoint' ? {
     normal: Position;
-} : unknown) & (S extends 'Model' ? {
+} : unknown) & // 三维标签需要法向量
+(S extends 'Model' ? {
     matrix: number[];
+} : unknown) & // 模型标签需要模型
+(S extends 'Mask' ? {
+    mask: string | HTMLCanvasElement;
+    color: [number, number, number] | number | string;
 } : unknown) & {
     [key: string]: any;
 };

package/dist/PanoTagPlugin/typings/tag/Utils.d.ts

@@ -15,7 +15,34 @@ export interface MinMax {
     min?: number;
     max?: number;
 }
-export type StickType = '2DPoint' | '3DPoint' | 'Plane' | 'Model';
+export type StickType = '2DPoint' | '3DPoint' | 'Plane' | 'Model' | '3DBox' | 'Polygon' | 'Mask';
+/**
+ * 3DBox 位置定义
+ */
+export interface BoxPosition {
+    /** 起始点坐标 [x, y, z] */
+    start: ArrayPosition;
+    /** 结束点坐标 [x, y, z] */
+    end: ArrayPosition;
+    /** 旋转角度 [x, y, z]（欧拉角） */
+    rotation: ArrayPosition;
+}
+/** 3DBox 标签 */
+export type BoxTag<C extends TagContentType = TagContentType> = TagInstance<C, '3DBox'>;
+/**
+ * Polygon 位置定义
+ * 多边形由多个点组成，至少需要 3 个点
+ */
+export type PolygonPosition = ArrayPosition[];
+/** Polygon 标签 */
+export type PolygonTag<C extends TagContentType = TagContentType> = TagInstance<C, 'Polygon'>;
+/**
+ * Mask 位置定义
+ * Mask 标签的 position 由 mask 图和 color 计算得出，类型为普通的 Position
+ */
+export type MaskPosition = Position;
+/** Mask 标签 */
+export type MaskTag<C extends TagContentType = TagContentType> = TagInstance<C, 'Mask'>;
 /**
  * @description 标签 icon 动画配置
  */
@@ -67,6 +94,28 @@ export interface TagStyle {
          */
         size?: 'S' | 'M' | 'L' | 'XL' | number;
     } & TagIconUrl;
+    /** 3D Box 和Polygon样式 */
+    boxOrpolygon?: {
+        /** 填充颜色（十六进制） */
+        color?: number;
+        /** 填充透明度 0-1 */
+        opacity?: number;
+        /** 线条颜色（十六进制） */
+        lineColor?: number;
+        /** 线条宽度 */
+        lineWidth?: number;
+    };
+    /** Mask 标签样式 */
+    mask?: {
+        /** 高亮颜色（支持 RGB 数组、十六进制数字、#FFFFFF 格式字符串） */
+        color?: [number, number, number] | number | string;
+        /** 透明度 0-1，用于填充区域；描边区域始终完全不透明 */
+        opacity?: number;
+        /** 颜色匹配容差（归一化值 0-1，默认 0.001） */
+        tolerance?: number;
+        /** @deprecated 使用 color 代替 */
+        highlightColor?: [number, number, number] | number;
+    };
 }
 export type TagGLTFObject = GLTFObject & {
     customID: number | string;

package/dist/PanoTagPlugin/utils/sculptDataToBoxPosition.d.ts

@@ -0,0 +1,6 @@
+import * as THREE from 'three';
+import type { BoxPosition } from '../typings';
+/**
+ * 将 Sculpt 数据转换为 BoxPosition
+ */
+export declare function sculptDataToBoxPosition(bottomPoints: THREE.Vector3[], heightPoint: THREE.Vector3): BoxPosition;

package/dist/PanoTagPlugin/utils/tag/tagCheck.d.ts

@@ -1,9 +1,15 @@
 import type { TagContentType, TagInstance } from '../../typings';
 import type { ModelTagInterface } from '../../controller/Tag/ModelTag';
 import type { PlaneTagInterface } from '../../controller/Tag/PlaneTag';
+import type { PolygonTagInterface } from '../../controller/Tag/PolygonTag';
+import type { BoxTagInterface } from '../../controller/Tag/BoxTag';
+import type { MaskTagInterface } from '../../controller/Tag/MaskTag';
 export declare function isPlaneTag<T extends TagContentType>(tag: TagInstance<T>): tag is PlaneTagInterface<T>;
 export declare function isPoint3DTag<T extends TagContentType>(tag: TagInstance<T>): tag is TagInstance<T, '3DPoint'>;
 export declare function is3DTag<T extends TagContentType>(tag: TagInstance): tag is TagInstance<T, '3DPoint'> | TagInstance<T, 'Plane'>;
 export declare function isMediaModelTag(tag: TagInstance): tag is ModelTagInterface<'MediaModel'>;
 export declare function isModelTag(tag: TagInstance): tag is ModelTagInterface<'Model'>;
 export declare function isMediaPlaneTag(tag: TagInstance): tag is PlaneTagInterface<'MediaModel'>;
+export declare function isPolygonTag(tag: TagInstance): tag is PolygonTagInterface;
+export declare function is3DBoxTag(tag: TagInstance): tag is BoxTagInterface;
+export declare function isMaskTag(tag: TagInstance): tag is MaskTagInterface;

package/dist/PanoTagPlugin/utils/tagPosition.d.ts

@@ -1,4 +1,13 @@
-import { Vector3 } from 'three';
-import type { TagInstance } from '../typings';
-export declare function getTagPosition(tag: TagInstance): Vector3 | [Vector3, Vector3, Vector3, Vector3];
+import type { Vector3 } from 'three';
+import { Matrix4 } from 'three';
+import type { TagInstance, BoxPosition } from '../typings';
+/**
+ * 计算 BoxPosition 的8个角点
+ */
+export declare function getBoxCorners(boxPosition: BoxPosition, transform: Matrix4): Vector3[];
+/**
+ * 应用 matrix 变换到点数组
+ */
+export declare function applyMatrixToPoints(points: Vector3[], matrix?: number[]): Vector3[];
+export declare function getTagPosition(tag: TagInstance): Vector3 | [Vector3, Vector3, Vector3, Vector3] | Vector3[];
 export declare function getTagCenterPosition(tag: TagInstance): Vector3;

package/dist/Sculpt/Meshes/Line.d.ts

@@ -36,6 +36,10 @@ export declare class LineMesh extends IObject3D implements RenderDomObjectType {
     private paramsStyle;
     private lastRenderDomItem;
     private lastFOV;
+    private fiveListenersInited;
+    private fiveRef?;
+    private initFiveListeners;
+    private removeFiveListeners;
     constructor(params?: Partial<LineMeshStyle & LineData>);
     updateMatrixWorld(force?: boolean): void;
     setPoints(points: AnyPositions): void;