@babylonjs/core 9.5.0 → 9.5.1

package/Materials/PBR/openpbrMaterial.d.ts

@@ -180,6 +180,11 @@ export declare class OpenPBRMaterialDefines extends OpenPBRMaterialDefines_base
      * Number of samples to use for the fuzz IBL lighting calculations
      */
     FUZZ_IBL_SAMPLES: number;
+    /**
+     * Enables the 4-tap rotated-grid kernel for refractive background blur.
+     * When false, a single dithered sample is used instead.
+     */
+    REFRACTION_HIGH_QUALITY_BLUR: boolean;
     /**
      * Tells the shader to enable the fuzz layer
      */
@@ -205,6 +210,10 @@ export declare class OpenPBRMaterialDefines extends OpenPBRMaterialDefines_base
      * Enables the use of screen-space irradiance texture for scattering
      */
     USE_IRRADIANCE_TEXTURE_FOR_SCATTERING: boolean;
+    /**
+     * Number of samples used by the screen-space SSS convolution kernel.
+     */
+    SSS_SAMPLE_COUNT: number;
     /**
      * Indicates that the irradiance texture is from the legacy GeometryBufferRenderer.
      * We use this to handle direct lights which don't render in the legacy GBuffer irradiance.
@@ -817,6 +826,20 @@ export declare class OpenPBRMaterial extends OpenPBRMaterialBase {
      */
     ambientOcclusionTexture: Nullable<BaseTexture>;
     private _ambientOcclusionTexture;
+    /** SSS convolution uses 8 samples. */
+    static readonly SSS_QUALITY_LOW = 0;
+    /** SSS convolution uses 16 samples (default). */
+    static readonly SSS_QUALITY_MEDIUM = 1;
+    /** SSS convolution uses 32 samples. */
+    static readonly SSS_QUALITY_HIGH = 2;
+    private _sssQuality;
+    /**
+     * Controls the sample count of the screen-space SSS convolution kernel.
+     * Use the SSS_QUALITY_LOW / MEDIUM / HIGH constants (8 / 16 / 32 samples).
+     * Higher quality reduces noise at the cost of GPU time. Default: MEDIUM.
+     */
+    get sssQuality(): number;
+    set sssQuality(value: number);
     private _sssIrradianceTexture;
     /**
      * Defines the irradiance texture used for subsurface scattering.
@@ -1186,6 +1209,14 @@ export declare class OpenPBRMaterial extends OpenPBRMaterialBase {
      */
     get backgroundRefractionTexture(): Nullable<BaseTexture>;
     set backgroundRefractionTexture(texture: Nullable<BaseTexture>);
+    private _refractionHighQualityBlur;
+    /**
+     * When true, uses a 4-tap rotated-grid kernel for refractive background blur,
+     * eliminating bilinear block artifacts at the cost of 3 extra texture samples.
+     * When false, a single dithered sample is used. Default: true.
+     */
+    get refractionHighQualityBlur(): boolean;
+    set refractionHighQualityBlur(value: boolean);
     /**
      * Force the shader to compute irradiance in the fragment shader in order to take normal mapping into account.
      * @internal

package/Materials/PBR/openpbrMaterial.js

@@ -228,6 +228,11 @@ export class OpenPBRMaterialDefines extends ImageProcessingDefinesMixin(OpenPBRM
          * Number of samples to use for the fuzz IBL lighting calculations
          */
         this.FUZZ_IBL_SAMPLES = 6;
+        /**
+         * Enables the 4-tap rotated-grid kernel for refractive background blur.
+         * When false, a single dithered sample is used instead.
+         */
+        this.REFRACTION_HIGH_QUALITY_BLUR = false;
         /**
          * Tells the shader to enable the fuzz layer
          */
