@realsee/dnalogel 3.77.4 → 3.77.6

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;