@onerjs/core 8.48.3 → 8.48.5

package/FrameGraph/Tasks/Rendering/iblShadows/iblShadowsSpatialBlurTask.d.ts

@@ -0,0 +1,26 @@
+import { type DrawWrapper, type FrameGraph, type FrameGraphTextureHandle } from "../../../../index.js";
+import { type FrameGraphIblShadowsVoxelizationTask } from "./iblShadowsVoxelizationTask.js";
+import { Vector4 } from "../../../../Maths/math.vector.js";
+import { ThinCustomPostProcess } from "../../../../PostProcesses/thinCustomPostProcess.js";
+import { FrameGraphTask } from "../../../frameGraphTask.js";
+/**
+ * Task used to spatially blur IBL shadows.
+ * @internal
+ */
+export declare class FrameGraphIblShadowsSpatialBlurTask extends FrameGraphTask {
+    sourceTexture?: FrameGraphTextureHandle;
+    depthTexture?: FrameGraphTextureHandle;
+    normalTexture?: FrameGraphTextureHandle;
+    /** Voxelization task providing the dynamic voxelGridSize used as worldScale. */
+    voxelizationTask?: FrameGraphIblShadowsVoxelizationTask;
+    readonly outputTexture: FrameGraphTextureHandle;
+    readonly postProcess: ThinCustomPostProcess;
+    protected readonly _postProcessDrawWrapper: DrawWrapper;
+    protected readonly _blurParameters: Vector4;
+    constructor(name: string, frameGraph: FrameGraph);
+    getClassName(): string;
+    initAsync(): Promise<unknown>;
+    isReady(): boolean;
+    record(): void;
+    dispose(): void;
+}

package/FrameGraph/Tasks/Rendering/iblShadows/iblShadowsSpatialBlurTask.js

@@ -0,0 +1,82 @@
+
+import { Vector4 } from "../../../../Maths/math.vector.js";
+import { ThinCustomPostProcess } from "../../../../PostProcesses/thinCustomPostProcess.js";
+import { FrameGraphTask } from "../../../frameGraphTask.js";
+/**
+ * Task used to spatially blur IBL shadows.
+ * @internal
+ */
+export class FrameGraphIblShadowsSpatialBlurTask extends FrameGraphTask {
+    constructor(name, frameGraph) {
+        super(name, frameGraph);
+        this._blurParameters = new Vector4(0, 0, 0, 0);
+        this.postProcess = new ThinCustomPostProcess(name, frameGraph.engine, {
+            fragmentShader: "iblShadowSpatialBlur",
+            uniforms: ["blurParameters"],
+            samplers: ["voxelTracingSampler", "depthSampler", "worldNormalSampler"],
+            shaderLanguage: frameGraph.engine.isWebGPU ? 1 /* ShaderLanguage.WGSL */ : 0 /* ShaderLanguage.GLSL */,
+        });
+        this._postProcessDrawWrapper = this.postProcess.drawWrapper;
+        this.outputTexture = this._frameGraph.textureManager.createDanglingHandle();
+    }
+    getClassName() {
+        return "FrameGraphIblShadowsSpatialBlurTask";
+    }
+    // eslint-disable-next-line @typescript-eslint/promise-function-async, no-restricted-syntax
+    initAsync() {
+        if (this._frameGraph.engine.isWebGPU) {
+            return import("../../../../ShadersWGSL/iblShadowSpatialBlur.fragment.js");
+        }
+        return import("../../../../Shaders/iblShadowSpatialBlur.fragment.js");
+    }
+    isReady() {
+        return this.postProcess.isReady();
+    }
+    record() {
+        if (this.sourceTexture === undefined || this.depthTexture === undefined || this.normalTexture === undefined) {
+            throw new Error(`FrameGraphIblShadowsSpatialBlurTask ${this.name}: sourceTexture, depthTexture and normalTexture are required`);
+        }
+        const textureManager = this._frameGraph.textureManager;
+        const size = textureManager.getTextureAbsoluteDimensions(this.sourceTexture);
+        const creationOptions = {
+            size,
+            sizeIsPercentage: false,
+            isHistoryTexture: false,
+            options: {
+                createMipMaps: false,
+                samples: 1,
+                types: [0],
+                formats: [5],
+                useSRGBBuffers: [false],
+                creationFlags: [0],
+                labels: [`${this.name} Output`],
+            },
+        };
+        textureManager.resolveDanglingHandle(this.outputTexture, undefined, `${this.name} Output`, creationOptions);
+        const pass = this._frameGraph.addRenderPass(this.name);
+        pass.addDependencies(this.sourceTexture);
+        pass.addDependencies(this.depthTexture);
+        pass.addDependencies(this.normalTexture);
+        pass.setRenderTarget(this.outputTexture);
+        pass.setExecuteFunc((context) => {
+            context.setTextureSamplingMode(this.sourceTexture, 1);
+            context.setTextureSamplingMode(this.depthTexture, 1);
+            context.setTextureSamplingMode(this.normalTexture, 1);
+            const iterationCount = 1;
+            this._blurParameters.set(iterationCount, this.voxelizationTask?.voxelGridSize ?? 1.0, 0.0, 0.0);
+            context.applyFullScreenEffect(this._postProcessDrawWrapper, () => {
+                const effect = this._postProcessDrawWrapper.effect;
+                context.bindTextureHandle(effect, "voxelTracingSampler", this.sourceTexture);
+                context.bindTextureHandle(effect, "depthSampler", this.depthTexture);
+                context.bindTextureHandle(effect, "worldNormalSampler", this.normalTexture);
+                effect.setVector4("blurParameters", this._blurParameters);
+                this.postProcess.bind();
+            }, undefined, false, false, true);
+        });
+    }
+    dispose() {
+        this.postProcess.dispose();
+        super.dispose();
+    }
+}
+//# sourceMappingURL=iblShadowsSpatialBlurTask.js.map

