@realsee/dnalogel 3.77.4 → 3.77.6

package/libs/PanoTagPlugin/index.js

@@ -1,7 +1,7 @@
 import r from "./controller/index.js";
-import { pluginFlag as Li } from "./controller/index.js";
-import { defaultGlobalConfig as Ni } from "./typings/tag/TagConfig.js";
-import { ContentType as Qi, DimensionType as Ri, PointType as Si } from "./Archive/deprecated.js";
+import { pluginFlag as Ri } from "./controller/index.js";
+import { defaultGlobalConfig as Ui } from "./typings/tag/TagConfig.js";
+import { ContentType as Wi, DimensionType as Xi, PointType as Yi } from "./Archive/deprecated.js";
 import "three";
 import "../vendor/object-assign-deep/objectAssignDeep.js";
 import "../shared-utils/positionToVector3.js";
@@ -285,6 +285,11 @@ import "../Sculpt/Meshes/Box.js";
 import "../shared-utils/forReverseEach.js";
 import "../Sculpt/Objects/Line/index.js";
 import "../shared-utils/five/getFloorMesh.js";
+import "./controller/Tag/BoxTag.js";
+import "./utils/sculptDataToBoxPosition.js";
+import "./controller/Tag/PolygonTag.js";
+import "./controller/Tag/MaskTag.js";
+import "./controller/Tag/MaskTag.shaders.js";
 import "./Components/TagContainer.js";
 import "./Components/TagItem.js";
 import "./Components/Common/TagPoint.js";
@@ -303,14 +308,14 @@ import "./Components/Common/TagPopover/ArrowRightIcon.js";
 import "./Components/Common/TagPopover/ShareIcon.js";
 import "./utils/popoverContainer.js";
 import "../shared-utils/animationFrame/BetterTween.js";
-const Ii = (o, t) => new r(o, t);
+const Ni = (o, t) => new r(o, t);
 export {
-  Qi as ContentType,
-  Ri as DimensionType,
-  Ii as PanoTagPlugin,
+  Wi as ContentType,
+  Xi as DimensionType,
+  Ni as PanoTagPlugin,
   r as PanoTagPluginController,
-  Si as PointType,
-  Ii as default,
-  Ni as defaultGlobalConfig,
-  Li as pluginFlag
+  Yi as PointType,
+  Ni as default,
+  Ui as defaultGlobalConfig,
+  Ri as pluginFlag
 };

package/libs/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/libs/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/libs/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/libs/PanoTagPlugin/utils/addDebugPoints.js

@@ -1,8 +1,8 @@
 import * as o from "three";
