@babylonjs/core 7.22.3 → 7.22.5

package/Rendering/IBLShadows/iblShadowsImportanceSamplingRenderer.d.ts

@@ -0,0 +1,88 @@
+import type { Scene } from "../../scene";
+import { ProceduralTexture } from "../../Materials/Textures/Procedurals/proceduralTexture";
+import "../../Shaders/iblShadowsImportanceSamplingDebug.fragment";
+import "../../Shaders/iblShadowsCdfx.fragment";
+import "../../Shaders/iblShadowsIcdfx.fragment";
+import "../../Shaders/iblShadowsCdfy.fragment";
+import "../../Shaders/iblShadowsIcdfy.fragment";
+import { PostProcess } from "../../PostProcesses/postProcess";
+import type { BaseTexture } from "../../Materials/Textures/baseTexture";
+import { Observable } from "../../Misc/observable";
+/**
+ * Build cdf maps for IBL importance sampling during IBL shadow computation.
+ * This should not be instanciated directly, as it is part of a scene component
+ * @internal
+ */
+export declare class _IblShadowsImportanceSamplingRenderer {
+    private _scene;
+    private _engine;
+    private _cdfyPT;
+    private _icdfyPT;
+    private _cdfxPT;
+    private _icdfxPT;
+    private _iblSource;
+    /**
+     * Gets the IBL source texture being used by the importance sampling renderer
+     */
+    get iblSource(): BaseTexture;
+    /**
+     * Sets the IBL source texture to be used by the importance sampling renderer.
+     * This will trigger recreation of the importance sampling assets.
+     */
+    set iblSource(source: BaseTexture);
+    private _recreateAssetsFromNewIbl;
+    /**
+     * Return the cumulative distribution function (CDF) Y texture
+     * @returns Return the cumulative distribution function (CDF) Y texture
+     */
+    getIcdfyTexture(): ProceduralTexture;
+    /**
+     * Return the cumulative distribution function (CDF) X texture
+     * @returns Return the cumulative distribution function (CDF) X texture
+     */
+    getIcdfxTexture(): ProceduralTexture;
+    /** Enable the debug view for this pass */
+    debugEnabled: boolean;
+    private _debugPass;
+    private _debugSizeParams;
+    /**
+     * Sets params that control the position and scaling of the debug display on the screen.
+     * @param x Screen X offset of the debug display (0-1)
+     * @param y Screen Y offset of the debug display (0-1)
+     * @param widthScale X scale of the debug display (0-1)
+     * @param heightScale Y scale of the debug display (0-1)
+     */
+    setDebugDisplayParams(x: number, y: number, widthScale: number, heightScale: number): void;
+    /**
+     * The name of the debug pass post process
+     */
+    get debugPassName(): string;
+    private _debugPassName;
+    /**
+     * Gets the debug pass post process
+     * @returns The post process
+     */
+    getDebugPassPP(): PostProcess;
+    /**
+     * Instanciates the importance sampling renderer
+     * @param scene Scene to attach to
+     * @returns The importance sampling renderer
+     */
+    constructor(scene: Scene);
+    /**
+     * Observable that triggers when the importance sampling renderer is ready
+     */
+    onReadyObservable: Observable<void>;
+    private _createTextures;
+    private _disposeTextures;
+    private _createDebugPass;
+    /**
+     * Checks if the importance sampling renderer is ready
+     * @returns true if the importance sampling renderer is ready
+     */
+    isReady(): boolean;
+    /**
+     * Disposes the importance sampling renderer and associated resources
+     */
+    dispose(): void;
+}

package/Rendering/IBLShadows/iblShadowsImportanceSamplingRenderer.js