@@ -253,6 +258,10 @@ export class OpenPBRMaterialDefines extends ImageProcessingDefinesMixin(OpenPBRM
          * Enables the use of screen-space irradiance texture for scattering
          */
         this.USE_IRRADIANCE_TEXTURE_FOR_SCATTERING = false;
+        /**
+         * Number of samples used by the screen-space SSS convolution kernel.
+         */
+        this.SSS_SAMPLE_COUNT = 16;
         /**
          * Indicates that the irradiance texture is from the legacy GeometryBufferRenderer.
          * We use this to handle direct lights which don't render in the legacy GBuffer irradiance.
@@ -393,6 +402,20 @@ export class OpenPBRMaterial extends OpenPBRMaterialBase {
     set geometryCoatTangentAngle(value) {
         this.geometryCoatTangent = new Vector2(Math.cos(value), Math.sin(value));
     }
+    /**
+     * Controls the sample count of the screen-space SSS convolution kernel.
+     * Use the SSS_QUALITY_LOW / MEDIUM / HIGH constants (8 / 16 / 32 samples).
+     * Higher quality reduces noise at the cost of GPU time. Default: MEDIUM.
+     */
+    get sssQuality() {
+        return this._sssQuality;
+    }
+    set sssQuality(value) {
+        if (this._sssQuality !== value) {
+            this._sssQuality = value;
+            this.markAsDirty(1);
+        }
+    }
     /**
      * Defines the irradiance texture used for subsurface scattering.
      * If it's not provided, the irradiance will be looked for in the scene.geometryBufferRenderer.
@@ -496,6 +519,20 @@ export class OpenPBRMaterial extends OpenPBRMaterialBase {
         this._backgroundRefractionTexture = texture;
         this._markAllSubMeshesAsTexturesDirty();
     }
+    /**
+     * When true, uses a 4-tap rotated-grid kernel for refractive background blur,
+     * eliminating bilinear block artifacts at the cost of 3 extra texture samples.
+     * When false, a single dithered sample is used. Default: true.
+     */
+    get refractionHighQualityBlur() {
+        return this._refractionHighQualityBlur;
+    }
+    set refractionHighQualityBlur(value) {
+        if (this._refractionHighQualityBlur !== value) {
+            this._refractionHighQualityBlur = value;
+            this.markAsDirty(1);
+        }
+    }
     /**
      * Enables realtime filtering on the texture.
      */
@@ -574,7 +611,7 @@ export class OpenPBRMaterial extends OpenPBRMaterialBase {
         this._subsurfaceWeightTexture = new Sampler("subsurface_weight", "subsurfaceWeight", "SUBSURFACE_WEIGHT");
         this._subsurfaceColor = new Property("subsurface_color", new Color3(0.8, 0.8, 0.8), "vSubsurfaceColor", 3, 0, "SUBSURFACE_SLAB");
         this._subsurfaceColorTexture = new Sampler("subsurface_color", "subsurfaceColor", "SUBSURFACE_COLOR");
-        this._subsurfaceRadius = new Property("subsurface_radius", 1.0, "vSubsurfaceRadius", 1, 0, "SUBSURFACE_SLAB");
+        this._subsurfaceRadius = new Property("subsurface_radius", 0.1, "vSubsurfaceRadius", 1, 0, "SUBSURFACE_SLAB");
         this._subsurfaceRadiusScale = new Property("subsurface_radius_scale", new Color3(1, 0.5, 0.25), "vSubsurfaceRadiusScale", 3, 0, "SUBSURFACE_SLAB");
         this._subsurfaceRadiusScaleTexture = new Sampler("subsurface_radius_scale", "subsurfaceRadiusScale", "SUBSURFACE_RADIUS_SCALE");
         this._subsurfaceScatterAnisotropy = new Property("subsurface_scatter_anisotropy", 0.0, "vSubsurfaceScatterAnisotropy", 1, 0, "SUBSURFACE_SLAB");
@@ -621,6 +658,7 @@ export class OpenPBRMaterial extends OpenPBRMaterialBase {
         this._thinFilmThicknessTexture = new Sampler("thin_film_thickness", "thinFilmThickness", "THIN_FILM_THICKNESS");
         this._thinFilmIor = new Property("thin_film_ior", 1.4, "vThinFilmIor", 1, 0);
         this._ambientOcclusionTexture = new Sampler("ambient_occlusion", "ambientOcclusion", "AMBIENT_OCCLUSION");
+        this._sssQuality = OpenPBRMaterial.SSS_QUALITY_MEDIUM;
         this._sssIrradianceTexture = null;
         this._sssDepthTexture = null;
         this._uniformsList = {};
@@ -931,6 +969,7 @@ export class OpenPBRMaterial extends OpenPBRMaterialBase {
          */
         this._environmentFuzzBRDFTexture = null;
         this._backgroundRefractionTexture = null;
+        this._refractionHighQualityBlur = true;
         /**
          * Force the shader to compute irradiance in the fragment shader in order to take normal mapping into account.
          * @internal
@@ -1537,7 +1576,7 @@ export class OpenPBRMaterial extends OpenPBRMaterialBase {
                             BindTextureMatrix(sampler.value, ubo, sampler.samplerPrefix);
                         }
                     }
-                    if (this.geometryNormalTexture) {
+                    if (this.geometryNormalTexture || this.geometryCoatNormalTexture) {
                         if (scene._mirroredCameraPosition) {
                             ubo.updateFloat2("vTangentSpaceParams", this._invertNormalMapX ? 1.0 : -1.0, this._invertNormalMapY ? 1.0 : -1.0);
                         }
@@ -2063,6 +2102,7 @@ export class OpenPBRMaterial extends OpenPBRMaterialBase {
                 }
                 if (this.hasTransparency) {
                     defines.REFRACTED_BACKGROUND = !!this._backgroundRefractionTexture && MaterialFlags.RefractionTextureEnabled;
+                    defines.REFRACTION_HIGH_QUALITY_BLUR = this._refractionHighQualityBlur;
                     defines.REFRACTED_LIGHTS = true;
                     const radianceTexture = this._getRadianceTexture();
                     if (radianceTexture) {
@@ -2146,6 +2186,8 @@ export class OpenPBRMaterial extends OpenPBRMaterialBase {
         defines.IRIDESCENCE = this.thinFilmWeight > 0.0;
         defines.DISPERSION = this.transmissionDispersionScale > 0.0;
         defines.SCATTERING = this.hasScattering;
+        const _sssSampleCounts = [8, 16, 32];
+        defines.SSS_SAMPLE_COUNT = _sssSampleCounts[this._sssQuality] ?? 16;
         defines.TRANSMISSION_SLAB = this.transmissionWeight > 0;
         defines.TRANSMISSION_SLAB_VOLUME = this.transmissionWeight > 0 && this.transmissionDepth > 0;
         defines.SUBSURFACE_SLAB = this.subsurfaceWeight > 0;
@@ -2203,6 +2245,12 @@ export class OpenPBRMaterial extends OpenPBRMaterialBase {
         this._callbackPluginEventPrepareDefines(this._eventInfo);
     }
 }
+/** SSS convolution uses 8 samples. */
+OpenPBRMaterial.SSS_QUALITY_LOW = 0;
+/** SSS convolution uses 16 samples (default). */
+OpenPBRMaterial.SSS_QUALITY_MEDIUM = 1;
+/** SSS convolution uses 32 samples. */
+OpenPBRMaterial.SSS_QUALITY_HIGH = 2;
 OpenPBRMaterial._noiseTextures = {};
 /**
  * Force all the PBR materials to compile to glsl even on WebGPU engines.