From 508bbff54eda57db5d2c9ac0d2734eeb656898a3 Mon Sep 17 00:00:00 2001
From: Julien Guertault <9511025+virtualzavie@users.noreply.github.com>
Date: Fri, 17 Jan 2025 17:11:30 +0100
Subject: [PATCH 01/11] Add Base Weight uniform parameter

---
 packages/dev/core/src/Materials/PBR/pbrBaseMaterial.ts |  6 ++++++
 packages/dev/core/src/Materials/PBR/pbrMaterial.ts     |  4 ++++
 .../Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx    |  3 ++-
 .../Shaders/ShadersInclude/pbrFragmentDeclaration.fx   |  1 +
 .../src/Shaders/ShadersInclude/pbrUboDeclaration.fx    |  1 +
 packages/dev/core/src/Shaders/pbr.fragment.fx          |  5 +++--
 .../ShadersInclude/pbrBlockAlbedoOpacity.fx            |  1 +
 .../ShadersWGSL/ShadersInclude/pbrUboDeclaration.fx    |  1 +
 packages/dev/core/src/ShadersWGSL/pbr.fragment.fx      |  1 +
 .../materials/pbrMaterialPropertyGridComponent.tsx     | 10 ++++++++++
 10 files changed, 30 insertions(+), 3 deletions(-)

