@babylonjs/core 7.32.3 → 7.32.5

package/Rendering/IBLShadows/iblShadowsPluginMaterial.d.ts

@@ -0,0 +1,60 @@
+import { MaterialDefines } from "../../Materials/materialDefines.js";
+import { MaterialPluginBase } from "../../Materials/materialPluginBase.js";
+import type { InternalTexture } from "../../Materials/Textures/internalTexture.js";
+import type { Material } from "../../Materials/material.js";
+import type { StandardMaterial } from "../../Materials/standardMaterial.js";
+import { PBRBaseMaterial } from "../../Materials/PBR/pbrBaseMaterial.js";
+import type { UniformBuffer } from "../../Materials/uniformBuffer.js";
+import { ShaderLanguage } from "../../Materials/shaderLanguage.js";
+/**
+ * @internal
+ */
+declare class MaterialIBLShadowsRenderDefines extends MaterialDefines {
+    RENDER_WITH_IBL_SHADOWS: boolean;
+}
+/**
+ * Plugin used to render the contribution from IBL shadows.
+ */
+export declare class IBLShadowsPluginMaterial extends MaterialPluginBase {
+    /**
+     * Defines the name of the plugin.
+     */
+    static readonly Name = "IBLShadowsPluginMaterial";
+    /**
+     * The texture containing the contribution from IBL shadows.
+     */
+    iblShadowsTexture: InternalTexture;
+    /**
+     * The opacity of the shadows.
+     */
+    shadowOpacity: number;
+    private _isEnabled;
+    /**
+     * Defines if the plugin is enabled in the material.
+     */
+    isEnabled: boolean;
+    protected _markAllSubMeshesAsTexturesDirty(): void;
+    private _internalMarkAllSubMeshesAsTexturesDirty;
+    /**
+     * Gets a boolean indicating that the plugin is compatible with a give shader language.
+     * @returns true if the plugin is compatible with the shader language
+     */
+    isCompatible(): boolean;
+    constructor(material: Material | StandardMaterial | PBRBaseMaterial);
+    prepareDefines(defines: MaterialIBLShadowsRenderDefines): void;
+    getClassName(): string;
+    getUniforms(): {
+        ubo: {
+            name: string;
+            size: number;
+            type: string;
+        }[];
+        fragment: string;
+    };
+    getSamplers(samplers: string[]): void;
+    bindForSubMesh(uniformBuffer: UniformBuffer): void;
+    getCustomCode(shaderType: string, shaderLanguage: ShaderLanguage): {
+        [name: string]: string;
+    } | null;
+}
+export {};

package/Rendering/IBLShadows/iblShadowsPluginMaterial.js

