@realsee/dnalogel 3.81.11-alpha.2 → 3.81.12-alpha.1

package/libs/FireScenePlugin/utils/particleTexture.d.ts

@@ -0,0 +1,21 @@
+import type * as THREE from 'three';
+type TextureListener = (texture: THREE.Texture | null) => void;
+/**
+ * 火焰、烟雾、喷水共用的粒子贴图。
+ */
+export declare class ParticleTexture {
+    private loader;
+    private url;
+    private texture;
+    private listeners;
+    /** 当前贴图。加载完成前为 null */
+    get current(): THREE.Texture | null;
+    setUrl(url: string): void;
+    /**
+     * 订阅贴图变化（含清空），返回取消订阅的函数。
+     */
+    onChange(listener: TextureListener): () => void;
+    dispose(): void;
+    private emit;
+}
+export {};

package/libs/FireScenePlugin/utils/particleTexture.js

@@ -0,0 +1,40 @@
+var s = Object.defineProperty;
+var h = (r, t, e) => t in r ? s(r, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : r[t] = e;
+var i = (r, t, e) => (h(r, typeof t != "symbol" ? t + "" : t, e), e);
+import { getTextureLoader as l } from "../../shared-utils/three/getTextureLoader.js";
+import "../../shared-utils/three/loadTexture.js";
+import "three";
+class d {
+  constructor() {
+    i(this, "loader", l());
+    i(this, "url", "");
+    i(this, "texture", null);
+    i(this, "listeners", /* @__PURE__ */ new Set());
+  }
+  /** 当前贴图。加载完成前为 null */
+  get current() {
+    return this.texture;
+  }
+  setUrl(t) {
+    t !== this.url && (this.url = t, this.texture = null, this.emit(), t && this.loader.load(t).then((e) => {
+      t === this.url && (this.texture = e, this.emit());
+    }));
+  }
+  /**
+   * 订阅贴图变化（含清空），返回取消订阅的函数。
+   */
+  onChange(t) {
+    return this.listeners.add(t), () => {
+      this.listeners.delete(t);
+    };
+  }
+  dispose() {
+    this.listeners.clear(), this.texture = null, this.url = "", this.loader.dispose();
+  }
+  emit() {
+    this.listeners.forEach((t) => t(this.texture));
+  }
+}
+export {
+  d as ParticleTexture
+};

package/libs/FireScenePlugin/utils/radialSpread.d.ts

@@ -0,0 +1,54 @@
+import * as THREE from 'three';
+import type { FireSpreadBounds } from '../typing';
+export interface RadialSpreadOptions {
+    /** 区域包围盒（世界坐标）：[minX, minY, minZ, maxX, maxY, maxZ] */
+    bounds: FireSpreadBounds;
+    /** 扩散中心（世界坐标） */
+    origin: THREE.Vector3;
+    /** 噪声种子。同一个 seed 得到同一套布局，火焰用火焰 id，烟雾用烟雾源 id */
+    seed: string;
+    /** 扩散半径上限 */
+    spreadRange: number;
+    /** 增长率，影响每一步的半径推进距离 */
+    growthRate: number;
+    /** 网格边长（米），不传按 1 米 */
+    cell?: number;
+}
+export interface RadialSpreadCell {
+    /** 新铺开的位置，已做抖动，不会排成规则阵列 */
+    position: THREE.Vector3;
+    /** 尺寸抖动系数（0.9~1.1），调用方按需用在实体大小上 */
+    scaleJitter: number;
+}
+export interface RadialSpreadStepResult {
+    /** 这一步新铺开的位置 */
+    cells: RadialSpreadCell[];
+    /** 当前扩散半径 */
+    radius: number;
+    /** 当前覆盖率（0~1） */
+    coverage: number;
+}
+/**
+ * 径向扩散：以某个点为中心、按网格扫描包围盒，每一步只取当前半径环带内的格子。
+ */
+export declare class RadialSpread {
+    private readonly bounds;
+    private readonly origin;
+    private readonly seed;
+    private readonly cell;
+    private readonly spreadRange;
+    private readonly growthRate;
+    private readonly coveredCells;
+    private readonly totalCells;
+    private readonly nx;
+    private readonly nz;
+    private currentRadius;
+    private maxRing;
+    constructor(options: RadialSpreadOptions);
+    /** 当前扩散半径 */
+    get radius(): number;
+    /** 当前覆盖率（0~1） */
+    get coverage(): number;
+    step(growthLevel: number, maxNew: number): RadialSpreadStepResult;
+    private isCovered;
+}

package/libs/FireScenePlugin/utils/radialSpread.js

@@ -0,0 +1,75 @@
+var Z = Object.defineProperty;
+var $ = (n, t, e) => t in n ? Z(n, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : n[t] = e;
+var h = (n, t, e) => ($(n, typeof t != "symbol" ? t + "" : t, e), e);
+import * as j from "three";
+import { MAX_SPREAD_CELLS_PER_STEP as k } from "../constants.js";
+class D {
+  constructor(t) {
+    h(this, "bounds");
+    h(this, "origin");
+    h(this, "seed");
+    h(this, "cell");
+    h(this, "spreadRange");
+    h(this, "growthRate");
+    h(this, "coveredCells", /* @__PURE__ */ new Set());
+    h(this, "totalCells");
+    h(this, "nx");
+    h(this, "nz");
+    h(this, "currentRadius", 0);
+    h(this, "maxRing", 0);
+    var d;
+    this.bounds = t.bounds, this.origin = t.origin, this.seed = t.seed, this.spreadRange = t.spreadRange, this.growthRate = t.growthRate, this.cell = Math.max(0.08, (d = t.cell) != null ? d : 1);
+    const [e, , r, a, , g] = this.bounds;
+    this.nx = Math.max(1, Math.ceil((a - e) / this.cell)), this.nz = Math.max(1, Math.ceil((g - r) / this.cell)), this.totalCells = this.nx * this.nz;
+  }
+  /** 当前扩散半径 */
+  get radius() {
+    return this.currentRadius;
+  }
+  /** 当前覆盖率（0~1） */
+  get coverage() {
+    return Math.min(1, this.coveredCells.size / Math.max(1, this.totalCells));
+  }
+  step(t, e) {
+    const [r, , a, g, , d] = this.bounds, o = this.origin, b = Math.max(this.cell * 0.35, this.spreadRange / 28 * Math.max(0.2, this.growthRate));
+    this.currentRadius = Math.min(this.spreadRange, this.currentRadius + b);
+    const z = (o.x - r) / this.cell - 0.5, p = (o.z - a) / this.cell - 0.5, m = Math.max(0, Math.floor(this.currentRadius / this.cell)), u = Math.max(1, Math.min(k, e)), c = [];
+    for (let s = 0; s < this.nx; s++) {
+      for (let i = 0; i < this.nz && !(c.length >= u); i++) {
+        const x = r + s * this.cell + this.cell / 2, M = a + i * this.cell + this.cell / 2, R = `${s}_${i}`;
+        if (this.coveredCells.has(R))
+          continue;
+        const C = Math.max(Math.abs(s - Math.round(z)), Math.abs(i - Math.round(p)));
+        if (C > m || C < this.maxRing)
+          continue;
+        const w = Math.atan2(M - o.z, x - o.x), E = t * 0.3, f = 0.75 + 0.2 * Math.sin(w * 3 + E), S = l(s, i, this.seed), _ = this.isCovered(s - 1, i) || this.isCovered(s + 1, i) || this.isCovered(s, i - 1) || this.isCovered(s, i + 1) ? f : Math.max(0.55, f - 0.15);
+        if (S > _)
+          continue;
+        const v = this.cell * 0.35, X = (l(s + 13, i + 7, this.seed) - 0.5) * 2 * v, y = (l(s + 29, i + 3, this.seed) - 0.5) * 2 * v;
+        c.push({
+          position: new j.Vector3(x + X, o.y, M + y),
+          scaleJitter: 0.9 + 0.2 * l(s + 5, i + 11, this.seed)
+        }), this.coveredCells.add(R);
+      }
+      if (c.length >= u)
+        break;
+    }
+    return c.length < u * 0.25 && (this.maxRing = Math.min(m, this.maxRing + 1)), { cells: c, radius: this.currentRadius, coverage: this.coverage };
+  }
+  isCovered(t, e) {
+    return this.coveredCells.has(`${t}_${e}`);
+  }
+}
+function l(n, t, e) {
+  const r = A(e), a = Math.sin(n * 12.9898 + t * 78.233 + r * 1e-4) * 43758.5453;
+  return a - Math.floor(a);
+}
+function A(n) {
+  let t = 2166136261;
+  for (let e = 0; e < n.length; e++)
+    t ^= n.charCodeAt(e), t = Math.imul(t, 16777619);
+  return t >>> 0;
+}
+export {
+  D as RadialSpread
+};

package/libs/FireScenePlugin/utils/spread.d.ts

@@ -0,0 +1,17 @@
+import type { FireSpreadBounds } from '../typing';
+/** 蔓延边界的尺寸信息 */
+export interface SpreadSize {
+    volume: number;
+    /** 水平面对角线长度 */
+    diagonal: number;
+}
+/** 由蔓延边界算尺寸：火与烟共用 */
+export declare const measureSpreadBounds: (bounds: FireSpreadBounds) => SpreadSize;
+/**
+ * 蔓延速度 → 步进间隔与增长率。
+ * 速度越快，间隔越短、每次增长越多；火与烟用同一套手感。
+ */
+export declare const speedToGrowth: (spreadSpeed: number) => {
+    interval: number;
+    growthRate: number;
+};

package/libs/FireScenePlugin/utils/spread.js

@@ -0,0 +1,17 @@
+const M = (a) => {
+  const [t, h, s, o, m, r] = a, e = Math.abs(o - t), i = Math.abs(m - h), n = Math.abs(r - s);
+  return {
+    volume: e * i * n,
+    diagonal: Math.sqrt(e * e + n * n)
+  };
+}, c = (a) => {
+  const t = Math.max(0.1, Math.min(2, a));
+  return {
+    interval: Math.max(200, 1e3 / t),
+    growthRate: Math.max(0.1, Math.min(0.8, t * 0.3))
+  };
+};
+export {
+  M as measureSpreadBounds,
+  c as speedToGrowth
+};

package/libs/Sculpt/index.d.ts

@@ -164,6 +164,10 @@ export declare class Sculpt extends Subscribe<Event> {
     private five;
     private creatingItem;
     constructor(five: Five, theme?: SculptType.Theme, config?: SculptConfig);
+    /**
+     * @description: 销毁实例：清空内容、解绑全局快捷键、把 group 从场景移除
+     */
+    destroy(): void;
     /**
      * @description: 加载数据 展示
      */

package/libs/Sculpt/index.js

@@ -1,16 +1,16 @@
 var O = Object.defineProperty, S = Object.defineProperties;
 var U = Object.getOwnPropertyDescriptors;
-var y = Object.getOwnPropertySymbols;
-var D = Object.prototype.hasOwnProperty, L = Object.prototype.propertyIsEnumerable;
-var p = (l, n, e) => n in l ? O(l, n, { enumerable: !0, configurable: !0, writable: !0, value: e }) : l[n] = e, g = (l, n) => {
+var a = Object.getOwnPropertySymbols;
+var z = Object.prototype.hasOwnProperty, D = Object.prototype.propertyIsEnumerable;
+var y = (l, n, e) => n in l ? O(l, n, { enumerable: !0, configurable: !0, writable: !0, value: e }) : l[n] = e, g = (l, n) => {
   for (var e in n || (n = {}))
-    D.call(n, e) && p(l, e, n[e]);
-  if (y)
-    for (var e of y(n))
-      L.call(n, e) && p(l, e, n[e]);
+    z.call(n, e) && y(l, e, n[e]);
+  if (a)
+    for (var e of a(n))
+      D.call(n, e) && y(l, e, n[e]);
   return l;
-}, a = (l, n) => S(l, U(n));
-var u = (l, n, e) => (p(l, typeof n != "symbol" ? n + "" : n, e), e);
+}, I = (l, n) => S(l, U(n));
+var u = (l, n, e) => (y(l, typeof n != "symbol" ? n + "" : n, e), e);
 var m = (l, n, e) => new Promise((t, i) => {
   var c = (o) => {
     try {
@@ -27,9 +27,9 @@ var m = (l, n, e) => new Promise((t, i) => {
   }, r = (o) => o.done ? t(o.value) : Promise.resolve(o.value).then(c, s);
   r((e = e.apply(l, n)).next());
 });
-import { globalModules as B } from "./utils/Modules/Global.js";
-import { Subscribe as E } from "../shared-utils/Subscribe.js";
-import { IObject3D as z } from "../shared-utils/three/IObject3D.js";
+import { globalModules as L } from "./utils/Modules/Global.js";
+import { Subscribe as B } from "../shared-utils/Subscribe.js";
+import { IObject3D as E } from "../shared-utils/three/IObject3D.js";
 import "../shared-utils/tag.js";
 import "three";
 import "../vendor/hammerjs/hammer.js";
@@ -37,7 +37,7 @@ import "../shared-utils/three/PointSelector/index.js";
 import "../shared-utils/three/CSS3DRenderer/index.js";
 import "../CSS3DRenderPlugin/utils/generateBehindFiveElement.js";
 import "@realsee/five/line";
-import { notNil as k } from "../shared-utils/isNil.js";
+import { notNil as F } from "../shared-utils/isNil.js";
 import "../shared-utils/three/core/Five_LineMaterial2.js";
 import "../shared-utils/three/core/Sphere.js";
 import "../shared-utils/three/blink.js";
@@ -45,20 +45,20 @@ import "../vendor/@tweenjs/tween/dist/tween.esm.js.js";
 import "../CSS3DRenderPlugin/utils/three/CSS3DRender.js";
 import "../vendor/earcut/src/earcut.js";
 import "../shared-utils/five/FivePuppet.js";
-import { recurveFindObject as F } from "../shared-utils/three/recurveFindObject.js";
-import { Polyline as I } from "./Objects/Polyline/index.js";
-import { Point as _ } from "./Objects/Point/index.js";
+import { recurveFindObject as k } from "../shared-utils/three/recurveFindObject.js";
+import { Polyline as _ } from "./Objects/Polyline/index.js";
+import { Point as b } from "./Objects/Point/index.js";
 import { Polygon as w } from "./Objects/Polygon/index.js";
-import { Prism as b } from "./Objects/Prism/index.js";
+import { Prism as v } from "./Objects/Prism/index.js";
 import { Rectangle as j } from "./Objects/Rectangle/index.js";
-import { Circle as v } from "./Objects/Circle/index.js";
-import { Cylinder as P } from "./Objects/Cylinder/index.js";
-import { Box as R } from "./Objects/Box/index.js";
+import { Circle as P } from "./Objects/Circle/index.js";
+import { Cylinder as R } from "./Objects/Cylinder/index.js";
+import { Box as C } from "./Objects/Box/index.js";
 import { forReverseEach as H } from "../shared-utils/forReverseEach.js";
-import { Line as C } from "./Objects/Line/index.js";
-import { hotkeys as x } from "../vendor/hotkeys-js/dist/hotkeys.esm.js";
+import { Line as x } from "./Objects/Line/index.js";
+import { hotkeys as p } from "../vendor/hotkeys-js/dist/hotkeys.esm.js";
 import { withResolvers as M } from "../shared-utils/promise/withResolvers.js";
-const d = class extends E {
+const d = class extends B {
   constructor(e, t, i) {
     super();
     u(this, "group");
@@ -90,9 +90,9 @@ const d = class extends E {
     });
     this.five = e, this.theme = t, this.config = g({
       magnifier: { width: 190, height: 190, scale: 2, dragEnabled: !0 }
-    }, i), this.group = new z(), this.group.name = "Sculpt", this.group.__sculpt__ = this, this.group.__five__ = this.five, e.scene.add(this.group), d.modules.init(e, this.config), x("ctrl+z, command+z", this.undo), x("ctrl+shift+z, command+shift+z", this.redo), d.modules.fiveDomEvents.addEventListener(this.group, "click", ({ intersects: c, origDomEvent: s }) => {
+    }, i), this.group = new E(), this.group.name = "Sculpt", this.group.__sculpt__ = this, this.group.__five__ = this.five, e.scene.add(this.group), d.modules.init(e, this.config), p("ctrl+z, command+z", this.undo), p("ctrl+shift+z, command+shift+z", this.redo), d.modules.fiveDomEvents.addEventListener(this.group, "click", ({ intersects: c, origDomEvent: s }) => {
       var o;
-      const r = F((o = c == null ? void 0 : c[0]) == null ? void 0 : o.object, (h) => h.isSculptObject);
+      const r = k((o = c == null ? void 0 : c[0]) == null ? void 0 : o.object, (h) => h.isSculptObject);
       return r && !r.editing ? this.emit("click", s, r) : !1;
     }), window.__SCULPT_DEBUG__ = this, window.__SCULPT_MODULES_DEBUG__ = d.modules;
   }
@@ -104,12 +104,18 @@ const d = class extends E {
         } catch (t) {
           return console.error(t), null;
         }
-      }).filter(k)
+      }).filter(F)
     };
   }
   get items() {
     return this.group.children;
   }
+  /**
+   * @description: 销毁实例：清空内容、解绑全局快捷键、把 group 从场景移除
+   */
+  destroy() {
+    this.clear(), p.unbind("ctrl+z, command+z", this.undo), p.unbind("ctrl+shift+z, command+shift+z", this.redo), this.group.removeFromParent();
+  }
   /**
    * @description: 加载数据 展示
    */
@@ -118,10 +124,10 @@ const d = class extends E {
     this.clear();
     const i = (c = e == null ? void 0 : e.items) == null ? void 0 : c.map((s) => {
       var o;
-      const r = a(g({}, s), {
+      const r = I(g({}, s), {
         style: g(g({}, (o = this.theme) == null ? void 0 : o[s.type.toLowerCase()]), s.style)
       });
-      return s.type === "Point" ? new _(r, t) : s.type === "line" ? new C(r, t) : s.type === "Polyline" ? new I(r, t) : s.type === "Polygon" ? new w(r, t) : s.type === "Prism" ? new b(r, t) : s.type === "Rectangle" ? new j(r, t) : s.type === "Circle" ? new v(r, t) : s.type === "Cylinder" ? new P(r, t) : s.type === "Box" ? new R(r, t) : null;
+      return s.type === "Point" ? new b(r, t) : s.type === "line" ? new x(r, t) : s.type === "Polyline" ? new _(r, t) : s.type === "Polygon" ? new w(r, t) : s.type === "Prism" ? new v(r, t) : s.type === "Rectangle" ? new j(r, t) : s.type === "Circle" ? new P(r, t) : s.type === "Cylinder" ? new R(r, t) : s.type === "Box" ? new C(r, t) : null;
     });
     this.group.add(...i), this.five.needsRender = !0;
   }
@@ -146,7 +152,7 @@ const d = class extends E {
   createPoint(...e) {
     return m(this, null, function* () {
       var t, i;
-      return Object.assign((t = e[0]) != null ? t : {}, (i = this.theme) == null ? void 0 : i.point, e[0]), this.createItem(_, ...e);
+      return Object.assign((t = e[0]) != null ? t : {}, (i = this.theme) == null ? void 0 : i.point, e[0]), this.createItem(b, ...e);
     });
   }
   /**
@@ -155,7 +161,7 @@ const d = class extends E {
   createLine(...e) {
     return m(this, null, function* () {
       var t, i;
-      return Object.assign((t = e[0]) != null ? t : {}, (i = this.theme) == null ? void 0 : i.line, e[0]), this.createItem(C, ...e);
+      return Object.assign((t = e[0]) != null ? t : {}, (i = this.theme) == null ? void 0 : i.line, e[0]), this.createItem(x, ...e);
     });
   }
   /**
@@ -172,7 +178,7 @@ const d = class extends E {
   createPolyline(...e) {
     return m(this, null, function* () {
       var t, i;
-      return Object.assign((t = e[0]) != null ? t : {}, (i = this.theme) == null ? void 0 : i.polyline, e[0]), this.createItem(I, ...e);
+      return Object.assign((t = e[0]) != null ? t : {}, (i = this.theme) == null ? void 0 : i.polyline, e[0]), this.createItem(_, ...e);
     });
   }
   /**
@@ -206,7 +212,7 @@ const d = class extends E {
       }, t.__onWillAddPoint = (r, o) => {
         const h = this.creatingItem;
         this.emit("prism.experimental_point_will_add", h, r, o);
-      }, e[0] = t, this.createItem(b, ...e);
+      }, e[0] = t, this.createItem(v, ...e);
     });
   }
   /**
@@ -224,7 +230,7 @@ const d = class extends E {
   createCircle(...e) {
     return m(this, null, function* () {
       var t, i;
-      return Object.assign((t = e[0]) != null ? t : {}, (i = this.theme) == null ? void 0 : i.circle, e[0]), this.createItem(v, ...e);
+      return Object.assign((t = e[0]) != null ? t : {}, (i = this.theme) == null ? void 0 : i.circle, e[0]), this.createItem(P, ...e);
     });
   }
   /**
@@ -233,7 +239,7 @@ const d = class extends E {
   createCylinder(...e) {
     return m(this, null, function* () {
       var t, i;
-      return Object.assign((t = e[0]) != null ? t : {}, (i = this.theme) == null ? void 0 : i.cylinder, e[0]), this.createItem(P, ...e);
+      return Object.assign((t = e[0]) != null ? t : {}, (i = this.theme) == null ? void 0 : i.cylinder, e[0]), this.createItem(R, ...e);
     });
   }
   /**
@@ -242,7 +248,7 @@ const d = class extends E {
   createBox(...e) {
     return m(this, null, function* () {
       var t, i;
-      return Object.assign((t = e[0]) != null ? t : {}, (i = this.theme) == null ? void 0 : i.box, e[0]), this.createItem(R, ...e);
+      return Object.assign((t = e[0]) != null ? t : {}, (i = this.theme) == null ? void 0 : i.box, e[0]), this.createItem(C, ...e);
     });
   }
   canUndo() {
@@ -276,7 +282,7 @@ const d = class extends E {
   }
 };
 let f = d;
-u(f, "modules", B);
+u(f, "modules", L);
 const Ie = (l, n, e) => {
   if (n && typeof n == "object" && ("theme" in n || "config" in n)) {
     const t = n;

package/libs/base/BasePlugin.js

@@ -23,7 +23,7 @@ let I = class {
     /**
      * @realsee/dnalogel 版本号
      */
-    r(this, "VERSION", "3.81.11-alpha.2");
+    r(this, "VERSION", "3.81.12-alpha.1");
     r(this, "NAME");
     r(this, "five");
     r(this, "workUtil");

package/libs/index.d.ts

@@ -29,5 +29,6 @@ export * from './Sculpt';
 export * from './ModelMakerPlugin';
 export * from './DigitalPerformancePlugin';
 export * as DigitalPerformanceV2 from './DigitalPerformanceV2Plugin';
+export * from './FireScenePlugin';
 export * as Util from './shared-utils/exports';
 export type { PlaybackManager, PlaybackController, PlaybackSession, MediaOperations } from './shared-utils/playback';