@onerjs/core 8.48.3 → 8.48.5

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

@@ -0,0 +1,218 @@
+import { Matrix, Quaternion, Vector3 } from "../../../../Maths/math.vector.js";
+import { Observable } from "../../../../Misc/observable.js";
+import { _IblShadowsVoxelRenderer } from "../../../../Rendering/IBLShadows/iblShadowsVoxelRenderer.js";
+import { FrameGraphTask } from "../../../frameGraphTask.js";
+/**
+ * Task used to voxelize shadow casting objects for IBL shadows.
+ * @internal
+ */
+export class FrameGraphIblShadowsVoxelizationTask extends FrameGraphTask {
+    /**
+     * Sets voxel grid resolution exponent. Actual resolution is 2^resolutionExp.
+     */
+    set resolutionExp(value) {
+        const newValue = Math.round(Math.max(1, Math.min(value, 8)));
+        if (newValue === this._resolutionExp) {
+            return;
+        }
+        this._resolutionExp = newValue;
+        if (this._voxelRenderer) {
+            this._voxelRenderer.voxelResolutionExp = this._resolutionExp;
+        }
+        this.dirty = true;
+    }
+    /**
+     * Gets voxel grid resolution exponent. Actual resolution is 2^resolutionExp.
+     */
+    get resolutionExp() {
+        return this._resolutionExp;
+    }
+    /**
+     * 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() {
+        return this._refreshRate;
+    }
+    set refreshRate(value) {
+        this._refreshRate = Math.max(-1, Math.round(value));
+    }
+    /**
+     * Creates a new voxelization task.
+     * @param name The task name.
+     * @param frameGraph The frame graph this task belongs to.
+     */
+    constructor(name, frameGraph) {
+        super(name, frameGraph);
+        /**
+         * Observable raised when voxelization completes.
+         */
+        this.onVoxelizationCompleteObservable = new Observable();
+        /**
+         * World-space voxel grid size.
+         */
+        this.voxelGridSize = 1;
+        /**
+         * Voxel grid resolution exponent. Actual resolution is 2^resolutionExp.
+         */
+        this._resolutionExp = 6;
+        /**
+         * Enables tri-planar voxelization mode.
+         */
+        this.triPlanarVoxelization = true;
+        /**
+         * Indicates whether voxelization should be refreshed.
+         */
+        this.dirty = true;
+        this._refreshRate = -1;
+        /**
+         * World-to-voxel normalization matrix used by tracing.
+         */
+        this.worldScaleMatrix = Matrix.Identity();
+        this._voxelizationCompleteObserver = null;
+        this._frameCounter = 0;
+        this.outputVoxelGridTexture = this._frameGraph.textureManager.createDanglingHandle();
+    }
+    /**
+     * Gets the class name.
+     * @returns The class name.
+     */
+    getClassName() {
+        return "FrameGraphIblShadowsVoxelizationTask";
+    }
+    /**
+     * Checks whether the task has all required inputs.
+     * @returns True when ready.
+     */
+    isReady() {
+        return true;
+    }
+    /**
+     * Requests a voxelization update on the next eligible frame.
+     */
+    requestVoxelizationUpdate() {
+        this.dirty = true;
+    }
+    /**
+     * Recomputes voxel world bounds from the current object list and updates worldScaleMatrix.
+     */
+    updateSceneBounds() {
+        this._updateWorldScaleMatrix();
+    }
+    /**
+     * Records the voxelization passes.
+     */
+    record() {
+        if (this.objectList === undefined) {
+            throw new Error(`FrameGraphIblShadowsVoxelizationTask ${this.name}: objectList is required`);
+        }
+        this._ensureVoxelRenderer();
+        this._updateWorldScaleMatrix();
+        this._updateOutputTextureHandlesFromRenderer();
+        const voxelRT = this._voxelRenderer.getRT();
+        const voxelRTInternalTexture = voxelRT.getInternalTexture();
+        if (!voxelRTInternalTexture) {
+            throw new Error(`FrameGraphIblShadowsVoxelizationTask ${this.name}: voxel renderer RT texture is unavailable`);
+        }
+        this._voxelRTTextureHandle = this._frameGraph.textureManager.importTexture(`${this.name} Voxel RT`, voxelRTInternalTexture, this._voxelRTTextureHandle);
+        const pass = this._frameGraph.addRenderPass(this.name);
+        pass.setRenderTarget(this._voxelRTTextureHandle);
+        pass.addDependencies(this.outputVoxelGridTexture);
+        pass.setExecuteFunc((context) => {
+            context.restoreDefaultFramebuffer();
+            this._frameCounter++;
+            const shouldRefreshFromRate = this.refreshRate >= 0 && (this._frameCounter - 1) % (this.refreshRate + 1) === 0;
+            if (this._voxelRenderer.isVoxelizationInProgress()) {
+                this._voxelRenderer.processVoxelization();
+                return;
+            }
+            if (this.dirty || shouldRefreshFromRate) {
+                const meshes = this.objectList.meshes;
+                if (meshes.length === 0) {
+                    return;
+                }
+                this._ensureVoxelRenderer();
+                this._updateWorldScaleMatrix();
+                this._voxelRenderer.setWorldScaleMatrix(this.worldScaleMatrix);
+                this._voxelRenderer.updateVoxelGrid(meshes, false);
+                this.dirty = false;
+            }
+            if (this._voxelRenderer.isVoxelizationInProgress()) {
+                this._voxelRenderer.processVoxelization();
+            }
+        });
+    }
+    /**
+     * Disposes internal resources.
+     */
+    dispose() {
+        this._detachVoxelizationObserver();
+        this._voxelRenderer?.dispose();
+        this._voxelRenderer = undefined;
+        this.onVoxelizationCompleteObservable.clear();
+        super.dispose();
+    }
+    _ensureVoxelRenderer() {
+        const needsNewRenderer = !this._voxelRenderer || this._voxelRendererResolutionExp !== this.resolutionExp || this._voxelRendererTriPlanar !== this.triPlanarVoxelization;
+        if (!needsNewRenderer) {
+            return;
+        }
+        this._voxelRenderer?.dispose();
+        this._voxelRenderer = new _IblShadowsVoxelRenderer(this._frameGraph.scene, {}, this.resolutionExp, this.triPlanarVoxelization);
+        this._attachVoxelizationObserver();
+        this._voxelRendererResolutionExp = this.resolutionExp;
+        this._voxelRendererTriPlanar = this.triPlanarVoxelization;
+    }
+    _attachVoxelizationObserver() {
+        this._detachVoxelizationObserver();
+        if (!this._voxelRenderer) {
+            return;
+        }
+        this._voxelizationCompleteObserver = this._voxelRenderer.onVoxelizationCompleteObservable.add(() => {
+            this._updateOutputTextureHandlesFromRenderer();
+            this.onVoxelizationCompleteObservable.notifyObservers();
+        });
+    }
+    _detachVoxelizationObserver() {
+        if (this._voxelRenderer && this._voxelizationCompleteObserver) {
+            this._voxelRenderer.onVoxelizationCompleteObservable.remove(this._voxelizationCompleteObserver);
+        }
+        this._voxelizationCompleteObserver = null;
+    }
+    _updateWorldScaleMatrix() {
+        const meshes = this.objectList?.meshes;
+        if (!meshes || meshes.length === 0 || !isFinite(this.voxelGridSize) || this.voxelGridSize <= 0) {
+            this.worldScaleMatrix.copyFrom(Matrix.Identity());
+            return;
+        }
+        const bounds = {
+            min: new Vector3(Number.MAX_VALUE, Number.MAX_VALUE, Number.MAX_VALUE),
+            max: new Vector3(-Number.MAX_VALUE, -Number.MAX_VALUE, -Number.MAX_VALUE),
+        };
+        for (const mesh of meshes) {
+            const localBounds = mesh.getHierarchyBoundingVectors(true);
+            bounds.min = Vector3.Minimize(bounds.min, localBounds.min);
+            bounds.max = Vector3.Maximize(bounds.max, localBounds.max);
+        }
+        const size = bounds.max.subtract(bounds.min);
+        this.voxelGridSize = Math.max(size.x, size.y, size.z);
+        const halfSize = this.voxelGridSize / 2.0;
+        const centerOffset = bounds.max.add(bounds.min).multiplyByFloats(-0.5, -0.5, -0.5);
+        const invWorldScaleMatrix = Matrix.Compose(new Vector3(1.0 / halfSize, 1.0 / halfSize, 1.0 / halfSize), new Quaternion(), Vector3.Zero());
+        const invTranslationMatrix = Matrix.Compose(new Vector3(1.0, 1.0, 1.0), new Quaternion(), centerOffset);
+        invTranslationMatrix.multiplyToRef(invWorldScaleMatrix, this.worldScaleMatrix);
+    }
+    _updateOutputTextureHandlesFromRenderer() {
+        const voxelTexture = this._voxelRenderer.getVoxelGrid();
+        const voxelInternalTexture = voxelTexture.getInternalTexture();
+        if (!voxelInternalTexture) {
+            throw new Error(`FrameGraphIblShadowsVoxelizationTask ${this.name}: voxel renderer texture is unavailable`);
+        }
+        this._voxelGridTextureHandle = this._frameGraph.textureManager.importTexture(`${this.name} Voxel Grid`, voxelInternalTexture, this._voxelGridTextureHandle);
+        this._frameGraph.textureManager.resolveDanglingHandle(this.outputVoxelGridTexture, this._voxelGridTextureHandle);
+    }
+}
+//# sourceMappingURL=iblShadowsVoxelizationTask.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"iblShadowsVoxelizationTask.js","sourceRoot":"","sources":["../../../../../../../dev/core/src/FrameGraph/Tasks/Rendering/iblShadows/iblShadowsVoxelizationTask.ts"],"names":[],"mappings":"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","sourcesContent":["import { type FrameGraph, type FrameGraphObjectList, type FrameGraphTextureHandle, type Mesh, type Observer } from \"core/index\";\r\nimport { Matrix, Quaternion, Vector3 } from \"core/Maths/math.vector\";\r\nimport { Observable } from \"core/Misc/observable\";\r\nimport { _IblShadowsVoxelRenderer } from \"core/Rendering/IBLShadows/iblShadowsVoxelRenderer\";\r\nimport { FrameGraphTask } from \"../../../frameGraphTask\";\r\n\r\n/**\r\n * Task used to voxelize shadow casting objects for IBL shadows.\r\n * @internal\r\n */\r\nexport class FrameGraphIblShadowsVoxelizationTask extends FrameGraphTask {\r\n    /**\r\n     * Observable raised when voxelization completes.\r\n     */\r\n    public readonly onVoxelizationCompleteObservable = new Observable<void>();\r\n\r\n    /**\r\n     * Input object list containing the meshes to voxelize.\r\n     */\r\n    public objectList: FrameGraphObjectList;\r\n\r\n    /**\r\n     * World-space voxel grid size.\r\n     */\r\n    public voxelGridSize = 1;\r\n\r\n    /**\r\n     * Voxel grid resolution exponent. Actual resolution is 2^resolutionExp.\r\n     */\r\n    private _resolutionExp = 6;\r\n    /**\r\n     * Sets voxel grid resolution exponent. Actual resolution is 2^resolutionExp.\r\n     */\r\n    public set resolutionExp(value: number) {\r\n        const newValue = Math.round(Math.max(1, Math.min(value, 8)));\r\n        if (newValue === this._resolutionExp) {\r\n            return;\r\n        }\r\n        this._resolutionExp = newValue;\r\n        if (this._voxelRenderer) {\r\n            this._voxelRenderer.voxelResolutionExp = this._resolutionExp;\r\n        }\r\n        this.dirty = true;\r\n    }\r\n    /**\r\n     * Gets voxel grid resolution exponent. Actual resolution is 2^resolutionExp.\r\n     */\r\n    public get resolutionExp(): number {\r\n        return this._resolutionExp;\r\n    }\r\n\r\n    /**\r\n     * Enables tri-planar voxelization mode.\r\n     */\r\n    public triPlanarVoxelization = true;\r\n\r\n    /**\r\n     * Indicates whether voxelization should be refreshed.\r\n     */\r\n    public dirty = true;\r\n\r\n    private _refreshRate = -1;\r\n\r\n    /**\r\n     * Controls how often voxelization is refreshed.\r\n     * - -1: manual only (requires setting `dirty = true`)\r\n     * - 0: every frame\r\n     * - 1: skip 1 frame between updates\r\n     * - N: skip N frames between updates\r\n     */\r\n    public get refreshRate(): number {\r\n        return this._refreshRate;\r\n    }\r\n\r\n    public set refreshRate(value: number) {\r\n        this._refreshRate = Math.max(-1, Math.round(value));\r\n    }\r\n\r\n    /**\r\n     * World-to-voxel normalization matrix used by tracing.\r\n     */\r\n    public readonly worldScaleMatrix = Matrix.Identity();\r\n\r\n    /**\r\n     * Output voxel grid texture handle.\r\n     */\r\n    public readonly outputVoxelGridTexture: FrameGraphTextureHandle;\r\n\r\n    private _voxelRenderer?: _IblShadowsVoxelRenderer;\r\n    private _voxelRendererResolutionExp?: number;\r\n    private _voxelRendererTriPlanar?: boolean;\r\n    private _voxelizationCompleteObserver: Observer<void> | null = null;\r\n    private _voxelRTTextureHandle?: FrameGraphTextureHandle;\r\n    private _voxelGridTextureHandle?: FrameGraphTextureHandle;\r\n    private _frameCounter = 0;\r\n\r\n    /**\r\n     * Creates a new voxelization task.\r\n     * @param name The task name.\r\n     * @param frameGraph The frame graph this task belongs to.\r\n     */\r\n    constructor(name: string, frameGraph: FrameGraph) {\r\n        super(name, frameGraph);\r\n\r\n        this.outputVoxelGridTexture = this._frameGraph.textureManager.createDanglingHandle();\r\n    }\r\n\r\n    /**\r\n     * Gets the class name.\r\n     * @returns The class name.\r\n     */\r\n    public override getClassName(): string {\r\n        return \"FrameGraphIblShadowsVoxelizationTask\";\r\n    }\r\n\r\n    /**\r\n     * Checks whether the task has all required inputs.\r\n     * @returns True when ready.\r\n     */\r\n    public override isReady(): boolean {\r\n        return true;\r\n    }\r\n\r\n    /**\r\n     * Requests a voxelization update on the next eligible frame.\r\n     */\r\n    public requestVoxelizationUpdate(): void {\r\n        this.dirty = true;\r\n    }\r\n\r\n    /**\r\n     * Recomputes voxel world bounds from the current object list and updates worldScaleMatrix.\r\n     */\r\n    public updateSceneBounds(): void {\r\n        this._updateWorldScaleMatrix();\r\n    }\r\n\r\n    /**\r\n     * Records the voxelization passes.\r\n     */\r\n    public override record() {\r\n        if (this.objectList === undefined) {\r\n            throw new Error(`FrameGraphIblShadowsVoxelizationTask ${this.name}: objectList is required`);\r\n        }\r\n\r\n        this._ensureVoxelRenderer();\r\n        this._updateWorldScaleMatrix();\r\n\r\n        this._updateOutputTextureHandlesFromRenderer();\r\n\r\n        const voxelRT = this._voxelRenderer!.getRT();\r\n        const voxelRTInternalTexture = voxelRT.getInternalTexture();\r\n        if (!voxelRTInternalTexture) {\r\n            throw new Error(`FrameGraphIblShadowsVoxelizationTask ${this.name}: voxel renderer RT texture is unavailable`);\r\n        }\r\n        this._voxelRTTextureHandle = this._frameGraph.textureManager.importTexture(`${this.name} Voxel RT`, voxelRTInternalTexture, this._voxelRTTextureHandle);\r\n\r\n        const pass = this._frameGraph.addRenderPass(this.name);\r\n        pass.setRenderTarget(this._voxelRTTextureHandle);\r\n        pass.addDependencies(this.outputVoxelGridTexture);\r\n        pass.setExecuteFunc((context) => {\r\n            context.restoreDefaultFramebuffer();\r\n\r\n            this._frameCounter++;\r\n            const shouldRefreshFromRate = this.refreshRate >= 0 && (this._frameCounter - 1) % (this.refreshRate + 1) === 0;\r\n\r\n            if (this._voxelRenderer!.isVoxelizationInProgress()) {\r\n                this._voxelRenderer!.processVoxelization();\r\n                return;\r\n            }\r\n\r\n            if (this.dirty || shouldRefreshFromRate) {\r\n                const meshes = this.objectList!.meshes as Mesh[];\r\n                if (meshes.length === 0) {\r\n                    return;\r\n                }\r\n\r\n                this._ensureVoxelRenderer();\r\n                this._updateWorldScaleMatrix();\r\n                this._voxelRenderer!.setWorldScaleMatrix(this.worldScaleMatrix);\r\n                this._voxelRenderer!.updateVoxelGrid(meshes, false);\r\n                this.dirty = false;\r\n            }\r\n\r\n            if (this._voxelRenderer!.isVoxelizationInProgress()) {\r\n                this._voxelRenderer!.processVoxelization();\r\n            }\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Disposes internal resources.\r\n     */\r\n    public override dispose(): void {\r\n        this._detachVoxelizationObserver();\r\n        this._voxelRenderer?.dispose();\r\n        this._voxelRenderer = undefined;\r\n        this.onVoxelizationCompleteObservable.clear();\r\n        super.dispose();\r\n    }\r\n\r\n    private _ensureVoxelRenderer(): void {\r\n        const needsNewRenderer = !this._voxelRenderer || this._voxelRendererResolutionExp !== this.resolutionExp || this._voxelRendererTriPlanar !== this.triPlanarVoxelization;\r\n\r\n        if (!needsNewRenderer) {\r\n            return;\r\n        }\r\n\r\n        this._voxelRenderer?.dispose();\r\n        this._voxelRenderer = new _IblShadowsVoxelRenderer(this._frameGraph.scene, {} as never, this.resolutionExp, this.triPlanarVoxelization);\r\n        this._attachVoxelizationObserver();\r\n        this._voxelRendererResolutionExp = this.resolutionExp;\r\n        this._voxelRendererTriPlanar = this.triPlanarVoxelization;\r\n    }\r\n\r\n    private _attachVoxelizationObserver(): void {\r\n        this._detachVoxelizationObserver();\r\n\r\n        if (!this._voxelRenderer) {\r\n            return;\r\n        }\r\n\r\n        this._voxelizationCompleteObserver = this._voxelRenderer.onVoxelizationCompleteObservable.add(() => {\r\n            this._updateOutputTextureHandlesFromRenderer();\r\n            this.onVoxelizationCompleteObservable.notifyObservers();\r\n        });\r\n    }\r\n\r\n    private _detachVoxelizationObserver(): void {\r\n        if (this._voxelRenderer && this._voxelizationCompleteObserver) {\r\n            this._voxelRenderer.onVoxelizationCompleteObservable.remove(this._voxelizationCompleteObserver);\r\n        }\r\n\r\n        this._voxelizationCompleteObserver = null;\r\n    }\r\n\r\n    private _updateWorldScaleMatrix(): void {\r\n        const meshes = this.objectList?.meshes as Mesh[] | undefined;\r\n        if (!meshes || meshes.length === 0 || !isFinite(this.voxelGridSize) || this.voxelGridSize <= 0) {\r\n            this.worldScaleMatrix.copyFrom(Matrix.Identity());\r\n            return;\r\n        }\r\n\r\n        const bounds = {\r\n            min: new Vector3(Number.MAX_VALUE, Number.MAX_VALUE, Number.MAX_VALUE),\r\n            max: new Vector3(-Number.MAX_VALUE, -Number.MAX_VALUE, -Number.MAX_VALUE),\r\n        };\r\n\r\n        for (const mesh of meshes) {\r\n            const localBounds = mesh.getHierarchyBoundingVectors(true);\r\n            bounds.min = Vector3.Minimize(bounds.min, localBounds.min);\r\n            bounds.max = Vector3.Maximize(bounds.max, localBounds.max);\r\n        }\r\n\r\n        const size = bounds.max.subtract(bounds.min);\r\n        this.voxelGridSize = Math.max(size.x, size.y, size.z);\r\n\r\n        const halfSize = this.voxelGridSize / 2.0;\r\n        const centerOffset = bounds.max.add(bounds.min).multiplyByFloats(-0.5, -0.5, -0.5);\r\n        const invWorldScaleMatrix = Matrix.Compose(new Vector3(1.0 / halfSize, 1.0 / halfSize, 1.0 / halfSize), new Quaternion(), Vector3.Zero());\r\n        const invTranslationMatrix = Matrix.Compose(new Vector3(1.0, 1.0, 1.0), new Quaternion(), centerOffset);\r\n        invTranslationMatrix.multiplyToRef(invWorldScaleMatrix, this.worldScaleMatrix);\r\n    }\r\n\r\n    private _updateOutputTextureHandlesFromRenderer(): void {\r\n        const voxelTexture = this._voxelRenderer!.getVoxelGrid();\r\n        const voxelInternalTexture = voxelTexture.getInternalTexture();\r\n        if (!voxelInternalTexture) {\r\n            throw new Error(`FrameGraphIblShadowsVoxelizationTask ${this.name}: voxel renderer texture is unavailable`);\r\n        }\r\n\r\n        this._voxelGridTextureHandle = this._frameGraph.textureManager.importTexture(`${this.name} Voxel Grid`, voxelInternalTexture, this._voxelGridTextureHandle);\r\n        this._frameGraph.textureManager.resolveDanglingHandle(this.outputVoxelGridTexture, this._voxelGridTextureHandle);\r\n    }\r\n}\r\n"]}

