babylonjs-loaders 8.30.1 → 8.30.3

package/babylonjs.loaders.module.d.ts

@@ -6534,6 +6534,20 @@ export class STLFileLoader implements ISceneLoaderPlugin {
 declare module "babylonjs-loaders/STL/index" {
 export * from "babylonjs-loaders/STL/stlFileLoader";
 
+}
+declare module "babylonjs-loaders/SPLAT/spz" {
+import { Scene } from "babylonjs/scene";
+import { SPLATLoadingOptions } from "babylonjs-loaders/SPLAT/splatLoadingOptions";
+import { IParsedPLY } from "babylonjs-loaders/SPLAT/splatDefs";
+/**
+ * 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>;
+
 }
 declare module "babylonjs-loaders/SPLAT/splatLoadingOptions" {
 /**
@@ -6564,6 +6578,12 @@ export const SPLATFileLoaderMetadata: {
         readonly ".spz": {
             readonly isBinary: true;
         };
+        readonly ".json": {
+            readonly isBinary: false;
+        };
+        readonly ".sog": {
+            readonly isBinary: true;
+        };
     };
 };
 
@@ -6608,6 +6628,12 @@ export class SPLATFileLoader implements ISceneLoaderPluginAsync, ISceneLoaderPlu
         readonly ".spz": {
             readonly isBinary: true;
         };
+        readonly ".json": {
+            readonly isBinary: false;
+        };
+        readonly ".sog": {
+            readonly isBinary: true;
+        };
     };
     /**
      * Creates loader for gaussian splatting files
@@ -6630,7 +6656,7 @@ export class SPLATFileLoader implements ISceneLoaderPluginAsync, ISceneLoaderPlu
     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.
@@ -6658,6 +6684,118 @@ export class SPLATFileLoader implements ISceneLoaderPluginAsync, ISceneLoaderPlu
     private static _ConvertPLYToSplat;
 }
 
+}
+declare module "babylonjs-loaders/SPLAT/splatDefs" {
+/**
+ * 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;
+}
+
+}
+declare module "babylonjs-loaders/SPLAT/sog" {
+import { Scene } from "babylonjs/scene";
+import { IParsedPLY } from "babylonjs-loaders/SPLAT/splatDefs";
+/**
+ * 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>;
+
 }
 declare module "babylonjs-loaders/SPLAT/index" {
 export * from "babylonjs-loaders/SPLAT/splatLoadingOptions";
@@ -13618,6 +13756,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
      */
@@ -13645,6 +13793,12 @@ declare module BABYLON {
             readonly ".spz": {
                 readonly isBinary: true;
             };
+            readonly ".json": {
+                readonly isBinary: false;
+            };
+            readonly ".sog": {
+                readonly isBinary: true;
+            };
         };
     };
 
@@ -13681,6 +13835,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
@@ -13703,7 +13863,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.
@@ -13732,6 +13892,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>;
+
+
 
 
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "babylonjs-loaders",
-    "version": "8.30.1",
+    "version": "8.30.3",
     "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": "^8.30.1",
-        "babylonjs-gltf2interface": "^8.30.1"
+        "babylonjs": "^8.30.3",
+        "babylonjs-gltf2interface": "^8.30.3"
     },
     "devDependencies": {
         "@dev/build-tools": "1.0.0",