babylonjs-loaders 7.37.0 → 7.37.1

package/babylonjs.loaders.module.d.ts

@@ -2091,15 +2091,33 @@ declare module "babylonjs-loaders/glTF/2.0/Extensions/KHR_materials_variants" {
 import { Nullable } from "babylonjs/types";
 import { IGLTFLoaderExtension } from "babylonjs-loaders/glTF/2.0/glTFLoaderExtension";
 import { GLTFLoader } from "babylonjs-loaders/glTF/2.0/glTFLoader";
-import { Mesh } from "babylonjs/Meshes/mesh";
 import { AbstractMesh } from "babylonjs/Meshes/abstractMesh";
 import { INode, IMeshPrimitive, IMesh } from "babylonjs-loaders/glTF/2.0/glTFLoaderInterfaces";
+import { TransformNode } from "babylonjs/Meshes/transformNode";
+import { GLTFLoaderExtensionOptions } from "babylonjs-loaders/glTF/glTFFileLoader";
+const NAME = "KHR_materials_variants";
+export type MaterialVariantsController = Parameters<Required<GLTFLoaderExtensionOptions[typeof NAME]>["onLoaded"]>[0];
 module "babylonjs-loaders/glTF/glTFFileLoader" {
     interface GLTFLoaderExtensionOptions {
         /**
          * Defines options for the KHR_materials_variants extension.
          */
-        ["KHR_materials_variants"]: {};
+        ["KHR_materials_variants"]: Partial<{
+            /**
+             * Defines a callback that will be called if material variants are loaded.
+             * @experimental
+             */
+            onLoaded: (controller: {
+                /**
+                 * The list of available variant names for this asset.
+                 */
+                readonly variants: readonly string[];
+                /**
+                 * Gets or sets the selected variant.
+                 */
+                selectedVariant: string;
+            }) => void;
+        }>;
     }
 }
 /**
@@ -2124,58 +2142,61 @@ export class KHR_materials_variants implements IGLTFLoaderExtension {
     dispose(): void;
     /**
      * Gets the list of available variant names for this asset.
-     * @param rootMesh The glTF root mesh
+     * @param rootNode The glTF root node
      * @returns the list of all the variant names for this model
      */
-    static GetAvailableVariants(rootMesh: Mesh): string[];
+    static GetAvailableVariants(rootNode: TransformNode): string[];
     /**
      * Gets the list of available variant names for this asset.
-     * @param rootMesh The glTF root mesh
+     * @param rootNode The glTF root node
      * @returns the list of all the variant names for this model
      */
-    getAvailableVariants(rootMesh: Mesh): string[];
+    getAvailableVariants(rootNode: TransformNode): string[];
     /**
      * Select a variant given a variant name or a list of variant names.
-     * @param rootMesh The glTF root mesh
+     * @param rootNode The glTF root node
      * @param variantName The variant name(s) to select.
      */
-    static SelectVariant(rootMesh: Mesh, variantName: string | string[]): void;
+    static SelectVariant(rootNode: TransformNode, variantName: string | string[]): void;
     /**
      * Select a variant given a variant name or a list of variant names.
-     * @param rootMesh The glTF root mesh
+     * @param rootNode The glTF root node
      * @param variantName The variant name(s) to select.
      */
-    selectVariant(rootMesh: Mesh, variantName: string | string[]): void;
+    selectVariant(rootNode: TransformNode, variantName: string | string[]): void;
     /**
      * Reset back to the original before selecting a variant.
-     * @param rootMesh The glTF root mesh
+     * @param rootNode The glTF root node
      */
-    static Reset(rootMesh: Mesh): void;
+    static Reset(rootNode: TransformNode): void;
     /**
      * Reset back to the original before selecting a variant.
-     * @param rootMesh The glTF root mesh
+     * @param rootNode The glTF root node
      */
-    reset(rootMesh: Mesh): void;
+    reset(rootNode: TransformNode): void;
     /**
      * Gets the last selected variant name(s) or null if original.
-     * @param rootMesh The glTF root mesh
+     * @param rootNode The glTF root node
      * @returns The selected variant name(s).
      */
-    static GetLastSelectedVariant(rootMesh: Mesh): Nullable<string | string[]>;
+    static GetLastSelectedVariant(rootNode: TransformNode): Nullable<string | string[]>;
     /**
      * Gets the last selected variant name(s) or null if original.
-     * @param rootMesh The glTF root mesh
+     * @param rootNode The glTF root node
      * @returns The selected variant name(s).
      */
-    getLastSelectedVariant(rootMesh: Mesh): Nullable<string | string[]>;
+    getLastSelectedVariant(rootNode: TransformNode): Nullable<string | string[]>;
     private static _GetExtensionMetadata;
     /** @internal */
     onLoading(): void;
+    /** @internal */
+    onReady(): void;
     /**
      * @internal
      */
     _loadMeshPrimitiveAsync(context: string, name: string, node: INode, mesh: IMesh, primitive: IMeshPrimitive, assign: (babylonMesh: AbstractMesh) => void): Nullable<Promise<AbstractMesh>>;
 }
+export {};
 
 }
 declare module "babylonjs-loaders/glTF/2.0/Extensions/KHR_materials_unlit" {
@@ -4254,6 +4275,9 @@ export const SPLATFileLoaderMetadata: {
         readonly ".ply": {
             readonly isBinary: true;
         };
+        readonly ".spz": {
+            readonly isBinary: true;
+        };
     };
 };
 