package/FrameGraph/Tasks/Rendering/iblShadows/iblShadowsSpatialBlurTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iblShadowsSpatialBlurTask.js","sourceRoot":"","sources":["../../../../../../../dev/core/src/FrameGraph/Tasks/Rendering/iblShadows/iblShadowsSpatialBlurTask.ts"],"names":[],"mappings":"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","sourcesContent":["import { type DrawWrapper, type FrameGraph, type FrameGraphTextureCreationOptions, type FrameGraphTextureHandle } from \"core/index\";\r\nimport { Constants } from \"core/Engines/constants\";\r\nimport { type FrameGraphIblShadowsVoxelizationTask } from \"./iblShadowsVoxelizationTask\";\r\nimport { Vector4 } from \"core/Maths/math.vector\";\r\nimport { ShaderLanguage } from \"core/Materials/shaderLanguage\";\r\nimport { ThinCustomPostProcess } from \"core/PostProcesses/thinCustomPostProcess\";\r\nimport { FrameGraphTask } from \"../../../frameGraphTask\";\r\n\r\n/**\r\n * Task used to spatially blur IBL shadows.\r\n * @internal\r\n */\r\nexport class FrameGraphIblShadowsSpatialBlurTask extends FrameGraphTask {\r\n    public sourceTexture?: FrameGraphTextureHandle;\r\n    public depthTexture?: FrameGraphTextureHandle;\r\n    public normalTexture?: FrameGraphTextureHandle;\r\n\r\n    /** Voxelization task providing the dynamic voxelGridSize used as worldScale. */\r\n    public voxelizationTask?: FrameGraphIblShadowsVoxelizationTask;\r\n\r\n    public readonly outputTexture: FrameGraphTextureHandle;\r\n\r\n    public readonly postProcess: ThinCustomPostProcess;\r\n    protected readonly _postProcessDrawWrapper: DrawWrapper;\r\n    protected readonly _blurParameters = new Vector4(0, 0, 0, 0);\r\n\r\n    constructor(name: string, frameGraph: FrameGraph) {\r\n        super(name, frameGraph);\r\n\r\n        this.postProcess = new ThinCustomPostProcess(name, frameGraph.engine, {\r\n            fragmentShader: \"iblShadowSpatialBlur\",\r\n            uniforms: [\"blurParameters\"],\r\n            samplers: [\"voxelTracingSampler\", \"depthSampler\", \"worldNormalSampler\"],\r\n            shaderLanguage: frameGraph.engine.isWebGPU ? ShaderLanguage.WGSL : ShaderLanguage.GLSL,\r\n        });\r\n        this._postProcessDrawWrapper = this.postProcess.drawWrapper;\r\n\r\n        this.outputTexture = this._frameGraph.textureManager.createDanglingHandle();\r\n    }\r\n\r\n    public override getClassName(): string {\r\n        return \"FrameGraphIblShadowsSpatialBlurTask\";\r\n    }\r\n\r\n    // eslint-disable-next-line @typescript-eslint/promise-function-async, no-restricted-syntax\r\n    public override initAsync(): Promise<unknown> {\r\n        if (this._frameGraph.engine.isWebGPU) {\r\n            return import(\"../../../../ShadersWGSL/iblShadowSpatialBlur.fragment\");\r\n        }\r\n\r\n        return import(\"../../../../Shaders/iblShadowSpatialBlur.fragment\");\r\n    }\r\n\r\n    public override isReady(): boolean {\r\n        return this.postProcess.isReady();\r\n    }\r\n\r\n    public override record() {\r\n        if (this.sourceTexture === undefined || this.depthTexture === undefined || this.normalTexture === undefined) {\r\n            throw new Error(`FrameGraphIblShadowsSpatialBlurTask ${this.name}: sourceTexture, depthTexture and normalTexture are required`);\r\n        }\r\n\r\n        const textureManager = this._frameGraph.textureManager;\r\n        const size = textureManager.getTextureAbsoluteDimensions(this.sourceTexture);\r\n        const creationOptions: FrameGraphTextureCreationOptions = {\r\n            size,\r\n            sizeIsPercentage: false,\r\n            isHistoryTexture: false,\r\n            options: {\r\n                createMipMaps: false,\r\n                samples: 1,\r\n                types: [Constants.TEXTURETYPE_UNSIGNED_BYTE],\r\n                formats: [Constants.TEXTUREFORMAT_RGBA],\r\n                useSRGBBuffers: [false],\r\n                creationFlags: [0],\r\n                labels: [`${this.name} Output`],\r\n            },\r\n        };\r\n\r\n        textureManager.resolveDanglingHandle(this.outputTexture, undefined, `${this.name} Output`, creationOptions);\r\n\r\n        const pass = this._frameGraph.addRenderPass(this.name);\r\n\r\n        pass.addDependencies(this.sourceTexture);\r\n        pass.addDependencies(this.depthTexture);\r\n        pass.addDependencies(this.normalTexture);\r\n        pass.setRenderTarget(this.outputTexture);\r\n        pass.setExecuteFunc((context) => {\r\n            context.setTextureSamplingMode(this.sourceTexture!, Constants.TEXTURE_NEAREST_SAMPLINGMODE);\r\n            context.setTextureSamplingMode(this.depthTexture!, Constants.TEXTURE_NEAREST_SAMPLINGMODE);\r\n            context.setTextureSamplingMode(this.normalTexture!, Constants.TEXTURE_NEAREST_SAMPLINGMODE);\r\n\r\n            const iterationCount = 1;\r\n            this._blurParameters.set(iterationCount, this.voxelizationTask?.voxelGridSize ?? 1.0, 0.0, 0.0);\r\n\r\n            context.applyFullScreenEffect(\r\n                this._postProcessDrawWrapper,\r\n                () => {\r\n                    const effect = this._postProcessDrawWrapper.effect!;\r\n\r\n                    context.bindTextureHandle(effect, \"voxelTracingSampler\", this.sourceTexture!);\r\n                    context.bindTextureHandle(effect, \"depthSampler\", this.depthTexture!);\r\n                    context.bindTextureHandle(effect, \"worldNormalSampler\", this.normalTexture!);\r\n                    effect.setVector4(\"blurParameters\", this._blurParameters);\r\n\r\n                    this.postProcess.bind();\r\n                },\r\n                undefined,\r\n                false,\r\n                false,\r\n                true\r\n            );\r\n        });\r\n    }\r\n\r\n    public override dispose(): void {\r\n        this.postProcess.dispose();\r\n        super.dispose();\r\n    }\r\n}\r\n"]}