@@ -0,0 +1,231 @@
+
+import { Texture } from "../../Materials/Textures/texture.js";
+import { ProceduralTexture } from "../../Materials/Textures/Procedurals/proceduralTexture.js";
+import "../../Shaders/iblShadowsImportanceSamplingDebug.fragment.js";
+import "../../Shaders/iblShadowsCdfx.fragment.js";
+import "../../Shaders/iblShadowsIcdfx.fragment.js";
+import "../../Shaders/iblShadowsCdfy.fragment.js";
+import "../../Shaders/iblShadowsIcdfy.fragment.js";
+import { PostProcess } from "../../PostProcesses/postProcess.js";
+import { Vector4 } from "../../Maths/math.vector.js";
+import { RawTexture } from "../../Materials/Textures/rawTexture.js";
+import { Observable } from "../../Misc/observable.js";
+import { HDRCubeTexture } from "../../Materials/Textures/hdrCubeTexture.js";
+/**
+ * Build cdf maps for IBL importance sampling during IBL shadow computation.
+ * This should not be instanciated directly, as it is part of a scene component
+ * @internal
+ */
+export class _IblShadowsImportanceSamplingRenderer {
+    /**
+     * Gets the IBL source texture being used by the importance sampling renderer
+     */
+    get iblSource() {
+        return this._iblSource;
+    }
+    /**
+     * Sets the IBL source texture to be used by the importance sampling renderer.
+     * This will trigger recreation of the importance sampling assets.
+     */
+    set iblSource(source) {
+        if (this._iblSource === source) {
+            return;
+        }
+        if (source instanceof Texture) {
+            if (source.isReady()) {
+                this._recreateAssetsFromNewIbl(source);
+            }
+            else {
+                source.onLoadObservable.addOnce(this._recreateAssetsFromNewIbl);
+            }
+        }
+        else if (source instanceof HDRCubeTexture) {
+            if (source.isReady()) {
+                this._recreateAssetsFromNewIbl(source);
+            }
+            else {
+                source.onLoadObservable.addOnce(this._recreateAssetsFromNewIbl.bind(this, source));
+            }
+        }
+    }
+    _recreateAssetsFromNewIbl(source) {
+        if (this._debugPass) {
+            this._debugPass.dispose();
+        }
+        this._disposeTextures();
+        this._iblSource = source;
+        this._createTextures();
+        if (this._debugPass) {
+            // Recreate the debug pass because of the new textures
+            this._createDebugPass();
+        }
+        // Once the textures are generated, notify that they are ready to use.
+        this._icdfxPT.onGeneratedObservable.addOnce(() => {
+            this.onReadyObservable.notifyObservers();
+        });
+    }
+    /**
+     * Return the cumulative distribution function (CDF) Y texture
+     * @returns Return the cumulative distribution function (CDF) Y texture
+     */
+    getIcdfyTexture() {
+        return this._icdfyPT;
+    }
+    /**
+     * Return the cumulative distribution function (CDF) X texture
+     * @returns Return the cumulative distribution function (CDF) X texture
+     */
+    getIcdfxTexture() {
+        return this._icdfxPT;
+    }
+    /**
+     * Sets params that control the position and scaling of the debug display on the screen.
+     * @param x Screen X offset of the debug display (0-1)
+     * @param y Screen Y offset of the debug display (0-1)
+     * @param widthScale X scale of the debug display (0-1)
+     * @param heightScale Y scale of the debug display (0-1)
+     */
+    setDebugDisplayParams(x, y, widthScale, heightScale) {
+        this._debugSizeParams.set(x, y, widthScale, heightScale);
+    }
+    /**
+     * The name of the debug pass post process
+     */
+    get debugPassName() {
+        return this._debugPassName;
+    }
+    /**
+     * Gets the debug pass post process
+     * @returns The post process
+     */
+    getDebugPassPP() {
+        if (!this._debugPass) {
+            this._createDebugPass();
+        }
+        return this._debugPass;
+    }
+    /**
+     * Instanciates the importance sampling renderer
+     * @param scene Scene to attach to
+     * @returns The importance sampling renderer
+     */
+    constructor(scene) {
+        /** Enable the debug view for this pass */
+        this.debugEnabled = false;
+        this._debugSizeParams = new Vector4(0.0, 0.0, 0.0, 0.0);
+        this._debugPassName = "Importance Sample Debug";
+        /**
+         * Observable that triggers when the importance sampling renderer is ready
+         */
+        this.onReadyObservable = new Observable();
+        this._scene = scene;
+        this._engine = scene.getEngine();
+    }
+    _createTextures() {
+        const size = this._iblSource ? this._iblSource.getSize() : { width: 1, height: 1 };
+        if (!this._iblSource) {
+            this._iblSource = RawTexture.CreateRTexture(new Uint8Array([255]), 1, 1, this._scene, false, false, 1, 0);
+            this._iblSource.name = "Placeholder IBL Source";
+        }
+        if (this._iblSource.isCube) {
+            size.width *= 4;
+            size.height *= 2;
+        }
+        // Create CDF maps (Cumulative Distribution Function) to assist in importance sampling
+        const cdfOptions = {
+            generateDepthBuffer: false,
+            generateMipMaps: false,
+            format: 6,
+            type: 1,
+            samplingMode: 1,
+        };
+        const icdfOptions = {
+            generateDepthBuffer: false,
+            generateMipMaps: false,
+            format: 6,
+            type: 2,
+            samplingMode: 1,
+        };
+        this._cdfyPT = new ProceduralTexture("cdfyTexture", { width: size.width, height: size.height + 1 }, "iblShadowsCdfy", this._scene, cdfOptions, false, false);
+        this._cdfyPT.autoClear = false;
+        this._cdfyPT.setTexture("iblSource", this._iblSource);
+        this._cdfyPT.setInt("iblHeight", size.height);
+        if (this._iblSource.isCube) {
+            this._cdfyPT.defines = "#define IBL_USE_CUBE_MAP\n";
+        }
+        this._cdfyPT.refreshRate = 0;
+        this._icdfyPT = new ProceduralTexture("icdfyTexture", { width: size.width, height: size.height }, "iblShadowsIcdfy", this._scene, icdfOptions, false, false);
+        this._icdfyPT.autoClear = false;
+        this._icdfyPT.setTexture("cdfy", this._cdfyPT);
+        this._icdfyPT.refreshRate = 0;
+        this._cdfxPT = new ProceduralTexture("cdfxTexture", { width: size.width + 1, height: 1 }, "iblShadowsCdfx", this._scene, cdfOptions, false, false);
+        this._cdfxPT.autoClear = false;
+        this._cdfxPT.setTexture("cdfy", this._cdfyPT);
+        this._cdfxPT.refreshRate = 0;
+        this._icdfxPT = new ProceduralTexture("icdfxTexture", { width: size.width, height: 1 }, "iblShadowsIcdfx", this._scene, icdfOptions, false, false);
+        this._icdfxPT.autoClear = false;
+        this._icdfxPT.setTexture("cdfx", this._cdfxPT);
+        this._icdfxPT.refreshRate = 0;
+    }
+    _disposeTextures() {
+        this._cdfyPT?.dispose();
+        this._icdfyPT?.dispose();
+        this._cdfxPT?.dispose();
+        this._icdfxPT?.dispose();
+        this._iblSource?.dispose();
+    }
+    _createDebugPass() {
+        if (this._debugPass) {
+            this._debugPass.dispose();
+        }
+        const debugOptions = {
+            width: this._scene.getEngine().getRenderWidth(),
+            height: this._scene.getEngine().getRenderHeight(),
+            samplingMode: Texture.BILINEAR_SAMPLINGMODE,
+            engine: this._engine,
+            textureType: 0,
+            uniforms: ["sizeParams"],
+            samplers: ["cdfy", "icdfy", "cdfx", "icdfx", "iblSource"],
+            defines: this._iblSource?.isCube ? "#define IBL_USE_CUBE_MAP\n" : "",
+        };
+        this._debugPass = new PostProcess(this._debugPassName, "iblShadowsImportanceSamplingDebug", debugOptions);
+        const debugEffect = this._debugPass.getEffect();
+        if (debugEffect) {
+            debugEffect.defines = this._iblSource?.isCube ? "#define IBL_USE_CUBE_MAP\n" : "";
+        }
+        if (this._iblSource?.isCube) {
+            this._debugPass.updateEffect("#define IBL_USE_CUBE_MAP\n");
+        }
+        this._debugPass.onApplyObservable.add((effect) => {
+            effect.setTexture("cdfy", this._cdfyPT);
+            effect.setTexture("icdfy", this._icdfyPT);
+            effect.setTexture("cdfx", this._cdfxPT);
+            effect.setTexture("icdfx", this._icdfxPT);
+            effect.setTexture("iblSource", this._iblSource);
+            effect.setFloat4("sizeParams", this._debugSizeParams.x, this._debugSizeParams.y, this._debugSizeParams.z, this._debugSizeParams.w);
+        });
+    }
+    /**
+     * Checks if the importance sampling renderer is ready
+     * @returns true if the importance sampling renderer is ready
+     */
+    isReady() {
+        return (this._iblSource &&
+            this._iblSource.name !== "Placeholder IBL Source" &&
+            this._iblSource.isReady() &&
+            this._cdfyPT.isReady() &&
+            this._icdfyPT.isReady() &&
+            this._cdfxPT.isReady() &&
+            this._icdfxPT.isReady());
+    }
+    /**
+     * Disposes the importance sampling renderer and associated resources
+     */
+    dispose() {
+        this._disposeTextures();
+        if (this._debugPass) {
+            this._debugPass.dispose();
+        }
+    }
+}
+//# sourceMappingURL=iblShadowsImportanceSamplingRenderer.js.map