@@ -0,0 +1,166 @@
+import { __decorate } from "../../tslib.es6.js";
+import { MaterialDefines } from "../../Materials/materialDefines.js";
+import { MaterialPluginBase } from "../../Materials/materialPluginBase.js";
+
+import { PBRBaseMaterial } from "../../Materials/PBR/pbrBaseMaterial.js";
+import { expandToProperty, serialize } from "../../Misc/decorators.js";
+import { RegisterClass } from "../../Misc/typeStore.js";
+/**
+ * @internal
+ */
+class MaterialIBLShadowsRenderDefines extends MaterialDefines {
+    constructor() {
+        super(...arguments);
+        this.RENDER_WITH_IBL_SHADOWS = false;
+    }
+}
+/**
+ * Plugin used to render the contribution from IBL shadows.
+ */
+export class IBLShadowsPluginMaterial extends MaterialPluginBase {
+    _markAllSubMeshesAsTexturesDirty() {
+        this._enable(this._isEnabled);
+        this._internalMarkAllSubMeshesAsTexturesDirty();
+    }
+    /**
+     * Gets a boolean indicating that the plugin is compatible with a give shader language.
+     * @returns true if the plugin is compatible with the shader language
+     */
+    isCompatible() {
+        return true;
+    }
+    constructor(material) {
+        super(material, IBLShadowsPluginMaterial.Name, 310, new MaterialIBLShadowsRenderDefines());
+        /**
+         * The opacity of the shadows.
+         */
+        this.shadowOpacity = 1.0;
+        this._isEnabled = false;
+        /**
+         * Defines if the plugin is enabled in the material.
+         */
+        this.isEnabled = false;
+        this._internalMarkAllSubMeshesAsTexturesDirty = material._dirtyCallbacks[1];
+    }
+    prepareDefines(defines) {
+        defines.RENDER_WITH_IBL_SHADOWS = this._isEnabled;
+    }
+    getClassName() {
+        return "IBLShadowsPluginMaterial";
+    }
+    getUniforms() {
+        return {
+            ubo: [
+                { name: "renderTargetSize", size: 2, type: "vec2" },
+                { name: "shadowOpacity", size: 1, type: "float" },
+            ],
+            fragment: `#ifdef RENDER_WITH_IBL_SHADOWS
+                    uniform vec2 renderTargetSize;
+                    uniform float shadowOpacity;
+                #endif`,
+        };
+    }
+    getSamplers(samplers) {
+        samplers.push("iblShadowsTexture");
+    }
+    bindForSubMesh(uniformBuffer) {
+        if (this._isEnabled) {
+            uniformBuffer.bindTexture("iblShadowsTexture", this.iblShadowsTexture);
+            uniformBuffer.updateFloat2("renderTargetSize", this._material.getScene().getEngine().getRenderWidth(), this._material.getScene().getEngine().getRenderHeight());
+            uniformBuffer.updateFloat("shadowOpacity", this.shadowOpacity);
+        }
+    }
+    getCustomCode(shaderType, shaderLanguage) {
+        let frag;
+        if (shaderLanguage === 1 /* ShaderLanguage.WGSL */) {
+            frag = {
+                // eslint-disable-next-line @typescript-eslint/naming-convention
+                CUSTOM_FRAGMENT_DEFINITIONS: `
+                #ifdef RENDER_WITH_IBL_SHADOWS
+                    var iblShadowsTextureSampler: sampler;
+                    var iblShadowsTexture: texture_2d<f32>;
+
+                    fn computeIndirectShadow() -> vec2f {
+                        var uv = fragmentInputs.position.xy / uniforms.renderTargetSize;
+                        var shadowValue: vec2f = textureSample(iblShadowsTexture, iblShadowsTextureSampler, uv).rg;
+                        return mix(shadowValue, vec2f(1.0), 1.0 - uniforms.shadowOpacity);
+                    }
+                #endif
+            `,
+            };
+            if (this._material instanceof PBRBaseMaterial) {
+                // eslint-disable-next-line @typescript-eslint/naming-convention
+                frag["CUSTOM_FRAGMENT_BEFORE_FINALCOLORCOMPOSITION"] = `
+                #ifdef RENDER_WITH_IBL_SHADOWS
+                    #ifdef REFLECTION
+                        var shadowValue: vec2f = computeIndirectShadow();
+                        finalIrradiance *= vec3f(shadowValue.x);
+                        finalRadianceScaled *= vec3f(mix(pow(shadowValue.y, 4.0), shadowValue.x, roughness));
+                    #endif
+                #endif
+            `;
+            }
+            else {
+                frag["CUSTOM_FRAGMENT_BEFORE_FRAGCOLOR"] = `
+                #ifdef RENDER_WITH_IBL_SHADOWS
+                    var shadowValue: vec2f = computeIndirectShadow();
+                    color *= toGammaSpace(vec4f(shadowValue.x, shadowValue.x, shadowValue.x, 1.0f));
+                #endif
+            `;
+            }
+        }
+        else {
+            frag = {
+                // eslint-disable-next-line @typescript-eslint/naming-convention
+                CUSTOM_FRAGMENT_DEFINITIONS: `
+                #ifdef RENDER_WITH_IBL_SHADOWS
+                    uniform sampler2D iblShadowsTexture;
+
+                    vec2 computeIndirectShadow() {
+                        vec2 uv = gl_FragCoord.xy / renderTargetSize;
+                        vec2 shadowValue = texture2D(iblShadowsTexture, uv).rg;
+                        return mix(shadowValue.rg, vec2(1.0), 1.0 - shadowOpacity);
+                    }
+                #endif
+            `,
+            };
+            if (this._material instanceof PBRBaseMaterial) {
+                // eslint-disable-next-line @typescript-eslint/naming-convention
+                frag["CUSTOM_FRAGMENT_BEFORE_FINALCOLORCOMPOSITION"] = `
+                #ifdef RENDER_WITH_IBL_SHADOWS
+                    #ifdef REFLECTION
+                        vec2 shadowValue = computeIndirectShadow();
+                        finalIrradiance *= shadowValue.x;
+                        finalRadianceScaled *= mix(pow(shadowValue.y, 4.0), shadowValue.x, roughness);
+                    #endif
+                #endif
+            `;
+            }
+            else {
+                frag["CUSTOM_FRAGMENT_BEFORE_FRAGCOLOR"] = `
+                #ifdef RENDER_WITH_IBL_SHADOWS
+                    vec2 shadowValue = computeIndirectShadow();
+                    color.rgb *= toGammaSpace(shadowValue.x);
+                #endif
+            `;
+            }
+        }
+        return shaderType === "vertex" ? null : frag;
+    }
+}
+/**
+ * Defines the name of the plugin.
+ */
+IBLShadowsPluginMaterial.Name = "IBLShadowsPluginMaterial";
+__decorate([
+    serialize()
+], IBLShadowsPluginMaterial.prototype, "iblShadowsTexture", void 0);
+__decorate([
+    serialize()
+], IBLShadowsPluginMaterial.prototype, "shadowOpacity", void 0);
+__decorate([
+    serialize(),
+    expandToProperty("_markAllSubMeshesAsTexturesDirty")
+], IBLShadowsPluginMaterial.prototype, "isEnabled", void 0);
+RegisterClass(`BABYLON.IBLShadowsPluginMaterial`, IBLShadowsPluginMaterial);
+//# sourceMappingURL=iblShadowsPluginMaterial.js.map