package/FrameGraph/Tasks/Rendering/iblShadows/iblShadowsTracingTask.d.ts

@@ -0,0 +1,61 @@
+import { type Camera, type DrawWrapper, type FrameGraph, type FrameGraphTextureHandle } from "../../../../index.js";
+import { type FrameGraphIblShadowsVoxelizationTask } from "./iblShadowsVoxelizationTask.js";
+import { Matrix, Vector4 } from "../../../../Maths/math.vector.js";
+import { ThinCustomPostProcess } from "../../../../PostProcesses/thinCustomPostProcess.js";
+import { FrameGraphTask } from "../../../frameGraphTask.js";
+/**
+ * Task used to trace IBL shadows from a voxel grid.
+ * @internal
+ */
+export declare class FrameGraphIblShadowsTracingTask extends FrameGraphTask {
+    camera?: Camera;
+    voxelGridTexture?: FrameGraphTextureHandle;
+    depthTexture?: FrameGraphTextureHandle;
+    normalTexture?: FrameGraphTextureHandle;
+    icdfTexture?: FrameGraphTextureHandle;
+    environmentTexture?: FrameGraphTextureHandle;
+    blueNoiseTexture?: FrameGraphTextureHandle;
+    private _sampleDirections;
+    get sampleDirections(): number;
+    set sampleDirections(value: number);
+    voxelShadowOpacity: number;
+    ssShadowOpacity: number;
+    private _ssShadowSampleCount;
+    get ssShadowSampleCount(): number;
+    set ssShadowSampleCount(value: number);
+    private _ssShadowStride;
+    get ssShadowStride(): number;
+    set ssShadowStride(value: number);
+    /** Scale factor applied to voxelGridSize / 2^resolutionExp to get the max SSS ray distance. */
+    ssShadowDistanceScale: number;
+    /** Scale factor applied to voxelGridSize to get the SSS surface thickness. */
+    ssShadowThicknessScale: number;
+    /** Voxelization task providing dynamic voxelGridSize and resolutionExp for SSS parameter derivation. */
+    voxelizationTask?: FrameGraphIblShadowsVoxelizationTask;
+    envRotation: number;
+    voxelNormalBias: number;
+    voxelDirectionBias: number;
+    worldScaleMatrix: Matrix;
+    readonly outputTexture: FrameGraphTextureHandle;
+    readonly postProcess: ThinCustomPostProcess;
+    protected readonly _postProcessDrawWrapper: DrawWrapper;
+    protected readonly _shadowParameters: Vector4;
+    protected readonly _sssParameters: Vector4;
+    protected readonly _opacityParameters: Vector4;
+    protected readonly _voxelBiasParameters: Vector4;
+    protected readonly _cameraInvView: Matrix;
+    protected readonly _cameraInvProj: Matrix;
+    protected readonly _cameraInvViewProjection: Matrix;
+    protected _frameId: number;
+    protected _coloredShadows: boolean;
+    protected _currentDefines: string;
+    constructor(name: string, frameGraph: FrameGraph);
+    getClassName(): string;
+    initAsync(): Promise<unknown>;
+    get coloredShadows(): boolean;
+    set coloredShadows(value: boolean);
+    isReady(): boolean;
+    record(): void;
+    dispose(): void;
+    protected _updateDefines(): void;
+}

package/FrameGraph/Tasks/Rendering/iblShadows/iblShadowsTracingTask.js

