@realsee/five 6.8.7 → 6.9.0-alpha.0

package/five/gaussian-splatting/orderTexture.d.ts

@@ -0,0 +1,18 @@
+import * as THREE from 'three';
+export declare class OrderTexture {
+    texture: THREE.DataTexture;
+    readonly width: number;
+    private height;
+    private data;
+    private _count;
+    constructor(width?: number);
+    /** 当前有效实例数（= 最近一次 update 的 order 长度） */
+    get count(): number;
+    private createTexture;
+    /**
+     * 用最新 order 更新纹理内容。order[i] = 第 i 个实例要画的全局点索引 P。
+     * 长度超出当前容量时按需扩容（重建纹理）。
+     */
+    update(order: Uint32Array): void;
+    dispose(): void;
+}

package/five/gaussian-splatting/reorderPass.d.ts

@@ -0,0 +1,34 @@
+import * as THREE from 'three';
+/** 一个对象在“排序发起时的旧布局”里占据的全局点索引区间及其到当前布局的位移。 */
+export interface ReorderSegment {
+    oldStart: number;
+    oldEnd: number;
+    delta: number;
+    removed: boolean;
+}
+export declare class ReorderPass {
+    static readonly SENTINEL = 4294967295;
+    private readonly maxSeg;
+    private material;
+    private scene;
+    private camera;
+    private mesh;
+    private segStart;
+    private segEnd;
+    private segDelta;
+    private segRemoved;
+    constructor(maxSeg?: number);
+    /** 创建一张既能作为 reorder 输出、又能被主渲染 shader 以 usampler2D 采样的 R32UI 目标。 */
+    static createOrderTarget(width: number, height: number): THREE.WebGLRenderTarget;
+    /**
+     * 执行一次 reorder。
+     * @param srcOrder    旧 order 纹理（R32UI，usampler2D 可采样），内容为全局点索引 P
+     * @param orderWidth  order 纹理宽度（实例 i → coord = (i%width, i/width)）
+     * @param dst         输出目标（R32UI RenderTarget），尺寸需与 srcOrder 对应实例布局一致
+     * @param segments    区间→位移/剔除段表（长度不应超过 maxSeg）
+     */
+    run(renderer: THREE.WebGLRenderer, srcOrder: THREE.Texture, orderWidth: number, dst: THREE.WebGLRenderTarget, segments: ReorderSegment[]): void;
+    dispose(): void;
+    private static readonly VERTEX;
+    private static buildFragment;
+}

package/five/gaussian-splatting/shStore.d.ts

@@ -0,0 +1,16 @@
+import * as THREE from 'three';
+import type { PBMGaussianSplattingObject } from '../model/objects/pbmGaussianSplattingObject';
+export declare class SHStore {
+    texture: THREE.DataTexture | null;
+    readonly textureSize: THREE.Vector2;
+    /** 数据支持的最大 SH 阶数 = max(obj.maxSHDegree) */
+    dataMaxDegree: number;
+    /** 当前纹理实际写入的阶数 = min(usedSHDegree, dataMaxDegree) */
+    appliedDegree: number;
+    /**
+     * 按对象顺序重建 SH 纹理。返回是否构建了纹理（usedSHDegree/数据不足时返回 false 且不建纹理）。
+     * totalPoints 必须与大纹理布局一致（对象顺序累加 numPoints）。
+     */
+    sync(objects: readonly PBMGaussianSplattingObject[], usedSHDegree: number): boolean;
+    dispose(): void;
+}

package/five/gaussian-splatting/splatAssembler.d.ts

