babylonjs-loaders 9.2.1 → 9.2.2

package/babylonjs.loaders.d.ts

@@ -6790,13 +6790,45 @@ declare namespace BABYLON {
 
 
     /**
-     * Parses SPZ data and returns a promise resolving to an IParsedPLY object.
+     * Parses SPZ data and returns a promise resolving to an IParsedSplat object.
      * @param data The ArrayBuffer containing SPZ data.
      * @param scene The Babylon.js scene.
-     * @param loadingOptions Options for loading Gaussian Splatting files.
+     * @param _loadingOptions Options for loading Gaussian Splatting files.
      * @returns A promise resolving to the parsed SPZ data.
      */
-    export function ParseSpz(data: ArrayBuffer, scene: Scene, loadingOptions: SPLATLoadingOptions): Promise<IParsedSplat>;
+    export function ParseSpz(data: ArrayBuffer, scene: Scene, _loadingOptions: SPLATLoadingOptions): Promise<IParsedSplat>;
+    /**
+     * Returns the initialized spz WASM module loaded from the given URL, loading it on first call.
+     * @param url URL to the spz WASM ES module (its default export should be a factory function)
+     * @returns A promise resolving to the initialized spz WASM module
+     */
+    export function GetSpzModule(url: string): Promise<SpzModule>;
+    /**
+     * Converts a GaussianCloud object (from the spz WASM module) into the packed 32-byte-per-splat
+     * ArrayBuffer and SH texture arrays expected by GaussianSplattingMeshBase.updateData.
+     *
+     * Packed layout per splat (32 bytes):
+     *   [0-11]  position xyz   (float32 x3)
+     *   [12-23] scale xyz      (float32 x3)
+     *   [24-27] color RGBA     (uint8 x4, colors in [0,255], alpha in [0,255])
+     *   [28-31] quaternion wxyz (uint8 x4, encoded as q * 127.5 + 127.5)
+     *
+     * SH coefficients from the cloud (Float32, range ~[-1,1]) are encoded to bytes
+     * using the SPZ convention (load-spz.cc unquantizeSH): byte = coeff * 128 + 128.
+     *
+     * @param cloud The GaussianCloud returned by spz.loadSpzFromBuffer
+     * @param scene The Babylon.js scene (used to query maxTextureSize for SH textures)
+     * @param useCoroutine If true, yields periodically to avoid blocking the main thread
+     * @returns A coroutine returning an IParsedSplat ready to be passed to updateData
+     */
+    export function ConvertSpzToSplat(cloud: GaussianCloud, scene: Scene, useCoroutine?: boolean): Coroutine<IParsedSplat>;
+    /**
+     * Async version of ConvertSpzToSplat that yields periodically to avoid blocking the main thread.
+     * @param cloud The GaussianCloud returned by spz.loadSpzFromBuffer
+     * @param scene The Babylon.js scene
+     * @returns A promise resolving to an IParsedSplat
+     */
+    export function ConvertSpzToSplatAsync(cloud: any, scene: Scene): Promise<IParsedSplat>;
 
 
     /**
@@ -6830,6 +6862,17 @@ declare namespace BABYLON {
          * Mesh that will be used to load data instead of creating a new one
          */
         gaussianSplattingMesh?: GaussianSplattingMesh;
+        /**
+         * URL to load the spz WASM ES module from (e.g. the \@adobe/spz package).
+         * When provided, the WASM-based SPZ loader is used, which supports extra features
+         * such as antialiasing metadata, and vendor-specific extensions such as safe-orbit
+         * camera limits.
+         * Defaults to the \@adobe/spz unpkg URL when WebAssembly is supported, and undefined otherwise.
+         * Set to undefined to force the built-in manual SPZ parser regardless of WebAssembly support.
+         * @example Setting the URL directly on the loader options
+         * spzLibraryUrl: "https://unpkg.com/\@adobe/spz\@0.2.0/dist/spz.js"
+         */
+        spzLibraryUrl?: string;
     };
 
 
@@ -6968,6 +7011,7 @@ declare namespace BABYLON {
         faces?: number[];
         hasVertexColors?: boolean;
         sh?: Uint8Array[];
+        shDegree?: number;
         trainedWithAntialiasing?: boolean;
         compressed?: boolean;
         rawSplat?: boolean;