package/Rendering/IBLShadows/iblShadowsImportanceSamplingRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iblShadowsImportanceSamplingRenderer.js","sourceRoot":"","sources":["../../../../../dev/core/src/Rendering/IBLShadows/iblShadowsImportanceSamplingRenderer.ts"],"names":[],"mappings":"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","sourcesContent":["import { Constants } from \"../../Engines/constants\";\r\nimport type { AbstractEngine } from \"../../Engines/abstractEngine\";\r\n\r\nimport type { Scene } from \"../../scene\";\r\nimport { Texture } from \"../../Materials/Textures/texture\";\r\nimport type { TextureSize } from \"../../Materials/Textures/textureCreationOptions\";\r\nimport { ProceduralTexture } from \"../../Materials/Textures/Procedurals/proceduralTexture\";\r\nimport type { IProceduralTextureCreationOptions } from \"../../Materials/Textures/Procedurals/proceduralTexture\";\r\nimport \"../../Shaders/iblShadowsImportanceSamplingDebug.fragment\";\r\nimport \"../../Shaders/iblShadowsCdfx.fragment\";\r\nimport \"../../Shaders/iblShadowsIcdfx.fragment\";\r\nimport \"../../Shaders/iblShadowsCdfy.fragment\";\r\nimport \"../../Shaders/iblShadowsIcdfy.fragment\";\r\nimport { PostProcess } from \"../../PostProcesses/postProcess\";\r\nimport type { PostProcessOptions } from \"../../PostProcesses/postProcess\";\r\nimport { Vector4 } from \"../../Maths/math.vector\";\r\nimport { RawTexture } from \"../../Materials/Textures/rawTexture\";\r\nimport type { BaseTexture } from \"../../Materials/Textures/baseTexture\";\r\nimport { Observable } from \"../../Misc/observable\";\r\nimport { HDRCubeTexture } from \"../../Materials/Textures/hdrCubeTexture\";\r\n\r\n/**\r\n * Build cdf maps for IBL importance sampling during IBL shadow computation.\r\n * This should not be instanciated directly, as it is part of a scene component\r\n * @internal\r\n */\r\nexport class _IblShadowsImportanceSamplingRenderer {\r\n    private _scene: Scene;\r\n    private _engine: AbstractEngine;\r\n\r\n    private _cdfyPT: ProceduralTexture;\r\n    private _icdfyPT: ProceduralTexture;\r\n    private _cdfxPT: ProceduralTexture;\r\n    private _icdfxPT: ProceduralTexture;\r\n    private _iblSource: BaseTexture;\r\n\r\n    /**\r\n     * Gets the IBL source texture being used by the importance sampling renderer\r\n     */\r\n    public get iblSource(): BaseTexture {\r\n        return this._iblSource;\r\n    }\r\n\r\n    /**\r\n     * Sets the IBL source texture to be used by the importance sampling renderer.\r\n     * This will trigger recreation of the importance sampling assets.\r\n     */\r\n    public set iblSource(source: BaseTexture) {\r\n        if (this._iblSource === source) {\r\n            return;\r\n        }\r\n        if (source instanceof Texture) {\r\n            if (source.isReady()) {\r\n                this._recreateAssetsFromNewIbl(source);\r\n            } else {\r\n                source.onLoadObservable.addOnce(this._recreateAssetsFromNewIbl);\r\n            }\r\n        } else if (source instanceof HDRCubeTexture) {\r\n            if (source.isReady()) {\r\n                this._recreateAssetsFromNewIbl(source);\r\n            } else {\r\n                source.onLoadObservable.addOnce(this._recreateAssetsFromNewIbl.bind(this, source));\r\n            }\r\n        }\r\n    }\r\n\r\n    private _recreateAssetsFromNewIbl(source: BaseTexture) {\r\n        if (this._debugPass) {\r\n            this._debugPass.dispose();\r\n        }\r\n        this._disposeTextures();\r\n        this._iblSource = source;\r\n        this._createTextures();\r\n\r\n        if (this._debugPass) {\r\n            // Recreate the debug pass because of the new textures\r\n            this._createDebugPass();\r\n        }\r\n\r\n        // Once the textures are generated, notify that they are ready to use.\r\n        this._icdfxPT.onGeneratedObservable.addOnce(() => {\r\n            this.onReadyObservable.notifyObservers();\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Return the cumulative distribution function (CDF) Y texture\r\n     * @returns Return the cumulative distribution function (CDF) Y texture\r\n     */\r\n    public getIcdfyTexture(): ProceduralTexture {\r\n        return this._icdfyPT;\r\n    }\r\n\r\n    /**\r\n     * Return the cumulative distribution function (CDF) X texture\r\n     * @returns Return the cumulative distribution function (CDF) X texture\r\n     */\r\n    public getIcdfxTexture(): ProceduralTexture {\r\n        return this._icdfxPT;\r\n    }\r\n\r\n    /** Enable the debug view for this pass */\r\n    public debugEnabled: boolean = false;\r\n    private _debugPass: PostProcess;\r\n    private _debugSizeParams: Vector4 = new Vector4(0.0, 0.0, 0.0, 0.0);\r\n\r\n    /**\r\n     * Sets params that control the position and scaling of the debug display on the screen.\r\n     * @param x Screen X offset of the debug display (0-1)\r\n     * @param y Screen Y offset of the debug display (0-1)\r\n     * @param widthScale X scale of the debug display (0-1)\r\n     * @param heightScale Y scale of the debug display (0-1)\r\n     */\r\n    public setDebugDisplayParams(x: number, y: number, widthScale: number, heightScale: number) {\r\n        this._debugSizeParams.set(x, y, widthScale, heightScale);\r\n    }\r\n\r\n    /**\r\n     * The name of the debug pass post process\r\n     */\r\n    public get debugPassName(): string {\r\n        return this._debugPassName;\r\n    }\r\n    private _debugPassName: string = \"Importance Sample Debug\";\r\n\r\n    /**\r\n     * Gets the debug pass post process\r\n     * @returns The post process\r\n     */\r\n    public getDebugPassPP(): PostProcess {\r\n        if (!this._debugPass) {\r\n            this._createDebugPass();\r\n        }\r\n        return this._debugPass;\r\n    }\r\n\r\n    /**\r\n     * Instanciates the importance sampling renderer\r\n     * @param scene Scene to attach to\r\n     * @returns The importance sampling renderer\r\n     */\r\n    constructor(scene: Scene) {\r\n        this._scene = scene;\r\n        this._engine = scene.getEngine();\r\n    }\r\n\r\n    /**\r\n     * Observable that triggers when the importance sampling renderer is ready\r\n     */\r\n    public onReadyObservable: Observable<void> = new Observable<void>();\r\n\r\n    private _createTextures() {\r\n        const size: TextureSize = this._iblSource ? this._iblSource.getSize() : { width: 1, height: 1 };\r\n        if (!this._iblSource) {\r\n            this._iblSource = RawTexture.CreateRTexture(\r\n                new Uint8Array([255]),\r\n                1,\r\n                1,\r\n                this._scene,\r\n                false,\r\n                false,\r\n                Constants.TEXTURE_NEAREST_SAMPLINGMODE,\r\n                Constants.TEXTURETYPE_UNSIGNED_BYTE\r\n            );\r\n            this._iblSource.name = \"Placeholder IBL Source\";\r\n        }\r\n\r\n        if (this._iblSource!.isCube) {\r\n            size.width *= 4;\r\n            size.height *= 2;\r\n        }\r\n\r\n        // Create CDF maps (Cumulative Distribution Function) to assist in importance sampling\r\n        const cdfOptions: IProceduralTextureCreationOptions = {\r\n            generateDepthBuffer: false,\r\n            generateMipMaps: false,\r\n            format: Constants.TEXTUREFORMAT_R,\r\n            type: Constants.TEXTURETYPE_FLOAT,\r\n            samplingMode: Constants.TEXTURE_NEAREST_SAMPLINGMODE,\r\n        };\r\n        const icdfOptions: IProceduralTextureCreationOptions = {\r\n            generateDepthBuffer: false,\r\n            generateMipMaps: false,\r\n            format: Constants.TEXTUREFORMAT_R,\r\n            type: Constants.TEXTURETYPE_HALF_FLOAT,\r\n            samplingMode: Constants.TEXTURE_NEAREST_SAMPLINGMODE,\r\n        };\r\n        this._cdfyPT = new ProceduralTexture(\"cdfyTexture\", { width: size.width, height: size.height + 1 }, \"iblShadowsCdfy\", this._scene, cdfOptions, false, false);\r\n        this._cdfyPT.autoClear = false;\r\n        this._cdfyPT.setTexture(\"iblSource\", this._iblSource as Texture);\r\n        this._cdfyPT.setInt(\"iblHeight\", size.height);\r\n        if (this._iblSource.isCube) {\r\n            this._cdfyPT.defines = \"#define IBL_USE_CUBE_MAP\\n\";\r\n        }\r\n        this._cdfyPT.refreshRate = 0;\r\n        this._icdfyPT = new ProceduralTexture(\"icdfyTexture\", { width: size.width, height: size.height }, \"iblShadowsIcdfy\", this._scene, icdfOptions, false, false);\r\n        this._icdfyPT.autoClear = false;\r\n        this._icdfyPT.setTexture(\"cdfy\", this._cdfyPT);\r\n        this._icdfyPT.refreshRate = 0;\r\n        this._cdfxPT = new ProceduralTexture(\"cdfxTexture\", { width: size.width + 1, height: 1 }, \"iblShadowsCdfx\", this._scene, cdfOptions, false, false);\r\n        this._cdfxPT.autoClear = false;\r\n        this._cdfxPT.setTexture(\"cdfy\", this._cdfyPT);\r\n        this._cdfxPT.refreshRate = 0;\r\n        this._icdfxPT = new ProceduralTexture(\"icdfxTexture\", { width: size.width, height: 1 }, \"iblShadowsIcdfx\", this._scene, icdfOptions, false, false);\r\n        this._icdfxPT.autoClear = false;\r\n        this._icdfxPT.setTexture(\"cdfx\", this._cdfxPT);\r\n        this._icdfxPT.refreshRate = 0;\r\n    }\r\n\r\n    private _disposeTextures() {\r\n        this._cdfyPT?.dispose();\r\n        this._icdfyPT?.dispose();\r\n        this._cdfxPT?.dispose();\r\n        this._icdfxPT?.dispose();\r\n        this._iblSource?.dispose();\r\n    }\r\n\r\n    private _createDebugPass() {\r\n        if (this._debugPass) {\r\n            this._debugPass.dispose();\r\n        }\r\n        const debugOptions: PostProcessOptions = {\r\n            width: this._scene.getEngine().getRenderWidth(),\r\n            height: this._scene.getEngine().getRenderHeight(),\r\n            samplingMode: Texture.BILINEAR_SAMPLINGMODE,\r\n            engine: this._engine,\r\n            textureType: Constants.TEXTURETYPE_UNSIGNED_INT,\r\n            uniforms: [\"sizeParams\"],\r\n            samplers: [\"cdfy\", \"icdfy\", \"cdfx\", \"icdfx\", \"iblSource\"],\r\n            defines: this._iblSource?.isCube ? \"#define IBL_USE_CUBE_MAP\\n\" : \"\",\r\n        };\r\n        this._debugPass = new PostProcess(this._debugPassName, \"iblShadowsImportanceSamplingDebug\", debugOptions);\r\n        const debugEffect = this._debugPass.getEffect();\r\n        if (debugEffect) {\r\n            debugEffect.defines = this._iblSource?.isCube ? \"#define IBL_USE_CUBE_MAP\\n\" : \"\";\r\n        }\r\n        if (this._iblSource?.isCube) {\r\n            this._debugPass.updateEffect(\"#define IBL_USE_CUBE_MAP\\n\");\r\n        }\r\n        this._debugPass.onApplyObservable.add((effect) => {\r\n            effect.setTexture(\"cdfy\", this._cdfyPT);\r\n            effect.setTexture(\"icdfy\", this._icdfyPT);\r\n            effect.setTexture(\"cdfx\", this._cdfxPT);\r\n            effect.setTexture(\"icdfx\", this._icdfxPT);\r\n            effect.setTexture(\"iblSource\", this._iblSource);\r\n            effect.setFloat4(\"sizeParams\", this._debugSizeParams.x, this._debugSizeParams.y, this._debugSizeParams.z, this._debugSizeParams.w);\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Checks if the importance sampling renderer is ready\r\n     * @returns true if the importance sampling renderer is ready\r\n     */\r\n    public isReady() {\r\n        return (\r\n            this._iblSource &&\r\n            this._iblSource.name !== \"Placeholder IBL Source\" &&\r\n            this._iblSource.isReady() &&\r\n            this._cdfyPT.isReady() &&\r\n            this._icdfyPT.isReady() &&\r\n            this._cdfxPT.isReady() &&\r\n            this._icdfxPT.isReady()\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Disposes the importance sampling renderer and associated resources\r\n     */\r\n    public dispose() {\r\n        this._disposeTextures();\r\n        if (this._debugPass) {\r\n            this._debugPass.dispose();\r\n        }\r\n    }\r\n}\r\n"]}