package/Rendering/IBLShadows/iblShadowsPluginMaterial.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iblShadowsPluginMaterial.js","sourceRoot":"","sources":["../../../../../dev/core/src/Rendering/IBLShadows/iblShadowsPluginMaterial.ts"],"names":[],"mappings":"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","sourcesContent":["import { MaterialDefines } from \"core/Materials/materialDefines\";\r\nimport { MaterialPluginBase } from \"core/Materials/materialPluginBase\";\r\nimport type { InternalTexture } from \"core/Materials/Textures/internalTexture\";\r\nimport type { Material } from \"core/Materials/material\";\r\nimport { Constants } from \"core/Engines/constants\";\r\nimport type { StandardMaterial } from \"core/Materials/standardMaterial\";\r\nimport { PBRBaseMaterial } from \"core/Materials/PBR/pbrBaseMaterial\";\r\nimport type { UniformBuffer } from \"core/Materials/uniformBuffer\";\r\nimport { expandToProperty, serialize } from \"core/Misc/decorators\";\r\nimport { RegisterClass } from \"core/Misc/typeStore\";\r\n\r\nimport { ShaderLanguage } from \"core/Materials/shaderLanguage\";\r\n/**\r\n * @internal\r\n */\r\nclass MaterialIBLShadowsRenderDefines extends MaterialDefines {\r\n    public RENDER_WITH_IBL_SHADOWS = false;\r\n}\r\n\r\n/**\r\n * Plugin used to render the contribution from IBL shadows.\r\n */\r\nexport class IBLShadowsPluginMaterial extends MaterialPluginBase {\r\n    /**\r\n     * Defines the name of the plugin.\r\n     */\r\n    public static readonly Name = \"IBLShadowsPluginMaterial\";\r\n\r\n    /**\r\n     * The texture containing the contribution from IBL shadows.\r\n     */\r\n    @serialize()\r\n    public iblShadowsTexture: InternalTexture;\r\n\r\n    /**\r\n     * The opacity of the shadows.\r\n     */\r\n    @serialize()\r\n    public shadowOpacity: number = 1.0;\r\n\r\n    private _isEnabled = false;\r\n    /**\r\n     * Defines if the plugin is enabled in the material.\r\n     */\r\n    @serialize()\r\n    @expandToProperty(\"_markAllSubMeshesAsTexturesDirty\")\r\n    public isEnabled = false;\r\n\r\n    protected _markAllSubMeshesAsTexturesDirty(): void {\r\n        this._enable(this._isEnabled);\r\n        this._internalMarkAllSubMeshesAsTexturesDirty();\r\n    }\r\n\r\n    private _internalMarkAllSubMeshesAsTexturesDirty: () => void;\r\n\r\n    /**\r\n     * Gets a boolean indicating that the plugin is compatible with a give shader language.\r\n     * @returns true if the plugin is compatible with the shader language\r\n     */\r\n    public override isCompatible(): boolean {\r\n        return true;\r\n    }\r\n\r\n    constructor(material: Material | StandardMaterial | PBRBaseMaterial) {\r\n        super(material, IBLShadowsPluginMaterial.Name, 310, new MaterialIBLShadowsRenderDefines());\r\n        this._internalMarkAllSubMeshesAsTexturesDirty = material._dirtyCallbacks[Constants.MATERIAL_TextureDirtyFlag];\r\n    }\r\n\r\n    public override prepareDefines(defines: MaterialIBLShadowsRenderDefines) {\r\n        defines.RENDER_WITH_IBL_SHADOWS = this._isEnabled;\r\n    }\r\n\r\n    public override getClassName() {\r\n        return \"IBLShadowsPluginMaterial\";\r\n    }\r\n\r\n    public override getUniforms() {\r\n        return {\r\n            ubo: [\r\n                { name: \"renderTargetSize\", size: 2, type: \"vec2\" },\r\n                { name: \"shadowOpacity\", size: 1, type: \"float\" },\r\n            ],\r\n            fragment: `#ifdef RENDER_WITH_IBL_SHADOWS\r\n                    uniform vec2 renderTargetSize;\r\n                    uniform float shadowOpacity;\r\n                #endif`,\r\n        };\r\n    }\r\n\r\n    public override getSamplers(samplers: string[]) {\r\n        samplers.push(\"iblShadowsTexture\");\r\n    }\r\n\r\n    public override bindForSubMesh(uniformBuffer: UniformBuffer) {\r\n        if (this._isEnabled) {\r\n            uniformBuffer.bindTexture(\"iblShadowsTexture\", this.iblShadowsTexture);\r\n            uniformBuffer.updateFloat2(\"renderTargetSize\", this._material.getScene().getEngine().getRenderWidth(), this._material.getScene().getEngine().getRenderHeight());\r\n            uniformBuffer.updateFloat(\"shadowOpacity\", this.shadowOpacity);\r\n        }\r\n    }\r\n\r\n    public override getCustomCode(shaderType: string, shaderLanguage: ShaderLanguage) {\r\n        let frag: { [name: string]: string };\r\n\r\n        if (shaderLanguage === ShaderLanguage.WGSL) {\r\n            frag = {\r\n                // eslint-disable-next-line @typescript-eslint/naming-convention\r\n                CUSTOM_FRAGMENT_DEFINITIONS: `\r\n                #ifdef RENDER_WITH_IBL_SHADOWS\r\n                    var iblShadowsTextureSampler: sampler;\r\n                    var iblShadowsTexture: texture_2d<f32>;\r\n\r\n                    fn computeIndirectShadow() -> vec2f {\r\n                        var uv = fragmentInputs.position.xy / uniforms.renderTargetSize;\r\n                        var shadowValue: vec2f = textureSample(iblShadowsTexture, iblShadowsTextureSampler, uv).rg;\r\n                        return mix(shadowValue, vec2f(1.0), 1.0 - uniforms.shadowOpacity);\r\n                    }\r\n                #endif\r\n            `,\r\n            };\r\n\r\n            if (this._material instanceof PBRBaseMaterial) {\r\n                // eslint-disable-next-line @typescript-eslint/naming-convention\r\n                frag[\"CUSTOM_FRAGMENT_BEFORE_FINALCOLORCOMPOSITION\"] = `\r\n                #ifdef RENDER_WITH_IBL_SHADOWS\r\n                    #ifdef REFLECTION\r\n                        var shadowValue: vec2f = computeIndirectShadow();\r\n                        finalIrradiance *= vec3f(shadowValue.x);\r\n                        finalRadianceScaled *= vec3f(mix(pow(shadowValue.y, 4.0), shadowValue.x, roughness));\r\n                    #endif\r\n                #endif\r\n            `;\r\n            } else {\r\n                frag[\"CUSTOM_FRAGMENT_BEFORE_FRAGCOLOR\"] = `\r\n                #ifdef RENDER_WITH_IBL_SHADOWS\r\n                    var shadowValue: vec2f = computeIndirectShadow();\r\n                    color *= toGammaSpace(vec4f(shadowValue.x, shadowValue.x, shadowValue.x, 1.0f));\r\n                #endif\r\n            `;\r\n            }\r\n        } else {\r\n            frag = {\r\n                // eslint-disable-next-line @typescript-eslint/naming-convention\r\n                CUSTOM_FRAGMENT_DEFINITIONS: `\r\n                #ifdef RENDER_WITH_IBL_SHADOWS\r\n                    uniform sampler2D iblShadowsTexture;\r\n\r\n                    vec2 computeIndirectShadow() {\r\n                        vec2 uv = gl_FragCoord.xy / renderTargetSize;\r\n                        vec2 shadowValue = texture2D(iblShadowsTexture, uv).rg;\r\n                        return mix(shadowValue.rg, vec2(1.0), 1.0 - shadowOpacity);\r\n                    }\r\n                #endif\r\n            `,\r\n            };\r\n\r\n            if (this._material instanceof PBRBaseMaterial) {\r\n                // eslint-disable-next-line @typescript-eslint/naming-convention\r\n                frag[\"CUSTOM_FRAGMENT_BEFORE_FINALCOLORCOMPOSITION\"] = `\r\n                #ifdef RENDER_WITH_IBL_SHADOWS\r\n                    #ifdef REFLECTION\r\n                        vec2 shadowValue = computeIndirectShadow();\r\n                        finalIrradiance *= shadowValue.x;\r\n                        finalRadianceScaled *= mix(pow(shadowValue.y, 4.0), shadowValue.x, roughness);\r\n                    #endif\r\n                #endif\r\n            `;\r\n            } else {\r\n                frag[\"CUSTOM_FRAGMENT_BEFORE_FRAGCOLOR\"] = `\r\n                #ifdef RENDER_WITH_IBL_SHADOWS\r\n                    vec2 shadowValue = computeIndirectShadow();\r\n                    color.rgb *= toGammaSpace(shadowValue.x);\r\n                #endif\r\n            `;\r\n            }\r\n        }\r\n\r\n        return shaderType === \"vertex\" ? null : frag;\r\n    }\r\n}\r\n\r\nRegisterClass(`BABYLON.IBLShadowsPluginMaterial`, IBLShadowsPluginMaterial);\r\n"]}