package/FrameGraph/Tasks/Rendering/iblShadowsRendererTask.d.ts

@@ -0,0 +1,217 @@
+import { type Camera, type FrameGraph, type FrameGraphObjectList, type FrameGraphTextureHandle, type InternalTexture, type Mesh } from "../../../index.js";
+import { type Material } from "../../../Materials/material.js";
+import { Observable } from "../../../Misc/observable.js";
+import { FrameGraphTask } from "../../frameGraphTask.js";
+import "../../../Rendering/iblCdfGeneratorSceneComponent.js";
+/**
+ * Composite task that owns the individual IBL shadows frame graph tasks.
+ * The frame graph remains flat internally, but this task groups the pipeline
+ * and owns the child task implementation details.
+ */
+export declare class FrameGraphIblShadowsRendererTask extends FrameGraphTask {
+    /** Final frame-graph texture handle produced by the task. */
+    readonly outputTexture: FrameGraphTextureHandle;
+    private readonly _voxelizationTask;
+    private readonly _tracingTask;
+    private readonly _spatialBlurTask;
+    private readonly _accumulationTask;
+    private _dependenciesResolved;
+    private _shadowOpacity;
+    private readonly _materialsWithRenderPlugin;
+    private readonly _outputTextureReadyObservable;
+    private _lastNotifiedOutputTexture;
+    private _observedEnvironmentTexture;
+    private _observedEnvironmentTextureUnsubscribe;
+    private _lastImportedIcdfTexture;
+    private _lastImportedEnvironmentTexture;
+    private _lastImportedBlueNoiseTexture;
+    private readonly _blueNoiseTexture;
+    private _cameraViewChangedObserver;
+    private _cdfTextureChangedObserver;
+    private _cdfGeneratedObserver;
+    private _environmentTextureChangedObserver;
+    private _beforeRenderDependencyObserver;
+    private _beforeRenderOutputReadyObserver;
+    private _blueNoiseLoadObserver;
+    private _texturesAllocatedObserver;
+    private _voxelizationCompleteObserver;
+    /**
+     * Gets the class name.
+     * @returns The class name.
+     */
+    getClassName(): string;
+    get name(): string;
+    set name(value: string);
+    /**
+     * Whether the task is disabled.
+     */
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    /** Camera used by the tracing stage. */
+    get camera(): Camera;
+    /** Camera used by the tracing stage. */
+    set camera(value: Camera);
+    /** Object list used by voxelization. */
+    get objectList(): FrameGraphObjectList;
+    /** Object list used by voxelization. */
+    set objectList(value: FrameGraphObjectList);
+    /**
+     * Depth texture handle used by tracing and blur.
+     * This should be the screen-space depth of all objects in the scene
+     * that will receive shadows.
+     * It is important that this texture stores 32-bit depth values to avoid artifacts.
+     */
+    depthTexture: FrameGraphTextureHandle;
+    /**
+     * World-space normal texture handle used by tracing and blur.
+     * This should store the world-space normals of all objects in the scene
+     * that will receive shadows. Each component should be normalized to [0, 1] rather than [-1, 1].
+     * Recommended to be 16-bit floating point though 8-bit unsigned byte can be used with minimal
+     * loss in quality.
+     */
+    normalTexture: FrameGraphTextureHandle;
+    /**
+     * Position texture handle used by accumulation.
+     * This should store the world-space position of all objects in the scene
+     * that will receive shadows.
+     * Should be stored as 16-bit floating point.
+     */
+    positionTexture: FrameGraphTextureHandle;
+    /**
+     * Velocity texture handle used by accumulation.
+     * This should store the linear velocity per pixel of all objects in the scene
+     * that will receive shadows.
+     * Should be stored as 16-bit floating point.
+     */
+    velocityTexture: FrameGraphTextureHandle;
+    /** Number of tracing sample directions. */
+    get sampleDirections(): number;
+    /** Number of tracing sample directions. */
+    set sampleDirections(value: number);
+    /** Whether traced shadows preserve environment color. */
+    get coloredShadows(): boolean;
+    /** Whether traced shadows preserve environment color. */
+    set coloredShadows(value: boolean);
+    /** Opacity of voxel-traced shadows. */
+    get voxelShadowOpacity(): number;
+    /** Opacity of voxel-traced shadows. */
+    set voxelShadowOpacity(value: number);
+    /** Opacity of screen-space shadows. */
+    get ssShadowOpacity(): number;
+    /** Opacity of screen-space shadows. */
+    set ssShadowOpacity(value: number);
+    /** Number of screen-space shadow samples. */
+    get ssShadowSampleCount(): number;
+    /** Number of screen-space shadow samples. */
+    set ssShadowSampleCount(value: number);
+    /** Stride used by screen-space shadow sampling. */
+    get ssShadowStride(): number;
+    /** Stride used by screen-space shadow sampling. */
+    set ssShadowStride(value: number);
+    /** Distance scale used by screen-space shadow tracing. */
+    get ssShadowDistanceScale(): number;
+    /** Distance scale used by screen-space shadow tracing. */
+    set ssShadowDistanceScale(value: number);
+    /** Thickness scale used by screen-space shadow tracing. */
+    get ssShadowThicknessScale(): number;
+    /** Thickness scale used by screen-space shadow tracing. */
+    set ssShadowThicknessScale(value: number);
+    /** Voxel tracing normal bias. */
+    get voxelNormalBias(): number;
+    /** Voxel tracing normal bias. */
+    set voxelNormalBias(value: number);
+    /** Voxel tracing direction bias. */
+    get voxelDirectionBias(): number;
+    /** Voxel tracing direction bias. */
+    set voxelDirectionBias(value: number);
+    /** Environment rotation in radians. */
+    get envRotation(): number;
+    /** Environment rotation in radians. */
+    set envRotation(value: number);
+    /** Temporal shadow remanence while moving. */
+    get shadowRemanence(): number;
+    /** Temporal shadow remanence while moving. */
+    set shadowRemanence(value: number);
+    /** Final material shadow opacity. */
+    get shadowOpacity(): number;
+    /** Final material shadow opacity. */
+    set shadowOpacity(value: number);
+    /** Voxelization resolution exponent. */
+    get resolutionExp(): number;
+    /** Voxelization resolution exponent. */
+    set resolutionExp(value: number);
+    /** Voxelization refresh rate. */
+    get refreshRate(): number;
+    /** Voxelization refresh rate. */
+    set refreshRate(value: number);
+    /** Whether tri-planar voxelization is used. */
+    get triPlanarVoxelization(): boolean;
+    /** Whether tri-planar voxelization is used. */
+    set triPlanarVoxelization(value: boolean);
+    /** Current world-space voxel grid size. */
+    get voxelGridSize(): number;
+    /** True when the accumulated output texture is ready. */
+    get outputTextureReady(): boolean;
+    /** Notifies when the accumulated output texture becomes ready. */
+    get onOutputTextureReadyObservable(): Observable<InternalTexture>;
+    /** Triggers a voxelization refresh on the next eligible frame. */
+    updateVoxelization(): void;
+    /** Recomputes the voxelization scene bounds from the current object list. */
+    updateSceneBounds(): void;
+    /** Resets temporal accumulation. */
+    resetAccumulation(): void;
+    /**
+     * Adds one or more materials that should receive IBL shadows.
+     * @param material The material or materials to register. If omitted, all scene materials are added.
+     */
+    addShadowReceivingMaterial(material?: Material | Material[]): void;
+    /**
+     * Removes one or more materials from IBL shadow reception.
+     * @param material The material or materials to unregister.
+     */
+    removeShadowReceivingMaterial(material: Material | Material[]): void;
+    /** Clears all registered shadow-receiving materials. */
+    clearShadowReceivingMaterials(): void;
+    /**
+     * Adds one or more meshes to the voxelization object list.
+     * @param mesh The mesh or meshes to add.
+     */
+    addShadowCastingMesh(mesh: Mesh | Mesh[]): void;
+    /**
+     * Removes one or more meshes from the voxelization object list.
+     * @param mesh The mesh or meshes to remove.
+     */
+    removeShadowCastingMesh(mesh: Mesh | Mesh[]): void;
+    /** Clears all shadow-casting meshes from the voxelization object list. */
+    clearShadowCastingMeshes(): void;
+    private _initAsyncCancel;
+    initAsync(): Promise<unknown>;
+    isReady(): boolean;
+    /**
+     * Records the parent task.
+     * Child tasks record the actual passes.
+     */
+    record(): void;
+    /**
+     * Disposes the task and owned resources.
+     */
+    dispose(): void;
+    /**
+     * Creates a new IBL shadows composite task.
+     * @param name The task name.
+     * @param frameGraph The owning frame graph.
+     */
+    constructor(name: string, frameGraph: FrameGraph);
+    private _disposeDependencyObservers;
+    private _disposeObservers;
+    private _setCamera;
+    private _observeEnvironmentTexture;
+    private _getEnvironmentTextureInternal;
+    private _getAccumulationOutputTexture;
+    private _notifyIfOutputTextureReady;
+    private _applyMaterialPluginParameters;
+    private _addShadowReceivingMaterialInternal;
+    private readonly _onEnvironmentTextureLoaded;
+    private _tryEnableShadowsTasks;
+    private _initialize;
+}