-import { arrayPositionToVector3 as c } from "../../shared-utils/positionToVector3.js";
-function M(h, p) {
-  p.forEach((t) => {
-    const r = new o.SphereGeometry(0.02, 16, 16), i = [], a = [
+import { arrayPositionToVector3 as p } from "../../shared-utils/positionToVector3.js";
+function M(l, y) {
+  y.forEach((s) => {
+    const c = new o.SphereGeometry(0.02, 16, 16), r = [], n = [
       new o.MeshBasicMaterial({ color: 16776960 }),
       // 黄
       new o.MeshBasicMaterial({ color: 16711935 }),
@@ -12,17 +12,31 @@ function M(h, p) {
       new o.MeshBasicMaterial({ color: 65535 })
       // 蓝
     ];
-    if (t.position.length === 4)
-      t.position.forEach((e, s) => {
-        const l = a[s], n = new o.Mesh(r, l);
-        n.position.copy(c(e)), i.push(n);
+    if (s.stickType === "3DBox") {
+      const e = s.position;
+      if (e != null && e.start && (e != null && e.end)) {
+        const i = new o.Mesh(c, n[0]);
+        i.position.copy(p(e.start)), r.push(i);
+        const t = new o.Mesh(c, n[1]);
+        t.position.copy(p(e.end)), r.push(t);
+      }
+    } else if (s.stickType === "Polygon") {
+      const e = s.position;
+      Array.isArray(e) && e.length > 0 && e.forEach((i, t) => {
+        const a = n[t % n.length], h = new o.Mesh(c, a);
+        h.position.copy(p(i)), r.push(h);
       });
-    else {
-      const e = a[0], s = new o.Mesh(r, e);
-      s.position.copy(c(t.position)), i.push(s);
+    } else if (Array.isArray(s.position) && s.position.length === 4)
+      s.position.forEach((e, i) => {
+        const t = n[i], a = new o.Mesh(c, t);
+        a.position.copy(p(e)), r.push(a);
+      });
+    else if (Array.isArray(s.position)) {
+      const e = n[0], i = new o.Mesh(c, e);
+      i.position.copy(p(s.position)), r.push(i);
     }
-    i.forEach((e) => {
-      e.material.depthTest = !1, h.scene.add(e);
+    r.forEach((e) => {
+      e.material.depthTest = !1, l.scene.add(e);
     });
   });
 }

package/libs/PanoTagPlugin/utils/index.js

@@ -1,34 +1,37 @@
-import { addDebugPoints as a } from "./addDebugPoints.js";
-import { noTypecheck as n } from "./noTypecheck.js";
+import { addDebugPoints as p } from "./addDebugPoints.js";
+import { noTypecheck as s } from "./noTypecheck.js";
 import { planeNormal as f } from "./planeNormal.js";
-import { getTagCenterPosition as u, getTagPosition as x } from "./tagPosition.js";
-import { checkRange as c } from "./checkRange.js";
-import { normalPositionToPositions as T } from "./normalPositionToPositions.js";
-import { debounce as h, debounceByKey as V } from "./debounce.js";
-import { throttle as y } from "./throttle.js";
-import { binarySearchFirstBig as B, searchFirstValueSmallThanLastValue as F } from "./search.js";
-import { formatVideo as S, getVideoThumbnail as Y, getVimeoId as C, getYouTubeId as D, isVimeo as K, isYouTube as L } from "./videoHelper.js";
+import { applyMatrixToPoints as l, getBoxCorners as u, getTagCenterPosition as T, getTagPosition as c } from "./tagPosition.js";
+import { checkRange as b } from "./checkRange.js";
+import { normalPositionToPositions as P } from "./normalPositionToPositions.js";
+import { debounce as y, debounceByKey as B } from "./debounce.js";
+import { throttle as C } from "./throttle.js";
+import { binarySearchFirstBig as I, searchFirstValueSmallThanLastValue as S } from "./search.js";
+import { formatVideo as D, getVideoThumbnail as K, getVimeoId as L, getYouTubeId as M, isVimeo as N, isYouTube as R } from "./videoHelper.js";
 import "three";
 import "../../shared-utils/positionToVector3.js";
 import "../../shared-utils/three/centerPoint.js";
 import "./tag/tagCheck.js";
+import "../../shared-utils/five/transformPosition.js";
 export {
-  a as addDebugPoints,
-  B as binarySearchFirstBig,
-  c as checkRange,
-  h as debounce,
-  V as debounceByKey,
-  S as formatVideo,
-  u as getTagCenterPosition,
-  x as getTagPosition,
-  Y as getVideoThumbnail,
-  C as getVimeoId,
-  D as getYouTubeId,
-  K as isVimeo,
-  L as isYouTube,
-  n as noTypecheck,
-  T as normalPositionToPositions,
+  p as addDebugPoints,
+  l as applyMatrixToPoints,
+  I as binarySearchFirstBig,
+  b as checkRange,
+  y as debounce,
+  B as debounceByKey,
+  D as formatVideo,
+  u as getBoxCorners,
+  T as getTagCenterPosition,
+  c as getTagPosition,
+  K as getVideoThumbnail,
+  L as getVimeoId,
+  M as getYouTubeId,
+  N as isVimeo,
+  R as isYouTube,
+  s as noTypecheck,
+  P as normalPositionToPositions,
   f as planeNormal,
-  F as searchFirstValueSmallThanLastValue,
-  y as throttle
+  S as searchFirstValueSmallThanLastValue,
+  C as throttle
 };

package/libs/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/libs/PanoTagPlugin/utils/sculptDataToBoxPosition.js

@@ -0,0 +1,18 @@
+import * as t from "three";
+function E(r, p) {
+  const s = new t.Vector3().subVectors(p, r[0]), y = r.map((n) => n.clone().add(s)), i = [...r, ...y], e = new t.Vector3();
+  i.forEach((n) => e.add(n)), e.divideScalar(8);
+  const x = new t.Vector3().subVectors(r[1], r[0]).clone().normalize(), l = s.clone().normalize(), V = new t.Vector3().crossVectors(x, l).normalize(), h = new t.Matrix4().makeBasis(x, l, V), m = new t.Quaternion().setFromRotationMatrix(h), a = new t.Euler().setFromQuaternion(m), w = m.clone().inverse(), c = i.map((n) => n.clone().sub(e).applyQuaternion(w)), u = c.map((n) => n.x), z = c.map((n) => n.y), d = c.map((n) => n.z), o = new t.Vector3(
+    (Math.max(...u) - Math.min(...u)) / 2,
+    (Math.max(...z) - Math.min(...z)) / 2,
+    (Math.max(...d) - Math.min(...d)) / 2
+  ), M = new t.Vector3(e.x - o.x, e.y - o.y, e.z - o.z), A = new t.Vector3(e.x + o.x, e.y + o.y, e.z + o.z);
+  return {
+    start: M.toArray(),
+    end: A.toArray(),
+    rotation: [a.x, a.y, a.z]
+  };
+}
+export {
+  E as sculptDataToBoxPosition
+};

package/libs/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/libs/PanoTagPlugin/utils/tag/tagCheck.js

@@ -1,26 +1,38 @@
-function n(e) {
-  return e.stickType === "Plane";
+function e(n) {
+  return n.stickType === "Plane";
 }
-function i(e) {
-  return e.stickType === "3DPoint";
+function i(n) {
+  return n.stickType === "3DPoint";
 }
-function t(e) {
-  return e.stickType === "3DPoint" || e.stickType === "Plane";
+function t(n) {
+  return n.stickType === "3DPoint" || n.stickType === "Plane";
 }
-function o(e) {
-  return e.stickType === "Model" && e.contentType === "MediaModel";
+function o(n) {
+  return n.stickType === "Model" && n.contentType === "MediaModel";
 }
-function c(e) {
-  return e.stickType === "Model" && e.contentType === "Model";
+function c(n) {
+  return n.stickType === "Model" && n.contentType === "Model";
 }
-function T(e) {
-  return e.stickType === "Plane" && e.contentType === "MediaPlane";
+function T(n) {
+  return n.stickType === "Plane" && n.contentType === "MediaPlane";
+}
+function s(n) {
+  return n.stickType === "Polygon";
+}
+function r(n) {
+  return n.stickType === "3DBox";
+}
+function u(n) {
+  return n.stickType === "Mask";
 }
 export {
+  r as is3DBoxTag,
   t as is3DTag,
+  u as isMaskTag,
   o as isMediaModelTag,
   T as isMediaPlaneTag,
   c as isModelTag,
-  n as isPlaneTag,
-  i as isPoint3DTag
+  e as isPlaneTag,
+  i as isPoint3DTag,
+  s as isPolygonTag
 };

package/libs/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/libs/PanoTagPlugin/utils/tagPosition.js

@@ -1,22 +1,55 @@
-import { Matrix4 as n } from "three";
-import { centerPoint as e } from "../../shared-utils/three/centerPoint.js";
-import { isMediaModelTag as a } from "./tag/tagCheck.js";
-import { anyPositionToVector3 as m, vector3Position as s } from "../../shared-utils/positionToVector3.js";
-function p(o) {
+import { Euler as y, Vector3 as t, Matrix4 as p } from "three";
+import { centerPoint as x } from "../../shared-utils/three/centerPoint.js";
+import { is3DBoxTag as M, isPolygonTag as d, isMediaModelTag as P, isMaskTag as T } from "./tag/tagCheck.js";
+import { anyPositionToVector3 as a, vector3Position as z } from "../../shared-utils/positionToVector3.js";
+import { transformPosition as A } from "../../shared-utils/five/transformPosition.js";
+function h(o, i) {
+  const n = a(o.start), r = a(o.end), e = new y().fromArray(o.rotation), s = A(new t((n.x + r.x) / 2, (n.y + r.y) / 2, (n.z + r.z) / 2), i), m = new t(Math.abs(r.x - n.x) / 2, Math.abs(r.y - n.y) / 2, Math.abs(r.z - n.z) / 2), u = new p().makeRotationFromEuler(e), f = [
+    // 底面4个点 (y = -0.5)
+    new t(-0.5, -0.5, -0.5),
+    new t(0.5, -0.5, -0.5),
+    new t(0.5, -0.5, 0.5),
+    new t(-0.5, -0.5, 0.5),
+    // 顶面4个点 (y = 0.5)
+    new t(-0.5, 0.5, -0.5),
+    new t(0.5, 0.5, -0.5),
+    new t(0.5, 0.5, 0.5),
+    new t(-0.5, 0.5, 0.5)
+  ], l = m.clone().multiplyScalar(2);
+  return f.map((w) => w.clone().multiply(l).applyMatrix4(u).add(s));
+}
+function c(o, i) {
+  if (!i)
+    return o;
+  const n = new p().fromArray(i);
+  return o.map((r) => r.clone().applyMatrix4(n));
+}
+function k(o) {
   const i = (() => {
-    if (a(o) && o.matrix) {
-      const r = new n().fromArray(o.matrix);
-      return o.data.mediaPosition.map((t) => m(t).clone().applyMatrix4(r));
-    } else
-      return o.position;
+    var n, r;
+    if (M(o) && o.position) {
+      const e = h(o.position, (r = (n = o.plugin) == null ? void 0 : n.workUtil) == null ? void 0 : r.transform);
+      return c(e, o.matrix);
+    }
+    if (d(o) && o.position) {
+      const e = o.position.map((s) => a(s));
+      return c(e, o.matrix);
+    }
+    if (P(o) && o.matrix) {
+      const e = o.data.mediaPosition.map((s) => a(s));
+      return c(e, o.matrix);
+    }
+    return T(o) ? o.position && Array.isArray(o.position) ? a(o.position) : (console.warn("[getTagPosition] Mask tag without position, tag id:", o.id), new t(0, 0, 0)) : o.position;
   })();
-  return s(i);
+  return z(i);
 }
-function x(o) {
-  const i = p(o);
-  return e(...Array.isArray(i) ? i : [i]);
+function v(o) {
+  const i = k(o);
+  return x(...Array.isArray(i) ? i : [i]);
 }
 export {
-  x as getTagCenterPosition,
-  p as getTagPosition
+  c as applyMatrixToPoints,
+  h as getBoxCorners,
+  v as getTagCenterPosition,
+  k as getTagPosition
 };

package/libs/base/BasePlugin.js

@@ -23,7 +23,7 @@ let I = class {
     /**
      * @realsee/dnalogel 版本号
      */
-    r(this, "VERSION", "3.77.4");
+    r(this, "VERSION", "3.77.6");
     r(this, "NAME");
     r(this, "five");
     r(this, "workUtil");

package/libs/index.d.ts

@@ -27,4 +27,5 @@ export * from './AreaMakerPlugin';
 export * from './CurrentPanoImagePlugin';
 export * from './Sculpt';
 export * from './ModelMakerPlugin';
+export * from './DigitalPerformancePlugin';
 export * as Util from './shared-utils/exports';