@babylonjs/core 8.40.1 → 8.41.1

package/FrameGraph/Tasks/PostProcesses/volumetricLightingTask.d.ts

@@ -2,10 +2,6 @@ import type { Camera, DirectionalLight, FrameGraph, FrameGraphObjectList, FrameG
 import { Vector3 } from "../../../Maths/math.vector.js";
 import { Color3 } from "../../../Maths/math.color.js";
 import { FrameGraphTask } from "../../frameGraphTask.js";
-import "../../../Shaders/volumetricLightingRenderVolume.vertex.js";
-import "../../../Shaders/volumetricLightingRenderVolume.fragment.js";
-import "../../../ShadersWGSL/volumetricLightingRenderVolume.vertex.js";
-import "../../../ShadersWGSL/volumetricLightingRenderVolume.fragment.js";
 /**
  * A frame graph task that performs volumetric lighting.
  */
@@ -86,6 +82,7 @@ export declare class FrameGraphVolumetricLightingTask extends FrameGraphTask {
      * @param enableExtinction Whether to enable extinction in the volumetric lighting effect (default: false). If you don't plan to set extinction to something different than (0, 0, 0), you can disable this to save some performance.
      */
     constructor(name: string, frameGraph: FrameGraph, enableExtinction?: boolean);
+    initAsync(): Promise<unknown>;
     isReady(): boolean;
     getClassName(): string;
     record(skipCreationOfDisabledPasses?: boolean): void;

package/FrameGraph/Tasks/PostProcesses/volumetricLightingTask.js

@@ -6,10 +6,6 @@ import { FrameGraphTask } from "../../frameGraphTask.js";
 import { FrameGraphClearTextureTask } from "../Texture/clearTextureTask.js";
 import { FrameGraphObjectRendererTask } from "../Rendering/objectRendererTask.js";
 import { ShaderMaterial } from "../../../Materials/shaderMaterial.js";
-import "../../../Shaders/volumetricLightingRenderVolume.vertex.js";
-import "../../../Shaders/volumetricLightingRenderVolume.fragment.js";
-import "../../../ShadersWGSL/volumetricLightingRenderVolume.vertex.js";
-import "../../../ShadersWGSL/volumetricLightingRenderVolume.fragment.js";
 const InvViewProjectionMatrix = new Matrix();
 /**
  * A frame graph task that performs volumetric lighting.
@@ -113,6 +109,13 @@ export class FrameGraphVolumetricLightingTask extends FrameGraphTask {
         this.extinction = new Vector3(this.extinction.x, this.extinction.y, this.extinction.z);
         this.lightPower = this._lightPower;
     }
+    // eslint-disable-next-line @typescript-eslint/promise-function-async, no-restricted-syntax
+    initAsync() {
+        if (this._frameGraph.engine.isWebGPU) {
+            return Promise.all([import("../../../ShadersWGSL/volumetricLightingRenderVolume.vertex.js"), import("../../../ShadersWGSL/volumetricLightingRenderVolume.fragment.js")]);
+        }
+        return Promise.all([import("../../../Shaders/volumetricLightingRenderVolume.vertex.js"), import("../../../Shaders/volumetricLightingRenderVolume.fragment.js")]);
+    }
     isReady() {
         return (this._renderLightingVolumeMaterial.isReady() &&
             this._clearLightingVolumeTextureTask.isReady() &&

package/FrameGraph/Tasks/PostProcesses/volumetricLightingTask.js.map

@@ -1 +1 @@
-{"version":3,"file":"volumetricLightingTask.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FrameGraph/Tasks/PostProcesses/volumetricLightingTask.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Camera, DirectionalLight, FrameGraph, FrameGraphObjectList, FrameGraphTextureHandle } from \"core/index\";\r\nimport { FrameGraphVolumetricLightingBlendVolumeTask } from \"./volumetricLightingBlendVolumeTask\";\r\nimport { Matrix, TmpVectors, Vector2, Vector3, Vector4 } from \"core/Maths/math.vector\";\r\nimport { Color3, Color4 } from \"core/Maths/math.color\";\r\nimport { FrameGraphTask } from \"../../frameGraphTask\";\r\nimport { Constants } from \"core/Engines/constants\";\r\nimport { FrameGraphClearTextureTask } from \"../Texture/clearTextureTask\";\r\nimport { FrameGraphObjectRendererTask } from \"../Rendering/objectRendererTask\";\r\nimport { ShaderMaterial } from \"core/Materials/shaderMaterial\";\r\nimport { ShaderLanguage } from \"core/Materials/shaderLanguage\";\r\n\r\nimport \"core/Shaders/volumetricLightingRenderVolume.vertex\";\r\nimport \"core/Shaders/volumetricLightingRenderVolume.fragment\";\r\nimport \"core/ShadersWGSL/volumetricLightingRenderVolume.vertex\";\r\nimport \"core/ShadersWGSL/volumetricLightingRenderVolume.fragment\";\r\n\r\nconst InvViewProjectionMatrix = new Matrix();\r\n\r\n/**\r\n * A frame graph task that performs volumetric lighting.\r\n */\r\nexport class FrameGraphVolumetricLightingTask extends FrameGraphTask {\r\n    /**\r\n     * The target texture to which the volumetric lighting will be applied.\r\n     */\r\n    public targetTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * The sampling mode to use when blending the volumetric lighting texture with targetTexture.\r\n     */\r\n    public sourceSamplingMode = Constants.TEXTURE_BILINEAR_SAMPLINGMODE;\r\n\r\n    /**\r\n     * The depth texture used for volumetric lighting calculations.\r\n     * It must be the depth texture used to generate targetTexture.\r\n     */\r\n    public depthTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * The camera used for volumetric lighting calculations.\r\n     */\r\n    public camera: Camera;\r\n\r\n    /**\r\n     * The mesh representing the lighting volume.\r\n     * This is the mesh that will be rendered to create the volumetric lighting effect.\r\n     */\r\n    public lightingVolumeMesh: FrameGraphObjectList;\r\n\r\n    /**\r\n     * The directional light used for volumetric lighting.\r\n     */\r\n    public light: DirectionalLight;\r\n\r\n    /**\r\n     * The lighting volume texture (optional).\r\n     * If not provided, a new texture will be created, which the same size, format and type as targetTexture.\r\n     * This is the texture that will store the volumetric lighting information, before being blended to targetTexture.\r\n     */\r\n    public lightingVolumeTexture?: FrameGraphTextureHandle;\r\n\r\n    private _extinctionPhaseG = new Vector4(0, 0, 0, 0);\r\n\r\n    /**\r\n     * The phase G parameter for the volumetric lighting effect (default: 0).\r\n     * This parameter controls the anisotropy of the scattering.\r\n     * A value of 0 means isotropic scattering, while a value of 1 means forward scattering and -1 means backward scattering.\r\n     */\r\n    public get phaseG() {\r\n        return this._extinctionPhaseG.w;\r\n    }\r\n\r\n    public set phaseG(value: number) {\r\n        this._extinctionPhaseG.w = value;\r\n        this._renderLightingVolumeMaterial.setVector4(\"extinctionPhaseG\", this._extinctionPhaseG);\r\n    }\r\n\r\n    /**\r\n     * Whether to enable extinction in the volumetric lighting effect (default: false).\r\n     * Read-only property set in the constructor.\r\n     */\r\n    public readonly enableExtinction: boolean;\r\n\r\n    /**\r\n     * The extinction coefficient for the volumetric lighting effect (default: (0, 0, 0) - no extinction).\r\n     * This parameter controls how much light is absorbed and scattered as it travels through the medium.\r\n     * Will only have an effect if enableExtinction is set to true in the constructor!\r\n     */\r\n    public get extinction() {\r\n        return this._blendLightingVolumeTask.postProcess.extinction;\r\n    }\r\n\r\n    public set extinction(value: Vector3) {\r\n        this._extinctionPhaseG.x = Math.max(value.x, 1e-6);\r\n        this._extinctionPhaseG.y = Math.max(value.y, 1e-6);\r\n        this._extinctionPhaseG.z = Math.max(value.z, 1e-6);\r\n        this._renderLightingVolumeMaterial.setVector4(\"extinctionPhaseG\", this._extinctionPhaseG);\r\n        this._blendLightingVolumeTask.postProcess.extinction.copyFromFloats(this._extinctionPhaseG.x, this._extinctionPhaseG.y, this._extinctionPhaseG.z);\r\n    }\r\n\r\n    private _lightPower = new Color3(1, 1, 1);\r\n\r\n    /**\r\n     * The light power/color for the volumetric lighting effect (default: (1, 1, 1)).\r\n     * This parameter controls the intensity and color of the light used for volumetric lighting.\r\n     */\r\n    public get lightPower() {\r\n        return this._lightPower;\r\n    }\r\n\r\n    public set lightPower(value: Color3) {\r\n        this._lightPower.copyFrom(value);\r\n        this._renderLightingVolumeMaterial.setColor3(\"lightPower\", this._lightPower);\r\n    }\r\n\r\n    public override get name() {\r\n        return this._name;\r\n    }\r\n\r\n    public override set name(name: string) {\r\n        this._name = name;\r\n        if (this._renderLightingVolumeMaterial) {\r\n            this._renderLightingVolumeMaterial.name = `${name} - render lighting volume`;\r\n        }\r\n        if (this._clearLightingVolumeTextureTask) {\r\n            this._clearLightingVolumeTextureTask.name = `${name} - clear lighting volume texture`;\r\n        }\r\n        if (this._renderLightingVolumeTask) {\r\n            this._renderLightingVolumeTask.name = `${name} - render lighting volume`;\r\n        }\r\n        if (this._blendLightingVolumeTask) {\r\n            this._blendLightingVolumeTask.name = `${name} - blend lighting volume`;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * The output texture of the task. It will be the same as targetTexture.\r\n     */\r\n    public readonly outputTexture: FrameGraphTextureHandle;\r\n\r\n    private readonly _clearLightingVolumeTextureTask: FrameGraphClearTextureTask;\r\n    private readonly _renderLightingVolumeTask: FrameGraphObjectRendererTask;\r\n    private readonly _blendLightingVolumeTask: FrameGraphVolumetricLightingBlendVolumeTask;\r\n    private _renderLightingVolumeMaterial: ShaderMaterial;\r\n\r\n    /**\r\n     * Creates a new FrameGraphVolumetricLightingTask.\r\n     * @param name The name of the task.\r\n     * @param frameGraph The frame graph to which the task belongs.\r\n     * @param enableExtinction Whether to enable extinction in the volumetric lighting effect (default: false). If you don't plan to set extinction to something different than (0, 0, 0), you can disable this to save some performance.\r\n     */\r\n    constructor(name: string, frameGraph: FrameGraph, enableExtinction = false) {\r\n        super(name, frameGraph);\r\n\r\n        this.enableExtinction = enableExtinction;\r\n\r\n        const isWebGPU = this._frameGraph.engine.isWebGPU;\r\n\r\n        this._renderLightingVolumeMaterial = new ShaderMaterial(`${name} - render lighting volume`, this._frameGraph.scene, \"volumetricLightingRenderVolume\", {\r\n            attributes: [\"position\"],\r\n            uniformBuffers: [\"Scene\", \"Mesh\"],\r\n            uniforms: [\"world\", \"viewProjection\", \"vEyePosition\", \"lightDir\", \"invViewProjection\", \"outputTextureSize\", \"extinctionPhaseG\", \"lightPower\", \"textureRatio\"],\r\n            samplers: [\"depthTexture\"],\r\n            defines: enableExtinction ? [\"USE_EXTINCTION\"] : [],\r\n            shaderLanguage: isWebGPU ? ShaderLanguage.WGSL : ShaderLanguage.GLSL,\r\n            needAlphaBlending: true,\r\n        });\r\n        this._renderLightingVolumeMaterial.backFaceCulling = false;\r\n        this._renderLightingVolumeMaterial.alphaMode = Constants.ALPHA_ADD;\r\n        this._renderLightingVolumeMaterial.onBindObservable.add(() => {\r\n            this._renderLightingVolumeMaterial.bindEyePosition(this._renderLightingVolumeMaterial.getEffect());\r\n        });\r\n\r\n        this._clearLightingVolumeTextureTask = new FrameGraphClearTextureTask(`clear lighting volume texture`, frameGraph);\r\n        this._renderLightingVolumeTask = new FrameGraphObjectRendererTask(`render lighting volume`, frameGraph, frameGraph.scene);\r\n        this._blendLightingVolumeTask = new FrameGraphVolumetricLightingBlendVolumeTask(`blend lighting volume texture`, frameGraph, enableExtinction);\r\n\r\n        this.onTexturesAllocatedObservable.add(() => {\r\n            this._renderLightingVolumeMaterial.setInternalTexture(\"depthTexture\", frameGraph.textureManager.getTextureFromHandle(this.depthTexture)!);\r\n        });\r\n\r\n        this.outputTexture = this._frameGraph.textureManager.createDanglingHandle();\r\n\r\n        // Triggers the setters to set the uniforms\r\n        this.phaseG = this._extinctionPhaseG.w;\r\n        this.extinction = new Vector3(this.extinction.x, this.extinction.y, this.extinction.z);\r\n        this.lightPower = this._lightPower;\r\n    }\r\n\r\n    public override isReady() {\r\n        return (\r\n            this._renderLightingVolumeMaterial.isReady() &&\r\n            this._clearLightingVolumeTextureTask.isReady() &&\r\n            this._renderLightingVolumeMaterial.isReady() &&\r\n            this._blendLightingVolumeTask.isReady()\r\n        );\r\n    }\r\n\r\n    public override getClassName(): string {\r\n        return \"FrameGraphVolumetricLightingTask\";\r\n    }\r\n\r\n    public override record(skipCreationOfDisabledPasses = false) {\r\n        if (this.targetTexture === undefined || this.depthTexture === undefined || this.camera === undefined || this.lightingVolumeMesh === undefined || this.light === undefined) {\r\n            throw new Error(`FrameGraphVolumetricLightingTask \"${this.name}\": targetTexture, depthTexture, camera, lightingVolumeMesh and light are required`);\r\n        }\r\n        if (!this.lightingVolumeMesh.meshes || this.lightingVolumeMesh.meshes.length === 0) {\r\n            throw new Error(`FrameGraphVolumetricLightingTask \"${this.name}\": lightingVolumeMesh is empty`);\r\n        }\r\n\r\n        this._frameGraph.textureManager.resolveDanglingHandle(this.outputTexture, this.targetTexture);\r\n\r\n        const textureManager = this._frameGraph.textureManager;\r\n\r\n        let lightingVolumeTexture = this.lightingVolumeTexture;\r\n        if (!lightingVolumeTexture) {\r\n            const targetTextureCreationOptions = textureManager.getTextureCreationOptions(this.targetTexture);\r\n\r\n            targetTextureCreationOptions.options.labels = [\"InScattering\"];\r\n            targetTextureCreationOptions.options.samples = 1;\r\n\r\n            lightingVolumeTexture = textureManager.createRenderTargetTexture(`${this.name} - lighting volume texture`, targetTextureCreationOptions);\r\n        }\r\n\r\n        this.lightingVolumeMesh.meshes[0].material = this._renderLightingVolumeMaterial;\r\n\r\n        const targetTextureSize = textureManager.getTextureAbsoluteDimensions(this.targetTexture);\r\n        const volumeTextureSize = textureManager.getTextureAbsoluteDimensions(lightingVolumeTexture);\r\n\r\n        this._renderLightingVolumeMaterial.setVector2(\r\n            \"textureRatio\",\r\n            new Vector2(targetTextureSize.width / volumeTextureSize.width, targetTextureSize.height / volumeTextureSize.height)\r\n        );\r\n        this._renderLightingVolumeMaterial.setVector2(\"outputTextureSize\", new Vector2(volumeTextureSize.width, volumeTextureSize.height));\r\n\r\n        const passUpdateMaterial = this._frameGraph.addPass(this.name);\r\n\r\n        passUpdateMaterial.setExecuteFunc(() => {\r\n            this.camera.getTransformationMatrix().invertToRef(InvViewProjectionMatrix);\r\n\r\n            this._renderLightingVolumeMaterial.setMatrix(\"invViewProjection\", InvViewProjectionMatrix);\r\n            this._renderLightingVolumeMaterial.setVector3(\"lightDir\", this.light.direction.normalizeToRef(TmpVectors.Vector3[0]));\r\n        });\r\n\r\n        this._clearLightingVolumeTextureTask.clearColor = true;\r\n        this._clearLightingVolumeTextureTask.clearStencil = this.enableExtinction;\r\n        this._clearLightingVolumeTextureTask.color = new Color4(0, 0, 0, 1);\r\n        this._clearLightingVolumeTextureTask.stencilValue = 0;\r\n        this._clearLightingVolumeTextureTask.targetTexture = lightingVolumeTexture;\r\n        this._clearLightingVolumeTextureTask.record(true);\r\n\r\n        this._renderLightingVolumeTask.targetTexture = this._clearLightingVolumeTextureTask.outputTexture;\r\n        this._renderLightingVolumeTask.objectList = this.lightingVolumeMesh;\r\n        this._renderLightingVolumeTask.camera = this.camera;\r\n        this._renderLightingVolumeTask.disableImageProcessing = true;\r\n        this._renderLightingVolumeTask.depthTest = false;\r\n        this._renderLightingVolumeTask.record(true);\r\n\r\n        this._blendLightingVolumeTask.sourceTexture = this._renderLightingVolumeTask.outputTexture;\r\n        this._blendLightingVolumeTask.sourceSamplingMode = this.sourceSamplingMode;\r\n        this._blendLightingVolumeTask.targetTexture = this.targetTexture;\r\n        this._blendLightingVolumeTask.depthTexture = this.depthTexture;\r\n        this._blendLightingVolumeTask.camera = this.camera;\r\n        this._blendLightingVolumeTask.record(true);\r\n\r\n        if (!skipCreationOfDisabledPasses) {\r\n            const disabledPass = this._frameGraph.addPass(this.name + \"_disabled\", true);\r\n\r\n            disabledPass.setExecuteFunc(() => {});\r\n        }\r\n    }\r\n\r\n    public override dispose() {\r\n        this._renderLightingVolumeMaterial?.dispose();\r\n        this._clearLightingVolumeTextureTask.dispose();\r\n        this._renderLightingVolumeTask.dispose();\r\n        this._blendLightingVolumeTask.dispose();\r\n        super.dispose();\r\n    }\r\n}\r\n"]}
+{"version":3,"file":"volumetricLightingTask.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FrameGraph/Tasks/PostProcesses/volumetricLightingTask.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2CAA2C,EAAE,MAAM,qCAAqC,CAAC;AAClG,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,sCAA+B;AACvF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,qCAA8B;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,sCAA+B;AACnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,6CAAsC;AAG/D,MAAM,uBAAuB,GAAG,IAAI,MAAM,EAAE,CAAC;AAE7C;;GAEG;AACH,MAAM,OAAO,gCAAiC,SAAQ,cAAc;IA0ChE;;;;OAIG;IACH,IAAW,MAAM;QACb,OAAO,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,IAAW,MAAM,CAAC,KAAa;QAC3B,IAAI,CAAC,iBAAiB,CAAC,CAAC,GAAG,KAAK,CAAC;QACjC,IAAI,CAAC,6BAA6B,CAAC,UAAU,CAAC,kBAAkB,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC9F,CAAC;IAQD;;;;OAIG;IACH,IAAW,UAAU;QACjB,OAAO,IAAI,CAAC,wBAAwB,CAAC,WAAW,CAAC,UAAU,CAAC;IAChE,CAAC;IAED,IAAW,UAAU,CAAC,KAAc;QAChC,IAAI,CAAC,iBAAiB,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,iBAAiB,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,iBAAiB,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,6BAA6B,CAAC,UAAU,CAAC,kBAAkB,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC1F,IAAI,CAAC,wBAAwB,CAAC,WAAW,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IACtJ,CAAC;IAID;;;OAGG;IACH,IAAW,UAAU;QACjB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED,IAAW,UAAU,CAAC,KAAa;QAC/B,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,6BAA6B,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACjF,CAAC;IAED,IAAoB,IAAI;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,IAAoB,IAAI,CAAC,IAAY;QACjC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,IAAI,CAAC,6BAA6B,EAAE,CAAC;YACrC,IAAI,CAAC,6BAA6B,CAAC,IAAI,GAAG,GAAG,IAAI,2BAA2B,CAAC;QACjF,CAAC;QACD,IAAI,IAAI,CAAC,+BAA+B,EAAE,CAAC;YACvC,IAAI,CAAC,+BAA+B,CAAC,IAAI,GAAG,GAAG,IAAI,kCAAkC,CAAC;QAC1F,CAAC;QACD,IAAI,IAAI,CAAC,yBAAyB,EAAE,CAAC;YACjC,IAAI,CAAC,yBAAyB,CAAC,IAAI,GAAG,GAAG,IAAI,2BAA2B,CAAC;QAC7E,CAAC;QACD,IAAI,IAAI,CAAC,wBAAwB,EAAE,CAAC;YAChC,IAAI,CAAC,wBAAwB,CAAC,IAAI,GAAG,GAAG,IAAI,0BAA0B,CAAC;QAC3E,CAAC;IACL,CAAC;IAYD;;;;;OAKG;IACH,YAAY,IAAY,EAAE,UAAsB,EAAE,gBAAgB,GAAG,KAAK;QACtE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QA7H5B;;WAEG;QACI,uBAAkB,GAAG,SAAS,CAAC,6BAA6B,CAAC;QA+B5D,sBAAiB,GAAG,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAuC5C,gBAAW,GAAG,IAAI,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAsDtC,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QAEzC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC;QAElD,IAAI,CAAC,6BAA6B,GAAG,IAAI,cAAc,CAAC,GAAG,IAAI,2BAA2B,EAAE,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,gCAAgC,EAAE;YAClJ,UAAU,EAAE,CAAC,UAAU,CAAC;YACxB,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;YACjC,QAAQ,EAAE,CAAC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,YAAY,EAAE,cAAc,CAAC;YAC7J,QAAQ,EAAE,CAAC,cAAc,CAAC;YAC1B,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE;YACnD,cAAc,EAAE,QAAQ,CAAC,CAAC,6BAAqB,CAAC,4BAAoB;YACpE,iBAAiB,EAAE,IAAI;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,6BAA6B,CAAC,eAAe,GAAG,KAAK,CAAC;QAC3D,IAAI,CAAC,6BAA6B,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;QACnE,IAAI,CAAC,6BAA6B,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE;YACzD,IAAI,CAAC,6BAA6B,CAAC,eAAe,CAAC,IAAI,CAAC,6BAA6B,CAAC,SAAS,EAAE,CAAC,CAAC;QACvG,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,+BAA+B,GAAG,IAAI,0BAA0B,CAAC,+BAA+B,EAAE,UAAU,CAAC,CAAC;QACnH,IAAI,CAAC,yBAAyB,GAAG,IAAI,4BAA4B,CAAC,wBAAwB,EAAE,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;QAC1H,IAAI,CAAC,wBAAwB,GAAG,IAAI,2CAA2C,CAAC,+BAA+B,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC;QAE/I,IAAI,CAAC,6BAA6B,CAAC,GAAG,CAAC,GAAG,EAAE;YACxC,IAAI,CAAC,6BAA6B,CAAC,kBAAkB,CAAC,cAAc,EAAE,UAAU,CAAC,cAAc,CAAC,oBAAoB,CAAC,IAAI,CAAC,YAAY,CAAE,CAAC,CAAC;QAC9I,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,oBAAoB,EAAE,CAAC;QAE5E,2CAA2C;QAC3C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACvF,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC;IACvC,CAAC;IAED,2FAA2F;IAC3E,SAAS;QACrB,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACnC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,4DAA4D,CAAC,EAAE,MAAM,CAAC,8DAA8D,CAAC,CAAC,CAAC,CAAC;QACvK,CAAC;QAED,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,wDAAwD,CAAC,EAAE,MAAM,CAAC,0DAA0D,CAAC,CAAC,CAAC,CAAC;IAC/J,CAAC;IAEe,OAAO;QACnB,OAAO,CACH,IAAI,CAAC,6BAA6B,CAAC,OAAO,EAAE;YAC5C,IAAI,CAAC,+BAA+B,CAAC,OAAO,EAAE;YAC9C,IAAI,CAAC,6BAA6B,CAAC,OAAO,EAAE;YAC5C,IAAI,CAAC,wBAAwB,CAAC,OAAO,EAAE,CAC1C,CAAC;IACN,CAAC;IAEe,YAAY;QACxB,OAAO,kCAAkC,CAAC;IAC9C,CAAC;IAEe,MAAM,CAAC,4BAA4B,GAAG,KAAK;QACvD,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,kBAAkB,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACxK,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,CAAC,IAAI,mFAAmF,CAAC,CAAC;QACvJ,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjF,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,CAAC,IAAI,gCAAgC,CAAC,CAAC;QACpG,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,qBAAqB,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QAE9F,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC;QAEvD,IAAI,qBAAqB,GAAG,IAAI,CAAC,qBAAqB,CAAC;QACvD,IAAI,CAAC,qBAAqB,EAAE,CAAC;YACzB,MAAM,4BAA4B,GAAG,cAAc,CAAC,yBAAyB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAElG,4BAA4B,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,cAAc,CAAC,CAAC;YAC/D,4BAA4B,CAAC,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC;YAEjD,qBAAqB,GAAG,cAAc,CAAC,yBAAyB,CAAC,GAAG,IAAI,CAAC,IAAI,4BAA4B,EAAE,4BAA4B,CAAC,CAAC;QAC7I,CAAC;QAED,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,6BAA6B,CAAC;QAEhF,MAAM,iBAAiB,GAAG,cAAc,CAAC,4BAA4B,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC1F,MAAM,iBAAiB,GAAG,cAAc,CAAC,4BAA4B,CAAC,qBAAqB,CAAC,CAAC;QAE7F,IAAI,CAAC,6BAA6B,CAAC,UAAU,CACzC,cAAc,EACd,IAAI,OAAO,CAAC,iBAAiB,CAAC,KAAK,GAAG,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,CAAC,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,CACtH,CAAC;QACF,IAAI,CAAC,6BAA6B,CAAC,UAAU,CAAC,mBAAmB,EAAE,IAAI,OAAO,CAAC,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;QAEnI,MAAM,kBAAkB,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE/D,kBAAkB,CAAC,cAAc,CAAC,GAAG,EAAE;YACnC,IAAI,CAAC,MAAM,CAAC,uBAAuB,EAAE,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC;YAE3E,IAAI,CAAC,6BAA6B,CAAC,SAAS,CAAC,mBAAmB,EAAE,uBAAuB,CAAC,CAAC;YAC3F,IAAI,CAAC,6BAA6B,CAAC,UAAU,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,cAAc,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1H,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,+BAA+B,CAAC,UAAU,GAAG,IAAI,CAAC;QACvD,IAAI,CAAC,+BAA+B,CAAC,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAC1E,IAAI,CAAC,+BAA+B,CAAC,KAAK,GAAG,IAAI,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACpE,IAAI,CAAC,+BAA+B,CAAC,YAAY,GAAG,CAAC,CAAC;QACtD,IAAI,CAAC,+BAA+B,CAAC,aAAa,GAAG,qBAAqB,CAAC;QAC3E,IAAI,CAAC,+BAA+B,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAElD,IAAI,CAAC,yBAAyB,CAAC,aAAa,GAAG,IAAI,CAAC,+BAA+B,CAAC,aAAa,CAAC;QAClG,IAAI,CAAC,yBAAyB,CAAC,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC;QACpE,IAAI,CAAC,yBAAyB,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACpD,IAAI,CAAC,yBAAyB,CAAC,sBAAsB,GAAG,IAAI,CAAC;QAC7D,IAAI,CAAC,yBAAyB,CAAC,SAAS,GAAG,KAAK,CAAC;QACjD,IAAI,CAAC,yBAAyB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE5C,IAAI,CAAC,wBAAwB,CAAC,aAAa,GAAG,IAAI,CAAC,yBAAyB,CAAC,aAAa,CAAC;QAC3F,IAAI,CAAC,wBAAwB,CAAC,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,CAAC;QAC3E,IAAI,CAAC,wBAAwB,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACjE,IAAI,CAAC,wBAAwB,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QAC/D,IAAI,CAAC,wBAAwB,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACnD,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE3C,IAAI,CAAC,4BAA4B,EAAE,CAAC;YAChC,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,WAAW,EAAE,IAAI,CAAC,CAAC;YAE7E,YAAY,CAAC,cAAc,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC1C,CAAC;IACL,CAAC;IAEe,OAAO;QACnB,IAAI,CAAC,6BAA6B,EAAE,OAAO,EAAE,CAAC;QAC9C,IAAI,CAAC,+BAA+B,CAAC,OAAO,EAAE,CAAC;QAC/C,IAAI,CAAC,yBAAyB,CAAC,OAAO,EAAE,CAAC;QACzC,IAAI,CAAC,wBAAwB,CAAC,OAAO,EAAE,CAAC;QACxC,KAAK,CAAC,OAAO,EAAE,CAAC;IACpB,CAAC;CACJ","sourcesContent":["import type { Camera, DirectionalLight, FrameGraph, FrameGraphObjectList, FrameGraphTextureHandle } from \"core/index\";\r\nimport { FrameGraphVolumetricLightingBlendVolumeTask } from \"./volumetricLightingBlendVolumeTask\";\r\nimport { Matrix, TmpVectors, Vector2, Vector3, Vector4 } from \"core/Maths/math.vector\";\r\nimport { Color3, Color4 } from \"core/Maths/math.color\";\r\nimport { FrameGraphTask } from \"../../frameGraphTask\";\r\nimport { Constants } from \"core/Engines/constants\";\r\nimport { FrameGraphClearTextureTask } from \"../Texture/clearTextureTask\";\r\nimport { FrameGraphObjectRendererTask } from \"../Rendering/objectRendererTask\";\r\nimport { ShaderMaterial } from \"core/Materials/shaderMaterial\";\r\nimport { ShaderLanguage } from \"core/Materials/shaderLanguage\";\r\n\r\nconst InvViewProjectionMatrix = new Matrix();\r\n\r\n/**\r\n * A frame graph task that performs volumetric lighting.\r\n */\r\nexport class FrameGraphVolumetricLightingTask extends FrameGraphTask {\r\n    /**\r\n     * The target texture to which the volumetric lighting will be applied.\r\n     */\r\n    public targetTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * The sampling mode to use when blending the volumetric lighting texture with targetTexture.\r\n     */\r\n    public sourceSamplingMode = Constants.TEXTURE_BILINEAR_SAMPLINGMODE;\r\n\r\n    /**\r\n     * The depth texture used for volumetric lighting calculations.\r\n     * It must be the depth texture used to generate targetTexture.\r\n     */\r\n    public depthTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * The camera used for volumetric lighting calculations.\r\n     */\r\n    public camera: Camera;\r\n\r\n    /**\r\n     * The mesh representing the lighting volume.\r\n     * This is the mesh that will be rendered to create the volumetric lighting effect.\r\n     */\r\n    public lightingVolumeMesh: FrameGraphObjectList;\r\n\r\n    /**\r\n     * The directional light used for volumetric lighting.\r\n     */\r\n    public light: DirectionalLight;\r\n\r\n    /**\r\n     * The lighting volume texture (optional).\r\n     * If not provided, a new texture will be created, which the same size, format and type as targetTexture.\r\n     * This is the texture that will store the volumetric lighting information, before being blended to targetTexture.\r\n     */\r\n    public lightingVolumeTexture?: FrameGraphTextureHandle;\r\n\r\n    private _extinctionPhaseG = new Vector4(0, 0, 0, 0);\r\n\r\n    /**\r\n     * The phase G parameter for the volumetric lighting effect (default: 0).\r\n     * This parameter controls the anisotropy of the scattering.\r\n     * A value of 0 means isotropic scattering, while a value of 1 means forward scattering and -1 means backward scattering.\r\n     */\r\n    public get phaseG() {\r\n        return this._extinctionPhaseG.w;\r\n    }\r\n\r\n    public set phaseG(value: number) {\r\n        this._extinctionPhaseG.w = value;\r\n        this._renderLightingVolumeMaterial.setVector4(\"extinctionPhaseG\", this._extinctionPhaseG);\r\n    }\r\n\r\n    /**\r\n     * Whether to enable extinction in the volumetric lighting effect (default: false).\r\n     * Read-only property set in the constructor.\r\n     */\r\n    public readonly enableExtinction: boolean;\r\n\r\n    /**\r\n     * The extinction coefficient for the volumetric lighting effect (default: (0, 0, 0) - no extinction).\r\n     * This parameter controls how much light is absorbed and scattered as it travels through the medium.\r\n     * Will only have an effect if enableExtinction is set to true in the constructor!\r\n     */\r\n    public get extinction() {\r\n        return this._blendLightingVolumeTask.postProcess.extinction;\r\n    }\r\n\r\n    public set extinction(value: Vector3) {\r\n        this._extinctionPhaseG.x = Math.max(value.x, 1e-6);\r\n        this._extinctionPhaseG.y = Math.max(value.y, 1e-6);\r\n        this._extinctionPhaseG.z = Math.max(value.z, 1e-6);\r\n        this._renderLightingVolumeMaterial.setVector4(\"extinctionPhaseG\", this._extinctionPhaseG);\r\n        this._blendLightingVolumeTask.postProcess.extinction.copyFromFloats(this._extinctionPhaseG.x, this._extinctionPhaseG.y, this._extinctionPhaseG.z);\r\n    }\r\n\r\n    private _lightPower = new Color3(1, 1, 1);\r\n\r\n    /**\r\n     * The light power/color for the volumetric lighting effect (default: (1, 1, 1)).\r\n     * This parameter controls the intensity and color of the light used for volumetric lighting.\r\n     */\r\n    public get lightPower() {\r\n        return this._lightPower;\r\n    }\r\n\r\n    public set lightPower(value: Color3) {\r\n        this._lightPower.copyFrom(value);\r\n        this._renderLightingVolumeMaterial.setColor3(\"lightPower\", this._lightPower);\r\n    }\r\n\r\n    public override get name() {\r\n        return this._name;\r\n    }\r\n\r\n    public override set name(name: string) {\r\n        this._name = name;\r\n        if (this._renderLightingVolumeMaterial) {\r\n            this._renderLightingVolumeMaterial.name = `${name} - render lighting volume`;\r\n        }\r\n        if (this._clearLightingVolumeTextureTask) {\r\n            this._clearLightingVolumeTextureTask.name = `${name} - clear lighting volume texture`;\r\n        }\r\n        if (this._renderLightingVolumeTask) {\r\n            this._renderLightingVolumeTask.name = `${name} - render lighting volume`;\r\n        }\r\n        if (this._blendLightingVolumeTask) {\r\n            this._blendLightingVolumeTask.name = `${name} - blend lighting volume`;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * The output texture of the task. It will be the same as targetTexture.\r\n     */\r\n    public readonly outputTexture: FrameGraphTextureHandle;\r\n\r\n    private readonly _clearLightingVolumeTextureTask: FrameGraphClearTextureTask;\r\n    private readonly _renderLightingVolumeTask: FrameGraphObjectRendererTask;\r\n    private readonly _blendLightingVolumeTask: FrameGraphVolumetricLightingBlendVolumeTask;\r\n    private _renderLightingVolumeMaterial: ShaderMaterial;\r\n\r\n    /**\r\n     * Creates a new FrameGraphVolumetricLightingTask.\r\n     * @param name The name of the task.\r\n     * @param frameGraph The frame graph to which the task belongs.\r\n     * @param enableExtinction Whether to enable extinction in the volumetric lighting effect (default: false). If you don't plan to set extinction to something different than (0, 0, 0), you can disable this to save some performance.\r\n     */\r\n    constructor(name: string, frameGraph: FrameGraph, enableExtinction = false) {\r\n        super(name, frameGraph);\r\n\r\n        this.enableExtinction = enableExtinction;\r\n\r\n        const isWebGPU = this._frameGraph.engine.isWebGPU;\r\n\r\n        this._renderLightingVolumeMaterial = new ShaderMaterial(`${name} - render lighting volume`, this._frameGraph.scene, \"volumetricLightingRenderVolume\", {\r\n            attributes: [\"position\"],\r\n            uniformBuffers: [\"Scene\", \"Mesh\"],\r\n            uniforms: [\"world\", \"viewProjection\", \"vEyePosition\", \"lightDir\", \"invViewProjection\", \"outputTextureSize\", \"extinctionPhaseG\", \"lightPower\", \"textureRatio\"],\r\n            samplers: [\"depthTexture\"],\r\n            defines: enableExtinction ? [\"USE_EXTINCTION\"] : [],\r\n            shaderLanguage: isWebGPU ? ShaderLanguage.WGSL : ShaderLanguage.GLSL,\r\n            needAlphaBlending: true,\r\n        });\r\n        this._renderLightingVolumeMaterial.backFaceCulling = false;\r\n        this._renderLightingVolumeMaterial.alphaMode = Constants.ALPHA_ADD;\r\n        this._renderLightingVolumeMaterial.onBindObservable.add(() => {\r\n            this._renderLightingVolumeMaterial.bindEyePosition(this._renderLightingVolumeMaterial.getEffect());\r\n        });\r\n\r\n        this._clearLightingVolumeTextureTask = new FrameGraphClearTextureTask(`clear lighting volume texture`, frameGraph);\r\n        this._renderLightingVolumeTask = new FrameGraphObjectRendererTask(`render lighting volume`, frameGraph, frameGraph.scene);\r\n        this._blendLightingVolumeTask = new FrameGraphVolumetricLightingBlendVolumeTask(`blend lighting volume texture`, frameGraph, enableExtinction);\r\n\r\n        this.onTexturesAllocatedObservable.add(() => {\r\n            this._renderLightingVolumeMaterial.setInternalTexture(\"depthTexture\", frameGraph.textureManager.getTextureFromHandle(this.depthTexture)!);\r\n        });\r\n\r\n        this.outputTexture = this._frameGraph.textureManager.createDanglingHandle();\r\n\r\n        // Triggers the setters to set the uniforms\r\n        this.phaseG = this._extinctionPhaseG.w;\r\n        this.extinction = new Vector3(this.extinction.x, this.extinction.y, this.extinction.z);\r\n        this.lightPower = this._lightPower;\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 Promise.all([import(\"../../../ShadersWGSL/volumetricLightingRenderVolume.vertex\"), import(\"../../../ShadersWGSL/volumetricLightingRenderVolume.fragment\")]);\r\n        }\r\n\r\n        return Promise.all([import(\"../../../Shaders/volumetricLightingRenderVolume.vertex\"), import(\"../../../Shaders/volumetricLightingRenderVolume.fragment\")]);\r\n    }\r\n\r\n    public override isReady() {\r\n        return (\r\n            this._renderLightingVolumeMaterial.isReady() &&\r\n            this._clearLightingVolumeTextureTask.isReady() &&\r\n            this._renderLightingVolumeMaterial.isReady() &&\r\n            this._blendLightingVolumeTask.isReady()\r\n        );\r\n    }\r\n\r\n    public override getClassName(): string {\r\n        return \"FrameGraphVolumetricLightingTask\";\r\n    }\r\n\r\n    public override record(skipCreationOfDisabledPasses = false) {\r\n        if (this.targetTexture === undefined || this.depthTexture === undefined || this.camera === undefined || this.lightingVolumeMesh === undefined || this.light === undefined) {\r\n            throw new Error(`FrameGraphVolumetricLightingTask \"${this.name}\": targetTexture, depthTexture, camera, lightingVolumeMesh and light are required`);\r\n        }\r\n        if (!this.lightingVolumeMesh.meshes || this.lightingVolumeMesh.meshes.length === 0) {\r\n            throw new Error(`FrameGraphVolumetricLightingTask \"${this.name}\": lightingVolumeMesh is empty`);\r\n        }\r\n\r\n        this._frameGraph.textureManager.resolveDanglingHandle(this.outputTexture, this.targetTexture);\r\n\r\n        const textureManager = this._frameGraph.textureManager;\r\n\r\n        let lightingVolumeTexture = this.lightingVolumeTexture;\r\n        if (!lightingVolumeTexture) {\r\n            const targetTextureCreationOptions = textureManager.getTextureCreationOptions(this.targetTexture);\r\n\r\n            targetTextureCreationOptions.options.labels = [\"InScattering\"];\r\n            targetTextureCreationOptions.options.samples = 1;\r\n\r\n            lightingVolumeTexture = textureManager.createRenderTargetTexture(`${this.name} - lighting volume texture`, targetTextureCreationOptions);\r\n        }\r\n\r\n        this.lightingVolumeMesh.meshes[0].material = this._renderLightingVolumeMaterial;\r\n\r\n        const targetTextureSize = textureManager.getTextureAbsoluteDimensions(this.targetTexture);\r\n        const volumeTextureSize = textureManager.getTextureAbsoluteDimensions(lightingVolumeTexture);\r\n\r\n        this._renderLightingVolumeMaterial.setVector2(\r\n            \"textureRatio\",\r\n            new Vector2(targetTextureSize.width / volumeTextureSize.width, targetTextureSize.height / volumeTextureSize.height)\r\n        );\r\n        this._renderLightingVolumeMaterial.setVector2(\"outputTextureSize\", new Vector2(volumeTextureSize.width, volumeTextureSize.height));\r\n\r\n        const passUpdateMaterial = this._frameGraph.addPass(this.name);\r\n\r\n        passUpdateMaterial.setExecuteFunc(() => {\r\n            this.camera.getTransformationMatrix().invertToRef(InvViewProjectionMatrix);\r\n\r\n            this._renderLightingVolumeMaterial.setMatrix(\"invViewProjection\", InvViewProjectionMatrix);\r\n            this._renderLightingVolumeMaterial.setVector3(\"lightDir\", this.light.direction.normalizeToRef(TmpVectors.Vector3[0]));\r\n        });\r\n\r\n        this._clearLightingVolumeTextureTask.clearColor = true;\r\n        this._clearLightingVolumeTextureTask.clearStencil = this.enableExtinction;\r\n        this._clearLightingVolumeTextureTask.color = new Color4(0, 0, 0, 1);\r\n        this._clearLightingVolumeTextureTask.stencilValue = 0;\r\n        this._clearLightingVolumeTextureTask.targetTexture = lightingVolumeTexture;\r\n        this._clearLightingVolumeTextureTask.record(true);\r\n\r\n        this._renderLightingVolumeTask.targetTexture = this._clearLightingVolumeTextureTask.outputTexture;\r\n        this._renderLightingVolumeTask.objectList = this.lightingVolumeMesh;\r\n        this._renderLightingVolumeTask.camera = this.camera;\r\n        this._renderLightingVolumeTask.disableImageProcessing = true;\r\n        this._renderLightingVolumeTask.depthTest = false;\r\n        this._renderLightingVolumeTask.record(true);\r\n\r\n        this._blendLightingVolumeTask.sourceTexture = this._renderLightingVolumeTask.outputTexture;\r\n        this._blendLightingVolumeTask.sourceSamplingMode = this.sourceSamplingMode;\r\n        this._blendLightingVolumeTask.targetTexture = this.targetTexture;\r\n        this._blendLightingVolumeTask.depthTexture = this.depthTexture;\r\n        this._blendLightingVolumeTask.camera = this.camera;\r\n        this._blendLightingVolumeTask.record(true);\r\n\r\n        if (!skipCreationOfDisabledPasses) {\r\n            const disabledPass = this._frameGraph.addPass(this.name + \"_disabled\", true);\r\n\r\n            disabledPass.setExecuteFunc(() => {});\r\n        }\r\n    }\r\n\r\n    public override dispose() {\r\n        this._renderLightingVolumeMaterial?.dispose();\r\n        this._clearLightingVolumeTextureTask.dispose();\r\n        this._renderLightingVolumeTask.dispose();\r\n        this._blendLightingVolumeTask.dispose();\r\n        super.dispose();\r\n    }\r\n}\r\n"]}

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

@@ -1,6 +1,5 @@
-import type { FrameGraphTextureHandle, Scene, Camera, FrameGraph, FrameGraphObjectList, AbstractMesh, ObjectRendererOptions } from "../../../index.js";
-import { FrameGraphTask } from "../../frameGraphTask.js";
-import { ObjectRenderer } from "../../../Rendering/objectRenderer.js";
+import type { FrameGraphTextureHandle, Scene, FrameGraph, AbstractMesh, ObjectRendererOptions, FrameGraphRenderContext, FrameGraphRenderPass, ObjectRenderer } from "../../../index.js";
+import { FrameGraphObjectRendererTask } from "./objectRendererTask.js";
 /**
  * Description of a texture used by the geometry renderer task.
  */
@@ -22,29 +21,7 @@ export interface IFrameGraphGeometryRendererTextureDescription {
 /**
  * Task used to render geometry to a set of textures.
  */
-export declare class FrameGraphGeometryRendererTask extends FrameGraphTask {
-    /**
-     * The depth texture attachment to use for rendering (optional).
-     */
-    depthTexture?: FrameGraphTextureHandle;
-    private _camera;
-    /**
-     * Gets or sets the camera used for rendering.
-     */
-    get camera(): Camera;
-    set camera(camera: Camera);
-    /**
-     * The object list used for rendering.
-     */
-    objectList: FrameGraphObjectList;
-    /**
-     * Whether depth testing is enabled (default is true).
-     */
-    depthTest: boolean;
-    /**
-     * Whether depth writing is enabled (default is true).
-     */
-    depthWrite: boolean;
+export declare class FrameGraphGeometryRendererTask extends FrameGraphObjectRendererTask {
     /**
      * The size of the output textures (default is 100% of the back buffer texture size).
      */
@@ -70,24 +47,18 @@ export declare class FrameGraphGeometryRendererTask extends FrameGraphTask {
      * Indicates if a mesh shouldn't be rendered when its material has depth write disabled (default is true).
      */
     dontRenderWhenMaterialDepthWriteIsDisabled: boolean;
+    private _disableDepthPrePass;
     /**
-     * If true, the output geometry texture(s) will be resolved at the end of the render pass, if samples is greater than 1 (default: true)
-     */
-    resolveMSAAColors: boolean;
-    /**
-     * If true, depthTexture will be resolved at the end of the render pass, if this texture is provided and samples is greater than 1 (default: true)
+     * Indicates whether the depth pre-pass is disabled (default is true).
+     * Materials that require depth pre-pass (Material.needDepthPrePass == true) don't work with the geometry renderer, that's why this setting is true by default.
+     * However, if the geometry renderer doesn't generate any geometry textures but only renders to the main target texture, then depth pre-pass can be enabled.
      */
-    resolveMSAADepth: boolean;
+    get disableDepthPrePass(): boolean;
+    set disableDepthPrePass(value: boolean);
     /**
      * The list of texture descriptions used by the geometry renderer task.
      */
     textureDescriptions: IFrameGraphGeometryRendererTextureDescription[];
-    /**
-     * The output depth texture attachment texture.
-     * This texture will point to the same texture than the depthTexture property if it is set.
-     * Note, however, that the handle itself will be different!
-     */
-    readonly outputDepthTexture: FrameGraphTextureHandle;
     /**
      * The depth (in view space) output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!
      */
@@ -133,26 +104,11 @@ export declare class FrameGraphGeometryRendererTask extends FrameGraphTask {
      * The linear velocity output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!
      */
     readonly geometryLinearVelocityTexture: FrameGraphTextureHandle;
-    /**
-     * The object renderer used by the geometry renderer task.
-     */
-    get objectRenderer(): ObjectRenderer;
     /**
      * Gets or sets the name of the task.
      */
     get name(): string;
     set name(value: string);
-    private _forceLayerMaskCheck;
-    /**
-     * Force checking the layerMask property even if a custom list of meshes is provided (ie. if renderList is not undefined). Default is true.
-     */
-    get forceLayerMaskCheck(): boolean;
-    set forceLayerMaskCheck(value: boolean);
-    private readonly _engine;
-    private readonly _scene;
-    private readonly _renderer;
-    private _textureWidth;
-    private _textureHeight;
     private _clearAttachmentsLayout;
     private _allAttachmentsLayout;
     /**
@@ -161,8 +117,9 @@ export declare class FrameGraphGeometryRendererTask extends FrameGraphTask {
      * @param frameGraph The frame graph the task belongs to.
      * @param scene The scene the frame graph is associated with.
      * @param options The options of the object renderer.
+     * @param existingObjectRenderer An existing object renderer to use (optional). If provided, the options parameter will be ignored.
      */
-    constructor(name: string, frameGraph: FrameGraph, scene: Scene, options?: ObjectRendererOptions);
+    constructor(name: string, frameGraph: FrameGraph, scene: Scene, options?: ObjectRendererOptions, existingObjectRenderer?: ObjectRenderer);
     /**
      * Gets the list of excluded meshes from the velocity texture.
      */
@@ -179,12 +136,14 @@ export declare class FrameGraphGeometryRendererTask extends FrameGraphTask {
      * @see excludeSkinnedMesh to exclude a skinned mesh from bones velocity computation.
      */
     removeExcludedSkinnedMeshFromVelocityTexture(skinnedMesh: AbstractMesh): void;
-    isReady(): boolean;
     getClassName(): string;
-    record(): void;
+    record(skipCreationOfDisabledPasses?: boolean, additionalExecute?: (context: FrameGraphRenderContext) => void): FrameGraphRenderPass;
     dispose(): void;
-    private _createMultiRenderTargetTexture;
-    private _checkDepthTextureCompatibility;
+    protected _resolveDanglingHandles(_targetTextures: FrameGraphTextureHandle[]): void;
+    protected _checkParameters(): void;
+    protected _checkTextureCompatibility(targetTextures: FrameGraphTextureHandle[]): boolean;
+    protected _getTargetHandles(): FrameGraphTextureHandle[];
+    protected _prepareRendering(context: FrameGraphRenderContext, depthEnabled: boolean): void;
     private _buildClearAttachmentsLayout;
     private _registerForRenderPassId;
 }

package/FrameGraph/Tasks/Rendering/geometryRendererTask.js

@@ -1,24 +1,12 @@
-import { backbufferDepthStencilTextureHandle } from "../../frameGraphTypes.js";
 import { Color4 } from "../../../Maths/math.color.js";
 import { MaterialHelperGeometryRendering } from "../../../Materials/materialHelper.geometryrendering.js";
 
-import { FrameGraphTask } from "../../frameGraphTask.js";
-import { ObjectRenderer } from "../../../Rendering/objectRenderer.js";
+import { FrameGraphObjectRendererTask } from "./objectRendererTask.js";
 const ClearColors = [new Color4(0, 0, 0, 0), new Color4(1, 1, 1, 1), new Color4(0, 0, 0, 0)];
 /**
  * Task used to render geometry to a set of textures.
  */
-export class FrameGraphGeometryRendererTask extends FrameGraphTask {
-    /**
-     * Gets or sets the camera used for rendering.
-     */
-    get camera() {
-        return this._camera;
-    }
-    set camera(camera) {
-        this._camera = camera;
-        this._renderer.activeCamera = this.camera;
-    }
+export class FrameGraphGeometryRendererTask extends FrameGraphObjectRendererTask {
     /**
      * Whether to reverse culling (default is false).
      */
@@ -33,10 +21,16 @@ export class FrameGraphGeometryRendererTask extends FrameGraphTask {
         }
     }
     /**
-     * The object renderer used by the geometry renderer task.
+     * Indicates whether the depth pre-pass is disabled (default is true).
+     * Materials that require depth pre-pass (Material.needDepthPrePass == true) don't work with the geometry renderer, that's why this setting is true by default.
+     * However, if the geometry renderer doesn't generate any geometry textures but only renders to the main target texture, then depth pre-pass can be enabled.
      */
-    get objectRenderer() {
-        return this._renderer;
+    get disableDepthPrePass() {
+        return this._disableDepthPrePass;
+    }
+    set disableDepthPrePass(value) {
+        this._disableDepthPrePass = value;
+        this._renderer.disableDepthPrePass = value;
     }
     /**
      * Gets or sets the name of the task.
@@ -50,36 +44,16 @@ export class FrameGraphGeometryRendererTask extends FrameGraphTask {
             this._renderer.name = value;
         }
     }
-    /**
-     * Force checking the layerMask property even if a custom list of meshes is provided (ie. if renderList is not undefined). Default is true.
-     */
-    get forceLayerMaskCheck() {
-        return this._forceLayerMaskCheck;
-    }
-    set forceLayerMaskCheck(value) {
-        if (value === this._forceLayerMaskCheck) {
-            return;
-        }
-        this._forceLayerMaskCheck = value;
-        this._renderer.forceLayerMaskCheck = value;
-    }
     /**
      * Constructs a new geometry renderer task.
      * @param name The name of the task.
      * @param frameGraph The frame graph the task belongs to.
      * @param scene The scene the frame graph is associated with.
      * @param options The options of the object renderer.
+     * @param existingObjectRenderer An existing object renderer to use (optional). If provided, the options parameter will be ignored.
      */
-    constructor(name, frameGraph, scene, options) {
-        super(name, frameGraph);
-        /**
-         * Whether depth testing is enabled (default is true).
-         */
-        this.depthTest = true;
-        /**
-         * Whether depth writing is enabled (default is true).
-         */
-        this.depthWrite = true;
+    constructor(name, frameGraph, scene, options, existingObjectRenderer) {
+        super(name, frameGraph, scene, options, existingObjectRenderer);
         /**
          * The size of the output textures (default is 100% of the back buffer texture size).
          */
@@ -97,26 +71,15 @@ export class FrameGraphGeometryRendererTask extends FrameGraphTask {
          * Indicates if a mesh shouldn't be rendered when its material has depth write disabled (default is true).
          */
         this.dontRenderWhenMaterialDepthWriteIsDisabled = true;
-        /**
-         * If true, the output geometry texture(s) will be resolved at the end of the render pass, if samples is greater than 1 (default: true)
-         */
-        this.resolveMSAAColors = true;
-        /**
-         * If true, depthTexture will be resolved at the end of the render pass, if this texture is provided and samples is greater than 1 (default: true)
-         */
-        this.resolveMSAADepth = false;
+        this._disableDepthPrePass = true;
         /**
          * The list of texture descriptions used by the geometry renderer task.
          */
         this.textureDescriptions = [];
-        this._forceLayerMaskCheck = true;
-        this._scene = scene;
-        this._engine = this._scene.getEngine();
-        this._renderer = new ObjectRenderer(name, scene, options);
-        this._renderer.renderSprites = false;
-        this._renderer.renderParticles = false;
-        this._renderer.enableBoundingBoxRendering = false;
-        this._renderer.enableOutlineRendering = false;
+        this.renderSprites = false;
+        this.renderParticles = false;
+        this.enableBoundingBoxRendering = false;
+        this.enableOutlineRendering = false;
         this._renderer.disableDepthPrePass = true;
         this._renderer.customIsReadyFunction = (mesh, refreshRate, preWarm) => {
             if (this.dontRenderWhenMaterialDepthWriteIsDisabled && mesh.material && mesh.material.disableDepthWrite) {
@@ -129,10 +92,8 @@ export class FrameGraphGeometryRendererTask extends FrameGraphTask {
                 scene.updateTransformMatrix(true);
             }
         });
-        this.name = name;
         this._clearAttachmentsLayout = new Map();
         this._allAttachmentsLayout = [];
-        this.outputDepthTexture = this._frameGraph.textureManager.createDanglingHandle();
         this.geometryViewDepthTexture = this._frameGraph.textureManager.createDanglingHandle();
         this.geometryNormViewDepthTexture = this._frameGraph.textureManager.createDanglingHandle();
         this.geometryScreenDepthTexture = this._frameGraph.textureManager.createDanglingHandle();
@@ -176,34 +137,19 @@ export class FrameGraphGeometryRendererTask extends FrameGraphTask {
             list.splice(index, 1);
         }
     }
-    isReady() {
-        return this._renderer.isReadyForRendering(this._textureWidth, this._textureHeight);
-    }
     getClassName() {
         return "FrameGraphGeometryRendererTask";
     }
-    record() {
-        if (this.objectList === undefined) {
-            throw new Error(`FrameGraphGeometryRendererTask ${this.name}: object list must be provided`);
-        }
-        // Make sure the renderList / particleSystemList are set when FrameGraphGeometryRendererTask.isReady() is called!
-        this._renderer.renderList = this.objectList.meshes;
-        this._renderer.particleSystemList = this.objectList.particleSystems;
-        const outputTextureHandle = this._createMultiRenderTargetTexture();
-        const depthEnabled = this._checkDepthTextureCompatibility();
+    record(skipCreationOfDisabledPasses = false, additionalExecute) {
         this._buildClearAttachmentsLayout();
         this._registerForRenderPassId(this._renderer.renderPassId);
-        const outputTextureDescription = outputTextureHandle.length > 0 ? this._frameGraph.textureManager.getTextureDescription(outputTextureHandle[0]) : null;
-        this._textureWidth = outputTextureDescription?.size.width ?? 0;
-        this._textureHeight = outputTextureDescription?.size.height ?? 0;
-        // Create pass
         MaterialHelperGeometryRendering.MarkAsDirty(this._renderer.renderPassId, this.objectList.meshes || this._scene.meshes);
-        const pass = this._frameGraph.addRenderPass(this.name);
-        pass.setRenderTarget(outputTextureHandle);
+        const pass = super.record(skipCreationOfDisabledPasses, additionalExecute);
+        const outputTextureHandles = pass.renderTarget;
         let needPreviousWorldMatrices = false;
         for (let i = 0; i < this.textureDescriptions.length; i++) {
             const description = this.textureDescriptions[i];
-            const handle = outputTextureHandle[i];
+            const handle = outputTextureHandles[i];
             const index = MaterialHelperGeometryRendering.GeometryTextureDescriptions.findIndex((f) => f.type === description.type);
             const geometryDescription = MaterialHelperGeometryRendering.GeometryTextureDescriptions[index];
             switch (geometryDescription.type) {
@@ -245,30 +191,55 @@ export class FrameGraphGeometryRendererTask extends FrameGraphTask {
             }
         }
         this._scene.needsPreviousWorldMatrices = needPreviousWorldMatrices;
-        pass.setRenderTargetDepth(this.depthTexture);
-        pass.setExecuteFunc((context) => {
-            this._renderer.renderList = this.objectList.meshes;
-            this._renderer.particleSystemList = this.objectList.particleSystems;
-            pass.frameGraphRenderTarget.renderTargetWrapper.resolveMSAAColors = this.resolveMSAAColors;
-            pass.frameGraphRenderTarget.renderTargetWrapper.resolveMSAADepth = this.resolveMSAADepth;
-            context.setDepthStates(this.depthTest && depthEnabled, this.depthWrite && depthEnabled);
-            this._clearAttachmentsLayout.forEach((layout, clearType) => {
-                context.clearColorAttachments(ClearColors[clearType], layout);
-            });
-            context.bindAttachments(this._allAttachmentsLayout);
-            context.render(this._renderer, this._textureWidth, this._textureHeight);
-        });
-        const passDisabled = this._frameGraph.addRenderPass(this.name + "_disabled", true);
-        passDisabled.setRenderTarget(outputTextureHandle);
-        passDisabled.setRenderTargetDepth(this.depthTexture);
-        passDisabled.setExecuteFunc((_context) => { });
+        return pass;
     }
     dispose() {
         MaterialHelperGeometryRendering.DeleteConfiguration(this._renderer.renderPassId);
         this._renderer.dispose();
         super.dispose();
     }
-    _createMultiRenderTargetTexture() {
+    _resolveDanglingHandles(_targetTextures) {
+        if (this.targetTexture !== undefined) {
+            this._frameGraph.textureManager.resolveDanglingHandle(this.outputTexture, Array.isArray(this.targetTexture) ? this.targetTexture[0] : this.targetTexture);
+        }
+        if (this.depthTexture !== undefined) {
+            this._frameGraph.textureManager.resolveDanglingHandle(this.outputDepthTexture, this.depthTexture);
+        }
+    }
+    _checkParameters() {
+        if (this.objectList === undefined || this.camera === undefined) {
+            throw new Error(`FrameGraphGeometryRendererTask ${this.name}: object list and camera must be provided`);
+        }
+    }
+    _checkTextureCompatibility(targetTextures) {
+        let depthEnabled = false;
+        let dimensions = null;
+        if (this.targetTexture !== undefined) {
+            const outputTextureDescription = this._frameGraph.textureManager.getTextureDescription(Array.isArray(this.targetTexture) ? this.targetTexture[0] : this.targetTexture);
+            if (this.samples !== outputTextureDescription.options.samples) {
+                throw new Error(`FrameGraphGeometryRendererTask ${this.name}: the target texture and the output geometry textures  must have the same number of samples`);
+            }
+            dimensions = outputTextureDescription.size;
+        }
+        if (this.depthTexture !== undefined) {
+            const depthTextureDescription = this._frameGraph.textureManager.getTextureDescription(this.depthTexture);
+            if (depthTextureDescription.options.samples !== this.samples && this.textureDescriptions.length > 0) {
+                throw new Error(`FrameGraphGeometryRendererTask ${this.name}: the depth texture and the output geometry textures must have the same number of samples`);
+            }
+            this._frameGraph.textureManager.resolveDanglingHandle(this.outputDepthTexture, this.depthTexture);
+            depthEnabled = true;
+            dimensions = depthTextureDescription.size;
+        }
+        const geomTextureDimensions = this.sizeIsPercentage ? this._frameGraph.textureManager.getAbsoluteDimensions(this.size) : this.size;
+        if (dimensions !== null) {
+            if (geomTextureDimensions.width !== dimensions.width || geomTextureDimensions.height !== dimensions.height) {
+                throw new Error(`FrameGraphGeometryRendererTask ${this.name}: the geometry textures (size: ${geomTextureDimensions.width}x${geomTextureDimensions.height}) and the target/depth texture (size: ${dimensions.width}x${dimensions.height}) must have the same dimensions.`);
+            }
+        }
+        depthEnabled = depthEnabled || super._checkTextureCompatibility(targetTextures);
+        return depthEnabled;
+    }
+    _getTargetHandles() {
         const types = [];
         const formats = [];
         const labels = [];
@@ -284,38 +255,40 @@ export class FrameGraphGeometryRendererTask extends FrameGraphTask {
             labels[i] = MaterialHelperGeometryRendering.GeometryTextureDescriptions[index].name;
             useSRGBBuffers[i] = false;
         }
-        const baseHandle = this._frameGraph.textureManager.createRenderTargetTexture(this.name, {
-            size: this.size,
-            sizeIsPercentage: this.sizeIsPercentage,
-            options: {
-                createMipMaps: false,
-                samples: this.samples,
-                types,
-                formats,
-                useSRGBBuffers,
-                labels,
-            },
-        });
         const handles = [];
-        for (let i = 0; i < this.textureDescriptions.length; i++) {
-            handles.push(baseHandle + i);
+        if (this.textureDescriptions.length > 0) {
+            const baseHandle = this._frameGraph.textureManager.createRenderTargetTexture(this.name, {
+                size: this.size,
+                sizeIsPercentage: this.sizeIsPercentage,
+                options: {
+                    createMipMaps: false,
+                    samples: this.samples,
+                    types,
+                    formats,
+                    useSRGBBuffers,
+                    labels,
+                },
+            });
+            for (let i = 0; i < this.textureDescriptions.length; i++) {
+                handles.push(baseHandle + i);
+            }
         }
-        return handles;
-    }
-    _checkDepthTextureCompatibility() {
-        let depthEnabled = false;
-        if (this.depthTexture !== undefined) {
-            if (this.depthTexture === backbufferDepthStencilTextureHandle) {
-                throw new Error(`FrameGraphGeometryRendererTask ${this.name}: the depth/stencil back buffer is not allowed as a depth texture`);
+        if (this.targetTexture !== undefined) {
+            if (Array.isArray(this.targetTexture)) {
+                handles.push(...this.targetTexture);
             }
-            const depthTextureDescription = this._frameGraph.textureManager.getTextureDescription(this.depthTexture);
-            if (depthTextureDescription.options.samples !== this.samples && this.textureDescriptions.length > 0) {
-                throw new Error(`FrameGraphGeometryRendererTask ${this.name}: the depth texture and the output texture must have the same number of samples`);
+            else {
+                handles.push(this.targetTexture);
             }
-            this._frameGraph.textureManager.resolveDanglingHandle(this.outputDepthTexture, this.depthTexture);
-            depthEnabled = true;
         }
-        return depthEnabled;
+        return handles;
+    }
+    _prepareRendering(context, depthEnabled) {
+        context.setDepthStates(this.depthTest && depthEnabled, this.depthWrite && depthEnabled);
+        this._clearAttachmentsLayout.forEach((layout, clearType) => {
+            context.clearColorAttachments(ClearColors[clearType], layout);
+        });
+        context.bindAttachments(this._allAttachmentsLayout);
     }
     _buildClearAttachmentsLayout() {
         const clearAttachmentsLayout = new Map();
@@ -337,6 +310,20 @@ export class FrameGraphGeometryRendererTask extends FrameGraphTask {
             });
             allAttachmentsLayout.push(true);
         }
+        if (this.targetTexture !== undefined) {
+            let layout = clearAttachmentsLayout.get(0 /* GeometryRenderingTextureClearType.Zero */);
+            if (layout === undefined) {
+                layout = [];
+                clearAttachmentsLayout.set(0 /* GeometryRenderingTextureClearType.Zero */, layout);
+                for (let j = 0; j < this.textureDescriptions.length - 1; j++) {
+                    layout[j] = false;
+                }
+            }
+            clearAttachmentsLayout.forEach((layout) => {
+                layout.push(false);
+            });
+            allAttachmentsLayout.push(true);
+        }
         this._clearAttachmentsLayout = new Map();
         clearAttachmentsLayout.forEach((layout, clearType) => {
             this._clearAttachmentsLayout.set(clearType, this._engine.buildTextureLayout(layout));
@@ -351,6 +338,9 @@ export class FrameGraphGeometryRendererTask extends FrameGraphTask {
             const geometryDescription = MaterialHelperGeometryRendering.GeometryTextureDescriptions[index];
             configuration.defines[geometryDescription.defineIndex] = i;
         }
+        if (this.targetTexture !== undefined) {
+            configuration.defines["PREPASS_COLOR_INDEX"] = this.textureDescriptions.length;
+        }
         configuration.reverseCulling = this.reverseCulling;
     }
 }