@@ -0,0 +1,207 @@
+
+import { Matrix, Vector4 } from "../../../../Maths/math.vector.js";
+import { ThinCustomPostProcess } from "../../../../PostProcesses/thinCustomPostProcess.js";
+import { FrameGraphTask } from "../../../frameGraphTask.js";
+import { Color4 } from "../../../../Maths/math.color.js";
+/**
+ * Task used to trace IBL shadows from a voxel grid.
+ * @internal
+ */
+export class FrameGraphIblShadowsTracingTask extends FrameGraphTask {
+    get sampleDirections() {
+        return this._sampleDirections;
+    }
+    set sampleDirections(value) {
+        this._sampleDirections = Math.max(1, Math.round(value));
+    }
+    get ssShadowSampleCount() {
+        return this._ssShadowSampleCount;
+    }
+    set ssShadowSampleCount(value) {
+        this._ssShadowSampleCount = Math.max(1, Math.round(value));
+    }
+    get ssShadowStride() {
+        return this._ssShadowStride;
+    }
+    set ssShadowStride(value) {
+        this._ssShadowStride = Math.max(1, Math.round(value));
+    }
+    constructor(name, frameGraph) {
+        super(name, frameGraph);
+        this._sampleDirections = 2;
+        this.voxelShadowOpacity = 1;
+        this.ssShadowOpacity = 1;
+        this._ssShadowSampleCount = 16;
+        this._ssShadowStride = 8;
+        /** Scale factor applied to voxelGridSize / 2^resolutionExp to get the max SSS ray distance. */
+        this.ssShadowDistanceScale = 1.25;
+        /** Scale factor applied to voxelGridSize to get the SSS surface thickness. */
+        this.ssShadowThicknessScale = 1.0;
+        this.envRotation = 0;
+        this.voxelNormalBias = 1.4;
+        this.voxelDirectionBias = 1.75;
+        this.worldScaleMatrix = Matrix.Identity();
+        this._shadowParameters = new Vector4(0, 0, 0, 0);
+        this._sssParameters = new Vector4(0, 0, 0, 0);
+        this._opacityParameters = new Vector4(0, 0, 0, 0);
+        this._voxelBiasParameters = new Vector4(0, 0, 0, 0);
+        this._cameraInvView = Matrix.Identity();
+        this._cameraInvProj = Matrix.Identity();
+        this._cameraInvViewProjection = Matrix.Identity();
+        this._frameId = 0;
+        this._coloredShadows = false;
+        this._currentDefines = "";
+        this.postProcess = new ThinCustomPostProcess(name, frameGraph.engine, {
+            fragmentShader: "iblShadowVoxelTracing",
+            uniforms: [
+                "viewMtx",
+                "projMtx",
+                "invProjMtx",
+                "invViewMtx",
+                "invVPMtx",
+                "wsNormalizationMtx",
+                "shadowParameters",
+                "voxelBiasParameters",
+                "sssParameters",
+                "shadowOpacity",
+            ],
+            samplers: ["depthSampler", "worldNormalSampler", "blueNoiseSampler", "icdfSampler", "voxelGridSampler", "iblSampler"],
+            shaderLanguage: frameGraph.engine.isWebGPU ? 1 /* ShaderLanguage.WGSL */ : 0 /* ShaderLanguage.GLSL */,
+        });
+        this._postProcessDrawWrapper = this.postProcess.drawWrapper;
+        this.outputTexture = this._frameGraph.textureManager.createDanglingHandle();
+    }
+    getClassName() {
+        return "FrameGraphIblShadowsTracingTask";
+    }
+    // eslint-disable-next-line @typescript-eslint/promise-function-async, no-restricted-syntax
+    initAsync() {
+        if (this._frameGraph.engine.isWebGPU) {
+            return import("../../../../ShadersWGSL/iblShadowVoxelTracing.fragment.js");
+        }
+        return import("../../../../Shaders/iblShadowVoxelTracing.fragment.js");
+    }
+    get coloredShadows() {
+        return this._coloredShadows;
+    }
+    set coloredShadows(value) {
+        if (this._coloredShadows === value) {
+            return;
+        }
+        this._coloredShadows = value;
+        this._updateDefines();
+    }
+    isReady() {
+        return this.postProcess.isReady();
+    }
+    record() {
+        if (this.camera === undefined ||
+            this.voxelGridTexture === undefined ||
+            this.depthTexture === undefined ||
+            this.normalTexture === undefined ||
+            this.icdfTexture === undefined) {
+            throw new Error(`FrameGraphIblShadowsTracingTask ${this.name}: camera, voxelGridTexture, depthTexture, normalTexture and icdfTexture are required`);
+        }
+        const textureManager = this._frameGraph.textureManager;
+        const size = textureManager.getTextureAbsoluteDimensions(this.depthTexture);
+        const creationOptions = {
+            size,
+            sizeIsPercentage: false,
+            isHistoryTexture: false,
+            options: {
+                createMipMaps: false,
+                samples: 1,
+                types: [0],
+                formats: [5],
+                useSRGBBuffers: [false],
+                creationFlags: [0],
+                labels: [`${this.name} Output`],
+            },
+        };
+        textureManager.resolveDanglingHandle(this.outputTexture, undefined, `${this.name} Output`, creationOptions);
+        this._updateDefines();
+        const pass = this._frameGraph.addRenderPass(this.name);
+        const dependencies = [this.voxelGridTexture, this.depthTexture, this.normalTexture, this.icdfTexture];
+        if (this.environmentTexture !== undefined) {
+            dependencies.push(this.environmentTexture);
+        }
+        if (this.blueNoiseTexture !== undefined) {
+            dependencies.push(this.blueNoiseTexture);
+        }
+        pass.addDependencies(dependencies);
+        pass.setRenderTarget(this.outputTexture);
+        pass.setExecuteFunc((context) => {
+            if (this.icdfTexture === undefined || this.blueNoiseTexture === undefined || (this.coloredShadows && this.environmentTexture === undefined)) {
+                context.clear(new Color4(1, 1, 1, 1), true, false, false);
+                return;
+            }
+            context.setTextureSamplingMode(this.depthTexture, 1);
+            context.setTextureSamplingMode(this.normalTexture, 1);
+            context.setTextureSamplingMode(this.icdfTexture, 1);
+            context.setTextureSamplingMode(this.blueNoiseTexture, 1);
+            const view = this.camera.getViewMatrix();
+            const projection = this.camera.getProjectionMatrix();
+            projection.invertToRef(this._cameraInvProj);
+            view.invertToRef(this._cameraInvView);
+            this.camera.getTransformationMatrix().invertToRef(this._cameraInvViewProjection);
+            const voxelGridSize = textureManager.getTextureAbsoluteDimensions(this.voxelGridTexture);
+            const highestMip = Math.floor(Math.log2(Math.max(1, voxelGridSize.width)));
+            this._frameId++;
+            let rotation = 0.0;
+            if (this.environmentTexture) {
+                rotation = this._frameGraph.scene.environmentTexture.rotationY ?? 0;
+            }
+            rotation = this._frameGraph.scene.useRightHandedSystem ? -(rotation + 0.5 * Math.PI) : rotation - 0.5 * Math.PI;
+            rotation = rotation % (2.0 * Math.PI);
+            this._shadowParameters.set(this.sampleDirections, this._frameId, 1.0, rotation);
+            this._voxelBiasParameters.set(this.voxelNormalBias, this.voxelDirectionBias, highestMip, 0.0);
+            const gridSize = this.voxelizationTask?.voxelGridSize ?? 1.0;
+            const resExp = this.voxelizationTask?.resolutionExp ?? 6;
+            const sssMaxDist = (this.ssShadowDistanceScale * gridSize) / (1 << resExp);
+            const sssThickness = this.ssShadowThicknessScale * 0.005 * gridSize;
+            this._sssParameters.set(this.ssShadowSampleCount, this.ssShadowStride, sssMaxDist, sssThickness);
+            this._opacityParameters.set(this.voxelShadowOpacity, this.ssShadowOpacity, 0.0, 0.0);
+            context.applyFullScreenEffect(this._postProcessDrawWrapper, () => {
+                const effect = this._postProcessDrawWrapper.effect;
+                context.bindTextureHandle(effect, "voxelGridSampler", this.voxelGridTexture);
+                context.bindTextureHandle(effect, "depthSampler", this.depthTexture);
+                context.bindTextureHandle(effect, "worldNormalSampler", this.normalTexture);
+                context.bindTextureHandle(effect, "icdfSampler", this.icdfTexture);
+                context.bindTextureHandle(effect, "blueNoiseSampler", this.blueNoiseTexture);
+                if (this.coloredShadows && this.environmentTexture !== undefined) {
+                    context.bindTextureHandle(effect, "iblSampler", this.environmentTexture);
+                }
+                effect.setMatrix("viewMtx", view);
+                effect.setMatrix("projMtx", projection);
+                effect.setMatrix("invProjMtx", this._cameraInvProj);
+                effect.setMatrix("invViewMtx", this._cameraInvView);
+                effect.setMatrix("invVPMtx", this._cameraInvViewProjection);
+                effect.setMatrix("wsNormalizationMtx", this.worldScaleMatrix);
+                effect.setVector4("shadowParameters", this._shadowParameters);
+                effect.setVector4("voxelBiasParameters", this._voxelBiasParameters);
+                effect.setVector4("sssParameters", this._sssParameters);
+                effect.setVector4("shadowOpacity", this._opacityParameters);
+                this.postProcess.bind();
+            }, undefined, false, false, true);
+        });
+    }
+    dispose() {
+        this.postProcess.dispose();
+        super.dispose();
+    }
+    _updateDefines() {
+        const defines = ["#define WORLD_NORMAL_UNSIGNED"];
+        if (this._frameGraph.scene.useRightHandedSystem) {
+            defines.push("#define RIGHT_HANDED");
+        }
+        if (this.coloredShadows) {
+            defines.push("#define COLOR_SHADOWS 1u");
+        }
+        const defineString = defines.join("\n");
+        if (defineString !== this._currentDefines) {
+            this._currentDefines = defineString;
+            this.postProcess.updateEffect(this._currentDefines);
+        }
+    }
+}
+//# sourceMappingURL=iblShadowsTracingTask.js.map

