@speridlabs/visus 1.0.4 → 2.0.1

package/dist/main.d.ts

@@ -49,6 +49,15 @@ export declare class BoundingBox {
  * Class for loading PLY files with Gaussian Splat data
  */
 export declare class PlyLoader extends THREE.Loader {
+    private requestId;
+    private worker;
+    private pendingCallbacks;
+    constructor(manager?: THREE.LoadingManager);
+    /**
+     * Handles messages received from the parsing worker
+     * @param event The message event from the worker
+     */
+    private onWorkerMessage;
     /**
      * Load a PLY file with Gaussian Splat data
      * @param url URL of the PLY file
@@ -65,11 +74,20 @@ export declare class PlyLoader extends THREE.Loader {
      */
     loadAsync(url: string, onProgress?: (event: ProgressEvent) => void): Promise<SplatData>;
     /**
-     * Parse PLY buffer data into SplatData
+     * Parse PLY buffer data asynchronously using Web Worker
      * @param buffer ArrayBuffer containing PLY data
-     * @returns Parsed SplatData
+     * @returns Promise that resolves with parsed SplatData
+     */
+    private parseAsync;
+    /**
+     * Terminate the Web Worker and clean up resources
      */
-    parse(buffer: ArrayBuffer): SplatData;
+    dispose(): void;
+    /**
+     * Creates the self-contained code for the parsing Web Worker
+     * @returns A string containing the JavaScript code for the worker
+     */
+    private createWorkerCode;
 }
 
 export declare class SplatData {
@@ -79,7 +97,6 @@ export declare class SplatData {
     scales: Float32Array;
     colors: Float32Array;
     opacities: Float32Array;
-    centers: Float32Array;
     boundingBox: BoundingBox;
     constructor(numSplats?: number);
     private allocateBuffers;
@@ -164,7 +181,7 @@ export declare interface SplatMaterialOptions {
  */
 export declare class SplatMesh extends THREE.Mesh {
     sorter: SplatSorter;
-    splatData: SplatData;
+    splatData: SplatData | null;
     options: SplatMeshOptions;
     textureManager: TextureManager;
     material: SplatMaterial;
@@ -227,6 +244,7 @@ export declare class SplatMesh extends THREE.Mesh {
 
 export declare interface SplatMeshOptions extends SplatMaterialOptions {
     autoSort?: boolean;
+    keepSplatData?: boolean;
 }
 
 /**
@@ -253,8 +271,9 @@ export declare class SplatSorter extends THREE.EventDispatcher<{
      * @param orderTexture The THREE.DataTexture (R32UI) to store the sorted splat indices.
      * @param centers A Float32Array containing the center position (x, y, z) for each splat.
      * @param chunks Optional: A Float32Array containing bounding box chunk data [minX, minY, minZ, maxX, maxY, maxZ, ...] for optimization.
+     * @param transferOwnership Optional: If true, transfers ownership of centers buffer to worker (saves memory, main thread loses access). Default: false.
      */
-    init(orderTexture: THREE.DataTexture, centers: Float32Array, chunks?: Float32Array): void;
+    init(orderTexture: THREE.DataTexture, centers: Float32Array, chunks?: Float32Array, transferOwnership?: boolean): void;
     /**
      * Applies an optional mapping to filter or reorder splats before sorting.
      * The sorter will only consider splats whose original indices are present in the mapping.