@soonspacejs/plugin-fds 2.15.1

package/dist/utils/fds-cache.utils.d.ts

@@ -0,0 +1,48 @@
+import { TSimulatesManifest, TSliceData, TVolumePointsShape } from './fds.types';
+/** 播放时预取的前瞻秒数。 */
+declare const PLAYBACK_CHUNK_LOOKAHEAD_SEC = 1;
+/** 统一路径格式，避免 zip 内路径和运行时路径分隔符不一致。 */
+declare function normalizeFdsPath(path: string): string;
+/** 根据全局帧索引定位它所在的数据分片。 */
+declare function findItemForGlobalFrame(manifest: TSimulatesManifest, globalFrameIndex: number): {
+    item: {
+        seq: number;
+        grids: number;
+        frames: number;
+        url: string;
+    };
+    chunkStartFrame: number;
+};
+/** 判断一个分片的所有帧是否都已经进入内存缓存。 */
+declare function isChunkFramesLoaded(frames: (Uint8ClampedArray | undefined)[], chunkStartFrame: number, chunkFrameCount: number): boolean;
+/** 找出和目标帧区间有交集的所有分片起始帧。 */
+declare function chunkStartFramesOverlappingFrameRange(manifest: TSimulatesManifest, fMin: number, fMax: number): number[];
+/**
+ * 优先返回目标帧；如果该帧尚未解码，就退而求其次取最近的已解码帧。
+ * 这样时间轴可以继续推进，不必硬等精确帧解码完成。
+ */
+declare function findBestRenderableFrame(frames: (Uint8ClampedArray | undefined)[], preferredFrameIndex: number): number;
+/** 推断整段模拟时长，优先使用导出时携带的真实秒数。 */
+declare function inferSimulationDurationSec(manifest: TSimulatesManifest, slice: TSliceData, totalFrames: number, preferredDurationSec?: number): number;
+/** 把外部传入的帧索引收敛到合法范围内。 */
+declare function clampFrameIndex(frameIndex: number, totalFrames: number): number;
+/** 把帧索引换算成物理秒数。 */
+declare function frameIndexToTime(frameIndex: number, maxTime: number, totalFrames: number, slice?: TSliceData): number;
+/** 把物理秒数换算成最接近的帧索引。 */
+declare function timeToFrameIndex(timeSec: number, maxTime: number, totalFrames: number, slice?: TSliceData): number;
+/** 保证传给 worker 的是可安全转移所有权的独立 ArrayBuffer。 */
+declare function toTransferableArrayBuffer(bytes: Uint8Array): ArrayBuffer;
+/**
+ * 对解码 worker 做一层包装，把消息分发、Promise 生命周期和销毁逻辑
+ * 集中在这里，主加载流程只关心“请求一个分片并拿到帧数组”。
+ */
+declare function createChunkFramesReader(shape: TVolumePointsShape): {
+    /** 解码已经从 zip 中读出的分片字节。 */
+    readChunk(arrayBuffer: ArrayBuffer, item: TSimulatesManifest["items"][number], startFrameIndex: number): Promise<{
+        frames: Uint8ClampedArray[];
+        startFrameIndex: number;
+    }>;
+    /** 终止 worker，并让所有挂起请求立刻失败。 */
+    dispose(): void;
+};
+export { PLAYBACK_CHUNK_LOOKAHEAD_SEC, chunkStartFramesOverlappingFrameRange, clampFrameIndex, createChunkFramesReader, findBestRenderableFrame, findItemForGlobalFrame, frameIndexToTime, inferSimulationDurationSec, isChunkFramesLoaded, normalizeFdsPath, timeToFrameIndex, toTransferableArrayBuffer, };

package/dist/utils/fds-mesh.utils.d.ts

