babylonjs-loaders 9.9.1 → 9.9.2

package/babylonjs.loaders.module.d.ts

@@ -1501,7 +1501,7 @@ export class OpenPBRMaterialLoadingAdapter implements IMaterialLoadingAdapter {
     set useAlphaFromBaseColorTexture(value: boolean);
     /**
      * Gets whether alpha is used from the base color texture.
-     * @returns Always false for OpenPBR as it's handled automatically
+     * @returns True if alpha is used from the base color texture
      */
     get useAlphaFromBaseColorTexture(): boolean;
     /**
@@ -7354,6 +7354,12 @@ export type SPLATLoadingOptions = {
      * Required for IBL shadows to work if keepInRam is false.
      */
     needsRotationScaleTextures?: boolean;
+    /**
+     * Load SOG files as raw GPU textures and dequantize in the shader.
+     * Skips the CPU decode pass and yields much faster load times.
+     * Requires WebGL2 / WebGPU. Defaults to false (CPU decode).
+     */
+    useSogTextures?: boolean;
     /**
      * 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
@@ -7495,6 +7501,7 @@ export class SPLATFileLoader implements ISceneLoaderPluginAsync, ISceneLoaderPlu
 
 }
 declare module "babylonjs-loaders/SPLAT/splatDefs" {
+import { BaseTexture } from "babylonjs/Materials/Textures/baseTexture.pure";
 /**
  * Indicator of the parsed ply buffer. A standard ready to use splat or an array of positions for a point cloud
  */
@@ -7504,6 +7511,45 @@ export enum Mode {
     Mesh = 2,
     Reject = 3
 }
+/**
+ * SOG (Self-Organized Gaussians) raw texture set + decoding parameters.
+ * Used when SOG webp textures are fed directly to the GPU and dequantized in the shader.
+ */
+export interface ISogTexturePack {
+    /** SOG file version (1 or 2). */
+    version: 1 | 2;
+    /** Number of splats. */
+    splatCount: number;
+    /** SH degree (0..3+). */
+    shDegree: number;
+    /** Raw webp textures, all RGBA8 with nearest sampling. */
+    meansTextureL: BaseTexture;
+    meansTextureU: BaseTexture;
+    scalesTexture: BaseTexture;
+    quatsTexture: BaseTexture;
+    sh0Texture: BaseTexture;
+    shCentroidsTexture?: BaseTexture;
+    shLabelsTexture?: BaseTexture;
+    /** Optional codebook (v2) packed into a 1D R32F texture. Encoding:
+     *  - texels [0..255]   : scales codebook
+     *  - texels [256..511] : sh0 codebook
+     *  - texels [512..767] : shN codebook
+     */
+    codebookTexture?: BaseTexture;
+    /** Mins/maxs (v1) used as uniforms. */
+    meansMin: [number, number, number];
+    meansMax: [number, number, number];
+    scalesMin?: [number, number, number];
+    scalesMax?: [number, number, number];
+    sh0Min?: [number, number, number, number];
+    sh0Max?: [number, number, number, number];
+    shnMin?: number;
+    shnMax?: number;
+    /** SH layout info. */
+    shCoeffCount: number;
+    /** CPU-side decoded positions for the depth-sort worker. */
+    positions: Float32Array;
+}
 /**
  * A parsed buffer and how to use it
  */
@@ -7521,6 +7567,8 @@ export interface IParsedSplat {
     safeOrbitCameraElevationMinMax?: [number, number];
     upAxis?: "X" | "Y" | "Z";
     chirality?: "LeftHanded" | "RightHanded";
+    /** When set, the splats are to be uploaded as raw SOG textures and dequantized in the shader. */
+    sogTextures?: ISogTexturePack;
 }
 
 }