@@ -4295,6 +4319,9 @@ export class SPLATFileLoader implements ISceneLoaderPluginAsync, ISceneLoaderPlu
         readonly ".ply": {
             readonly isBinary: true;
         };
+        readonly ".spz": {
+            readonly isBinary: true;
+        };
     };
     /**
      * Creates loader for gaussian splatting files
@@ -4317,6 +4344,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 _parseSPZ;
     private _parse;
     /**
      * Load into an asset container.
@@ -6841,7 +6869,9 @@ declare module BABYLON {
 
 }
 declare module BABYLON.GLTF2.Loader.Extensions {
-        /**
+        const NAME = "KHR_materials_variants";
+    export type MaterialVariantsController = Parameters<Required<GLTFLoaderExtensionOptions[typeof NAME]>["onLoaded"]>[0];
+    /**
      * [Specification](https://github.com/KhronosGroup/glTF/blob/main/extensions/2.0/Khronos/KHR_materials_variants/README.md)
      */
     export class KHR_materials_variants implements BABYLON.GLTF2.IGLTFLoaderExtension {
@@ -6863,53 +6893,55 @@ declare module BABYLON.GLTF2.Loader.Extensions {
         dispose(): void;
         /**
          * Gets the list of available variant names for this asset.
-         * @param rootMesh The glTF root mesh
+         * @param rootNode The glTF root node
          * @returns the list of all the variant names for this model
          */
-        static GetAvailableVariants(rootMesh: Mesh): string[];
+        static GetAvailableVariants(rootNode: TransformNode): string[];
         /**
          * Gets the list of available variant names for this asset.
-         * @param rootMesh The glTF root mesh
+         * @param rootNode The glTF root node
          * @returns the list of all the variant names for this model
          */
-        getAvailableVariants(rootMesh: Mesh): string[];
+        getAvailableVariants(rootNode: TransformNode): string[];
         /**
          * Select a variant given a variant name or a list of variant names.
-         * @param rootMesh The glTF root mesh
+         * @param rootNode The glTF root node
          * @param variantName The variant name(s) to select.
          */
-        static SelectVariant(rootMesh: Mesh, variantName: string | string[]): void;
+        static SelectVariant(rootNode: TransformNode, variantName: string | string[]): void;
         /**
          * Select a variant given a variant name or a list of variant names.
-         * @param rootMesh The glTF root mesh
+         * @param rootNode The glTF root node
          * @param variantName The variant name(s) to select.
          */
-        selectVariant(rootMesh: Mesh, variantName: string | string[]): void;
+        selectVariant(rootNode: TransformNode, variantName: string | string[]): void;
         /**
          * Reset back to the original before selecting a variant.
-         * @param rootMesh The glTF root mesh
+         * @param rootNode The glTF root node
          */
-        static Reset(rootMesh: Mesh): void;
+        static Reset(rootNode: TransformNode): void;
         /**
          * Reset back to the original before selecting a variant.
-         * @param rootMesh The glTF root mesh
+         * @param rootNode The glTF root node
          */
-        reset(rootMesh: Mesh): void;
+        reset(rootNode: TransformNode): void;
         /**
          * Gets the last selected variant name(s) or null if original.
-         * @param rootMesh The glTF root mesh
+         * @param rootNode The glTF root node
          * @returns The selected variant name(s).
          */
-        static GetLastSelectedVariant(rootMesh: Mesh): Nullable<string | string[]>;
+        static GetLastSelectedVariant(rootNode: TransformNode): Nullable<string | string[]>;
         /**
          * Gets the last selected variant name(s) or null if original.
-         * @param rootMesh The glTF root mesh
+         * @param rootNode The glTF root node
          * @returns The selected variant name(s).
          */
-        getLastSelectedVariant(rootMesh: Mesh): Nullable<string | string[]>;
+        getLastSelectedVariant(rootNode: TransformNode): Nullable<string | string[]>;
         private static _GetExtensionMetadata;
         /** @internal */
         onLoading(): void;
+        /** @internal */
+        onReady(): void;
         /**
          * @internal
          */
@@ -6924,7 +6956,22 @@ declare module BABYLON {
         /**
          * Defines options for the KHR_materials_variants extension.
          */
-        ["KHR_materials_variants"]: {};
+        ["KHR_materials_variants"]: Partial<{
+            /**
+             * Defines a callback that will be called if material variants are loaded.
+             * @experimental
+             */
+            onLoaded: (controller: {
+                /**
+                 * The list of available variant names for this asset.
+                 */
+                readonly variants: readonly string[];
+                /**
+                 * Gets or sets the selected variant.
+                 */
+                selectedVariant: string;
+            }) => void;
+        }>;
     }
 
 }
@@ -8943,6 +8990,9 @@ declare module BABYLON {
             readonly ".ply": {
                 readonly isBinary: true;
             };
+            readonly ".spz": {
+                readonly isBinary: true;
+            };
         };
     };
 
@@ -8976,6 +9026,9 @@ declare module BABYLON {
             readonly ".ply": {
                 readonly isBinary: true;
             };
+            readonly ".spz": {
+                readonly isBinary: true;
+            };
         };
         /**
          * Creates loader for gaussian splatting files
@@ -8998,6 +9051,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 _parseSPZ;
         private _parse;
         /**
          * Load into an asset container.

package/package.json

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