@babylonjs/loaders 9.6.1 → 9.7.0

package/glTF/2.0/materialLoadingAdapter.d.ts

@@ -11,10 +11,20 @@ export interface IMaterialLoadingAdapter {
      * Gets the underlying material
      */
     readonly material: Material;
+    /** @deprecated Use finalizeAsync instead. */
+    finalize?(): void;
     /**
-     * Finalizes material properties after loading is complete.
+     * Finalizes material properties after all loading is complete.
+     * May return a Promise for async work (e.g. GPU texture processing). Any returned
+     * Promise is tracked by the loader and awaited before the COMPLETE state is reached,
+     * so callers can rely on onCompleteObservable for fully processed materials.
+     *
+     * The loader passes an AbortSignal that is aborted when the loader is disposed.
+     * Implementations should check `signal.aborted` after each await point and, if
+     * aborted, release any intermediate resources and return early.
+     * @param signal An AbortSignal that fires when the loader is disposed mid-flight.
      */
-    finalize?(): void;
+    finalizeAsync?(signal: AbortSignal): Promise<void> | void;
     /**
      * Whether the material should be treated as unlit
      */
@@ -76,6 +86,10 @@ export interface IMaterialLoadingAdapter {
      * @param enableEdgeColor - Whether to enable edge color support
      */
     enableSpecularEdgeColor(enableEdgeColor?: boolean): void;
+    /**
+     * Enable the specular/glossiness workflow and disable metallic/roughness.
+     */
+    configureSpecularGlossiness(): void;
     /**
      * Sets/gets the specular weight
      */
@@ -104,6 +118,11 @@ export interface IMaterialLoadingAdapter {
      * Sets/gets the specular IOR
      */
     specularIor: number;
+    /**
+     * Sets/gets the glossiness (inverted roughness)
+     * ONLY used for specular/glossiness workflow; has no effect when metallic/roughness workflow is active
+     */
+    glossiness: number;
     /**
      * Sets/gets the emissive color
      */
@@ -220,6 +239,9 @@ export interface IMaterialLoadingAdapter {
      * Configures transmission for thin-surface transmission (KHR_materials_transmission)
      */
     configureTransmission(): void;
+    /**
+     * Configures volume properties for volumetric transmission (KHR_materials_volume)
+     */
     configureVolume(): void;
     /**
      * Sets whether the material is thin-walled (i.e. non-volumetric) or not.

package/glTF/2.0/materialLoadingAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"materialLoadingAdapter.js","sourceRoot":"","sources":["../../../../../dev/loaders/src/glTF/2.0/materialLoadingAdapter.ts"],"names":[],"mappings":"","sourcesContent":["import { type Material } from \"core/Materials/material\";\r\nimport { type BaseTexture } from \"core/Materials/Textures/baseTexture\";\r\nimport { type Nullable } from \"core/types\";\r\nimport { type Color3 } from \"core/Maths/math.color\";\r\n\r\n/**\r\n * Interface for material loading adapters that provides a unified OpenPBR-like interface\r\n * for both OpenPBR and PBR materials, eliminating conditional branches in extensions.\r\n */\r\nexport interface IMaterialLoadingAdapter {\r\n    /**\r\n     * Gets the underlying material\r\n     */\r\n    readonly material: Material;\r\n\r\n    /**\r\n     * Finalizes material properties after loading is complete.\r\n     */\r\n    finalize?(): void;\r\n\r\n    /**\r\n     * Whether the material should be treated as unlit\r\n     */\r\n    isUnlit: boolean;\r\n\r\n    // ========================================\r\n    // CULLING PROPERTIES\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the back face culling\r\n     */\r\n    backFaceCulling: boolean;\r\n\r\n    /**\r\n     * Sets/gets the two sided lighting\r\n     */\r\n    twoSidedLighting: boolean;\r\n\r\n    // ========================================\r\n    // ALPHA PROPERTIES\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the alpha cutoff value (used for alpha test mode)\r\n     */\r\n    alphaCutOff: number;\r\n\r\n    /**\r\n     * Sets/gets whether to use alpha from albedo/base color texture\r\n     */\r\n    useAlphaFromBaseColorTexture: boolean;\r\n\r\n    /**\r\n     * Sets/Gets whether the transparency is treated as alpha coverage\r\n     */\r\n    transparencyAsAlphaCoverage: boolean;\r\n\r\n    // ========================================\r\n    // BASE PARAMETERS\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the base color\r\n     */\r\n    baseColor: Color3;\r\n\r\n    /**\r\n     * Sets/gets the base color texture\r\n     */\r\n    baseColorTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the base diffuse roughness\r\n     */\r\n    baseDiffuseRoughness: number;\r\n\r\n    /**\r\n     * Sets/gets the base diffuse roughness texture\r\n     */\r\n    baseDiffuseRoughnessTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the base metalness\r\n     */\r\n    baseMetalness: number;\r\n\r\n    /**\r\n     * Sets/gets the base metalness texture\r\n     */\r\n    baseMetalnessTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets whether to use roughness from metallic texture green channel\r\n     */\r\n    useRoughnessFromMetallicTextureGreen: boolean;\r\n\r\n    /**\r\n     * Sets whether to use metallic from metallic texture blue channel\r\n     */\r\n    useMetallicFromMetallicTextureBlue: boolean;\r\n\r\n    // ========================================\r\n    // SPECULAR PARAMETERS\r\n    // ========================================\r\n\r\n    /**\r\n     * Configures specular properties and enables OpenPBR BRDF model for edge color support\r\n     * @param enableEdgeColor - Whether to enable edge color support\r\n     */\r\n    enableSpecularEdgeColor(enableEdgeColor?: boolean): void;\r\n\r\n    /**\r\n     * Sets/gets the specular weight\r\n     */\r\n    specularWeight: number;\r\n\r\n    /**\r\n     * Sets/gets the specular weight texture\r\n     */\r\n    specularWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the specular color\r\n     */\r\n    specularColor: Color3;\r\n\r\n    /**\r\n     * Sets/gets the specular color texture\r\n     */\r\n    specularColorTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the specular roughness\r\n     */\r\n    specularRoughness: number;\r\n\r\n    /**\r\n     * Sets/gets the specular roughness texture\r\n     */\r\n    specularRoughnessTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the specular IOR\r\n     */\r\n    specularIor: number;\r\n\r\n    // ========================================\r\n    // EMISSION PARAMETERS\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the emissive color\r\n     */\r\n    emissionColor: Color3;\r\n\r\n    /**\r\n     * Sets/gets the emissive luminance\r\n     */\r\n    emissionLuminance: number;\r\n\r\n    /**\r\n     * Sets/gets the emissive texture\r\n     */\r\n    emissionColorTexture: Nullable<BaseTexture>;\r\n\r\n    // ========================================\r\n    // AMBIENT OCCLUSION\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the ambient occlusion texture\r\n     */\r\n    ambientOcclusionTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the ambient occlusion texture strength/level\r\n     */\r\n    ambientOcclusionTextureStrength: number;\r\n\r\n    // ========================================\r\n    // COAT PARAMETERS\r\n    // ========================================\r\n\r\n    /**\r\n     * Configures clear coat for PBR material\r\n     */\r\n    configureCoat(): void;\r\n\r\n    /**\r\n     * Sets/gets the coat weight\r\n     */\r\n    coatWeight: number;\r\n\r\n    /**\r\n     * Sets/gets the coat weight texture\r\n     */\r\n    coatWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the coat color\r\n     */\r\n    coatColor: Color3;\r\n\r\n    /**\r\n     * Sets the coat color texture\r\n     */\r\n    coatColorTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the coat roughness\r\n     */\r\n    coatRoughness: number;\r\n\r\n    /**\r\n     * Sets/gets the coat roughness texture\r\n     */\r\n    coatRoughnessTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the coat index of refraction (IOR)\r\n     */\r\n    coatIor: number;\r\n\r\n    /**\r\n     * Sets the coat darkening\r\n     */\r\n    coatDarkening: number;\r\n\r\n    /**\r\n     * Sets the coat darkening texture\r\n     */\r\n    coatDarkeningTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the coat roughness anisotropy\r\n     */\r\n    coatRoughnessAnisotropy: number;\r\n\r\n    /**\r\n     * Sets the coat tangent angle for anisotropy\r\n     */\r\n    geometryCoatTangentAngle: number;\r\n\r\n    /**\r\n     * Sets the coat tangent texture for anisotropy\r\n     */\r\n    geometryCoatTangentTexture: Nullable<BaseTexture>;\r\n\r\n    // ========================================\r\n    // TRANSMISSION LAYER\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets the transmission weight\r\n     */\r\n    transmissionWeight: number;\r\n\r\n    /**\r\n     * Sets the transmission weight texture\r\n     */\r\n    transmissionWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the attenuation distance\r\n     */\r\n    transmissionDepth: number;\r\n\r\n    /**\r\n     * Sets the attenuation color\r\n     */\r\n    transmissionColor: Color3;\r\n\r\n    /**\r\n     * Sets the scattering coefficient\r\n     */\r\n    transmissionScatter: Color3;\r\n\r\n    /**\r\n     * Sets the transmission scatter texture\r\n     */\r\n    transmissionScatterTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the scattering anisotropy (-1 to 1)\r\n     */\r\n    transmissionScatterAnisotropy: number;\r\n\r\n    /**\r\n     * Sets the dispersion Abbe number\r\n     */\r\n    transmissionDispersionAbbeNumber: number;\r\n\r\n    /**\r\n     * Sets the dispersion scale\r\n     */\r\n    transmissionDispersionScale: number;\r\n\r\n    /**\r\n     * The refraction background texture\r\n     */\r\n    refractionBackgroundTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Configures transmission for thin-surface transmission (KHR_materials_transmission)\r\n     */\r\n    configureTransmission(): void;\r\n\r\n    // ========================================\r\n    // VOLUME PROPERTIES\r\n    // ========================================\r\n\r\n    configureVolume(): void;\r\n\r\n    /**\r\n     * Sets whether the material is thin-walled (i.e. non-volumetric) or not.\r\n     */\r\n    geometryThinWalled: boolean;\r\n\r\n    /**\r\n     * Sets the thickness texture\r\n     */\r\n    volumeThicknessTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the thickness factor\r\n     */\r\n    volumeThickness: number;\r\n\r\n    // ========================================\r\n    // SUBSURFACE PROPERTIES (Subsurface Scattering)\r\n    // ========================================\r\n\r\n    /**\r\n     * Configures subsurface properties\r\n     */\r\n    configureSubsurface(): void;\r\n\r\n    /**\r\n     * Sets/gets the subsurface weight\r\n     */\r\n    subsurfaceWeight: number;\r\n\r\n    /**\r\n     * Sets/gets the subsurface weight texture\r\n     */\r\n    subsurfaceWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the subsurface color\r\n     */\r\n    subsurfaceColor: Color3;\r\n\r\n    /**\r\n     * Sets/gets the subsurface color texture\r\n     */\r\n    subsurfaceColorTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the diffuse transmission tint of the material\r\n     */\r\n    diffuseTransmissionTint: Color3;\r\n\r\n    /**\r\n     * Sets/gets the diffuse transmission tint texture of the material\r\n     */\r\n    diffuseTransmissionTintTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the subsurface radius (used for subsurface scattering)\r\n     */\r\n    subsurfaceRadius: number;\r\n\r\n    /**\r\n     * Sets/gets the subsurface radius scale (used for subsurface scattering)\r\n     */\r\n    subsurfaceRadiusScale: Color3;\r\n\r\n    /**\r\n     * Sets/gets the subsurface scattering anisotropy\r\n     */\r\n    subsurfaceScatterAnisotropy: number;\r\n\r\n    /**\r\n     * Does this material have a translucent surface (i.e. either transmission or subsurface)?\r\n     */\r\n    isTranslucent(): boolean;\r\n\r\n    // ========================================\r\n    // FUZZ LAYER (Sheen)\r\n    // ========================================\r\n\r\n    /**\r\n     * Configures initial settings for fuzz for material.\r\n     */\r\n    configureFuzz(): void;\r\n\r\n    /**\r\n     * Sets the fuzz weight\r\n     */\r\n    fuzzWeight: number;\r\n\r\n    /**\r\n     * Sets the fuzz weight texture\r\n     */\r\n    fuzzWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the fuzz color\r\n     */\r\n    fuzzColor: Color3;\r\n\r\n    /**\r\n     * Sets the fuzz color texture\r\n     */\r\n    fuzzColorTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the fuzz roughness\r\n     */\r\n    fuzzRoughness: number;\r\n\r\n    /**\r\n     * Sets the fuzz roughness texture\r\n     */\r\n    fuzzRoughnessTexture: Nullable<BaseTexture>;\r\n\r\n    // ========================================\r\n    // ANISOTROPY\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the specular roughness anisotropy\r\n     */\r\n    specularRoughnessAnisotropy: number;\r\n\r\n    /**\r\n     * Sets the anisotropy rotation\r\n     */\r\n    geometryTangentAngle: number;\r\n\r\n    /**\r\n     * Sets/gets the anisotropy texture\r\n     */\r\n    geometryTangentTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Configures glTF-style anisotropy for OpenPBR materials\r\n     * @param useGltfStyle - Whether to use glTF-style anisotropy (default: true)\r\n     */\r\n    configureGltfStyleAnisotropy(useGltfStyle?: boolean): void;\r\n\r\n    // ========================================\r\n    // THIN FILM IRIDESCENCE\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets the thin film weight\r\n     */\r\n    thinFilmWeight: number;\r\n\r\n    /**\r\n     * Sets the thin film IOR\r\n     */\r\n    thinFilmIor: number;\r\n\r\n    /**\r\n     * Sets the thin film thickness minimum\r\n     */\r\n    thinFilmThicknessMinimum: number;\r\n\r\n    /**\r\n     * Sets the thin film thickness maximum\r\n     */\r\n    thinFilmThicknessMaximum: number;\r\n\r\n    /**\r\n     * Sets the thin film iridescence texture\r\n     */\r\n    thinFilmWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the thin film thickness texture\r\n     */\r\n    thinFilmThicknessTexture: Nullable<BaseTexture>;\r\n\r\n    // ========================================\r\n    // UNLIT MATERIALS\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets the unlit flag\r\n     */\r\n    unlit: boolean;\r\n\r\n    // ========================================\r\n    // GEOMETRY PARAMETERS\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the geometry opacity\r\n     */\r\n    geometryOpacity: number;\r\n\r\n    /**\r\n     * Sets/gets the geometry normal texture\r\n     */\r\n    geometryNormalTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the normal map inversions for PBR material only\r\n     * @param invertX - Whether to invert the normal map on the X axis\r\n     * @param invertY - Whether to invert the normal map on the Y axis\r\n     */\r\n    setNormalMapInversions(invertX: boolean, invertY: boolean): void;\r\n\r\n    /**\r\n     * Sets/gets the coat normal texture\r\n     */\r\n    geometryCoatNormalTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the coat normal texture scale\r\n     */\r\n    geometryCoatNormalTextureScale: number;\r\n}\r\n"]}
+{"version":3,"file":"materialLoadingAdapter.js","sourceRoot":"","sources":["../../../../../dev/loaders/src/glTF/2.0/materialLoadingAdapter.ts"],"names":[],"mappings":"","sourcesContent":["import { type Material } from \"core/Materials/material\";\r\nimport { type BaseTexture } from \"core/Materials/Textures/baseTexture\";\r\nimport { type Nullable } from \"core/types\";\r\nimport { type Color3 } from \"core/Maths/math.color\";\r\n\r\n/**\r\n * Interface for material loading adapters that provides a unified OpenPBR-like interface\r\n * for both OpenPBR and PBR materials, eliminating conditional branches in extensions.\r\n */\r\nexport interface IMaterialLoadingAdapter {\r\n    /**\r\n     * Gets the underlying material\r\n     */\r\n    readonly material: Material;\r\n\r\n    /** @deprecated Use finalizeAsync instead. */\r\n    finalize?(): void;\r\n\r\n    /**\r\n     * Finalizes material properties after all loading is complete.\r\n     * May return a Promise for async work (e.g. GPU texture processing). Any returned\r\n     * Promise is tracked by the loader and awaited before the COMPLETE state is reached,\r\n     * so callers can rely on onCompleteObservable for fully processed materials.\r\n     *\r\n     * The loader passes an AbortSignal that is aborted when the loader is disposed.\r\n     * Implementations should check `signal.aborted` after each await point and, if\r\n     * aborted, release any intermediate resources and return early.\r\n     * @param signal An AbortSignal that fires when the loader is disposed mid-flight.\r\n     */\r\n    finalizeAsync?(signal: AbortSignal): Promise<void> | void;\r\n\r\n    /**\r\n     * Whether the material should be treated as unlit\r\n     */\r\n    isUnlit: boolean;\r\n\r\n    // ========================================\r\n    // CULLING PROPERTIES\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the back face culling\r\n     */\r\n    backFaceCulling: boolean;\r\n\r\n    /**\r\n     * Sets/gets the two sided lighting\r\n     */\r\n    twoSidedLighting: boolean;\r\n\r\n    // ========================================\r\n    // ALPHA PROPERTIES\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the alpha cutoff value (used for alpha test mode)\r\n     */\r\n    alphaCutOff: number;\r\n\r\n    /**\r\n     * Sets/gets whether to use alpha from albedo/base color texture\r\n     */\r\n    useAlphaFromBaseColorTexture: boolean;\r\n\r\n    /**\r\n     * Sets/Gets whether the transparency is treated as alpha coverage\r\n     */\r\n    transparencyAsAlphaCoverage: boolean;\r\n\r\n    // ========================================\r\n    // BASE PARAMETERS\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the base color\r\n     */\r\n    baseColor: Color3;\r\n\r\n    /**\r\n     * Sets/gets the base color texture\r\n     */\r\n    baseColorTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the base diffuse roughness\r\n     */\r\n    baseDiffuseRoughness: number;\r\n\r\n    /**\r\n     * Sets/gets the base diffuse roughness texture\r\n     */\r\n    baseDiffuseRoughnessTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the base metalness\r\n     */\r\n    baseMetalness: number;\r\n\r\n    /**\r\n     * Sets/gets the base metalness texture\r\n     */\r\n    baseMetalnessTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets whether to use roughness from metallic texture green channel\r\n     */\r\n    useRoughnessFromMetallicTextureGreen: boolean;\r\n\r\n    /**\r\n     * Sets whether to use metallic from metallic texture blue channel\r\n     */\r\n    useMetallicFromMetallicTextureBlue: boolean;\r\n\r\n    // ========================================\r\n    // SPECULAR PARAMETERS\r\n    // ========================================\r\n\r\n    /**\r\n     * Configures specular properties and enables OpenPBR BRDF model for edge color support\r\n     * @param enableEdgeColor - Whether to enable edge color support\r\n     */\r\n    enableSpecularEdgeColor(enableEdgeColor?: boolean): void;\r\n\r\n    /**\r\n     * Enable the specular/glossiness workflow and disable metallic/roughness.\r\n     */\r\n    configureSpecularGlossiness(): void;\r\n\r\n    /**\r\n     * Sets/gets the specular weight\r\n     */\r\n    specularWeight: number;\r\n\r\n    /**\r\n     * Sets/gets the specular weight texture\r\n     */\r\n    specularWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the specular color\r\n     */\r\n    specularColor: Color3;\r\n\r\n    /**\r\n     * Sets/gets the specular color texture\r\n     */\r\n    specularColorTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the specular roughness\r\n     */\r\n    specularRoughness: number;\r\n\r\n    /**\r\n     * Sets/gets the specular roughness texture\r\n     */\r\n    specularRoughnessTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the specular IOR\r\n     */\r\n    specularIor: number;\r\n\r\n    /**\r\n     * Sets/gets the glossiness (inverted roughness)\r\n     * ONLY used for specular/glossiness workflow; has no effect when metallic/roughness workflow is active\r\n     */\r\n    glossiness: number;\r\n\r\n    // ========================================\r\n    // EMISSION PARAMETERS\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the emissive color\r\n     */\r\n    emissionColor: Color3;\r\n\r\n    /**\r\n     * Sets/gets the emissive luminance\r\n     */\r\n    emissionLuminance: number;\r\n\r\n    /**\r\n     * Sets/gets the emissive texture\r\n     */\r\n    emissionColorTexture: Nullable<BaseTexture>;\r\n\r\n    // ========================================\r\n    // AMBIENT OCCLUSION\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the ambient occlusion texture\r\n     */\r\n    ambientOcclusionTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the ambient occlusion texture strength/level\r\n     */\r\n    ambientOcclusionTextureStrength: number;\r\n\r\n    // ========================================\r\n    // COAT PARAMETERS\r\n    // ========================================\r\n\r\n    /**\r\n     * Configures clear coat for PBR material\r\n     */\r\n    configureCoat(): void;\r\n\r\n    /**\r\n     * Sets/gets the coat weight\r\n     */\r\n    coatWeight: number;\r\n\r\n    /**\r\n     * Sets/gets the coat weight texture\r\n     */\r\n    coatWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the coat color\r\n     */\r\n    coatColor: Color3;\r\n\r\n    /**\r\n     * Sets the coat color texture\r\n     */\r\n    coatColorTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the coat roughness\r\n     */\r\n    coatRoughness: number;\r\n\r\n    /**\r\n     * Sets/gets the coat roughness texture\r\n     */\r\n    coatRoughnessTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the coat index of refraction (IOR)\r\n     */\r\n    coatIor: number;\r\n\r\n    /**\r\n     * Sets the coat darkening\r\n     */\r\n    coatDarkening: number;\r\n\r\n    /**\r\n     * Sets the coat darkening texture\r\n     */\r\n    coatDarkeningTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the coat roughness anisotropy\r\n     */\r\n    coatRoughnessAnisotropy: number;\r\n\r\n    /**\r\n     * Sets the coat tangent angle for anisotropy\r\n     */\r\n    geometryCoatTangentAngle: number;\r\n\r\n    /**\r\n     * Sets the coat tangent texture for anisotropy\r\n     */\r\n    geometryCoatTangentTexture: Nullable<BaseTexture>;\r\n\r\n    // ========================================\r\n    // TRANSMISSION LAYER\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets the transmission weight\r\n     */\r\n    transmissionWeight: number;\r\n\r\n    /**\r\n     * Sets the transmission weight texture\r\n     */\r\n    transmissionWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the attenuation distance\r\n     */\r\n    transmissionDepth: number;\r\n\r\n    /**\r\n     * Sets the attenuation color\r\n     */\r\n    transmissionColor: Color3;\r\n\r\n    /**\r\n     * Sets the scattering coefficient\r\n     */\r\n    transmissionScatter: Color3;\r\n\r\n    /**\r\n     * Sets the transmission scatter texture\r\n     */\r\n    transmissionScatterTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the scattering anisotropy (-1 to 1)\r\n     */\r\n    transmissionScatterAnisotropy: number;\r\n\r\n    /**\r\n     * Sets the dispersion Abbe number\r\n     */\r\n    transmissionDispersionAbbeNumber: number;\r\n\r\n    /**\r\n     * Sets the dispersion scale\r\n     */\r\n    transmissionDispersionScale: number;\r\n\r\n    /**\r\n     * The refraction background texture\r\n     */\r\n    refractionBackgroundTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Configures transmission for thin-surface transmission (KHR_materials_transmission)\r\n     */\r\n    configureTransmission(): void;\r\n\r\n    // ========================================\r\n    // VOLUME PROPERTIES\r\n    // ========================================\r\n\r\n    /**\r\n     * Configures volume properties for volumetric transmission (KHR_materials_volume)\r\n     */\r\n    configureVolume(): void;\r\n\r\n    /**\r\n     * Sets whether the material is thin-walled (i.e. non-volumetric) or not.\r\n     */\r\n    geometryThinWalled: boolean;\r\n\r\n    /**\r\n     * Sets the thickness texture\r\n     */\r\n    volumeThicknessTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the thickness factor\r\n     */\r\n    volumeThickness: number;\r\n\r\n    // ========================================\r\n    // SUBSURFACE PROPERTIES (Subsurface Scattering)\r\n    // ========================================\r\n\r\n    /**\r\n     * Configures subsurface properties\r\n     */\r\n    configureSubsurface(): void;\r\n\r\n    /**\r\n     * Sets/gets the subsurface weight\r\n     */\r\n    subsurfaceWeight: number;\r\n\r\n    /**\r\n     * Sets/gets the subsurface weight texture\r\n     */\r\n    subsurfaceWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the subsurface color\r\n     */\r\n    subsurfaceColor: Color3;\r\n\r\n    /**\r\n     * Sets/gets the subsurface color texture\r\n     */\r\n    subsurfaceColorTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the diffuse transmission tint of the material\r\n     */\r\n    diffuseTransmissionTint: Color3;\r\n\r\n    /**\r\n     * Sets/gets the diffuse transmission tint texture of the material\r\n     */\r\n    diffuseTransmissionTintTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets/gets the subsurface radius (used for subsurface scattering)\r\n     */\r\n    subsurfaceRadius: number;\r\n\r\n    /**\r\n     * Sets/gets the subsurface radius scale (used for subsurface scattering)\r\n     */\r\n    subsurfaceRadiusScale: Color3;\r\n\r\n    /**\r\n     * Sets/gets the subsurface scattering anisotropy\r\n     */\r\n    subsurfaceScatterAnisotropy: number;\r\n\r\n    /**\r\n     * Does this material have a translucent surface (i.e. either transmission or subsurface)?\r\n     */\r\n    isTranslucent(): boolean;\r\n\r\n    // ========================================\r\n    // FUZZ LAYER (Sheen)\r\n    // ========================================\r\n\r\n    /**\r\n     * Configures initial settings for fuzz for material.\r\n     */\r\n    configureFuzz(): void;\r\n\r\n    /**\r\n     * Sets the fuzz weight\r\n     */\r\n    fuzzWeight: number;\r\n\r\n    /**\r\n     * Sets the fuzz weight texture\r\n     */\r\n    fuzzWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the fuzz color\r\n     */\r\n    fuzzColor: Color3;\r\n\r\n    /**\r\n     * Sets the fuzz color texture\r\n     */\r\n    fuzzColorTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the fuzz roughness\r\n     */\r\n    fuzzRoughness: number;\r\n\r\n    /**\r\n     * Sets the fuzz roughness texture\r\n     */\r\n    fuzzRoughnessTexture: Nullable<BaseTexture>;\r\n\r\n    // ========================================\r\n    // ANISOTROPY\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the specular roughness anisotropy\r\n     */\r\n    specularRoughnessAnisotropy: number;\r\n\r\n    /**\r\n     * Sets the anisotropy rotation\r\n     */\r\n    geometryTangentAngle: number;\r\n\r\n    /**\r\n     * Sets/gets the anisotropy texture\r\n     */\r\n    geometryTangentTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Configures glTF-style anisotropy for OpenPBR materials\r\n     * @param useGltfStyle - Whether to use glTF-style anisotropy (default: true)\r\n     */\r\n    configureGltfStyleAnisotropy(useGltfStyle?: boolean): void;\r\n\r\n    // ========================================\r\n    // THIN FILM IRIDESCENCE\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets the thin film weight\r\n     */\r\n    thinFilmWeight: number;\r\n\r\n    /**\r\n     * Sets the thin film IOR\r\n     */\r\n    thinFilmIor: number;\r\n\r\n    /**\r\n     * Sets the thin film thickness minimum\r\n     */\r\n    thinFilmThicknessMinimum: number;\r\n\r\n    /**\r\n     * Sets the thin film thickness maximum\r\n     */\r\n    thinFilmThicknessMaximum: number;\r\n\r\n    /**\r\n     * Sets the thin film iridescence texture\r\n     */\r\n    thinFilmWeightTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the thin film thickness texture\r\n     */\r\n    thinFilmThicknessTexture: Nullable<BaseTexture>;\r\n\r\n    // ========================================\r\n    // UNLIT MATERIALS\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets the unlit flag\r\n     */\r\n    unlit: boolean;\r\n\r\n    // ========================================\r\n    // GEOMETRY PARAMETERS\r\n    // ========================================\r\n\r\n    /**\r\n     * Sets/gets the geometry opacity\r\n     */\r\n    geometryOpacity: number;\r\n\r\n    /**\r\n     * Sets/gets the geometry normal texture\r\n     */\r\n    geometryNormalTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the normal map inversions for PBR material only\r\n     * @param invertX - Whether to invert the normal map on the X axis\r\n     * @param invertY - Whether to invert the normal map on the Y axis\r\n     */\r\n    setNormalMapInversions(invertX: boolean, invertY: boolean): void;\r\n\r\n    /**\r\n     * Sets/gets the coat normal texture\r\n     */\r\n    geometryCoatNormalTexture: Nullable<BaseTexture>;\r\n\r\n    /**\r\n     * Sets the coat normal texture scale\r\n     */\r\n    geometryCoatNormalTextureScale: number;\r\n}\r\n"]}

package/glTF/2.0/openpbrMaterialLoadingAdapter.d.ts

@@ -9,6 +9,7 @@ import { type IMaterialLoadingAdapter } from "./materialLoadingAdapter.js";
  */
 export declare class OpenPBRMaterialLoadingAdapter implements IMaterialLoadingAdapter {
     private _material;
+    private _specWorkflow;
     /**
      * Creates a new instance of the OpenPBRMaterialLoadingAdapter.
      * @param material - The OpenPBR material to adapt.
@@ -151,6 +152,7 @@ export declare class OpenPBRMaterialLoadingAdapter implements IMaterialLoadingAd
      * @param _enableEdgeColor Whether to enable edge color support (ignored for OpenPBR)
      */
     enableSpecularEdgeColor(_enableEdgeColor?: boolean): void;
+    configureSpecularGlossiness(): void;
     /**
      * Sets the specular weight of the OpenPBR material.
      * @param value The specular weight value (0-1)
@@ -223,6 +225,11 @@ export declare class OpenPBRMaterialLoadingAdapter implements IMaterialLoadingAd
      * @returns The IOR value
      */
     get specularIor(): number;
+    /**
+     * Sets the glossiness (inverted roughness) of the OpenPBR material.
+     */
+    set glossiness(value: number);
+    get glossiness(): number;
     /**
      * Sets the emission color of the OpenPBR material.
      * @param value The emission color as a Color3
@@ -303,6 +310,10 @@ export declare class OpenPBRMaterialLoadingAdapter implements IMaterialLoadingAd
      * @param value The coat color as a Color3
      */
     set coatColor(value: Color3);
+    /**
+     * Gets the coat color of the OpenPBR material.
+     */
+    get coatColor(): Color3;
     /**
      * Sets the coat color texture of the OpenPBR material.
      * @param value The coat color texture or null
@@ -332,11 +343,13 @@ export declare class OpenPBRMaterialLoadingAdapter implements IMaterialLoadingAd
      * Sets the coat index of refraction (IOR) of the OpenPBR material.
      */
     set coatIor(value: number);
+    get coatIor(): number;
     /**
      * Sets the coat darkening value of the OpenPBR material.
      * @param value The coat darkening value
      */
     set coatDarkening(value: number);
+    get coatDarkening(): number;
     /**
      * Sets the coat darkening texture (OpenPBR: coatDarkeningTexture, no PBR equivalent)
      */
@@ -385,6 +398,7 @@ export declare class OpenPBRMaterialLoadingAdapter implements IMaterialLoadingAd
      * @param value The transmission weight texture or null
      */
     set transmissionWeightTexture(value: Nullable<BaseTexture>);
+    get transmissionWeightTexture(): Nullable<BaseTexture>;
     /**
      * Gets the transmission weight.
      * @returns Currently returns 0 as transmission is not yet available
@@ -453,6 +467,9 @@ export declare class OpenPBRMaterialLoadingAdapter implements IMaterialLoadingAd
      * @param value The refraction background texture or null
      */
     set refractionBackgroundTexture(value: Nullable<BaseTexture>);
+    /**
+     * Configures volume properties for OpenPBR material.
+     */
     configureVolume(): void;
     /**
      * Sets whether the material is thin-walled (i.e. non-volumetric) or not.
@@ -485,6 +502,7 @@ export declare class OpenPBRMaterialLoadingAdapter implements IMaterialLoadingAd
      * Sets the subsurface weight texture
      */
     set subsurfaceWeightTexture(value: Nullable<BaseTexture>);
+    get subsurfaceWeightTexture(): Nullable<BaseTexture>;
     /**
      * Sets the subsurface color.
      * @param value The subsurface tint color as a Color3
@@ -684,5 +702,11 @@ export declare class OpenPBRMaterialLoadingAdapter implements IMaterialLoadingAd
      * @param value The scale value for the coat normal texture
      */
     set geometryCoatNormalTextureScale(value: number);
-    finalize(): void;
+    /**
+     * Finalizes material properties after all loading is complete.
+     * @param signal An AbortSignal that fires when the loader is disposed. Intermediate
+     *   textures are disposed and the method returns early when aborted.
+     */
+    finalizeAsync(signal: AbortSignal): Promise<void>;
+    private copySurfaceToCoatAsync;
 }

package/glTF/2.0/openpbrMaterialLoadingAdapter.js

@@ -1,4 +1,5 @@
-import { Color3 } from "@babylonjs/core/Maths/math.color.js";
+import { Color3, Color4 } from "@babylonjs/core/Maths/math.color.js";
+import { MultiplyTexturesAsync, LerpTexturesAsync, CreateTextureWithFactorOperand, TextureChannel, TextureColorSpace, InvertTextureAsync, ExtractChannelAsync, ChannelMask, ExtractMaxChannelAsync, } from "@babylonjs/core/Materials/Textures/textureProcessor.js";
 /**
  * Material Loading Adapter for OpenPBR materials that provides a unified OpenPBR-like interface.
  */
@@ -8,6 +9,7 @@ export class OpenPBRMaterialLoadingAdapter {
      * @param material - The OpenPBR material to adapt.
      */
     constructor(material) {
+        this._specWorkflow = false;
         this._diffuseTransmissionTint = Color3.White();
         this._diffuseTransmissionTintTexture = null;
         this._material = material;
@@ -218,6 +220,9 @@ export class OpenPBRMaterialLoadingAdapter {
     enableSpecularEdgeColor(_enableEdgeColor = false) {
         // OpenPBR already supports edge color natively, no configuration needed
     }
+    configureSpecularGlossiness() {
+        this._specWorkflow = true;
+    }
     /**
      * Sets the specular weight of the OpenPBR material.
      * @param value The specular weight value (0-1)
@@ -330,6 +335,15 @@ export class OpenPBRMaterialLoadingAdapter {
     get specularIor() {
         return this._material.specularIor;
     }
+    /**
+     * Sets the glossiness (inverted roughness) of the OpenPBR material.
+     */
+    set glossiness(value) {
+        this._material.specularRoughness = Math.max(1.0 - value, 0.0);
+    }
+    get glossiness() {
+        return 1.0 - this._material.specularRoughness;
+    }
     // ========================================
     // EMISSION PARAMETERS
     // ========================================
@@ -455,6 +469,12 @@ export class OpenPBRMaterialLoadingAdapter {
     set coatColor(value) {
         this._material.coatColor = value;
     }
+    /**
+     * Gets the coat color of the OpenPBR material.
+     */
+    get coatColor() {
+        return this._material.coatColor;
+    }
     /**
      * Sets the coat color texture of the OpenPBR material.
      * @param value The coat color texture or null
@@ -499,6 +519,9 @@ export class OpenPBRMaterialLoadingAdapter {
     set coatIor(value) {
         this._material.coatIor = value;
     }
+    get coatIor() {
+        return this._material.coatIor;
+    }
     /**
      * Sets the coat darkening value of the OpenPBR material.
      * @param value The coat darkening value
@@ -506,6 +529,9 @@ export class OpenPBRMaterialLoadingAdapter {
     set coatDarkening(value) {
         this._material.coatDarkening = value;
     }
+    get coatDarkening() {
+        return this._material.coatDarkening;
+    }
     /**
      * Sets the coat darkening texture (OpenPBR: coatDarkeningTexture, no PBR equivalent)
      */
@@ -580,6 +606,9 @@ export class OpenPBRMaterialLoadingAdapter {
     set transmissionWeightTexture(value) {
         this._material.transmissionWeightTexture = value;
     }
+    get transmissionWeightTexture() {
+        return this._material.transmissionWeightTexture;
+    }
     /**
      * Gets the transmission weight.
      * @returns Currently returns 0 as transmission is not yet available
@@ -692,6 +721,9 @@ export class OpenPBRMaterialLoadingAdapter {
     // ========================================
     // VOLUME PROPERTIES
     // ========================================
+    /**
+     * Configures volume properties for OpenPBR material.
+     */
     configureVolume() {
         // If we're configuring volume, we assume the material is not thin-walled (i.e. it's volumetric).
         this._material.geometryThinWalled = 0.0;
@@ -748,6 +780,10 @@ export class OpenPBRMaterialLoadingAdapter {
      */
     set subsurfaceWeightTexture(value) {
         this._material.subsurfaceWeightTexture = value;
+        this._material._useSubsurfaceWeightFromTextureAlpha = true;
+    }
+    get subsurfaceWeightTexture() {
+        return this._material.subsurfaceWeightTexture;
     }
     /**
      * Sets the subsurface color.
@@ -1044,7 +1080,12 @@ export class OpenPBRMaterialLoadingAdapter {
             this._material.geometryCoatNormalTexture.level = value;
         }
     }
-    finalize() {
+    /**
+     * Finalizes material properties after all loading is complete.
+     * @param signal An AbortSignal that fires when the loader is disposed. Intermediate
+     *   textures are disposed and the method returns early when aborted.
+     */
+    async finalizeAsync(signal) {
         // Do final configuration for the material to handle any interactions/dependencies between properties that we had to defer until all properties were loaded.
         // If the material is volumetric, we may need to create a coat layer to handle the surface tint.
         if ((this._diffuseTransmissionTint && !this._diffuseTransmissionTint.equals(Color3.White())) || this._diffuseTransmissionTintTexture) {
@@ -1054,20 +1095,10 @@ export class OpenPBRMaterialLoadingAdapter {
                 this.subsurfaceColorTexture = this._diffuseTransmissionTintTexture;
             }
             else {
-                // The material is volumetric and we have surface tinting, so we need to move that tinting to the coat layer to preserve it.
-                // TODO: If we already have a coat slab, we'll have to merge the two.
-                if (this._material.coatWeight == 0 && (!this.baseColor.equals(Color3.White()) || this.baseColorTexture)) {
-                    this._material.coatWeight = this.subsurfaceWeight;
-                    this._material.coatWeightTexture = this.subsurfaceWeightTexture;
-                    this._material.coatColor = this._diffuseTransmissionTint;
-                    this._material.coatColorTexture = this._diffuseTransmissionTintTexture;
-                    this._material.coatIor = this._material.specularIor; // Use the same IOR for the coat as the specular layer to try to match the original reflection as closely as possible.
-                    this._material.coatDarkening = 0.0;
-                    this._material.coatRoughness = this._material.specularRoughness;
-                    this._material.coatRoughnessTexture = this._material.specularRoughnessTexture;
-                    // To simulate diffuse transmission, set the specular roughness to maximum and remove the roughness texture.
-                    this._material.specularRoughness = 1.0;
-                    this._material.specularRoughnessTexture = null;
+                // Otherwise, we have volumetric attenuation so we need to use the coat layer to preserve the base color tinting of glTF.
+                await this.copySurfaceToCoatAsync(this.subsurfaceWeight, this.subsurfaceWeightTexture, TextureChannel.A, this._diffuseTransmissionTint, this._diffuseTransmissionTintTexture, true, signal);
+                if (signal.aborted) {
+                    return;
                 }
             }
         }
@@ -1078,17 +1109,139 @@ export class OpenPBRMaterialLoadingAdapter {
                 this._material.transmissionColor = this._material.baseColor;
                 this._material.transmissionColorTexture = this._material.baseColorTexture;
             }
-            else if (this._material.coatWeight == 0 && (!this.baseColor.equals(Color3.White()) || this.baseColorTexture !== null)) {
+            else if (!this.baseColor.equals(Color3.White()) || this.baseColorTexture !== null) {
                 // Otherwise, we have volumetric attenuation so we need to use the coat layer to preserve the base color tinting of glTF.
-                // TODO: If we already have a coat slab, we'll have to merge the two.
-                this._material.coatWeight = this.transmissionWeight;
-                this._material.coatWeightTexture = this.transmissionWeightTexture;
-                this._material.coatColor = this.baseColor;
-                this._material.coatColorTexture = this.baseColorTexture;
-                this._material.coatIor = this._material.specularIor; // Use the same IOR for the coat as the specular layer to try to match the original reflection as closely as possible.
-                this._material.coatDarkening = 0.0;
-                this._material.coatRoughness = this._material.specularRoughness;
-                this._material.coatRoughnessTexture = this._material.specularRoughnessTexture;
+                await this.copySurfaceToCoatAsync(this.transmissionWeight, this.transmissionWeightTexture, TextureChannel.R, this.baseColor, this.baseColorTexture, false, signal);
+                if (signal.aborted) {
+                    return;
+                }
+            }
+        }
+        if (this._specWorkflow) {
+            // To convert from spec-gloss to OpenPBR, we'll grab the specular color's alpha channel (which contains glossiness) and
+            // invert it to get roughness.
+            const newRoughnessTexture = await InvertTextureAsync("newRoughnessTexture (" + this._material.name + ")", await ExtractChannelAsync("glossiness (" + this._material.name + ")", CreateTextureWithFactorOperand(this.specularColorTexture, new Color4(this.specularColor.r, this.specularColor.g, this.specularColor.b, this.glossiness), TextureChannel.A, TextureColorSpace.Linear), TextureChannel.A, this._material.getScene(), TextureColorSpace.Linear, ChannelMask.R), this._material.getScene(), ChannelMask.R, TextureColorSpace.Linear, ChannelMask.R);
+            if (signal.aborted) {
+                newRoughnessTexture.texture?.dispose();
+                return;
+            }
+            this.specularRoughnessTexture = newRoughnessTexture.texture;
+            this.specularRoughness = newRoughnessTexture.factor ? newRoughnessTexture.factor.r : 1.0;
+            // Metallic = max(linearize(specular).rgb). The specular texture is sRGB so we must
+            // linearize it first (TextureColorSpace.SRGB). The factor is already linear per convention.
+            // We store metallic as linear (no outputColorSpace) because it is a data/scalar value;
+            // encoding it as sRGB would corrupt it when it is used as the lerp t below.
+            const newMetallic = await ExtractMaxChannelAsync("metallicTexture (" + this._material.name + ")", CreateTextureWithFactorOperand(this.specularColorTexture, this.specularColor.toColor4(), TextureChannel.RGBA, TextureColorSpace.Linear), this._material.getScene(), false, TextureColorSpace.SRGB, ChannelMask.RGB);
+            if (signal.aborted) {
+                newMetallic.texture?.dispose();
+                return;
+            }
+            this.baseMetalnessTexture = newMetallic.texture;
+            this.baseMetalness = newMetallic.factor ? newMetallic.factor.r : 1.0;
+            // base_color = lerp(diffuse, specular, metallic).
+            // Strip dispose before passing newMetallic as t — its texture is already owned by the
+            // material (baseMetalnessTexture) and must not be released after the lerp pass.
+            const newBaseColor = await LerpTexturesAsync("newBaseColor (" + this._material.name + ")", CreateTextureWithFactorOperand(this.baseColorTexture, this.baseColor.toColor4(), TextureChannel.RGBA, TextureColorSpace.Linear), CreateTextureWithFactorOperand(this.specularColorTexture, this.specularColor.toColor4(), TextureChannel.RGBA, TextureColorSpace.Linear), { ...newMetallic, dispose: undefined, colorSpace: TextureColorSpace.Linear }, this._material.getScene(), TextureColorSpace.SRGB, ChannelMask.RGB);
+            if (signal.aborted) {
+                newBaseColor.texture?.dispose();
+                return;
+            }
+            const oldBaseColorTexture = this.baseColorTexture;
+            oldBaseColorTexture?.dispose();
+            this.baseColorTexture = newBaseColor.texture;
+            this.baseColor = newBaseColor.factor ? new Color3(newBaseColor.factor.r, newBaseColor.factor.g, newBaseColor.factor.b) : Color3.White();
+            const oldSpecularColorTexture = this.specularColorTexture;
+            oldSpecularColorTexture?.dispose();
+            this.specularColorTexture = null;
+        }
+    }
+    async copySurfaceToCoatAsync(weight, weightTexture, weightTextureChannel, color, colorTexture, diffuseTransmission = false, signal = new AbortController().signal) {
+        // Blend coat properties using:
+        // New coat will cover all areas that previously had coat or transmission.
+        //   new_coat_weight = max(weight, existing_coat_weight)
+        // New coat color is the multiplication of the base color tint and the existing coat tint, each blended by their respective weights:
+        //   new_coat_color  = lerp(white, existing_coat_color, existing_coat_weight)
+        //                   * lerp(white, color, weight)
+        // Snapshot the original coat properties before mutating them, so both lerps
+        // use the pre-merge values (the first lerp blends the *existing* coat color
+        // by the *existing* coat weight; we must not use the merged weight here).
+        const origCoatWeight = this._material.coatWeight;
+        const origCoatWeightTexture = this._material.coatWeightTexture;
+        const origCoatColor = this._material.coatColor.clone();
+        const origCoatColorTexture = this._material.coatColorTexture;
+        const origCoatNormalTexture = this._material.geometryCoatNormalTexture;
+        const origCoatWeightCol4 = new Color4(origCoatWeight, origCoatWeight, origCoatWeight, origCoatWeight);
+        const weightCol4 = new Color4(weight, weight, weight, weight);
+        this.coatWeightTexture = null;
+        this.coatWeight = 1.0;
+        const results = await Promise.allSettled([
+            LerpTexturesAsync("lerpExistingCoat", CreateTextureWithFactorOperand(null, new Color4(1, 1, 1, 1)), CreateTextureWithFactorOperand(origCoatColorTexture, origCoatColor.toColor4(), TextureChannel.RGBA, TextureColorSpace.SRGB), CreateTextureWithFactorOperand(origCoatWeightTexture, origCoatWeightCol4, TextureChannel.R), this._material.getScene(), TextureColorSpace.SRGB),
+            LerpTexturesAsync("lerpSurfaceColor", CreateTextureWithFactorOperand(null, new Color4(1, 1, 1, 1)), CreateTextureWithFactorOperand(colorTexture, color.toColor4(), TextureChannel.RGBA, TextureColorSpace.SRGB), CreateTextureWithFactorOperand(weightTexture, weightCol4, weightTextureChannel), this._material.getScene(), TextureColorSpace.SRGB),
+        ]);
+        const rejected = results.find((r) => r.status === "rejected");
+        if (rejected) {
+            for (const r of results) {
+                if (r.status === "fulfilled") {
+                    r.value.texture?.dispose();
+                }
+            }
+            throw rejected.reason;
+        }
+        const [lerpCoatColor, lerpSurfaceColor] = results.map((r) => r.value);
+        if (signal.aborted) {
+            lerpCoatColor.texture?.dispose();
+            lerpSurfaceColor.texture?.dispose();
+            return;
+        }
+        const newCoatColor = await MultiplyTexturesAsync("newCoatColor (" + this._material.name + ")", lerpCoatColor, lerpSurfaceColor, this._material.getScene(), TextureColorSpace.SRGB);
+        if (signal.aborted) {
+            newCoatColor.texture?.dispose();
+            return;
+        }
+        if (newCoatColor.texture) {
+            this.coatColorTexture = newCoatColor.texture;
+            this.coatColor = Color3.White();
+        }
+        else if (newCoatColor.factor) {
+            this.coatColorTexture = null;
+            this.coatColor.fromArray([newCoatColor.factor.r, newCoatColor.factor.g, newCoatColor.factor.b]);
+        }
+        const newCoatIor = await LerpTexturesAsync("newCoatIor (" + this._material.name + ")", CreateTextureWithFactorOperand(null, new Color4(this._material.specularIor, this._material.specularIor, this._material.specularIor, 1.0), TextureChannel.R), CreateTextureWithFactorOperand(null, new Color4(this.coatIor, this.coatIor, this.coatIor, 1.0), TextureChannel.R), CreateTextureWithFactorOperand(origCoatWeightTexture, origCoatWeightCol4, TextureChannel.R), this._material.getScene());
+        if (signal.aborted) {
+            newCoatIor.texture?.dispose();
+            return;
+        }
+        this.coatIor = newCoatIor.factor ? newCoatIor.factor.r : this.coatIor;
+        const newCoatRoughness = await LerpTexturesAsync("newCoatRoughness (" + this._material.name + ")", CreateTextureWithFactorOperand(this.specularRoughnessTexture, new Color4(this.specularRoughness, this.specularRoughness, this.specularRoughness, 1.0), TextureChannel.G), CreateTextureWithFactorOperand(this.coatRoughnessTexture, new Color4(this.coatRoughness, this.coatRoughness, this.coatRoughness, 1.0), TextureChannel.G), CreateTextureWithFactorOperand(origCoatWeightTexture, origCoatWeightCol4, TextureChannel.R), this._material.getScene());
+        if (signal.aborted) {
+            newCoatRoughness.texture?.dispose();
+            return;
+        }
+        this.coatRoughness = newCoatRoughness.factor ? newCoatRoughness.factor.r : 1.0;
+        this.coatRoughnessTexture = newCoatRoughness.texture;
+        const newCoatDarkening = await LerpTexturesAsync("newCoatDarkening (" + this._material.name + ")", CreateTextureWithFactorOperand(null, new Color4(0, 0, 0, 1.0), TextureChannel.R), CreateTextureWithFactorOperand(null, new Color4(this.coatDarkening, this.coatDarkening, this.coatDarkening, 1.0), TextureChannel.R), CreateTextureWithFactorOperand(origCoatWeightTexture, origCoatWeightCol4, TextureChannel.R), this._material.getScene());
+        if (signal.aborted) {
+            newCoatDarkening.texture?.dispose();
+            return;
+        }
+        this.coatDarkening = newCoatDarkening.factor ? newCoatDarkening.factor.r : this.coatDarkening;
+        if (diffuseTransmission) {
+            const newSpecularRoughness = await LerpTexturesAsync("newSpecularRoughness (" + this._material.name + ")", CreateTextureWithFactorOperand(this.specularRoughnessTexture, new Color4(this._material.specularRoughness, this._material.specularRoughness, this._material.specularRoughness, 1.0), TextureChannel.G), CreateTextureWithFactorOperand(null, new Color4(1, 1, 1, 1.0), TextureChannel.R), CreateTextureWithFactorOperand(weightTexture, weightCol4, weightTextureChannel), this._material.getScene());
+            if (signal.aborted) {
+                newSpecularRoughness.texture?.dispose();
+                return;
+            }
+            this.specularRoughness = newSpecularRoughness.factor ? newSpecularRoughness.factor.r : 1.0;
+            this.specularRoughnessTexture = newSpecularRoughness.texture;
+        }
+        if (origCoatNormalTexture || this.geometryNormalTexture) {
+            const newCoatNormal = await LerpTexturesAsync("newCoatNormal (" + this._material.name + ")", CreateTextureWithFactorOperand(this.geometryNormalTexture, this.geometryNormalTexture ? new Color4(1, 1, 1, 1) : new Color4(0.5, 0.5, 1.0, 1.0), TextureChannel.RGBA), CreateTextureWithFactorOperand(origCoatNormalTexture, origCoatNormalTexture ? new Color4(1, 1, 1, 1) : new Color4(0.5, 0.5, 1.0, 1.0), TextureChannel.RGBA), CreateTextureWithFactorOperand(origCoatWeightTexture, origCoatWeightCol4, TextureChannel.R), this._material.getScene());
+            if (signal.aborted) {
+                newCoatNormal.texture?.dispose();
+                return;
+            }
+            if (newCoatNormal.texture) {
+                this.geometryCoatNormalTexture = newCoatNormal.texture;
             }
         }
     }