diff --git a/packages/dev/core/src/Materials/PBR/pbrBaseMaterial.ts b/packages/dev/core/src/Materials/PBR/pbrBaseMaterial.ts
index ae3d9e551da..f9917fdb8aa 100644
--- a/packages/dev/core/src/Materials/PBR/pbrBaseMaterial.ts
+++ b/packages/dev/core/src/Materials/PBR/pbrBaseMaterial.ts
@@ -559,6 +559,8 @@ export abstract class PBRBaseMaterial extends PushMaterial {
      */
     public _albedoColor = new Color3(1, 1, 1);
 
+    public _baseWeight = 1;
+
     /**
      * AKA Specular Color in other nomenclature.
      * @internal
@@ -1413,6 +1415,7 @@ export abstract class PBRBaseMaterial extends PushMaterial {
             "vLightsType",
             "vAmbientColor",
             "vAlbedoColor",
+            "vBaseWeight",
             "vReflectivityColor",
             "vMetallicReflectanceFactors",
             "vEmissiveColor",
@@ -2005,6 +2008,7 @@ export abstract class PBRBaseMaterial extends PushMaterial {
 
         ubo.addUniform("vReflectionColor", 3);
         ubo.addUniform("vAlbedoColor", 4);
+        ubo.addUniform("vBaseWeight", 1);
         ubo.addUniform("vLightingIntensity", 4);
 
         ubo.addUniform("vReflectionMicrosurfaceInfos", 3);
@@ -2268,6 +2272,8 @@ export abstract class PBRBaseMaterial extends PushMaterial {
                     ubo.updateColor4("vAlbedoColor", this._albedoColor, this.alpha);
                 }
 
+                ubo.updateFloat("vBaseWeight", this._baseWeight);
+
                 // Misc
                 this._lightingInfos.x = this._directIntensity;
                 this._lightingInfos.y = this._emissiveIntensity;
diff --git a/packages/dev/core/src/Materials/PBR/pbrMaterial.ts b/packages/dev/core/src/Materials/PBR/pbrMaterial.ts
index 066d69fd23a..62ad14b63d6 100644
--- a/packages/dev/core/src/Materials/PBR/pbrMaterial.ts
+++ b/packages/dev/core/src/Materials/PBR/pbrMaterial.ts
@@ -270,6 +270,10 @@ export class PBRMaterial extends PBRBaseMaterial {
     @expandToProperty("_markAllSubMeshesAsTexturesDirty")
     public albedoColor = new Color3(1, 1, 1);
 
+    @serializeAsColor3("baseWeight")
+    @expandToProperty("_markAllSubMeshesAsTexturesDirty")
+    public baseWeight = 1;
+
     /**
      * AKA Specular Color in other nomenclature.
      */
diff --git a/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx b/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx
index 9b6827b904a..8e44993c183 100644
--- a/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx
+++ b/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx
@@ -11,6 +11,7 @@ albedoOpacityOutParams albedoOpacityBlock(
     ,in vec4 albedoTexture
     ,in vec2 albedoInfos
 #endif
+    , in float vBaseWeight
 #ifdef OPACITY
     ,in vec4 opacityMap
     ,in vec2 vOpacityInfos
@@ -22,7 +23,7 @@ albedoOpacityOutParams albedoOpacityBlock(
 #ifdef DECAL
     ,in vec4 decalColor
     ,in vec4 vDecalInfos
-#endif 
+#endif
 )
 {
     albedoOpacityOutParams outParams;
diff --git a/packages/dev/core/src/Shaders/ShadersInclude/pbrFragmentDeclaration.fx b/packages/dev/core/src/Shaders/ShadersInclude/pbrFragmentDeclaration.fx
index b2b55b6bd9f..7b75f80b84b 100644
--- a/packages/dev/core/src/Shaders/ShadersInclude/pbrFragmentDeclaration.fx
+++ b/packages/dev/core/src/Shaders/ShadersInclude/pbrFragmentDeclaration.fx
@@ -2,6 +2,7 @@ uniform vec4 vEyePosition;
 
 uniform vec3 vReflectionColor;
 uniform vec4 vAlbedoColor;
+uniform float vBaseWeight;
 
 // CUSTOM CONTROLS
 uniform vec4 vLightingIntensity;
diff --git a/packages/dev/core/src/Shaders/ShadersInclude/pbrUboDeclaration.fx b/packages/dev/core/src/Shaders/ShadersInclude/pbrUboDeclaration.fx
index 8a513b2b4ef..143ee0da107 100644
--- a/packages/dev/core/src/Shaders/ShadersInclude/pbrUboDeclaration.fx
+++ b/packages/dev/core/src/Shaders/ShadersInclude/pbrUboDeclaration.fx
@@ -47,6 +47,7 @@ uniform Material {
     mat4 reflectionMatrix;
     vec3 vReflectionColor;
     vec4 vAlbedoColor;
+  float vBaseWeight;
     vec4 vLightingIntensity;
     vec3 vReflectionMicrosurfaceInfos;
     float pointSize;
diff --git a/packages/dev/core/src/Shaders/pbr.fragment.fx b/packages/dev/core/src/Shaders/pbr.fragment.fx
index a2daa5c1479..ba44723e6de 100644
--- a/packages/dev/core/src/Shaders/pbr.fragment.fx
+++ b/packages/dev/core/src/Shaders/pbr.fragment.fx
@@ -104,6 +104,7 @@ void main(void) {
         , albedoTexture
         , vAlbedoInfos
     #endif
+        , vBaseWeight
     #ifdef OPACITY
         , opacityMap
         , vOpacityInfos
@@ -138,7 +139,7 @@ void main(void) {
     #ifdef AMBIENT
         ambientOcclusionColorMap,
         vAmbientInfos
-    #endif        
+    #endif
     );
 
     #include<pbrBlockLightmapInit>
@@ -257,7 +258,7 @@ void main(void) {
         #endif
             TBN,
             normalW,
-            viewDirectionW            
+            viewDirectionW
         );
     #endif
 
diff --git a/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx b/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx
index da3bd45fd27..0f7112953c3 100644
--- a/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx
+++ b/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx
@@ -11,6 +11,7 @@ fn albedoOpacityBlock(
     ,albedoTexture: vec4f
     ,albedoInfos: vec2f
 #endif
+    , vBaseWeight: f32
 #ifdef OPACITY
     ,opacityMap: vec4f
     ,vOpacityInfos: vec2f
diff --git a/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrUboDeclaration.fx b/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrUboDeclaration.fx
index 575e575c1bc..04223907da2 100644
--- a/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrUboDeclaration.fx
+++ b/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrUboDeclaration.fx
@@ -22,6 +22,7 @@ uniform vTangentSpaceParams: vec2f;
 uniform reflectionMatrix: mat4x4f;
 uniform vReflectionColor: vec3f;
 uniform vAlbedoColor: vec4f;
+uniform vBaseWeight: f32;
 uniform vLightingIntensity: vec4f;
 uniform vReflectionMicrosurfaceInfos: vec3f;
 uniform pointSize: f32;
diff --git a/packages/dev/core/src/ShadersWGSL/pbr.fragment.fx b/packages/dev/core/src/ShadersWGSL/pbr.fragment.fx
index b5d109e0945..d303658d2f5 100644
--- a/packages/dev/core/src/ShadersWGSL/pbr.fragment.fx
+++ b/packages/dev/core/src/ShadersWGSL/pbr.fragment.fx
@@ -89,6 +89,7 @@ fn main(input: FragmentInputs) -> FragmentOutputs {
         , albedoTexture
         , uniforms.vAlbedoInfos
     #endif
+        , uniforms.baseWeight
     #ifdef OPACITY
         , opacityMap
         , uniforms.vOpacityInfos
diff --git a/packages/dev/inspector/src/components/actionTabs/tabs/propertyGrids/materials/pbrMaterialPropertyGridComponent.tsx b/packages/dev/inspector/src/components/actionTabs/tabs/propertyGrids/materials/pbrMaterialPropertyGridComponent.tsx
index 39134c32905..4f87e3448bf 100644
--- a/packages/dev/inspector/src/components/actionTabs/tabs/propertyGrids/materials/pbrMaterialPropertyGridComponent.tsx
+++ b/packages/dev/inspector/src/components/actionTabs/tabs/propertyGrids/materials/pbrMaterialPropertyGridComponent.tsx
@@ -273,6 +273,16 @@ export class PBRMaterialPropertyGridComponent extends React.Component<IPBRMateri
                         onPropertyChangedObservable={this.props.onPropertyChangedObservable}
                         isLinear={true}
                     />
+                    <SliderLineComponent
+                        lockObject={this.props.lockObject}
+                        label="Base Weight"
+                        target={material}
+                        propertyName="baseWeight"
+                        minimum={0}
+                        maximum={1}
+                        step={0.01}
+                        onPropertyChangedObservable={this.props.onPropertyChangedObservable}
+                    />
                     <Color3LineComponent
                         lockObject={this.props.lockObject}
                         label="Reflectivity"

From 6f9d2c686f09b57ca9acdaa4a777185834768aa9 Mon Sep 17 00:00:00 2001
From: Julien Guertault <9511025+virtualzavie@users.noreply.github.com>
Date: Fri, 17 Jan 2025 17:11:44 +0100
Subject: [PATCH 02/11] Add Base Weight texture

---
 .../core/src/Materials/PBR/pbrBaseMaterial.ts | 45 +++++++++++++++++++
 .../dev/core/src/Materials/PBR/pbrMaterial.ts |  4 ++
 .../dev/core/src/Materials/materialFlags.ts   | 16 +++++++
 .../ShadersInclude/pbrBlockAlbedoOpacity.fx   |  6 ++-
 .../ShadersInclude/pbrFragmentDeclaration.fx  |  8 +++-
 .../pbrFragmentSamplersDeclaration.fx         |  7 +--
 .../ShadersInclude/pbrUboDeclaration.fx       |  2 +
 .../ShadersInclude/pbrVertexDeclaration.fx    | 14 +++++-
 packages/dev/core/src/Shaders/pbr.fragment.fx |  8 ++++
 packages/dev/core/src/Shaders/pbr.vertex.fx   |  2 +
 .../ShadersInclude/pbrBlockAlbedoOpacity.fx   |  6 ++-
 .../pbrFragmentSamplersDeclaration.fx         |  7 +--
 .../ShadersInclude/pbrUboDeclaration.fx       |  2 +
 .../dev/core/src/ShadersWGSL/pbr.fragment.fx  | 12 ++++-
 .../dev/core/src/ShadersWGSL/pbr.vertex.fx    |  2 +
 .../pbrMaterialPropertyGridComponent.tsx      |  8 ++++
 16 files changed, 135 insertions(+), 14 deletions(-)

diff --git a/packages/dev/core/src/Materials/PBR/pbrBaseMaterial.ts b/packages/dev/core/src/Materials/PBR/pbrBaseMaterial.ts
index f9917fdb8aa..5d1eb476920 100644
--- a/packages/dev/core/src/Materials/PBR/pbrBaseMaterial.ts
+++ b/packages/dev/core/src/Materials/PBR/pbrBaseMaterial.ts
@@ -100,6 +100,9 @@ export class PBRMaterialDefines extends MaterialDefines implements IImageProcess
     public ALBEDODIRECTUV = 0;
     public VERTEXCOLOR = false;
 
+    public BASEWEIGHT = false;
+    public BASEWEIGHTDIRECTUV = 0;
+
     public BAKED_VERTEX_ANIMATION_TEXTURE = false;
 
     public AMBIENT = false;
@@ -417,6 +420,8 @@ export abstract class PBRBaseMaterial extends PushMaterial {
      */
     public _albedoTexture: Nullable<BaseTexture> = null;
 
+    public _baseWeightTexture: Nullable<BaseTexture> = null;
+
     /**
      * AKA Occlusion Texture in other nomenclature.
      * @internal
@@ -1113,6 +1118,12 @@ export abstract class PBRBaseMaterial extends PushMaterial {
                     }
                 }
 
+                if (this._baseWeightTexture && MaterialFlags.BaseWeightTextureEnabled) {
+                    if (!this._baseWeightTexture.isReadyOrNotBlocking()) {
+                        return false;
+                    }
+                }
+
                 if (this._ambientTexture && MaterialFlags.AmbientTextureEnabled) {
                     if (!this._ambientTexture.isReadyOrNotBlocking()) {
                         return false;
@@ -1425,6 +1436,7 @@ export abstract class PBRBaseMaterial extends PushMaterial {
             "vFogColor",
             "pointSize",
             "vAlbedoInfos",
+            "vBaseWeightInfos",
             "vAmbientInfos",
             "vOpacityInfos",
             "vReflectionInfos",
@@ -1440,6 +1452,7 @@ export abstract class PBRBaseMaterial extends PushMaterial {
             "vLightmapInfos",
             "mBones",
             "albedoMatrix",
+            "baseWeightMatrix",
             "ambientMatrix",
             "opacityMatrix",
             "reflectionMatrix",
@@ -1481,6 +1494,7 @@ export abstract class PBRBaseMaterial extends PushMaterial {
 
         const samplers = [
             "albedoSampler",
+            "baseWeightSampler",
             "reflectivitySampler",
             "ambientSampler",
             "emissiveSampler",
@@ -1615,6 +1629,7 @@ export abstract class PBRBaseMaterial extends PushMaterial {
             }
             if (scene.texturesEnabled) {
                 defines.ALBEDODIRECTUV = 0;
+                defines.BASEWEIGHTDIRECTUV = 0;
                 defines.AMBIENTDIRECTUV = 0;
                 defines.OPACITYDIRECTUV = 0;
                 defines.EMISSIVEDIRECTUV = 0;
@@ -1636,6 +1651,12 @@ export abstract class PBRBaseMaterial extends PushMaterial {
                     defines.ALBEDO = false;
                 }
 
+                if (this._baseWeightTexture && MaterialFlags.BaseWeightTextureEnabled) {
+                    PrepareDefinesForMergedUV(this._baseWeightTexture, defines, "BASEWEIGHT");
+                } else {
+                    defines.BASEWEIGHT = false;
+                }
+
                 if (this._ambientTexture && MaterialFlags.AmbientTextureEnabled) {
                     PrepareDefinesForMergedUV(this._ambientTexture, defines, "AMBIENT");
                     defines.AMBIENTINGRAYSCALE = this._useAmbientInGrayScale;
@@ -1984,6 +2005,7 @@ export abstract class PBRBaseMaterial extends PushMaterial {
         // Order is important !
         const ubo = this._uniformBuffer;
         ubo.addUniform("vAlbedoInfos", 2);
+        ubo.addUniform("vBaseWeightInfos", 2);
         ubo.addUniform("vAmbientInfos", 4);
         ubo.addUniform("vOpacityInfos", 2);
         ubo.addUniform("vEmissiveInfos", 2);
@@ -1996,6 +2018,7 @@ export abstract class PBRBaseMaterial extends PushMaterial {
         ubo.addUniform("vReflectionSize", 3);
         ubo.addUniform("vBumpInfos", 3);
         ubo.addUniform("albedoMatrix", 16);
+        ubo.addUniform("baseWeightMatrix", 16);
         ubo.addUniform("ambientMatrix", 16);
         ubo.addUniform("opacityMatrix", 16);
         ubo.addUniform("emissiveMatrix", 16);
@@ -2111,6 +2134,11 @@ export abstract class PBRBaseMaterial extends PushMaterial {
                         BindTextureMatrix(this._albedoTexture, ubo, "albedo");
                     }
 
+                    if (this._baseWeightTexture && MaterialFlags.BaseWeightTextureEnabled) {
+                        ubo.updateFloat2("vBaseWeightInfos", this._baseWeightTexture.coordinatesIndex, this._baseWeightTexture.level);
+                        BindTextureMatrix(this._baseWeightTexture, ubo, "baseWeight");
+                    }
+
                     if (this._ambientTexture && MaterialFlags.AmbientTextureEnabled) {
                         ubo.updateFloat4(
                             "vAmbientInfos",
@@ -2296,6 +2324,10 @@ export abstract class PBRBaseMaterial extends PushMaterial {
                     ubo.setTexture("albedoSampler", this._albedoTexture);
                 }
 
+                if (this._baseWeightTexture && MaterialFlags.BaseWeightTextureEnabled) {
+                    ubo.setTexture("baseWeightSampler", this._baseWeightTexture);
+                }
+
                 if (this._ambientTexture && MaterialFlags.AmbientTextureEnabled) {
                     ubo.setTexture("ambientSampler", this._ambientTexture);
                 }
@@ -2430,6 +2462,10 @@ export abstract class PBRBaseMaterial extends PushMaterial {
             results.push(this._albedoTexture);
         }
 
+        if (this._baseWeightTexture && this._baseWeightTexture.animations && this._baseWeightTexture.animations.length > 0) {
+            results.push(this._baseWeightTexture);
+        }
+
         if (this._ambientTexture && this._ambientTexture.animations && this._ambientTexture.animations.length > 0) {
             results.push(this._ambientTexture);
         }
@@ -2498,6 +2534,10 @@ export abstract class PBRBaseMaterial extends PushMaterial {
             activeTextures.push(this._albedoTexture);
         }
 
+        if (this._baseWeightTexture) {
+            activeTextures.push(this._baseWeightTexture);
+        }
+
         if (this._ambientTexture) {
             activeTextures.push(this._ambientTexture);
         }
@@ -2559,6 +2599,10 @@ export abstract class PBRBaseMaterial extends PushMaterial {
             return true;
         }
 
+        if (this._baseWeightTexture === texture) {
+            return true;
+        }
+
         if (this._ambientTexture === texture) {
             return true;
         }
@@ -2638,6 +2682,7 @@ export abstract class PBRBaseMaterial extends PushMaterial {
             }
 
             this._albedoTexture?.dispose();
+            this._baseWeightTexture?.dispose();
             this._ambientTexture?.dispose();
             this._opacityTexture?.dispose();
             this._reflectionTexture?.dispose();
diff --git a/packages/dev/core/src/Materials/PBR/pbrMaterial.ts b/packages/dev/core/src/Materials/PBR/pbrMaterial.ts
index 62ad14b63d6..73c53182e70 100644
--- a/packages/dev/core/src/Materials/PBR/pbrMaterial.ts
+++ b/packages/dev/core/src/Materials/PBR/pbrMaterial.ts
@@ -92,6 +92,10 @@ export class PBRMaterial extends PBRBaseMaterial {
     @expandToProperty("_markAllSubMeshesAsTexturesDirty")
     public albedoTexture: Nullable<BaseTexture>;
 
+    @serializeAsTexture()
+    @expandToProperty("_markAllSubMeshesAsTexturesDirty")
+    public baseWeightTexture: Nullable<BaseTexture>;
+
     /**
      * AKA Occlusion Texture in other nomenclature.
      */
diff --git a/packages/dev/core/src/Materials/materialFlags.ts b/packages/dev/core/src/Materials/materialFlags.ts
index 50f94702866..6bb527f6db7 100644
--- a/packages/dev/core/src/Materials/materialFlags.ts
+++ b/packages/dev/core/src/Materials/materialFlags.ts
@@ -22,6 +22,22 @@ export class MaterialFlags {
         AbstractEngine.MarkAllMaterialsAsDirty(Constants.MATERIAL_TextureDirtyFlag);
     }
 
+    private static _BaseWeightTextureEnabled = true;
+    /**
+     * Are diffuse textures enabled in the application.
+     */
+    public static get BaseWeightTextureEnabled(): boolean {
+        return this._BaseWeightTextureEnabled;
+    }
+    public static set BaseWeightTextureEnabled(value: boolean) {
+        if (this._BaseWeightTextureEnabled === value) {
+            return;
+        }
+
+        this._BaseWeightTextureEnabled = value;
+        AbstractEngine.MarkAllMaterialsAsDirty(Constants.MATERIAL_TextureDirtyFlag);
+    }
+
     private static _DetailTextureEnabled = true;
     /**
      * Are detail textures enabled in the application.
diff --git a/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx b/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx
index 8e44993c183..aa7e748357b 100644
--- a/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx
+++ b/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx
@@ -12,6 +12,10 @@ albedoOpacityOutParams albedoOpacityBlock(
     ,in vec2 albedoInfos
 #endif
     , in float vBaseWeight
+#ifdef BASEWEIGHT
+    , in vec4 baseWeightTexture
+    , in vec2 vBaseWeightInfos
+#endif
 #ifdef OPACITY
     ,in vec4 opacityMap
     ,in vec2 vOpacityInfos
@@ -80,7 +84,7 @@ albedoOpacityOutParams albedoOpacityBlock(
     #endif
 
     #if !defined(SS_LINKREFRACTIONTOTRANSPARENCY) && !defined(ALPHAFRESNEL)
-        #ifdef ALPHATEST 
+        #ifdef ALPHATEST
             #if DEBUGMODE != 88
                 if (alpha < ALPHATESTVALUE)
                     discard;
diff --git a/packages/dev/core/src/Shaders/ShadersInclude/pbrFragmentDeclaration.fx b/packages/dev/core/src/Shaders/ShadersInclude/pbrFragmentDeclaration.fx
index 7b75f80b84b..9d913edf0f1 100644
--- a/packages/dev/core/src/Shaders/ShadersInclude/pbrFragmentDeclaration.fx
+++ b/packages/dev/core/src/Shaders/ShadersInclude/pbrFragmentDeclaration.fx
@@ -20,6 +20,10 @@ uniform vec3 vAmbientColor;
 uniform vec2 vAlbedoInfos;
 #endif
 
+#ifdef BASEWEIGHT
+uniform vec2 vBaseWeightInfos;
+#endif
+
 #ifdef AMBIENT
 uniform vec4 vAmbientInfos;
 #endif
@@ -65,14 +69,14 @@ uniform mat4 view;
 
     #if defined(USE_LOCAL_REFLECTIONMAP_CUBIC) && defined(REFLECTIONMAP_CUBIC)
 	    uniform vec3 vReflectionPosition;
-	    uniform vec3 vReflectionSize; 
+	    uniform vec3 vReflectionSize;
     #endif
 #endif
 
 // Refraction
 #if defined(SS_REFRACTION) && defined(SS_USE_LOCAL_REFRACTIONMAP_CUBIC)
     uniform vec3 vRefractionPosition;
-    uniform vec3 vRefractionSize; 
+    uniform vec3 vRefractionSize;
 #endif
 
 // Clear Coat
diff --git a/packages/dev/core/src/Shaders/ShadersInclude/pbrFragmentSamplersDeclaration.fx b/packages/dev/core/src/Shaders/ShadersInclude/pbrFragmentSamplersDeclaration.fx
index 9e84627ff18..9aefe9443ed 100644
--- a/packages/dev/core/src/Shaders/ShadersInclude/pbrFragmentSamplersDeclaration.fx
+++ b/packages/dev/core/src/Shaders/ShadersInclude/pbrFragmentSamplersDeclaration.fx
@@ -1,4 +1,5 @@
 #include<samplerFragmentDeclaration>(_DEFINENAME_,ALBEDO,_VARYINGNAME_,Albedo,_SAMPLERNAME_,albedo)
+#include<samplerFragmentDeclaration>(_DEFINENAME_,BASEWEIGHT,_VARYINGNAME_,BaseWeight,_SAMPLERNAME_,baseWeight)
 #include<samplerFragmentDeclaration>(_DEFINENAME_,AMBIENT,_VARYINGNAME_,Ambient,_SAMPLERNAME_,ambient)
 #include<samplerFragmentDeclaration>(_DEFINENAME_,OPACITY,_VARYINGNAME_,Opacity,_SAMPLERNAME_,opacity)
 #include<samplerFragmentDeclaration>(_DEFINENAME_,EMISSIVE,_VARYINGNAME_,Emissive,_SAMPLERNAME_,emissive)
@@ -42,7 +43,7 @@
         #define sampleReflection(s, c) textureCube(s, c)
 
         uniform samplerCube reflectionSampler;
-        
+
         #ifdef LODBASEDMICROSFURACE
             #define sampleReflectionLod(s, c, l) textureCubeLodEXT(s, c, l)
         #else
@@ -88,7 +89,7 @@
     #ifdef SS_REFRACTION
         #ifdef SS_REFRACTIONMAP_3D
             #define sampleRefraction(s, c) textureCube(s, c)
-            
+
             uniform samplerCube refractionSampler;
 
             #ifdef LODBASEDMICROSFURACE
@@ -99,7 +100,7 @@
             #endif
         #else
             #define sampleRefraction(s, c) texture2D(s, c)
-            
+
             uniform sampler2D refractionSampler;
 
             #ifdef LODBASEDMICROSFURACE
diff --git a/packages/dev/core/src/Shaders/ShadersInclude/pbrUboDeclaration.fx b/packages/dev/core/src/Shaders/ShadersInclude/pbrUboDeclaration.fx
index 143ee0da107..3900e558843 100644
--- a/packages/dev/core/src/Shaders/ShadersInclude/pbrUboDeclaration.fx
+++ b/packages/dev/core/src/Shaders/ShadersInclude/pbrUboDeclaration.fx
@@ -24,6 +24,7 @@ layout(std140, column_major) uniform;
 
 uniform Material {
     vec2 vAlbedoInfos;
+    vec2 vBaseWeightInfos;
     vec4 vAmbientInfos;
     vec2 vOpacityInfos;
     vec2 vEmissiveInfos;
@@ -36,6 +37,7 @@ uniform Material {
     vec3 vReflectionSize;
     vec3 vBumpInfos;
     mat4 albedoMatrix;
+    mat4 baseWeightMatrix;
     mat4 ambientMatrix;
     mat4 opacityMatrix;
     mat4 emissiveMatrix;
diff --git a/packages/dev/core/src/Shaders/ShadersInclude/pbrVertexDeclaration.fx b/packages/dev/core/src/Shaders/ShadersInclude/pbrVertexDeclaration.fx
index 65d44f24f0b..612b0f01908 100644
--- a/packages/dev/core/src/Shaders/ShadersInclude/pbrVertexDeclaration.fx
+++ b/packages/dev/core/src/Shaders/ShadersInclude/pbrVertexDeclaration.fx
@@ -2,13 +2,23 @@ uniform mat4 view;
 uniform mat4 viewProjection;
 #ifdef MULTIVIEW
 	mat4 viewProjectionR;
-#endif 
+#endif
 
 #ifdef ALBEDO
 uniform mat4 albedoMatrix;
 uniform vec2 vAlbedoInfos;
 #endif
 
+#ifdef BASEWEIGHT
+uniform mat4 baseWeightMatrix;
+uniform vec2 vBaseWeightInfos;
+#endif
+
+#ifdef BASEWEIGHT
+uniform mat4 baseWeightMatrix;
+uniform vec2 vBaseWeightInfos;
+#endif
+
 #ifdef AMBIENT
 uniform mat4 ambientMatrix;
 uniform vec4 vAmbientInfos;
@@ -29,7 +39,7 @@ uniform vec2 vLightmapInfos;
 uniform mat4 lightmapMatrix;
 #endif
 
-#ifdef REFLECTIVITY 
+#ifdef REFLECTIVITY
 uniform vec3 vReflectivityInfos;
 uniform mat4 reflectivityMatrix;
 #endif
diff --git a/packages/dev/core/src/Shaders/pbr.fragment.fx b/packages/dev/core/src/Shaders/pbr.fragment.fx
index ba44723e6de..fc13c953765 100644
--- a/packages/dev/core/src/Shaders/pbr.fragment.fx
+++ b/packages/dev/core/src/Shaders/pbr.fragment.fx
@@ -90,6 +90,10 @@ void main(void) {
     vec4 albedoTexture = texture2D(albedoSampler, vAlbedoUV + uvOffset);
 #endif
 
+#ifdef BASEWEIGHT
+    vec4 baseWeightTexture = texture2D(baseWeightSampler, vBaseWeightUV + uvOffset);
+#endif
+
 #ifdef OPACITY
     vec4 opacityMap = texture2D(opacitySampler, vOpacityUV + uvOffset);
 #endif
@@ -105,6 +109,10 @@ void main(void) {
         , vAlbedoInfos
     #endif
         , vBaseWeight
+    #ifdef BASEWEIGHT
+        , baseWeightTexture
+        , vBaseWeightInfos
+    #endif
     #ifdef OPACITY
         , opacityMap
         , vOpacityInfos
diff --git a/packages/dev/core/src/Shaders/pbr.vertex.fx b/packages/dev/core/src/Shaders/pbr.vertex.fx
index 464bd4a4689..2ad58a8687f 100644
--- a/packages/dev/core/src/Shaders/pbr.vertex.fx
+++ b/packages/dev/core/src/Shaders/pbr.vertex.fx
@@ -31,6 +31,7 @@ attribute vec4 color;
 #include<prePassVertexDeclaration>
 
 #include<samplerVertexDeclaration>(_DEFINENAME_,ALBEDO,_VARYINGNAME_,Albedo)
+#include<samplerVertexDeclaration>(_DEFINENAME_,BASEWEIGHT,_VARYINGNAME_,BaseWeight)
 #include<samplerVertexDeclaration>(_DEFINENAME_,DETAIL,_VARYINGNAME_,Detail)
 #include<samplerVertexDeclaration>(_DEFINENAME_,AMBIENT,_VARYINGNAME_,Ambient)
 #include<samplerVertexDeclaration>(_DEFINENAME_,OPACITY,_VARYINGNAME_,Opacity)
@@ -216,6 +217,7 @@ void main(void) {
     #include<uvVariableDeclaration>[3..7]
 
     #include<samplerVertexImplementation>(_DEFINENAME_,ALBEDO,_VARYINGNAME_,Albedo,_MATRIXNAME_,albedo,_INFONAME_,AlbedoInfos.x)
+    #include<samplerVertexImplementation>(_DEFINENAME_,BASEWEIGHT,_VARYINGNAME_,BaseWeight,_MATRIXNAME_,baseWeight,_INFONAME_,BaseWeightInfos.x)
     #include<samplerVertexImplementation>(_DEFINENAME_,DETAIL,_VARYINGNAME_,Detail,_MATRIXNAME_,detail,_INFONAME_,DetailInfos.x)
     #include<samplerVertexImplementation>(_DEFINENAME_,AMBIENT,_VARYINGNAME_,Ambient,_MATRIXNAME_,ambient,_INFONAME_,AmbientInfos.x)
     #include<samplerVertexImplementation>(_DEFINENAME_,OPACITY,_VARYINGNAME_,Opacity,_MATRIXNAME_,opacity,_INFONAME_,OpacityInfos.x)
diff --git a/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx b/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx
index 0f7112953c3..1e6cf59b52c 100644
--- a/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx
+++ b/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx
@@ -12,6 +12,10 @@ fn albedoOpacityBlock(
     ,albedoInfos: vec2f
 #endif
     , vBaseWeight: f32
+#ifdef BASEWEIGHT
+    , baseWeightTexture: vec4f
+    , vBaseWeightInfos: vec2f
+#endif
 #ifdef OPACITY
     ,opacityMap: vec4f
     ,vOpacityInfos: vec2f
@@ -80,7 +84,7 @@ fn albedoOpacityBlock(
     #endif
 
     #if !defined(SS_LINKREFRACTIONTOTRANSPARENCY) && !defined(ALPHAFRESNEL)
-        #ifdef ALPHATEST 
+        #ifdef ALPHATEST
             #if DEBUGMODE != 88
                 if (alpha < ALPHATESTVALUE) {
                     discard;
diff --git a/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrFragmentSamplersDeclaration.fx b/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrFragmentSamplersDeclaration.fx
index 63d8555f7f7..76275d8c2a4 100644
--- a/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrFragmentSamplersDeclaration.fx
+++ b/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrFragmentSamplersDeclaration.fx
@@ -1,4 +1,5 @@
 #include<samplerFragmentDeclaration>(_DEFINENAME_,ALBEDO,_VARYINGNAME_,Albedo,_SAMPLERNAME_,albedo)
+#include<samplerFragmentDeclaration>(_DEFINENAME_,BASEWEIGHT,_VARYINGNAME_,BaseWeight,_SAMPLERNAME_,baseWeight)
 #include<samplerFragmentDeclaration>(_DEFINENAME_,AMBIENT,_VARYINGNAME_,Ambient,_SAMPLERNAME_,ambient)
 #include<samplerFragmentDeclaration>(_DEFINENAME_,OPACITY,_VARYINGNAME_,Opacity,_SAMPLERNAME_,opacity)
 #include<samplerFragmentDeclaration>(_DEFINENAME_,EMISSIVE,_VARYINGNAME_,Emissive,_SAMPLERNAME_,emissive)
@@ -43,7 +44,7 @@
     #ifdef REFLECTIONMAP_3D
         var reflectionSamplerSampler: sampler;
         var reflectionSampler: texture_cube<f32>;
-        
+
         #ifdef LODBASEDMICROSFURACE
         #else
             var reflectionLowSamplerSampler: sampler;
@@ -93,7 +94,7 @@
 #ifdef SUBSURFACE
     #ifdef SS_REFRACTION
         #ifdef SS_REFRACTIONMAP_3D
-            
+
             var refractionSamplerSampler: sampler;
             var refractionSampler: texture_cube<f32>;
 
@@ -105,7 +106,7 @@
                 var refractionHighSampler: texture_cube<f32>;
             #endif
         #else
-            
+
             var refractionSamplerSampler: sampler;
             var refractionSampler: texture_2d<f32>;
 
diff --git a/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrUboDeclaration.fx b/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrUboDeclaration.fx
index 04223907da2..99990c7cfb3 100644
--- a/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrUboDeclaration.fx
+++ b/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrUboDeclaration.fx
@@ -1,4 +1,5 @@
 uniform vAlbedoInfos: vec2f;
+uniform vBaseWeightInfos: vec2f;
 uniform vAmbientInfos: vec4f;
 uniform vOpacityInfos: vec2f;
 uniform vEmissiveInfos: vec2f;
@@ -11,6 +12,7 @@ uniform vReflectionPosition: vec3f;
 uniform vReflectionSize: vec3f;
 uniform vBumpInfos: vec3f;
 uniform albedoMatrix: mat4x4f;
+uniform baseWeightMatrix: mat4x4f;
 uniform ambientMatrix: mat4x4f;
 uniform opacityMatrix: mat4x4f;
 uniform emissiveMatrix: mat4x4f;
diff --git a/packages/dev/core/src/ShadersWGSL/pbr.fragment.fx b/packages/dev/core/src/ShadersWGSL/pbr.fragment.fx
index d303658d2f5..e22f6c97297 100644
--- a/packages/dev/core/src/ShadersWGSL/pbr.fragment.fx
+++ b/packages/dev/core/src/ShadersWGSL/pbr.fragment.fx
@@ -75,6 +75,10 @@ fn main(input: FragmentInputs) -> FragmentOutputs {
     var albedoTexture: vec4f = textureSample(albedoSampler, albedoSamplerSampler, fragmentInputs.vAlbedoUV + uvOffset);
 #endif
 
+#ifdef BASEWEIGHT
+    var baseWeightTexture: vec4f = textureSample(baseWeightSampler, baseWeightSamplerSampler, fragmentInputs.vBaseWeightUV + uvOffset);
+#endif
+
 #ifdef OPACITY
     var opacityMap: vec4f = textureSample(opacitySampler, opacitySamplerSampler, fragmentInputs.vOpacityUV + uvOffset);
 #endif
@@ -90,6 +94,10 @@ fn main(input: FragmentInputs) -> FragmentOutputs {
         , uniforms.vAlbedoInfos
     #endif
         , uniforms.baseWeight
+    #ifdef BASEWEIGHT
+        , baseWeightTexture
+        , uniforms.vBaseWeightInfos
+    #endif
     #ifdef OPACITY
         , opacityMap
         , uniforms.vOpacityInfos
@@ -124,7 +132,7 @@ fn main(input: FragmentInputs) -> FragmentOutputs {
     #ifdef AMBIENT
         ambientOcclusionColorMap,
         uniforms.vAmbientInfos
-    #endif        
+    #endif
     );
 
     #include<pbrBlockLightmapInit>
@@ -243,7 +251,7 @@ fn main(input: FragmentInputs) -> FragmentOutputs {
         #endif
             TBN,
             normalW,
-            viewDirectionW            
+            viewDirectionW
         );
     #endif
 
diff --git a/packages/dev/core/src/ShadersWGSL/pbr.vertex.fx b/packages/dev/core/src/ShadersWGSL/pbr.vertex.fx
index 04446f38ec6..e83bc6068a2 100644
--- a/packages/dev/core/src/ShadersWGSL/pbr.vertex.fx
+++ b/packages/dev/core/src/ShadersWGSL/pbr.vertex.fx
@@ -27,6 +27,7 @@ attribute color: vec4f;
 #include<prePassVertexDeclaration>
 
 #include<samplerVertexDeclaration>(_DEFINENAME_,ALBEDO,_VARYINGNAME_,Albedo)
+#include<samplerVertexDeclaration>(_DEFINENAME_,BASEWEIGHT,_VARYINGNAME_,BaseWeight)
 #include<samplerVertexDeclaration>(_DEFINENAME_,DETAIL,_VARYINGNAME_,Detail)
 #include<samplerVertexDeclaration>(_DEFINENAME_,AMBIENT,_VARYINGNAME_,Ambient)
 #include<samplerVertexDeclaration>(_DEFINENAME_,OPACITY,_VARYINGNAME_,Opacity)
@@ -212,6 +213,7 @@ fn main(input : VertexInputs) -> FragmentInputs {
     #include<uvVariableDeclaration>[3..7]
 
     #include<samplerVertexImplementation>(_DEFINENAME_,ALBEDO,_VARYINGNAME_,Albedo,_MATRIXNAME_,albedo,_INFONAME_,AlbedoInfos.x)
+    #include<samplerVertexImplementation>(_DEFINENAME_,BASEWEIGHT,_VARYINGNAME_,BaseWeight,_MATRIXNAME_,baseWeight,_INFONAME_,BaseWeightInfos.x)
     #include<samplerVertexImplementation>(_DEFINENAME_,DETAIL,_VARYINGNAME_,Detail,_MATRIXNAME_,detail,_INFONAME_,DetailInfos.x)
     #include<samplerVertexImplementation>(_DEFINENAME_,AMBIENT,_VARYINGNAME_,Ambient,_MATRIXNAME_,ambient,_INFONAME_,AmbientInfos.x)
     #include<samplerVertexImplementation>(_DEFINENAME_,OPACITY,_VARYINGNAME_,Opacity,_MATRIXNAME_,opacity,_INFONAME_,OpacityInfos.x)
diff --git a/packages/dev/inspector/src/components/actionTabs/tabs/propertyGrids/materials/pbrMaterialPropertyGridComponent.tsx b/packages/dev/inspector/src/components/actionTabs/tabs/propertyGrids/materials/pbrMaterialPropertyGridComponent.tsx
index 4f87e3448bf..47a79124cf1 100644
--- a/packages/dev/inspector/src/components/actionTabs/tabs/propertyGrids/materials/pbrMaterialPropertyGridComponent.tsx
+++ b/packages/dev/inspector/src/components/actionTabs/tabs/propertyGrids/materials/pbrMaterialPropertyGridComponent.tsx
@@ -54,6 +54,14 @@ export class PBRMaterialPropertyGridComponent extends React.Component<IPBRMateri
                     onSelectionChangedObservable={this.props.onSelectionChangedObservable}
                     onDebugSelectionChangeObservable={onDebugSelectionChangeObservable}
                 />
+                <TextureLinkLineComponent
+                    label="Base Weight"
+                    texture={material.baseWeightTexture}
+                    propertyName="baseWeightTexture"
+                    material={material}
+                    onSelectionChangedObservable={this.props.onSelectionChangedObservable}
+                    onDebugSelectionChangeObservable={onDebugSelectionChangeObservable}
+                />
                 <TextureLinkLineComponent
                     label="Metallic Roughness"
                     texture={material.metallicTexture}

From 145e431058f7a27e5e49cb421ed4865900e1d4c0 Mon Sep 17 00:00:00 2001
From: Julien Guertault <9511025+virtualzavie@users.noreply.github.com>
Date: Fri, 17 Jan 2025 17:11:55 +0100
Subject: [PATCH 03/11] Use Base Weight in the shader

---
 .../src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx     | 6 ++++++
 .../src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx | 6 ++++++
 2 files changed, 12 insertions(+)

diff --git a/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx b/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx
index aa7e748357b..4ab4ca13a2b 100644
--- a/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx
+++ b/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx
@@ -68,6 +68,12 @@ albedoOpacityOutParams albedoOpacityBlock(
 
     #define CUSTOM_FRAGMENT_UPDATE_ALBEDO
 
+    #if BASEWEIGHT
+        surfaceAlbedo *= baseWeightTexture.r;
+    #else
+        surfaceAlbedo *= vBaseWeight;
+    #endif
+
     // _____________________________ Alpha Information _______________________________
     #ifdef OPACITY
         #ifdef OPACITYRGB
diff --git a/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx b/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx
index 1e6cf59b52c..d72c4985ad5 100644
--- a/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx
+++ b/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx
@@ -68,6 +68,12 @@ fn albedoOpacityBlock(
 
     #define CUSTOM_FRAGMENT_UPDATE_ALBEDO
 
+    #if BASEWEIGHT
+        surfaceAlbedo *= baseWeightTexture.r;
+    #else
+        surfaceAlbedo *= vBaseWeight;
+    #endif
+
     // _____________________________ Alpha Information _______________________________
     #ifdef OPACITY
         #ifdef OPACITYRGB

From 731030e1782cbf96f3d3b3ca0de280cb70129091 Mon Sep 17 00:00:00 2001
From: Julien Guertault <9511025+virtualzavie@users.noreply.github.com>
Date: Fri, 17 Jan 2025 17:45:18 +0100
Subject: [PATCH 04/11] Add visualization test

---
 .../ReferenceImages/openpbr-base-weight.png     | Bin 0 -> 25725 bytes
 .../tools/tests/test/visualization/config.json  |   5 +++++
 2 files changed, 5 insertions(+)
 create mode 100644 packages/tools/tests/test/visualization/ReferenceImages/openpbr-base-weight.png

diff --git a/packages/tools/tests/test/visualization/ReferenceImages/openpbr-base-weight.png b/packages/tools/tests/test/visualization/ReferenceImages/openpbr-base-weight.png
new file mode 100644
index 0000000000000000000000000000000000000000..a82410bc300b8acbfc3f4b48baa3aa8cc9ad5679
GIT binary patch
literal 25725
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
F{{U{QPdNYp

literal 0
HcmV?d00001

diff --git a/packages/tools/tests/test/visualization/config.json b/packages/tools/tests/test/visualization/config.json
index 877653f6b74..35e5af8edfe 100644
--- a/packages/tools/tests/test/visualization/config.json
+++ b/packages/tools/tests/test/visualization/config.json
@@ -1,6 +1,11 @@
 {
     "root": "https://cdn.babylonjs.com",
     "tests": [
+        {
+            "title": "OpenPBR Base Weight",
+            "playgroundId": "#DT1XPP#4",
+            "referenceImage": "openpbr_base_weight.png"
+        },
         {
             "title": "NME Glow Manual",
             "playgroundId": "#7QCYPB#320",

From 85849b3718bcdff292209091760c679a30723497 Mon Sep 17 00:00:00 2001
From: Julien Guertault <9511025+virtualzavie@users.noreply.github.com>
Date: Fri, 17 Jan 2025 17:58:23 +0100
Subject: [PATCH 05/11] Hard code base_weight=1 in NME

---
 .../src/Materials/Node/Blocks/PBR/pbrMetallicRoughnessBlock.ts | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/dev/core/src/Materials/Node/Blocks/PBR/pbrMetallicRoughnessBlock.ts b/packages/dev/core/src/Materials/Node/Blocks/PBR/pbrMetallicRoughnessBlock.ts
index 529edbde2ca..d0d6096f260 100644
--- a/packages/dev/core/src/Materials/Node/Blocks/PBR/pbrMetallicRoughnessBlock.ts
+++ b/packages/dev/core/src/Materials/Node/Blocks/PBR/pbrMetallicRoughnessBlock.ts
@@ -974,10 +974,11 @@ export class PBRMetallicRoughnessBlock extends NodeMaterialBlock {
                 ,vec4${state.fSuffix}(1.)
                 ,vec2${state.fSuffix}(1., 1.)
             #endif
+                ,1. // Base Weight
             #ifdef OPACITY
                 ,vec4${state.fSuffix}(${opacity})
                 ,vec2${state.fSuffix}(1., 1.)
-            #endif                
+            #endif
             );
 
             ${state._declareLocalVar("surfaceAlbedo", NodeMaterialBlockConnectionPointTypes.Vector3)} = albedoOpacityOut.surfaceAlbedo;

From f5bdd5eba256b2edab92b3be499229ce14aada87 Mon Sep 17 00:00:00 2001
From: Julien Guertault <9511025+virtualzavie@users.noreply.github.com>
Date: Fri, 17 Jan 2025 20:58:18 +0100
Subject: [PATCH 06/11] Fix typo

---
 packages/dev/core/src/Materials/PBR/pbrMaterial.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/dev/core/src/Materials/PBR/pbrMaterial.ts b/packages/dev/core/src/Materials/PBR/pbrMaterial.ts
index 73c53182e70..ed09dfc4bbc 100644
--- a/packages/dev/core/src/Materials/PBR/pbrMaterial.ts
+++ b/packages/dev/core/src/Materials/PBR/pbrMaterial.ts
@@ -274,7 +274,7 @@ export class PBRMaterial extends PBRBaseMaterial {
     @expandToProperty("_markAllSubMeshesAsTexturesDirty")
     public albedoColor = new Color3(1, 1, 1);
 
-    @serializeAsColor3("baseWeight")
+    @serialize("baseWeight")
     @expandToProperty("_markAllSubMeshesAsTexturesDirty")
     public baseWeight = 1;
 

From 8dab7fc28f5a323fccb124587eac6f9b665495bc Mon Sep 17 00:00:00 2001
From: Julien Guertault <9511025+virtualzavie@users.noreply.github.com>
Date: Fri, 17 Jan 2025 21:07:04 +0100
Subject: [PATCH 07/11] Add code documentation

---
 packages/dev/core/src/Materials/PBR/pbrBaseMaterial.ts | 8 ++++++++
 packages/dev/core/src/Materials/PBR/pbrMaterial.ts     | 6 ++++++
 packages/dev/core/src/Materials/materialFlags.ts       | 2 +-
 3 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/packages/dev/core/src/Materials/PBR/pbrBaseMaterial.ts b/packages/dev/core/src/Materials/PBR/pbrBaseMaterial.ts
index 5d1eb476920..9a61bb14669 100644
--- a/packages/dev/core/src/Materials/PBR/pbrBaseMaterial.ts
+++ b/packages/dev/core/src/Materials/PBR/pbrBaseMaterial.ts
@@ -420,6 +420,10 @@ export abstract class PBRBaseMaterial extends PushMaterial {
      */
     public _albedoTexture: Nullable<BaseTexture> = null;
 
+    /**
+     * OpenPBR Base Weight (multiplier to the diffuse and metal lobes).
+     * @internal
+     */
     public _baseWeightTexture: Nullable<BaseTexture> = null;
 
     /**
@@ -564,6 +568,10 @@ export abstract class PBRBaseMaterial extends PushMaterial {
      */
     public _albedoColor = new Color3(1, 1, 1);
 
+    /**
+     * OpenPBR Base Weight (multiplier to the diffuse and metal lobes).
+     * @internal
+     */
     public _baseWeight = 1;
 
     /**
diff --git a/packages/dev/core/src/Materials/PBR/pbrMaterial.ts b/packages/dev/core/src/Materials/PBR/pbrMaterial.ts
index ed09dfc4bbc..df311aa1d02 100644
--- a/packages/dev/core/src/Materials/PBR/pbrMaterial.ts
+++ b/packages/dev/core/src/Materials/PBR/pbrMaterial.ts
@@ -92,6 +92,9 @@ export class PBRMaterial extends PBRBaseMaterial {
     @expandToProperty("_markAllSubMeshesAsTexturesDirty")
     public albedoTexture: Nullable<BaseTexture>;
 
+    /**
+     * OpenPBR Base Weight (multiplier to the diffuse and metal lobes).
+     */
     @serializeAsTexture()
     @expandToProperty("_markAllSubMeshesAsTexturesDirty")
     public baseWeightTexture: Nullable<BaseTexture>;
@@ -274,6 +277,9 @@ export class PBRMaterial extends PBRBaseMaterial {
     @expandToProperty("_markAllSubMeshesAsTexturesDirty")
     public albedoColor = new Color3(1, 1, 1);
 
+    /**
+     * OpenPBR Base Weight (multiplier to the diffuse and metal lobes).
+     */
     @serialize("baseWeight")
     @expandToProperty("_markAllSubMeshesAsTexturesDirty")
     public baseWeight = 1;
diff --git a/packages/dev/core/src/Materials/materialFlags.ts b/packages/dev/core/src/Materials/materialFlags.ts
index 6bb527f6db7..af013512b86 100644
--- a/packages/dev/core/src/Materials/materialFlags.ts
+++ b/packages/dev/core/src/Materials/materialFlags.ts
@@ -24,7 +24,7 @@ export class MaterialFlags {
 
     private static _BaseWeightTextureEnabled = true;
     /**
-     * Are diffuse textures enabled in the application.
+     * Is the OpenPBR Base Weight texture enabled in the application.
      */
     public static get BaseWeightTextureEnabled(): boolean {
         return this._BaseWeightTextureEnabled;

From b30f78e75e4c89657dac50023e14f8412f5f5756 Mon Sep 17 00:00:00 2001
From: Julien Guertault <9511025+virtualzavie@users.noreply.github.com>
Date: Fri, 17 Jan 2025 22:24:00 +0100
Subject: [PATCH 08/11] Follow convention of multiplying the texture value by
 the uniform parameter

---
 .../core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx   | 3 +--
 .../src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx    | 3 +--
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx b/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx
index 4ab4ca13a2b..89fc4a85a3c 100644
--- a/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx
+++ b/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx
@@ -68,10 +68,9 @@ albedoOpacityOutParams albedoOpacityBlock(
 
     #define CUSTOM_FRAGMENT_UPDATE_ALBEDO
 
+    surfaceAlbedo *= vBaseWeight;
     #if BASEWEIGHT
         surfaceAlbedo *= baseWeightTexture.r;
-    #else
-        surfaceAlbedo *= vBaseWeight;
     #endif
 
     // _____________________________ Alpha Information _______________________________
diff --git a/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx b/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx
index d72c4985ad5..3d4f1b15a9c 100644
--- a/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx
+++ b/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx
@@ -68,10 +68,9 @@ fn albedoOpacityBlock(
 
     #define CUSTOM_FRAGMENT_UPDATE_ALBEDO
 
+    surfaceAlbedo *= vBaseWeight;
     #if BASEWEIGHT
         surfaceAlbedo *= baseWeightTexture.r;
-    #else
-        surfaceAlbedo *= vBaseWeight;
     #endif
 
     // _____________________________ Alpha Information _______________________________

From 2cd92ca0db7c695cba5115cacc74dd6c35cb33ed Mon Sep 17 00:00:00 2001
From: Julien Guertault <9511025+virtualzavie@users.noreply.github.com>
Date: Mon, 20 Jan 2025 14:53:10 +0100
Subject: [PATCH 09/11] Address review comments

---
 .../dev/core/src/Shaders/ShadersInclude/pbrUboDeclaration.fx | 2 +-
 .../core/src/Shaders/ShadersInclude/pbrVertexDeclaration.fx  | 5 -----
 2 files changed, 1 insertion(+), 6 deletions(-)

diff --git a/packages/dev/core/src/Shaders/ShadersInclude/pbrUboDeclaration.fx b/packages/dev/core/src/Shaders/ShadersInclude/pbrUboDeclaration.fx
index 3900e558843..b4184d15bb1 100644
--- a/packages/dev/core/src/Shaders/ShadersInclude/pbrUboDeclaration.fx
+++ b/packages/dev/core/src/Shaders/ShadersInclude/pbrUboDeclaration.fx
@@ -49,7 +49,7 @@ uniform Material {
     mat4 reflectionMatrix;
     vec3 vReflectionColor;
     vec4 vAlbedoColor;
-  float vBaseWeight;
+    float vBaseWeight;
     vec4 vLightingIntensity;
     vec3 vReflectionMicrosurfaceInfos;
     float pointSize;
diff --git a/packages/dev/core/src/Shaders/ShadersInclude/pbrVertexDeclaration.fx b/packages/dev/core/src/Shaders/ShadersInclude/pbrVertexDeclaration.fx
index 612b0f01908..d9142aaa417 100644
--- a/packages/dev/core/src/Shaders/ShadersInclude/pbrVertexDeclaration.fx
+++ b/packages/dev/core/src/Shaders/ShadersInclude/pbrVertexDeclaration.fx
@@ -14,11 +14,6 @@ uniform mat4 baseWeightMatrix;
 uniform vec2 vBaseWeightInfos;
 #endif
 
-#ifdef BASEWEIGHT
-uniform mat4 baseWeightMatrix;
-uniform vec2 vBaseWeightInfos;
-#endif
-
 #ifdef AMBIENT
 uniform mat4 ambientMatrix;
 uniform vec4 vAmbientInfos;

From 6a04dfaba8876e99add1e4069095d508562e09b3 Mon Sep 17 00:00:00 2001
From: Julien Guertault <9511025+virtualzavie@users.noreply.github.com>
Date: Mon, 20 Jan 2025 14:53:29 +0100
Subject: [PATCH 10/11] Document shading details

---
 .../src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx     | 6 ++++++
 .../src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx | 6 ++++++
 2 files changed, 12 insertions(+)

diff --git a/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx b/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx
index 89fc4a85a3c..b90bb3c494d 100644
--- a/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx
+++ b/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx
@@ -68,6 +68,12 @@ albedoOpacityOutParams albedoOpacityBlock(
 
     #define CUSTOM_FRAGMENT_UPDATE_ALBEDO
 
+    // According to OpenPBR:
+    // - for metals, base_weight is a factor to the base_color (F0, thus surfaceAlbedo in
+    //   Babylons.js).
+    // - for dielectrics, base_weight is a factor to the diffuse BRDF (i.e. it should be
+    //   applied in computeDiffuseLighting), but with the diffuse model *currently* used
+    //   in Babylon.js, factoring it into the surfaceAlbedo is equivalent.
     surfaceAlbedo *= vBaseWeight;
     #if BASEWEIGHT
         surfaceAlbedo *= baseWeightTexture.r;
diff --git a/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx b/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx
index 3d4f1b15a9c..14c7a4f1b57 100644
--- a/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx
+++ b/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx
@@ -68,6 +68,12 @@ fn albedoOpacityBlock(
 
     #define CUSTOM_FRAGMENT_UPDATE_ALBEDO
 
+    // According to OpenPBR:
+    // - for metals, base_weight is a factor to the base_color (F0, thus surfaceAlbedo in
+    //   Babylons.js).
+    // - for dielectrics, base_weight is a factor to the diffuse BRDF (i.e. it should be
+    //   applied in computeDiffuseLighting), but with the diffuse model *currently* used
+    //   in Babylon.js, factoring it into the surfaceAlbedo is equivalent.
     surfaceAlbedo *= vBaseWeight;
     #if BASEWEIGHT
         surfaceAlbedo *= baseWeightTexture.r;

From 5c5abfaf252ca842bb0609617668d3eb0e0d6f44 Mon Sep 17 00:00:00 2001
From: Julien Guertault <9511025+virtualzavie@users.noreply.github.com>
Date: Wed, 22 Jan 2025 11:08:25 +0100
Subject: [PATCH 11/11] Rename float vBaseWeight to baseWeight

---
 packages/dev/core/src/Materials/PBR/pbrBaseMaterial.ts      | 6 +++---
 .../src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx     | 4 ++--
 .../src/Shaders/ShadersInclude/pbrFragmentDeclaration.fx    | 2 +-
 .../core/src/Shaders/ShadersInclude/pbrUboDeclaration.fx    | 2 +-
 packages/dev/core/src/Shaders/pbr.fragment.fx               | 6 +++---
 .../src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx | 4 ++--
 .../src/ShadersWGSL/ShadersInclude/pbrUboDeclaration.fx     | 2 +-
 7 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/packages/dev/core/src/Materials/PBR/pbrBaseMaterial.ts b/packages/dev/core/src/Materials/PBR/pbrBaseMaterial.ts
index 9a61bb14669..f4e20c0a0c4 100644
--- a/packages/dev/core/src/Materials/PBR/pbrBaseMaterial.ts
+++ b/packages/dev/core/src/Materials/PBR/pbrBaseMaterial.ts
@@ -1434,7 +1434,7 @@ export abstract class PBRBaseMaterial extends PushMaterial {
             "vLightsType",
             "vAmbientColor",
             "vAlbedoColor",
-            "vBaseWeight",
+            "baseWeight",
             "vReflectivityColor",
             "vMetallicReflectanceFactors",
             "vEmissiveColor",
@@ -2039,7 +2039,7 @@ export abstract class PBRBaseMaterial extends PushMaterial {
 
         ubo.addUniform("vReflectionColor", 3);
         ubo.addUniform("vAlbedoColor", 4);
-        ubo.addUniform("vBaseWeight", 1);
+        ubo.addUniform("baseWeight", 1);
         ubo.addUniform("vLightingIntensity", 4);
 
         ubo.addUniform("vReflectionMicrosurfaceInfos", 3);
@@ -2308,7 +2308,7 @@ export abstract class PBRBaseMaterial extends PushMaterial {
                     ubo.updateColor4("vAlbedoColor", this._albedoColor, this.alpha);
                 }
 
-                ubo.updateFloat("vBaseWeight", this._baseWeight);
+                ubo.updateFloat("baseWeight", this._baseWeight);
 
                 // Misc
                 this._lightingInfos.x = this._directIntensity;
diff --git a/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx b/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx
index b90bb3c494d..67c32a6ad3a 100644
--- a/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx
+++ b/packages/dev/core/src/Shaders/ShadersInclude/pbrBlockAlbedoOpacity.fx
@@ -11,7 +11,7 @@ albedoOpacityOutParams albedoOpacityBlock(
     ,in vec4 albedoTexture
     ,in vec2 albedoInfos
 #endif
-    , in float vBaseWeight
+    , in float baseWeight
 #ifdef BASEWEIGHT
     , in vec4 baseWeightTexture
     , in vec2 vBaseWeightInfos
@@ -74,7 +74,7 @@ albedoOpacityOutParams albedoOpacityBlock(
     // - for dielectrics, base_weight is a factor to the diffuse BRDF (i.e. it should be
     //   applied in computeDiffuseLighting), but with the diffuse model *currently* used
     //   in Babylon.js, factoring it into the surfaceAlbedo is equivalent.
-    surfaceAlbedo *= vBaseWeight;
+    surfaceAlbedo *= baseWeight;
     #if BASEWEIGHT
         surfaceAlbedo *= baseWeightTexture.r;
     #endif
diff --git a/packages/dev/core/src/Shaders/ShadersInclude/pbrFragmentDeclaration.fx b/packages/dev/core/src/Shaders/ShadersInclude/pbrFragmentDeclaration.fx
index 9d913edf0f1..342aee5a9d5 100644
--- a/packages/dev/core/src/Shaders/ShadersInclude/pbrFragmentDeclaration.fx
+++ b/packages/dev/core/src/Shaders/ShadersInclude/pbrFragmentDeclaration.fx
@@ -2,7 +2,7 @@ uniform vec4 vEyePosition;
 
 uniform vec3 vReflectionColor;
 uniform vec4 vAlbedoColor;
-uniform float vBaseWeight;
+uniform float baseWeight;
 
 // CUSTOM CONTROLS
 uniform vec4 vLightingIntensity;
diff --git a/packages/dev/core/src/Shaders/ShadersInclude/pbrUboDeclaration.fx b/packages/dev/core/src/Shaders/ShadersInclude/pbrUboDeclaration.fx
index b4184d15bb1..dbef7e7c0a4 100644
--- a/packages/dev/core/src/Shaders/ShadersInclude/pbrUboDeclaration.fx
+++ b/packages/dev/core/src/Shaders/ShadersInclude/pbrUboDeclaration.fx
@@ -49,7 +49,7 @@ uniform Material {
     mat4 reflectionMatrix;
     vec3 vReflectionColor;
     vec4 vAlbedoColor;
-    float vBaseWeight;
+    float baseWeight;
     vec4 vLightingIntensity;
     vec3 vReflectionMicrosurfaceInfos;
     float pointSize;
diff --git a/packages/dev/core/src/Shaders/pbr.fragment.fx b/packages/dev/core/src/Shaders/pbr.fragment.fx
index fc13c953765..999d047887d 100644
--- a/packages/dev/core/src/Shaders/pbr.fragment.fx
+++ b/packages/dev/core/src/Shaders/pbr.fragment.fx
@@ -108,7 +108,7 @@ void main(void) {
         , albedoTexture
         , vAlbedoInfos
     #endif
-        , vBaseWeight
+        , baseWeight
     #ifdef BASEWEIGHT
         , baseWeightTexture
         , vBaseWeightInfos
@@ -154,7 +154,7 @@ void main(void) {
 
 #ifdef UNLIT
     vec3 diffuseBase = vec3(1., 1., 1.);
-#else
+#else // !UNLIT
 
     // _____________________________ Reflectivity _______________________________
     vec3 baseColor = surfaceAlbedo;
@@ -621,7 +621,7 @@ void main(void) {
 
     // _____________________________ Compute Final Lit Components ________________________
     #include<pbrBlockFinalLitComponents>
-#endif // UNLIT
+#endif // !UNLIT
 
     #include<pbrBlockFinalUnlitComponents>
 
diff --git a/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx b/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx
index 14c7a4f1b57..52c8c5b83e4 100644
--- a/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx
+++ b/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrBlockAlbedoOpacity.fx
@@ -11,7 +11,7 @@ fn albedoOpacityBlock(
     ,albedoTexture: vec4f
     ,albedoInfos: vec2f
 #endif
-    , vBaseWeight: f32
+    , baseWeight: f32
 #ifdef BASEWEIGHT
     , baseWeightTexture: vec4f
     , vBaseWeightInfos: vec2f
@@ -74,7 +74,7 @@ fn albedoOpacityBlock(
     // - for dielectrics, base_weight is a factor to the diffuse BRDF (i.e. it should be
     //   applied in computeDiffuseLighting), but with the diffuse model *currently* used
     //   in Babylon.js, factoring it into the surfaceAlbedo is equivalent.
-    surfaceAlbedo *= vBaseWeight;
+    surfaceAlbedo *= baseWeight;
     #if BASEWEIGHT
         surfaceAlbedo *= baseWeightTexture.r;
     #endif
diff --git a/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrUboDeclaration.fx b/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrUboDeclaration.fx
index 99990c7cfb3..b730d6beddf 100644
--- a/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrUboDeclaration.fx
+++ b/packages/dev/core/src/ShadersWGSL/ShadersInclude/pbrUboDeclaration.fx
@@ -24,7 +24,7 @@ uniform vTangentSpaceParams: vec2f;
 uniform reflectionMatrix: mat4x4f;
 uniform vReflectionColor: vec3f;
 uniform vAlbedoColor: vec4f;
-uniform vBaseWeight: f32;
+uniform baseWeight: f32;
 uniform vLightingIntensity: vec4f;
 uniform vReflectionMicrosurfaceInfos: vec3f;
 uniform pointSize: f32;