package/FrameGraph/Tasks/Rendering/iblShadows/iblShadowsTracingTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iblShadowsTracingTask.js","sourceRoot":"","sources":["../../../../../../../dev/core/src/FrameGraph/Tasks/Rendering/iblShadows/iblShadowsTracingTask.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Camera, type DrawWrapper, type FrameGraph, type FrameGraphTextureCreationOptions, type FrameGraphTextureHandle } from \"core/index\";\r\nimport { Constants } from \"core/Engines/constants\";\r\nimport { type FrameGraphIblShadowsVoxelizationTask } from \"./iblShadowsVoxelizationTask\";\r\nimport { Matrix, Vector4 } from \"core/Maths/math.vector\";\r\nimport { ShaderLanguage } from \"core/Materials/shaderLanguage\";\r\nimport { ThinCustomPostProcess } from \"core/PostProcesses/thinCustomPostProcess\";\r\nimport { FrameGraphTask } from \"../../../frameGraphTask\";\r\nimport { Color4 } from \"core/Maths/math.color\";\r\nimport { type CubeTexture } from \"core/Materials/Textures/cubeTexture\";\r\n\r\n/**\r\n * Task used to trace IBL shadows from a voxel grid.\r\n * @internal\r\n */\r\nexport class FrameGraphIblShadowsTracingTask extends FrameGraphTask {\r\n    public camera?: Camera;\r\n    public voxelGridTexture?: FrameGraphTextureHandle;\r\n    public depthTexture?: FrameGraphTextureHandle;\r\n    public normalTexture?: FrameGraphTextureHandle;\r\n    public icdfTexture?: FrameGraphTextureHandle;\r\n    public environmentTexture?: FrameGraphTextureHandle;\r\n    public blueNoiseTexture?: FrameGraphTextureHandle;\r\n\r\n    private _sampleDirections = 2;\r\n\r\n    public get sampleDirections(): number {\r\n        return this._sampleDirections;\r\n    }\r\n\r\n    public set sampleDirections(value: number) {\r\n        this._sampleDirections = Math.max(1, Math.round(value));\r\n    }\r\n\r\n    public voxelShadowOpacity = 1;\r\n    public ssShadowOpacity = 1;\r\n\r\n    private _ssShadowSampleCount = 16;\r\n\r\n    public get ssShadowSampleCount(): number {\r\n        return this._ssShadowSampleCount;\r\n    }\r\n\r\n    public set ssShadowSampleCount(value: number) {\r\n        this._ssShadowSampleCount = Math.max(1, Math.round(value));\r\n    }\r\n\r\n    private _ssShadowStride = 8;\r\n\r\n    public get ssShadowStride(): number {\r\n        return this._ssShadowStride;\r\n    }\r\n\r\n    public set ssShadowStride(value: number) {\r\n        this._ssShadowStride = Math.max(1, Math.round(value));\r\n    }\r\n    /** Scale factor applied to voxelGridSize / 2^resolutionExp to get the max SSS ray distance. */\r\n    public ssShadowDistanceScale = 1.25;\r\n    /** Scale factor applied to voxelGridSize to get the SSS surface thickness. */\r\n    public ssShadowThicknessScale = 1.0;\r\n    /** Voxelization task providing dynamic voxelGridSize and resolutionExp for SSS parameter derivation. */\r\n    public voxelizationTask?: FrameGraphIblShadowsVoxelizationTask;\r\n    public envRotation = 0;\r\n    public voxelNormalBias = 1.4;\r\n    public voxelDirectionBias = 1.75;\r\n    public worldScaleMatrix = Matrix.Identity();\r\n\r\n    public readonly outputTexture: FrameGraphTextureHandle;\r\n\r\n    public readonly postProcess: ThinCustomPostProcess;\r\n    protected readonly _postProcessDrawWrapper: DrawWrapper;\r\n    protected readonly _shadowParameters = new Vector4(0, 0, 0, 0);\r\n    protected readonly _sssParameters = new Vector4(0, 0, 0, 0);\r\n    protected readonly _opacityParameters = new Vector4(0, 0, 0, 0);\r\n    protected readonly _voxelBiasParameters = new Vector4(0, 0, 0, 0);\r\n    protected readonly _cameraInvView = Matrix.Identity();\r\n    protected readonly _cameraInvProj = Matrix.Identity();\r\n    protected readonly _cameraInvViewProjection = Matrix.Identity();\r\n    protected _frameId = 0;\r\n    protected _coloredShadows = false;\r\n    protected _currentDefines = \"\";\r\n\r\n    constructor(name: string, frameGraph: FrameGraph) {\r\n        super(name, frameGraph);\r\n\r\n        this.postProcess = new ThinCustomPostProcess(name, frameGraph.engine, {\r\n            fragmentShader: \"iblShadowVoxelTracing\",\r\n            uniforms: [\r\n                \"viewMtx\",\r\n                \"projMtx\",\r\n                \"invProjMtx\",\r\n                \"invViewMtx\",\r\n                \"invVPMtx\",\r\n                \"wsNormalizationMtx\",\r\n                \"shadowParameters\",\r\n                \"voxelBiasParameters\",\r\n                \"sssParameters\",\r\n                \"shadowOpacity\",\r\n            ],\r\n            samplers: [\"depthSampler\", \"worldNormalSampler\", \"blueNoiseSampler\", \"icdfSampler\", \"voxelGridSampler\", \"iblSampler\"],\r\n            shaderLanguage: frameGraph.engine.isWebGPU ? ShaderLanguage.WGSL : ShaderLanguage.GLSL,\r\n        });\r\n        this._postProcessDrawWrapper = this.postProcess.drawWrapper;\r\n\r\n        this.outputTexture = this._frameGraph.textureManager.createDanglingHandle();\r\n    }\r\n\r\n    public override getClassName(): string {\r\n        return \"FrameGraphIblShadowsTracingTask\";\r\n    }\r\n\r\n    // eslint-disable-next-line @typescript-eslint/promise-function-async, no-restricted-syntax\r\n    public override initAsync(): Promise<unknown> {\r\n        if (this._frameGraph.engine.isWebGPU) {\r\n            return import(\"../../../../ShadersWGSL/iblShadowVoxelTracing.fragment\");\r\n        }\r\n\r\n        return import(\"../../../../Shaders/iblShadowVoxelTracing.fragment\");\r\n    }\r\n\r\n    public get coloredShadows(): boolean {\r\n        return this._coloredShadows;\r\n    }\r\n\r\n    public set coloredShadows(value: boolean) {\r\n        if (this._coloredShadows === value) {\r\n            return;\r\n        }\r\n\r\n        this._coloredShadows = value;\r\n        this._updateDefines();\r\n    }\r\n\r\n    public override isReady(): boolean {\r\n        return this.postProcess.isReady();\r\n    }\r\n\r\n    public override record() {\r\n        if (\r\n            this.camera === undefined ||\r\n            this.voxelGridTexture === undefined ||\r\n            this.depthTexture === undefined ||\r\n            this.normalTexture === undefined ||\r\n            this.icdfTexture === undefined\r\n        ) {\r\n            throw new Error(`FrameGraphIblShadowsTracingTask ${this.name}: camera, voxelGridTexture, depthTexture, normalTexture and icdfTexture are required`);\r\n        }\r\n\r\n        const textureManager = this._frameGraph.textureManager;\r\n        const size = textureManager.getTextureAbsoluteDimensions(this.depthTexture);\r\n        const creationOptions: FrameGraphTextureCreationOptions = {\r\n            size,\r\n            sizeIsPercentage: false,\r\n            isHistoryTexture: false,\r\n            options: {\r\n                createMipMaps: false,\r\n                samples: 1,\r\n                types: [Constants.TEXTURETYPE_UNSIGNED_BYTE],\r\n                formats: [Constants.TEXTUREFORMAT_RGBA],\r\n                useSRGBBuffers: [false],\r\n                creationFlags: [0],\r\n                labels: [`${this.name} Output`],\r\n            },\r\n        };\r\n\r\n        textureManager.resolveDanglingHandle(this.outputTexture, undefined, `${this.name} Output`, creationOptions);\r\n\r\n        this._updateDefines();\r\n\r\n        const pass = this._frameGraph.addRenderPass(this.name);\r\n\r\n        const dependencies: FrameGraphTextureHandle[] = [this.voxelGridTexture, this.depthTexture, this.normalTexture, this.icdfTexture];\r\n        if (this.environmentTexture !== undefined) {\r\n            dependencies.push(this.environmentTexture);\r\n        }\r\n        if (this.blueNoiseTexture !== undefined) {\r\n            dependencies.push(this.blueNoiseTexture);\r\n        }\r\n        pass.addDependencies(dependencies);\r\n        pass.setRenderTarget(this.outputTexture);\r\n        pass.setExecuteFunc((context) => {\r\n            if (this.icdfTexture === undefined || this.blueNoiseTexture === undefined || (this.coloredShadows && this.environmentTexture === undefined)) {\r\n                context.clear(new Color4(1, 1, 1, 1), true, false, false);\r\n                return;\r\n            }\r\n\r\n            context.setTextureSamplingMode(this.depthTexture!, Constants.TEXTURE_NEAREST_SAMPLINGMODE);\r\n            context.setTextureSamplingMode(this.normalTexture!, Constants.TEXTURE_NEAREST_SAMPLINGMODE);\r\n            context.setTextureSamplingMode(this.icdfTexture!, Constants.TEXTURE_NEAREST_SAMPLINGMODE);\r\n            context.setTextureSamplingMode(this.blueNoiseTexture, Constants.TEXTURE_NEAREST_SAMPLINGMODE);\r\n\r\n            const view = this.camera!.getViewMatrix();\r\n            const projection = this.camera!.getProjectionMatrix();\r\n            projection.invertToRef(this._cameraInvProj);\r\n            view.invertToRef(this._cameraInvView);\r\n            this.camera!.getTransformationMatrix().invertToRef(this._cameraInvViewProjection);\r\n\r\n            const voxelGridSize = textureManager.getTextureAbsoluteDimensions(this.voxelGridTexture!);\r\n            const highestMip = Math.floor(Math.log2(Math.max(1, voxelGridSize.width)));\r\n\r\n            this._frameId++;\r\n            let rotation = 0.0;\r\n            if (this.environmentTexture) {\r\n                rotation = (this._frameGraph.scene.environmentTexture as CubeTexture).rotationY ?? 0;\r\n            }\r\n            rotation = this._frameGraph.scene.useRightHandedSystem ? -(rotation + 0.5 * Math.PI) : rotation - 0.5 * Math.PI;\r\n            rotation = rotation % (2.0 * Math.PI);\r\n            this._shadowParameters.set(this.sampleDirections, this._frameId, 1.0, rotation);\r\n            this._voxelBiasParameters.set(this.voxelNormalBias, this.voxelDirectionBias, highestMip, 0.0);\r\n            const gridSize = this.voxelizationTask?.voxelGridSize ?? 1.0;\r\n            const resExp = this.voxelizationTask?.resolutionExp ?? 6;\r\n            const sssMaxDist = (this.ssShadowDistanceScale * gridSize) / (1 << resExp);\r\n            const sssThickness = this.ssShadowThicknessScale * 0.005 * gridSize;\r\n            this._sssParameters.set(this.ssShadowSampleCount, this.ssShadowStride, sssMaxDist, sssThickness);\r\n            this._opacityParameters.set(this.voxelShadowOpacity, this.ssShadowOpacity, 0.0, 0.0);\r\n\r\n            context.applyFullScreenEffect(\r\n                this._postProcessDrawWrapper,\r\n                () => {\r\n                    const effect = this._postProcessDrawWrapper.effect!;\r\n\r\n                    context.bindTextureHandle(effect, \"voxelGridSampler\", this.voxelGridTexture!);\r\n                    context.bindTextureHandle(effect, \"depthSampler\", this.depthTexture!);\r\n                    context.bindTextureHandle(effect, \"worldNormalSampler\", this.normalTexture!);\r\n                    context.bindTextureHandle(effect, \"icdfSampler\", this.icdfTexture!);\r\n                    context.bindTextureHandle(effect, \"blueNoiseSampler\", this.blueNoiseTexture!);\r\n                    if (this.coloredShadows && this.environmentTexture !== undefined) {\r\n                        context.bindTextureHandle(effect, \"iblSampler\", this.environmentTexture);\r\n                    }\r\n\r\n                    effect.setMatrix(\"viewMtx\", view);\r\n                    effect.setMatrix(\"projMtx\", projection);\r\n                    effect.setMatrix(\"invProjMtx\", this._cameraInvProj);\r\n                    effect.setMatrix(\"invViewMtx\", this._cameraInvView);\r\n                    effect.setMatrix(\"invVPMtx\", this._cameraInvViewProjection);\r\n                    effect.setMatrix(\"wsNormalizationMtx\", this.worldScaleMatrix);\r\n                    effect.setVector4(\"shadowParameters\", this._shadowParameters);\r\n                    effect.setVector4(\"voxelBiasParameters\", this._voxelBiasParameters);\r\n                    effect.setVector4(\"sssParameters\", this._sssParameters);\r\n                    effect.setVector4(\"shadowOpacity\", this._opacityParameters);\r\n\r\n                    this.postProcess.bind();\r\n                },\r\n                undefined,\r\n                false,\r\n                false,\r\n                true\r\n            );\r\n        });\r\n    }\r\n\r\n    public override dispose(): void {\r\n        this.postProcess.dispose();\r\n        super.dispose();\r\n    }\r\n\r\n    protected _updateDefines(): void {\r\n        const defines: string[] = [\"#define WORLD_NORMAL_UNSIGNED\"];\r\n\r\n        if (this._frameGraph.scene.useRightHandedSystem) {\r\n            defines.push(\"#define RIGHT_HANDED\");\r\n        }\r\n        if (this.coloredShadows) {\r\n            defines.push(\"#define COLOR_SHADOWS 1u\");\r\n        }\r\n\r\n        const defineString = defines.join(\"\\n\");\r\n        if (defineString !== this._currentDefines) {\r\n            this._currentDefines = defineString;\r\n            this.postProcess.updateEffect(this._currentDefines);\r\n        }\r\n    }\r\n}\r\n"]}

