babylonjs-loaders 9.2.1 → 9.2.2

package/babylonjs.loaders.module.d.ts

@@ -7019,16 +7019,50 @@ export * from "babylonjs-loaders/STL/stlFileLoader";
 }
 declare module "babylonjs-loaders/SPLAT/spz" {
 import { Scene } from "babylonjs/scene";
+import { Coroutine } from "babylonjs/Misc/coroutine";
 import { SPLATLoadingOptions } from "babylonjs-loaders/SPLAT/splatLoadingOptions";
 import { IParsedSplat } from "babylonjs-loaders/SPLAT/splatDefs";
+
 /**
- * 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>;
 
 }
 declare module "babylonjs-loaders/SPLAT/splatLoadingOptions" {
@@ -7064,6 +7098,17 @@ export type SPLATLoadingOptions = {
      * 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;
 };
 
 }
@@ -7212,6 +7257,7 @@ export interface IParsedSplat {
     faces?: number[];
     hasVertexColors?: boolean;
     sh?: Uint8Array[];
+    shDegree?: number;
     trainedWithAntialiasing?: boolean;
     compressed?: boolean;
     rawSplat?: boolean;
@@ -14653,13 +14699,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>;
 
 
     /**
@@ -14693,6 +14771,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;
     };
 
 
@@ -14831,6 +14920,7 @@ declare namespace BABYLON {
         faces?: number[];
         hasVertexColors?: boolean;
         sh?: Uint8Array[];
+        shDegree?: number;
         trainedWithAntialiasing?: boolean;
         compressed?: boolean;
         rawSplat?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "babylonjs-loaders",
-    "version": "9.2.1",
+    "version": "9.2.2",
     "main": "babylonjs.loaders.min.js",
     "types": "babylonjs.loaders.module.d.ts",
     "files": [
@@ -15,8 +15,8 @@
         "test:escheck": "es-check es6 ./babylonjs.loaders.js"
     },
     "dependencies": {
-        "babylonjs": "9.2.1",
-        "babylonjs-gltf2interface": "9.2.1"
+        "babylonjs": "9.2.2",
+        "babylonjs-gltf2interface": "9.2.2"
     },
     "devDependencies": {
         "@dev/build-tools": "1.0.0",