@@ -7609,6 +7657,15 @@ export interface SOGRootData {
  * @returns Parsed data
  */
 export function ParseSogMeta(dataOrFiles: SOGRootData | Map<string, Uint8Array>, rootUrl: string, scene: Scene): Promise<IParsedSplat>;
+/**
+ * Parse SOG data and produce a set of GPU textures + dequantization parameters.
+ * The shader will sample these raw RGBA8 textures and reconstruct positions/scales/rotations/colors/SH on the GPU.
+ * @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 splat info with `sogTextures` populated.
+ */
+export function ParseSogMetaAsTextures(dataOrFiles: SOGRootData | Map<string, Uint8Array>, rootUrl: string, scene: Scene): Promise<IParsedSplat>;
 
 }
 declare module "babylonjs-loaders/SPLAT/index" {
@@ -9585,7 +9642,7 @@ declare namespace BABYLON.GLTF2 {
         set useAlphaFromBaseColorTexture(value: boolean);
         /**
          * Gets whether alpha is used from the base color texture.
-         * @returns Always false for OpenPBR as it's handled automatically
+         * @returns True if alpha is used from the base color texture
          */
         get useAlphaFromBaseColorTexture(): boolean;
         /**
@@ -15277,6 +15334,12 @@ declare namespace BABYLON {
          * Required for IBL shadows to work if keepInRam is false.
          */
         needsRotationScaleTextures?: boolean;
+        /**
+         * Load SOG files as raw GPU textures and dequantize in the shader.
+         * Skips the CPU decode pass and yields much faster load times.
+         * Requires WebGL2 / WebGPU. Defaults to false (CPU decode).
+         */
+        useSogTextures?: boolean;
         /**
          * 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
@@ -15417,6 +15480,45 @@ declare namespace BABYLON {
         Mesh = 2,
         Reject = 3
     }
+    /**
+     * SOG (Self-Organized Gaussians) raw texture set + decoding parameters.
+     * Used when SOG webp textures are fed directly to the GPU and dequantized in the shader.
+     */
+    export interface ISogTexturePack {
+        /** SOG file version (1 or 2). */
+        version: 1 | 2;
+        /** Number of splats. */
+        splatCount: number;
+        /** SH degree (0..3+). */
+        shDegree: number;
+        /** Raw webp textures, all RGBA8 with nearest sampling. */
+        meansTextureL: BaseTexture;
+        meansTextureU: BaseTexture;
+        scalesTexture: BaseTexture;
+        quatsTexture: BaseTexture;
+        sh0Texture: BaseTexture;
+        shCentroidsTexture?: BaseTexture;
+        shLabelsTexture?: BaseTexture;
+        /** Optional codebook (v2) packed into a 1D R32F texture. Encoding:
+         *  - texels [0..255]   : scales codebook
+         *  - texels [256..511] : sh0 codebook
+         *  - texels [512..767] : shN codebook
+         */
+        codebookTexture?: BaseTexture;
+        /** Mins/maxs (v1) used as uniforms. */
+        meansMin: [number, number, number];
+        meansMax: [number, number, number];
+        scalesMin?: [number, number, number];
+        scalesMax?: [number, number, number];
+        sh0Min?: [number, number, number, number];
+        sh0Max?: [number, number, number, number];
+        shnMin?: number;
+        shnMax?: number;
+        /** SH layout info. */
+        shCoeffCount: number;
+        /** CPU-side decoded positions for the depth-sort worker. */
+        positions: Float32Array;
+    }
     /**
      * A parsed buffer and how to use it
      */
@@ -15434,6 +15536,8 @@ declare namespace BABYLON {
         safeOrbitCameraElevationMinMax?: [number, number];
         upAxis?: "X" | "Y" | "Z";
         chirality?: "LeftHanded" | "RightHanded";
+        /** When set, the splats are to be uploaded as raw SOG textures and dequantized in the shader. */
+        sogTextures?: ISogTexturePack;
     }
 
 
@@ -15519,6 +15623,15 @@ declare namespace BABYLON {
      * @returns Parsed data
      */
     export function ParseSogMeta(dataOrFiles: SOGRootData | Map<string, Uint8Array>, rootUrl: string, scene: Scene): Promise<IParsedSplat>;
+    /**
+     * Parse SOG data and produce a set of GPU textures + dequantization parameters.
+     * The shader will sample these raw RGBA8 textures and reconstruct positions/scales/rotations/colors/SH on the GPU.
+     * @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 splat info with `sogTextures` populated.
+     */
+    export function ParseSogMetaAsTextures(dataOrFiles: SOGRootData | Map<string, Uint8Array>, rootUrl: string, scene: Scene): Promise<IParsedSplat>;
 
 
 

package/package.json

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