@onerjs/core 8.48.4 → 8.48.6

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;
+}

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"]}