@@ -0,0 +1,15 @@
+import { default as SoonSpace } from 'soonspacejs';
+import { Box3, Object3D } from 'three';
+import { FdsMesh } from '../class/FdsMesh';
+import { TVolumePointsShape } from './fds.types';
+/**
+ * 统计场景里可见、可渲染对象的包围盒。
+ * 已经存在的 FDS 对象会被跳过，避免重复加载时把旧体渲染结果算进去。
+ */
+declare function getRenderableSceneBox(ssp: SoonSpace, root?: Object3D): Box3;
+/**
+ * 根据场景包围盒创建 FDS 网格。
+ * 如果场景里暂时没有可用几何，则退回到一个以原点为中心的默认盒子。
+ */
+declare function createFdsMeshBySceneBox(ssp: SoonSpace, shape: TVolumePointsShape, root?: Object3D): FdsMesh;
+export { createFdsMeshBySceneBox, getRenderableSceneBox, };

package/dist/utils/fds-utils.d.ts

@@ -0,0 +1,3 @@
+import { Matrix4 } from 'three';
+export declare const fdsSpaceMatrix: Matrix4;
+export declare const threeToFdsSpaceMatrix: Matrix4;

package/dist/utils/fds.types.d.ts

@@ -0,0 +1,55 @@
+export type TVolumePointsShape = {
+    /** 体素宽度。 */
+    width: number;
+    /** 体素高度。 */
+    height: number;
+    /** 体素深度。 */
+    depth: number;
+};
+/** FDS 网格在 x/y/z 三个轴上的离散尺寸。 */
+export type TFdsMeshIjk = {
+    x: number;
+    y: number;
+    z: number;
+};
+/** FDS 网格在 FDS 坐标系中的包围盒范围。 */
+export type TFdsMeshXb = {
+    minX: number;
+    minY: number;
+    minZ: number;
+    maxX: number;
+    maxY: number;
+    maxZ: number;
+};
+/** 加载 FDS 时允许外部传入的覆盖参数。 */
+export type TFdsLoadOptions = {
+    meshIjk?: TFdsMeshIjk;
+    meshXb?: TFdsMeshXb;
+    simulationDurationSec?: number;
+    initialTimeSec?: number;
+    /** 指定要读取的 FDS 字段。 */
+    field?: 'temperature' | 'soot_density' | 'hrrpuv';
+};
+/** 构建端导出的分片清单，`shape` 为 `[宽, 高, 深, 总帧数]`。 */
+export type TSimulatesManifest = {
+    multiple?: number;
+    simulationDurationSec?: number;
+    headers: {
+        shape: [number, number, number, number];
+        maxValue?: number;
+    };
+    items: {
+        seq: number;
+        grids: number;
+        frames: number;
+        url: string;
+    }[];
+};
+/** 可选的帧时间映射，用于把帧索引还原成物理秒数。 */
+export type TSliceData = {
+    frames?: {
+        seq: number;
+        time: number;
+        url: string;
+    }[];
+};

package/dist/utils/gzip.d.ts

@@ -0,0 +1,9 @@
+/** 严格按 gzip 解压，调用方应确保输入本身就是 gzip。 */
+export declare function gunzipArrayBuffer(buf: ArrayBufferLike): Uint8Array;
+/** 如果是 gzip 则解压，否则保持原样返回。 */
+export declare function gunzipArrayBufferIfNeeded(buf: ArrayBufferLike): Uint8Array;
+/**
+ * 循环剥离可能叠加的 gzip 包装，直到拿到真正的 NDAV2 负载。
+ * 这样可以兼容对象存储、代理层或构建产物里多层 gzip 的情况。
+ */
+export declare function prepareNdav2ChunkPayload(buf: ArrayBufferLike): Uint8Array;

package/dist/utils/load-fds.d.ts