package/FrameGraph/Tasks/Rendering/iblShadows/iblShadowsVoxelizationTask.d.ts

@@ -0,0 +1,104 @@
+import { type FrameGraph, type FrameGraphObjectList, type FrameGraphTextureHandle } from "../../../../index.js";
+import { Matrix } from "../../../../Maths/math.vector.js";
+import { Observable } from "../../../../Misc/observable.js";
+import { FrameGraphTask } from "../../../frameGraphTask.js";
+/**
+ * Task used to voxelize shadow casting objects for IBL shadows.
+ * @internal
+ */
+export declare class FrameGraphIblShadowsVoxelizationTask extends FrameGraphTask {
+    /**
+     * Observable raised when voxelization completes.
+     */
+    readonly onVoxelizationCompleteObservable: Observable<void>;
+    /**
+     * Input object list containing the meshes to voxelize.
+     */
+    objectList: FrameGraphObjectList;
+    /**
+     * World-space voxel grid size.
+     */
+    voxelGridSize: number;
+    /**
+     * Voxel grid resolution exponent. Actual resolution is 2^resolutionExp.
+     */
+    private _resolutionExp;
+    /**
+     * Sets voxel grid resolution exponent. Actual resolution is 2^resolutionExp.
+     */
+    set resolutionExp(value: number);
+    /**
+     * Gets voxel grid resolution exponent. Actual resolution is 2^resolutionExp.
+     */
+    get resolutionExp(): number;
+    /**
+     * Enables tri-planar voxelization mode.
+     */
+    triPlanarVoxelization: boolean;
+    /**
+     * Indicates whether voxelization should be refreshed.
+     */
+    dirty: boolean;
+    private _refreshRate;
+    /**
+     * Controls how often voxelization is refreshed.
+     * - -1: manual only (requires setting `dirty = true`)
+     * - 0: every frame
+     * - 1: skip 1 frame between updates
+     * - N: skip N frames between updates
+     */
+    get refreshRate(): number;
+    set refreshRate(value: number);
+    /**
+     * World-to-voxel normalization matrix used by tracing.
+     */
+    readonly worldScaleMatrix: Matrix;
+    /**
+     * Output voxel grid texture handle.
+     */
+    readonly outputVoxelGridTexture: FrameGraphTextureHandle;
+    private _voxelRenderer?;
+    private _voxelRendererResolutionExp?;
+    private _voxelRendererTriPlanar?;
+    private _voxelizationCompleteObserver;
+    private _voxelRTTextureHandle?;
+    private _voxelGridTextureHandle?;
+    private _frameCounter;
+    /**
+     * Creates a new voxelization task.
+     * @param name The task name.
+     * @param frameGraph The frame graph this task belongs to.
+     */
+    constructor(name: string, frameGraph: FrameGraph);
+    /**
+     * Gets the class name.
+     * @returns The class name.
+     */
+    getClassName(): string;
+    /**
+     * Checks whether the task has all required inputs.
+     * @returns True when ready.
+     */
+    isReady(): boolean;
+    /**
+     * Requests a voxelization update on the next eligible frame.
+     */
+    requestVoxelizationUpdate(): void;
+    /**
+     * Recomputes voxel world bounds from the current object list and updates worldScaleMatrix.
+     */
+    updateSceneBounds(): void;
+    /**
+     * Records the voxelization passes.
+     */
+    record(): void;
+    /**
+     * Disposes internal resources.
+     */
+    dispose(): void;
+    private _ensureVoxelRenderer;
+    private _attachVoxelizationObserver;
+    private _detachVoxelizationObserver;
+    private _updateWorldScaleMatrix;
+    private _updateOutputTextureHandlesFromRenderer;
+}