babylonjs-loaders 8.30.1 → 8.30.3

package/babylonjs.loaders.d.ts

@@ -6352,6 +6352,16 @@ declare module BABYLON {
 
 
 
+    /**
+     * Parses SPZ data and returns a promise resolving to an IParsedPLY object.
+     * @param data The ArrayBuffer containing SPZ data.
+     * @param scene The Babylon.js scene.
+     * @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<IParsedPLY>;
+
+
     /**
      * Options for loading Gaussian Splatting and PLY files
      */
@@ -6379,6 +6389,12 @@ declare module BABYLON {
             readonly ".spz": {
                 readonly isBinary: true;
             };
+            readonly ".json": {
+                readonly isBinary: false;
+            };
+            readonly ".sog": {
+                readonly isBinary: true;
+            };
         };
     };
 
@@ -6415,6 +6431,12 @@ declare module BABYLON {
             readonly ".spz": {
                 readonly isBinary: true;
             };
+            readonly ".json": {
+                readonly isBinary: false;
+            };
+            readonly ".sog": {
+                readonly isBinary: true;
+            };
         };
         /**
          * Creates loader for gaussian splatting files
@@ -6437,7 +6459,7 @@ declare module BABYLON {
         importMeshAsync(meshesNames: any, scene: Scene, data: any, rootUrl: string, _onProgress?: (event: ISceneLoaderProgressEvent) => void, _fileName?: string): Promise<ISceneLoaderAsyncResult>;
         private static _BuildPointCloud;
         private static _BuildMesh;
-        private _parseSPZAsync;
+        private _unzipWithFFlateAsync;
         private _parseAsync;
         /**
          * Load into an asset container.
@@ -6466,6 +6488,114 @@ declare module BABYLON {
     }
 
 
+    /**
+     * Indicator of the parsed ply buffer. A standard ready to use splat or an array of positions for a point cloud
+     */
+    export enum Mode {
+        Splat = 0,
+        PointCloud = 1,
+        Mesh = 2,
+        Reject = 3
+    }
+    /**
+     * A parsed buffer and how to use it
+     */
+    export interface IParsedPLY {
+        data: ArrayBuffer;
+        mode: Mode;
+        faces?: number[];
+        hasVertexColors?: boolean;
+        sh?: Uint8Array[];
+        trainedWithAntialiasing?: boolean;
+        compressed?: boolean;
+        rawSplat?: boolean;
+    }
+
+
+    /**
+     * Definition of a SOG data file
+     */
+    export interface SOGDataFile {
+        /**
+         * index 0 is number of splats index 1 is number of components per splat (3 for vec3, 4 for vec4, etc.)
+         */
+        shape: number[];
+        /**
+         * type of components
+         */
+        dtype: string;
+        /**
+         * min range of data
+         */
+        mins?: number | number[];
+        /**
+         * max range of data
+         */
+        maxs?: number | number[];
+        /**
+         * palette for indexed data (quantized)
+         */
+        codebook?: number[];
+        /**
+         * type of encoding
+         */
+        encoding?: string;
+        /**
+         * number of bits for quantization (if any)
+         */
+        quantization?: number;
+        /**
+         * webp file names
+         */
+        files: string[];
+        /**
+         * SH band count (if applicable)
+         */
+        bands?: number;
+    }
+    /**
+     * Definition of the root SOG data file
+     */
+    export interface SOGRootData {
+        /**
+         * version of the SOG format
+         */
+        version?: number;
+        /**
+         * mean positions of the splats
+         */
+        means: SOGDataFile;
+        /**
+         * scales of the splats
+         */
+        scales: SOGDataFile;
+        /**
+         * quaternions of the splats
+         */
+        quats: SOGDataFile;
+        /**
+         * SH0 coefficients of the splats (base color)
+         */
+        sh0: SOGDataFile;
+        /**
+         *  Optional higher order SH coefficients of the splats (lighting information)
+         */
+        shN?: SOGDataFile;
+        /**
+         * number of splats (optional, can be inferred from means.shape[0])
+         */
+        count?: number;
+    }
+    /**
+     * Parse SOG data from either a SOGRootData object (with webp files loaded from rootUrl) or from a Map of filenames to Uint8Array file data (including meta.json)
+     * @param dataOrFiles Either the SOGRootData or a Map of filenames to Uint8Array file data (including meta.json)
+     * @param rootUrl Base URL to load webp files from (if dataOrFiles is SOGRootData)
+     * @param scene The Babylon.js scene
+     * @returns Parsed data
+     */
+    export function ParseSogMeta(dataOrFiles: SOGRootData | Map<string, Uint8Array>, rootUrl: string, scene: Scene): Promise<IParsedPLY>;
+
+
 
 
     /**