package/Rendering/IBLShadows/iblShadowsRenderPipeline.d.ts

@@ -1,10 +1,12 @@
-import type { AbstractMesh } from "../../Meshes/abstractMesh";
+import type { Mesh } from "../../Meshes/mesh";
 import type { Scene } from "../../scene";
 import type { BaseTexture } from "../../Materials/Textures/baseTexture";
 import { Texture } from "../../Materials/Textures/texture";
-import { PrePassRenderer } from "../prePassRenderer";
 import { PostProcessRenderPipeline } from "../../PostProcesses/RenderPipeline/postProcessRenderPipeline";
 import type { Camera } from "../../Cameras/camera.js";
+import { RawTexture } from "../../Materials/Textures/rawTexture.js";
+import type { Material } from "../../Materials/material.js";
+import { Observable } from "../../Misc/observable.js";
 interface IblShadowsSettings {
     /**
      * The exponent of the resolution of the voxel shadow grid. Higher resolutions will result in sharper
@@ -30,6 +32,11 @@ interface IblShadowsSettings {
      * bits of missing geometry.
      */
     triPlanarVoxelization: boolean;
+    /**
+     * A multiplier for the render size of the shadows. Used for rendering lower-resolution shadows
+     * to increase performance. Should be a value between 0 and 1.
+     */
+    shadowRenderSizeFactor: number;
     /**
      * Separate control for the opacity of the voxel shadows.
      */
@@ -51,11 +58,11 @@ interface IblShadowsSettings {
      * The maximum distance a shadow can be cast in screen space. This should usually be kept small
      * as screenspace shadows are mostly useful for small details.
      */
-    ssShadowMaxDist: number;
+    ssShadowDistanceScale: number;
     /**
      * Screen-space shadow thickness. This value controls the perceived thickness of the SS shadows.
      */
-    ssShadowThickness: number;
+    ssShadowThicknessScale: number;
 }
 /**
  * Voxel-based shadow rendering for IBL's.
@@ -66,83 +73,85 @@ export declare class IblShadowsRenderPipeline extends PostProcessRenderPipeline
      * The scene that this pipeline is attached to
      */
     scene: Scene;
-    private _voxelizationDirty;
-    private _boundsNeedUpdate;
     private _allowDebugPasses;
     private _debugPasses;
-    private _shadowCompositePP;
-    private _prePassEffectConfiguration;
-    private _excludedMeshes;
+    private _geometryBufferRenderer;
+    private _shadowCastingMeshes;
     private _voxelRenderer;
     private _importanceSamplingRenderer;
     private _voxelTracingPass;
     private _spatialBlurPass;
     private _accumulationPass;
     private _noiseTexture;
+    /**
+     * Raw texture to be used before final data is available.
+     * @internal
+     */
+    _dummyTexture2d: RawTexture;
+    private _dummyTexture3d;
     private _shadowOpacity;
     private _enabled;
+    private _materialsWithRenderPlugin;
+    /**
+     * Observable that triggers when the shadow renderer is ready
+     */
+    onShadowTextureReadyObservable: Observable<void>;
+    /**
+     * Observable that triggers when a new IBL is set and the importance sampling is ready
+     */
+    onNewIblReadyObservable: Observable<void>;
     /**
      * The current world-space size of that the voxel grid covers in the scene.
      */
     voxelGridSize: number;
     /**
-     * How dark the shadows appear. 1.0 is full opacity, 0.0 is no shadows.
+     * Reset the shadow accumulation.
      */
-    get shadowOpacity(): number;
+    resetAccumulation(): void;
     /**
      * How dark the shadows appear. 1.0 is full opacity, 0.0 is no shadows.
      */
+    get shadowOpacity(): number;
     set shadowOpacity(value: number);
+    private _renderSizeFactor;
     /**
-     * How dark the voxel shadows appear. 1.0 is full opacity, 0.0 is no shadows.
+     * A multiplier for the render size of the shadows. Used for rendering lower-resolution shadows.
      */
-    get voxelShadowOpacity(): number;
+    get shadowRenderSizeFactor(): number;
+    set shadowRenderSizeFactor(value: number);
     /**
      * How dark the voxel shadows appear. 1.0 is full opacity, 0.0 is no shadows.
      */
+    get voxelShadowOpacity(): number;
     set voxelShadowOpacity(value: number);
     /**
      * How dark the screen-space shadows appear. 1.0 is full opacity, 0.0 is no shadows.
      */
     get ssShadowOpacity(): number;
-    /**
-     * How dark the screen-space shadows appear. 1.0 is full opacity, 0.0 is no shadows.
-     */
     set ssShadowOpacity(value: number);
     /**
      * The number of samples used in the screen space shadow pass.
      */
     get ssShadowSamples(): number;
-    /**
-     * The number of samples used in the screen space shadow pass.
-     */
     set ssShadowSamples(value: number);
     /**
      * The stride of the screen-space shadow pass. This controls the distance between samples.
      */
     get ssShadowStride(): number;
-    /**
-     * The stride of the screen-space shadow pass. This controls the distance between samples.
-     */
     set ssShadowStride(value: number);
+    private _sssMaxDistScale;
     /**
-     * The maximum distance a shadow can be cast in screen space. This should usually be kept small
-     * as screenspace shadows are mostly useful for small details.
-     */
-    get ssShadowMaxDist(): number;
-    /**
-     * The maximum distance a shadow can be cast in screen space. This should usually be kept small
-     * as screenspace shadows are mostly useful for small details.
-     */
-    set ssShadowMaxDist(value: number);
-    /**
-     * Screen-space shadow thickness. This value controls the perceived thickness of the SS shadows.
+     * A scale for the maximum distance a shadow can be cast in screen space.
+     * The absolute distance for SS shadows is derived from the voxel size and this scalar.
      */
-    get ssShadowThickness(): number;
+    get ssShadowDistanceScale(): number;
+    set ssShadowDistanceScale(value: number);
+    private _sssThicknessScale;
     /**
      * Screen-space shadow thickness. This value controls the perceived thickness of the SS shadows.
      */
-    set ssShadowThickness(value: number);
+    get ssShadowThicknessScale(): number;
+    set ssShadowThicknessScale(value: number);
     /**
      * Set the IBL image to be used for shadowing. It can be either a cubemap
      * or a 2D equirectangular texture.
@@ -152,18 +161,45 @@ export declare class IblShadowsRenderPipeline extends PostProcessRenderPipeline
     /**
      * Returns the texture containing the voxel grid data
      * @returns The texture containing the voxel grid data
+     * @internal
      */
-    getVoxelGridTexture(): Texture;
+    _getVoxelGridTexture(): Texture;
     /**
      * Returns the texture containing the importance sampling CDF data for the IBL shadow pipeline
      * @returns The texture containing the importance sampling CDF data for the IBL shadow pipeline
+     * @internal
      */
-    getIcdfyTexture(): Texture;
+    _getIcdfyTexture(): Texture;
     /**
      * Returns the texture containing the importance sampling CDF data for the IBL shadow pipeline
      * @returns The texture containing the importance sampling CDF data for the IBL shadow pipeline
+     * @internal
+     */
+    _getIcdfxTexture(): Texture;
+    /**
+     * Returns the noise texture.
+     * @returns The noise texture.
+     * @internal
+     */
+    _getNoiseTexture(): Texture;
+    /**
+     * Returns the voxel-tracing texture.
+     * @returns The voxel-tracing texture.
+     * @internal
+     */
+    _getVoxelTracingTexture(): Texture;
+    /**
+     * Returns the spatial blur texture.
+     * @returns The spatial blur texture.
+     * @internal
      */
-    getIcdfxTexture(): Texture;
+    _getSpatialBlurTexture(): Texture;
+    /**
+     * Returns the accumulated shadow texture.
+     * @returns The accumulated shadow texture.
+     * @internal
+     */
+    _getAccumulatedTexture(): Texture;
     private _gbufferDebugPass;
     private _gbufferDebugEnabled;
     private _gBufferDebugSizeParams;
@@ -230,15 +266,15 @@ export declare class IblShadowsRenderPipeline extends PostProcessRenderPipeline
      */
     set accumulationPassDebugEnabled(enabled: boolean);
     /**
-     * Add a mesh in the exclusion list to prevent it to be handled by the IBL shadow pipeline
-     * @param mesh The mesh to exclude from the IBL shadow pipeline
+     * Add a mesh to be used for shadow casting in the IBL shadow pipeline
+     * @param mesh A mesh or list of meshes that you want to cast shadows
      */
-    addExcludedMesh(mesh: AbstractMesh): void;
+    addShadowCastingMesh(mesh: Mesh | Mesh[]): void;
     /**
-     * Remove a mesh from the exclusion list of the IBL shadow pipeline
-     * @param mesh The mesh to remove
+     * Remove a mesh from the shadow-casting list.
+     * @param mesh The mesh or list of meshes that you don't want to cast shadows.
      */
-    removeExcludedMesh(mesh: AbstractMesh): void;
+    removeShadowCastingMesh(mesh: Mesh | Mesh[]): void;
     /**
      * The exponent of the resolution of the voxel shadow grid. Higher resolutions will result in sharper
      * shadows but are more expensive to compute and require more memory.
@@ -300,8 +336,6 @@ export declare class IblShadowsRenderPipeline extends PostProcessRenderPipeline
      */
     toggleShadow(enabled: boolean): void;
     private _handleResize;
-    private _createShadowCombinePostProcess;
-    private _createEffectPasses;
     private _getGBufferDebugPass;
     private _createDebugPasses;
     private _disposeEffectPasses;
@@ -316,23 +350,30 @@ export declare class IblShadowsRenderPipeline extends PostProcessRenderPipeline
      * to be recalculated. This will also trigger a re-voxelization.
      */
     updateSceneBounds(): void;
-    private _updateBeforeRender;
-    private _listenForCameraChanges;
     /**
-     * Links to the prepass renderer
-     * @param prePassRenderer The scene PrePassRenderer
-     * @returns true if the pre pass is setup
+     * Update the SS shadow max distance and thickness based on the voxel grid size and resolution.
+     * The max distance should be just a little larger than the world size of a single voxel.
+     */
+    private _updateSSShadowParams;
+    /**
+     * Apply the shadows to a material or array of materials.
+     * @param material Material that will be affected by the shadows. If not provided, all materials of the scene will be affected.
      */
-    setPrePassRenderer(prePassRenderer: PrePassRenderer): boolean;
+    addShadowReceivingMaterial(material?: Material | Material[]): void;
+    /**
+     * Remove a material from receiving shadows
+     * @param material The material that will no longer receive shadows
+     */
+    removeShadowReceivingMaterial(material: Material | Material[]): void;
+    protected _addShadowSupportToMaterial(material: Material): void;
+    protected _setPluginParameters(): void;
+    private _updateBeforeRender;
+    private _listenForCameraChanges;
     /**
      * Checks if the IBL shadow pipeline is ready to render shadows
      * @returns true if the IBL shadow pipeline is ready to render the shadows
      */
     isReady(): boolean;
-    /**
-     * Renders accumulated shadows for IBL
-     */
-    update(): void;
     /**
      * Get the class name
      * @returns "IBLShadowsRenderPipeline"