@@ -0,0 +1,60 @@
+import * as THREE from 'three';
+import type { PBMGaussianSplattingObject } from '../model/objects/pbmGaussianSplattingObject';
+import { TileTexture } from './tileTexture';
+export interface AssembledRegion {
+    object: PBMGaussianSplattingObject;
+    tile: TileTexture;
+    start: number;
+    count: number;
+    transformIndex: number;
+    layerIndex: number;
+}
+export declare class SplatAssembler {
+    readonly width: number;
+    private target;
+    private targetHeight;
+    private regionMap;
+    private regionList;
+    private material;
+    private scene;
+    private camera;
+    private mesh;
+    constructor(width?: number);
+    get texture(): THREE.Texture | null;
+    get totalPoints(): number;
+    get regions(): readonly AssembledRegion[];
+    has(object: PBMGaussianSplattingObject): boolean;
+    add(object: PBMGaussianSplattingObject, tile: TileTexture, transformIndex: number, layerIndex: number): void;
+    /**
+     * 按有序对象列表增量同步（per-tile 纹理缓存）：
+     * - 存活对象：保留其 TileTexture（GPU 常驻，不重传），仅更新 transformIndex/layerIndex；
+     * - 新增对象：新建 TileTexture（CPU→GPU 一次）；
+     * - 移除对象：dispose 其 TileTexture。
+     * regionList 顺序严格按传入 objects 顺序（须与 RenderData 布局一致）。
+     */
+    sync(objects: readonly PBMGaussianSplattingObject[], resolveIndices: (obj: PBMGaussianSplattingObject) => {
+        transformIndex: number;
+        layerIndex: number;
+    }): void;
+    remove(object: PBMGaussianSplattingObject): void;
+    clear(): void;
+    /** 按当前 tile 顺序算连续偏移；render pass 从各 TileTexture 组装大纹理。 */
+    assemble(renderer: THREE.WebGLRenderer): void;
+    snapshot(): AssembledRegion[];
+    /**
+     * 提取排序输入（不依赖 RenderData）：
+     * - positions：每点世界坐标（从各 tile packedData 的 texel0 float32），按当前布局全局点索引排布；
+     * - transformIndices：每点所属对象的 transformIndex；
+     * 顺序与大纹理点索引一致（region.start + local）。
+     */
+    extractSortInputs(): {
+        positions: Float32Array;
+        transformIndices: Uint32Array;
+        count: number;
+    };
+    /** 回读组装后的大纹理（RGBA32UI）。供 spike 校验与 P4 排序取世界坐标使用。 */
+    readback(renderer: THREE.WebGLRenderer): Uint32Array;
+    dispose(): void;
+    private static readonly VERTEX;
+    private static readonly FRAGMENT;
+}

package/five/gaussian-splatting/tileTexture.d.ts

@@ -0,0 +1,10 @@
+import * as THREE from 'three';
+import type { PBMGaussianSplattingObject } from '../model/objects/pbmGaussianSplattingObject';
+export declare class TileTexture {
+    readonly texture: THREE.DataTexture;
+    readonly count: number;
+    readonly width: number;
+    readonly height: number;
+    constructor(object: PBMGaussianSplattingObject);
+    dispose(): void;
+}

package/five/gaussian-splatting/transformStore.d.ts

@@ -0,0 +1,20 @@
+import * as THREE from 'three';
+import type { PBMGaussianSplattingObject } from '../model/objects/pbmGaussianSplattingObject';
+export declare class TransformStore {
+    texture: THREE.DataTexture | null;
+    readonly width = 5;
+    private data;
+    private indexMap;
+    private count;
+    /** transformIndex（对象在当前布局中的序号） */
+    indexOf(object: PBMGaussianSplattingObject): number | undefined;
+    get objectCount(): number;
+    /** 供排序 worker 的矩阵数据（前 count*20 个 float 有效）。 */
+    get transforms(): Float32Array;
+    /** 按对象顺序分配 transformIndex，写入每对象矩阵 + selected，并重建纹理。 */
+    sync(objects: readonly PBMGaussianSplattingObject[]): void;
+    /** 单对象 transform / selected 变化，就地更新 + 标记整张重传。 */
+    updateOne(object: PBMGaussianSplattingObject): void;
+    private rebuildTexture;
+    dispose(): void;
+}