@@ -0,0 +1,10 @@
+import { default as SoonSpace } from 'soonspacejs';
+import { Object3D } from 'three';
+import { VolumePoints } from '../class/VolumePoints';
+import { TFdsLoadOptions } from './fds.types';
+/**
+ * 加载 FDS 压缩包，按需解码分片数据，并挂载成 `VolumePoints`。
+ * 对外暴露的是“按秒播放”的能力，内部仍然按帧和分片做缓存。
+ */
+declare function loadFDS(ssp: SoonSpace, url: string, parent?: Object3D | null, options?: TFdsLoadOptions): Promise<VolumePoints>;
+export { loadFDS, };

package/dist/utils/nda.d.ts

@@ -0,0 +1,10 @@
+import { default as ndarray } from 'ndarray';
+/**
+ * 读取 NDAV2 浮点体素数据。
+ * 文件头为 `NDAV2`，后面紧跟 `gridFloats` 个 float32 数据。
+ */
+export declare function readNdav2Floats(buf: Uint8Array, gridFloats: number): Float32Array;
+/** 如果输入是 gzip 包装，则先解压再按 NDA 解析。 */
+export declare function readAsNdArrayMaybeGzip(buf: Uint8Array): Promise<ndarray.NdArray<Float32Array<ArrayBuffer>> | undefined>;
+/** 读取 NDA 数据并解析成 `ndarray` 结构。 */
+export declare function readAsNdArray(buf: Uint8Array): Promise<ndarray.NdArray<Float32Array<ArrayBuffer>> | undefined>;

package/dist/utils/read-simulate.worker.d.ts

@@ -0,0 +1,19 @@
+/** 返回给主线程的体素尺寸描述。 */
+type TVolumePointsShape = {
+    width: number;
+    height: number;
+    depth: number;
+};
+/** 读取旧版 NDA v1 文件，同时兼容 gzip 包装。 */
+export declare function readNdaSingle(url: string, pageOrigin?: string): Promise<{
+    shape: TVolumePointsShape;
+    frames: Uint8ClampedArray<ArrayBufferLike>[];
+    transfers: ArrayBuffer[];
+}>;
+/** 拉取并解码一个 NDAV2 分片。 */
+export declare function readNdav2ChunkOnly(chunkUrl: string, grids: number, chunkFrameCount: number, xs: number, ys: number, zs: number, pageOrigin?: string): Promise<{
+    shape: TVolumePointsShape;
+    frames: Uint8ClampedArray<ArrayBuffer>[];
+    transfers: ArrayBuffer[];
+}>;
+export {};

package/dist/utils/zip.d.ts

@@ -0,0 +1,14 @@
+/** 轻量 zip 读取器，只实现当前 FDS 压缩包所需的读取能力。 */
+declare class ZipArchive {
+    #private;
+    constructor(bytes: ArrayBuffer | Uint8Array);
+    /** 判断指定文件是否存在于 zip 包中。 */
+    has(name: string): boolean;
+    /** 读取并按压缩方式解出指定文件的原始字节。 */
+    read(name: string): Uint8Array<ArrayBufferLike>;
+    /** 读取文本文件。 */
+    readText(name: string): string;
+    /** 读取 JSON 文件并直接反序列化。 */
+    readJson<T>(name: string): T;
+}
+export { ZipArchive, };

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@soonspacejs/plugin-fds",
+  "pluginName": "FdsPlugin",
+  "version": "2.15.1",
+  "description": "FDS plugin for SoonSpace.js",
+  "main": "dist/index.esm.js",
+  "module": "dist/index.esm.js",
+  "unpkg": "dist/index.esm.js",
+  "typings": "dist/index.d.ts",
+  "keywords": [
+    "soonspacejs",
+    "fds"
+  ],
+  "author": "xunwei",
+  "license": "UNLICENSED",
+  "gitHead": "4a87dd85050651088e11c3da777c49fab3db7e5d",
+  "peerDependencies": {
+    "soonspacejs": "2.15.1",
+    "fflate": "^0.8.2",
+    "ndarray": "^1.0.19",
+    "three": "^0.183.0"
+  }
+}