@babylonjs/core 7.31.2 → 7.32.1

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

@@ -0,0 +1,145 @@
+import type { FrameGraphTextureHandle, Scene, Camera, FrameGraph, FrameGraphObjectList, AbstractMesh } from "../../../index.js";
+import { RenderTargetTexture } from "../../../Materials/Textures/renderTargetTexture";
+import { FrameGraphTask } from "../../frameGraphTask";
+/**
+ * Description of a texture used by the geometry renderer task.
+ */
+export interface IFrameGraphGeometryRendererTextureDescription {
+    /**
+     * The type of the texture.
+     * The value should be one of the Constants.PREPASS_XXX_TEXTURE_TYPE values.
+     */
+    type: number;
+    /**
+     * The type of the texture.
+     */
+    textureType: number;
+    /**
+     * The format of the texture.
+     */
+    textureFormat: number;
+}
+/**
+ * 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;
+    /**
+     * The size of the output textures (default is 100% of the back buffer texture size).
+     */
+    size: {
+        width: number;
+        height: number;
+    };
+    /**
+     * Whether the size is a percentage of the back buffer size (default is true).
+     */
+    sizeIsPercentage: boolean;
+    /**
+     * The number of samples to use for the output textures (default is 1).
+     */
+    samples: number;
+    /**
+     * 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!
+     */
+    readonly geometryViewDepthTexture: FrameGraphTextureHandle;
+    /**
+     * The depth (in screen space) output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!
+     */
+    readonly geometryScreenDepthTexture: FrameGraphTextureHandle;
+    /**
+     * The normal (in view space) output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!
+     */
+    readonly geometryViewNormalTexture: FrameGraphTextureHandle;
+    /**
+     * The normal (in world space) output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!
+     */
+    readonly geometryWorldNormalTexture: FrameGraphTextureHandle;
+    /**
+     * The position (in local space) output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!
+     */
+    readonly geometryLocalPositionTexture: FrameGraphTextureHandle;
+    /**
+     * The position (in world space) output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!
+     */
+    readonly geometryWorldPositionTexture: FrameGraphTextureHandle;
+    /**
+     * The albedo output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!
+     */
+    readonly geometryAlbedoTexture: FrameGraphTextureHandle;
+    /**
+     * The reflectivity output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!
+     */
+    readonly geometryReflectivityTexture: FrameGraphTextureHandle;
+    /**
+     * The velocity output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!
+     */
+    readonly geometryVelocityTexture: FrameGraphTextureHandle;
+    /**
+     * The linear velocity output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!
+     */
+    readonly geometryLinearVelocityTexture: FrameGraphTextureHandle;
+    /**
+     * The render target texture used by the geometry renderer task.
+     */
+    get renderTargetTexture(): RenderTargetTexture;
+    /**
+     * Gets or sets the name of the task.
+     */
+    get name(): string;
+    set name(value: string);
+    private _engine;
+    private _scene;
+    private _rtt;
+    private _clearAttachmentsLayout;
+    private _allAttachmentsLayout;
+    /**
+     * 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.
+     */
+    constructor(name: string, frameGraph: FrameGraph, scene: Scene);
+    /**
+     * Gets the list of excluded meshes from the velocity texture.
+     */
+    get excludedSkinnedMeshFromVelocityTexture(): AbstractMesh[];
+    isReady(): boolean;
+    record(): void;
+    dispose(): void;
+    private _createMultiRenderTargetTexture;
+    private _checkDepthTextureCompatibility;
+    private _buildClearAttachmentsLayout;
+    private _registerForRenderPassId;
+}

package/FrameGraph/Tasks/Rendering/geometryRendererTask.js

@@ -0,0 +1,259 @@
+import { backbufferDepthStencilTextureHandle } from "../../frameGraphTypes.js";
+import { RenderTargetTexture } from "../../../Materials/Textures/renderTargetTexture.js";
+import { Color4 } from "../../../Maths/math.color.js";
+import { MaterialHelperGeometryRendering } from "../../../Materials/materialHelper.geometryrendering.js";
+
+import { FrameGraphTask } from "../../frameGraphTask.js";
+const clearColors = [new Color4(0, 0, 0, 0), new Color4(1, 1, 1, 1), new Color4(1e8, 1e8, 1e8, 1e8)];
+/**
+ * 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._rtt.activeCamera = this.camera;
+    }
+    /**
+     * The render target texture used by the geometry renderer task.
+     */
+    get renderTargetTexture() {
+        return this._rtt;
+    }
+    /**
+     * Gets or sets the name of the task.
+     */
+    get name() {
+        return this._name;
+    }
+    set name(value) {
+        this._name = value;
+        if (this._rtt) {
+            this._rtt.name = value + "_internal_rtt";
+        }
+    }
+    /**
+     * 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.
+     */
+    constructor(name, frameGraph, scene) {
+        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;
+        /**
+         * The size of the output textures (default is 100% of the back buffer texture size).
+         */
+        this.size = { width: 100, height: 100 };
+        /**
+         * Whether the size is a percentage of the back buffer size (default is true).
+         */
+        this.sizeIsPercentage = true;
+        /**
+         * The number of samples to use for the output textures (default is 1).
+         */
+        this.samples = 1;
+        /**
+         * The list of texture descriptions used by the geometry renderer task.
+         */
+        this.textureDescriptions = [];
+        this._scene = scene;
+        this._engine = this._scene.getEngine();
+        this._rtt = new RenderTargetTexture(name, 1, scene, {
+            delayAllocation: true,
+        });
+        this._rtt.skipInitialClear = true;
+        this._rtt.renderSprites = false;
+        this._rtt.renderParticles = false;
+        this.name = name;
+        this._clearAttachmentsLayout = new Map();
+        this._allAttachmentsLayout = [];
+        this.outputDepthTexture = this._frameGraph.createDanglingHandle();
+        this.geometryViewDepthTexture = this._frameGraph.createDanglingHandle();
+        this.geometryScreenDepthTexture = this._frameGraph.createDanglingHandle();
+        this.geometryViewNormalTexture = this._frameGraph.createDanglingHandle();
+        this.geometryWorldNormalTexture = this._frameGraph.createDanglingHandle();
+        this.geometryLocalPositionTexture = this._frameGraph.createDanglingHandle();
+        this.geometryWorldPositionTexture = this._frameGraph.createDanglingHandle();
+        this.geometryAlbedoTexture = this._frameGraph.createDanglingHandle();
+        this.geometryReflectivityTexture = this._frameGraph.createDanglingHandle();
+        this.geometryVelocityTexture = this._frameGraph.createDanglingHandle();
+        this.geometryLinearVelocityTexture = this._frameGraph.createDanglingHandle();
+    }
+    /**
+     * Gets the list of excluded meshes from the velocity texture.
+     */
+    get excludedSkinnedMeshFromVelocityTexture() {
+        return MaterialHelperGeometryRendering.GetConfiguration(this._rtt.renderPassId).excludedSkinnedMesh;
+    }
+    isReady() {
+        return this._rtt.isReadyForRendering();
+    }
+    record() {
+        if (this.textureDescriptions.length === 0 || this.objectList === undefined) {
+            throw new Error(`FrameGraphGeometryRendererTask ${this.name}: object list and at least one geometry texture description must be provided`);
+        }
+        const outputTextureHandle = this._createMultiRenderTargetTexture();
+        const depthEnabled = this._checkDepthTextureCompatibility();
+        this._buildClearAttachmentsLayout();
+        this._registerForRenderPassId(this._rtt.renderPassId);
+        const outputTextureDescription = this._frameGraph.getTextureDescription(outputTextureHandle);
+        this._rtt._size = outputTextureDescription.size;
+        // Create pass
+        MaterialHelperGeometryRendering.MarkAsDirty(this._rtt.renderPassId, this.objectList.meshes || this._scene.meshes);
+        const pass = this._frameGraph.addRenderPass(this.name);
+        pass.setRenderTarget(outputTextureHandle);
+        let handle = outputTextureHandle + 1;
+        for (let i = 0; i < this.textureDescriptions.length; i++) {
+            const description = this.textureDescriptions[i];
+            const index = MaterialHelperGeometryRendering.GeometryTextureDescriptions.findIndex((f) => f.type === description.type);
+            const geometryDescription = MaterialHelperGeometryRendering.GeometryTextureDescriptions[index];
+            switch (geometryDescription.type) {
+                case 5:
+                    this._frameGraph.resolveDanglingHandle(this.geometryViewDepthTexture, handle++);
+                    break;
+                case 10:
+                    this._frameGraph.resolveDanglingHandle(this.geometryScreenDepthTexture, handle++);
+                    break;
+                case 6:
+                    this._frameGraph.resolveDanglingHandle(this.geometryViewNormalTexture, handle++);
+                    break;
+                case 8:
+                    this._frameGraph.resolveDanglingHandle(this.geometryWorldNormalTexture, handle++);
+                    break;
+                case 9:
+                    this._frameGraph.resolveDanglingHandle(this.geometryLocalPositionTexture, handle++);
+                    break;
+                case 1:
+                    this._frameGraph.resolveDanglingHandle(this.geometryWorldPositionTexture, handle++);
+                    break;
+                case 12:
+                    this._frameGraph.resolveDanglingHandle(this.geometryAlbedoTexture, handle++);
+                    break;
+                case 3:
+                    this._frameGraph.resolveDanglingHandle(this.geometryReflectivityTexture, handle++);
+                    break;
+                case 2:
+                    this._frameGraph.resolveDanglingHandle(this.geometryVelocityTexture, handle++);
+                    break;
+                case 11:
+                    this._frameGraph.resolveDanglingHandle(this.geometryLinearVelocityTexture, handle++);
+                    break;
+            }
+        }
+        if (this.depthTexture !== undefined) {
+            pass.setRenderTargetDepth(this.depthTexture);
+        }
+        pass.setExecuteFunc((context) => {
+            this._rtt.renderList = this.objectList.meshes;
+            this._rtt.particleSystemList = this.objectList.particleSystems;
+            this._scene.incrementRenderId();
+            this._scene.resetCachedMaterial();
+            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._rtt);
+        });
+    }
+    dispose() {
+        MaterialHelperGeometryRendering.DeleteConfiguration(this._rtt.renderPassId);
+        this._rtt.dispose();
+        super.dispose();
+    }
+    _createMultiRenderTargetTexture() {
+        const types = [];
+        const formats = [];
+        const labels = [];
+        const useSRGBBuffers = [];
+        for (let i = 0; i < this.textureDescriptions.length; i++) {
+            const description = this.textureDescriptions[i];
+            const index = MaterialHelperGeometryRendering.GeometryTextureDescriptions.findIndex((f) => f.type === description.type);
+            if (index === -1) {
+                throw new Error(`FrameGraphGeometryRendererTask ${this.name}: unknown texture type ${description.type}`);
+            }
+            types[i] = description.textureType;
+            formats[i] = description.textureFormat;
+            labels[i] = MaterialHelperGeometryRendering.GeometryTextureDescriptions[index].name;
+            useSRGBBuffers[i] = false;
+        }
+        return this._frameGraph.createRenderTargetTexture(this.name, {
+            size: this.size,
+            sizeIsPercentage: this.sizeIsPercentage,
+            options: {
+                createMipMaps: false,
+                generateDepthBuffer: false,
+                textureCount: this.textureDescriptions.length,
+                samples: this.samples,
+                types,
+                formats,
+                useSRGBBuffers,
+                labels,
+            },
+        }, true);
+    }
+    _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`);
+            }
+            const depthTextureDescription = this._frameGraph.getTextureDescription(this.depthTexture);
+            if (depthTextureDescription.options.samples !== this.samples) {
+                throw new Error(`FrameGraphGeometryRendererTask ${this.name}: the depth texture and the output texture must have the same number of samples`);
+            }
+            this._frameGraph.resolveDanglingHandle(this.outputDepthTexture, this.depthTexture);
+            depthEnabled = true;
+        }
+        return depthEnabled;
+    }
+    _buildClearAttachmentsLayout() {
+        const clearAttachmentsLayout = new Map();
+        const allAttachmentsLayout = [];
+        for (let i = 0; i < this.textureDescriptions.length; i++) {
+            const description = this.textureDescriptions[i];
+            const index = MaterialHelperGeometryRendering.GeometryTextureDescriptions.findIndex((f) => f.type === description.type);
+            const geometryDescription = MaterialHelperGeometryRendering.GeometryTextureDescriptions[index];
+            let layout = clearAttachmentsLayout.get(geometryDescription.clearType);
+            if (layout === undefined) {
+                layout = [];
+                clearAttachmentsLayout.set(geometryDescription.clearType, layout);
+                for (let j = 0; j < i; j++) {
+                    layout[j] = false;
+                }
+            }
+            clearAttachmentsLayout.forEach((layout, clearType) => {
+                layout.push(clearType === geometryDescription.clearType);
+            });
+            allAttachmentsLayout.push(true);
+        }
+        this._clearAttachmentsLayout = new Map();
+        clearAttachmentsLayout.forEach((layout, clearType) => {
+            this._clearAttachmentsLayout.set(clearType, this._engine.buildTextureLayout(layout));
+        });
+        this._allAttachmentsLayout = this._engine.buildTextureLayout(allAttachmentsLayout);
+    }
+    _registerForRenderPassId(renderPassId) {
+        const configuration = MaterialHelperGeometryRendering.CreateConfiguration(renderPassId);
+        for (let i = 0; i < this.textureDescriptions.length; i++) {
+            const description = this.textureDescriptions[i];
+            const index = MaterialHelperGeometryRendering.GeometryTextureDescriptions.findIndex((f) => f.type === description.type);
+            const geometryDescription = MaterialHelperGeometryRendering.GeometryTextureDescriptions[index];
+            configuration.defines[geometryDescription.defineIndex] = i;
+        }
+    }
+}
+//# sourceMappingURL=geometryRendererTask.js.map

package/FrameGraph/Tasks/Rendering/geometryRendererTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometryRendererTask.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FrameGraph/Tasks/Rendering/geometryRendererTask.ts"],"names":[],"mappings":"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","sourcesContent":["// eslint-disable-next-line import/no-internal-modules\r\nimport type { FrameGraphTextureHandle, Scene, Camera, AbstractEngine, FrameGraph, GeometryRenderingTextureClearType, FrameGraphObjectList, AbstractMesh } from \"core/index\";\r\nimport { backbufferDepthStencilTextureHandle } from \"../../frameGraphTypes\";\r\nimport { RenderTargetTexture } from \"../../../Materials/Textures/renderTargetTexture\";\r\nimport { Color4 } from \"core/Maths/math.color\";\r\nimport { MaterialHelperGeometryRendering } from \"core/Materials/materialHelper.geometryrendering\";\r\nimport { Constants } from \"core/Engines/constants\";\r\nimport { FrameGraphTask } from \"../../frameGraphTask\";\r\n\r\n/**\r\n * Description of a texture used by the geometry renderer task.\r\n */\r\nexport interface IFrameGraphGeometryRendererTextureDescription {\r\n    /**\r\n     * The type of the texture.\r\n     * The value should be one of the Constants.PREPASS_XXX_TEXTURE_TYPE values.\r\n     */\r\n    type: number;\r\n\r\n    /**\r\n     * The type of the texture.\r\n     */\r\n    textureType: number;\r\n\r\n    /**\r\n     * The format of the texture.\r\n     */\r\n    textureFormat: number;\r\n}\r\n\r\nconst clearColors: Color4[] = [new Color4(0, 0, 0, 0), new Color4(1, 1, 1, 1), new Color4(1e8, 1e8, 1e8, 1e8)];\r\n\r\n/**\r\n * Task used to render geometry to a set of textures.\r\n */\r\nexport class FrameGraphGeometryRendererTask extends FrameGraphTask {\r\n    /**\r\n     * The depth texture attachment to use for rendering (optional).\r\n     */\r\n    public depthTexture?: FrameGraphTextureHandle;\r\n\r\n    private _camera: Camera;\r\n\r\n    /**\r\n     * Gets or sets the camera used for rendering.\r\n     */\r\n    public get camera() {\r\n        return this._camera;\r\n    }\r\n\r\n    public set camera(camera: Camera) {\r\n        this._camera = camera;\r\n        this._rtt.activeCamera = this.camera;\r\n    }\r\n\r\n    /**\r\n     * The object list used for rendering.\r\n     */\r\n    public objectList: FrameGraphObjectList;\r\n\r\n    /**\r\n     * Whether depth testing is enabled (default is true).\r\n     */\r\n    public depthTest = true;\r\n\r\n    /**\r\n     * Whether depth writing is enabled (default is true).\r\n     */\r\n    public depthWrite = true;\r\n\r\n    /**\r\n     * The size of the output textures (default is 100% of the back buffer texture size).\r\n     */\r\n    public size: { width: number; height: number } = { width: 100, height: 100 };\r\n\r\n    /**\r\n     * Whether the size is a percentage of the back buffer size (default is true).\r\n     */\r\n    public sizeIsPercentage = true;\r\n\r\n    /**\r\n     * The number of samples to use for the output textures (default is 1).\r\n     */\r\n    public samples = 1;\r\n\r\n    /**\r\n     * The list of texture descriptions used by the geometry renderer task.\r\n     */\r\n    public textureDescriptions: IFrameGraphGeometryRendererTextureDescription[] = [];\r\n\r\n    /**\r\n     * The output depth texture attachment texture.\r\n     * This texture will point to the same texture than the depthTexture property if it is set.\r\n     * Note, however, that the handle itself will be different!\r\n     */\r\n    public readonly outputDepthTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * The depth (in view space) output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!\r\n     */\r\n    public readonly geometryViewDepthTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * The depth (in screen space) output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!\r\n     */\r\n    public readonly geometryScreenDepthTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * The normal (in view space) output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!\r\n     */\r\n    public readonly geometryViewNormalTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * The normal (in world space) output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!\r\n     */\r\n    public readonly geometryWorldNormalTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * The position (in local space) output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!\r\n     */\r\n    public readonly geometryLocalPositionTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * The position (in world space) output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!\r\n     */\r\n    public readonly geometryWorldPositionTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * The albedo output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!\r\n     */\r\n    public readonly geometryAlbedoTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * The reflectivity output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!\r\n     */\r\n    public readonly geometryReflectivityTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * The velocity output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!\r\n     */\r\n    public readonly geometryVelocityTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * The linear velocity output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!\r\n     */\r\n    public readonly geometryLinearVelocityTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * The render target texture used by the geometry renderer task.\r\n     */\r\n    public get renderTargetTexture() {\r\n        return this._rtt;\r\n    }\r\n\r\n    /**\r\n     * Gets or sets the name of the task.\r\n     */\r\n    public override get name() {\r\n        return this._name;\r\n    }\r\n\r\n    public override set name(value: string) {\r\n        this._name = value;\r\n        if (this._rtt) {\r\n            this._rtt.name = value + \"_internal_rtt\";\r\n        }\r\n    }\r\n\r\n    private _engine: AbstractEngine;\r\n    private _scene: Scene;\r\n    private _rtt: RenderTargetTexture;\r\n    private _clearAttachmentsLayout: Map<GeometryRenderingTextureClearType, number[]>;\r\n    private _allAttachmentsLayout: number[];\r\n\r\n    /**\r\n     * Constructs a new geometry renderer task.\r\n     * @param name The name of the task.\r\n     * @param frameGraph The frame graph the task belongs to.\r\n     * @param scene The scene the frame graph is associated with.\r\n     */\r\n    constructor(name: string, frameGraph: FrameGraph, scene: Scene) {\r\n        super(name, frameGraph);\r\n\r\n        this._scene = scene;\r\n        this._engine = this._scene.getEngine();\r\n\r\n        this._rtt = new RenderTargetTexture(name, 1, scene, {\r\n            delayAllocation: true,\r\n        });\r\n        this._rtt.skipInitialClear = true;\r\n        this._rtt.renderSprites = false;\r\n        this._rtt.renderParticles = false;\r\n\r\n        this.name = name;\r\n        this._clearAttachmentsLayout = new Map();\r\n        this._allAttachmentsLayout = [];\r\n\r\n        this.outputDepthTexture = this._frameGraph.createDanglingHandle();\r\n        this.geometryViewDepthTexture = this._frameGraph.createDanglingHandle();\r\n        this.geometryScreenDepthTexture = this._frameGraph.createDanglingHandle();\r\n        this.geometryViewNormalTexture = this._frameGraph.createDanglingHandle();\r\n        this.geometryWorldNormalTexture = this._frameGraph.createDanglingHandle();\r\n        this.geometryLocalPositionTexture = this._frameGraph.createDanglingHandle();\r\n        this.geometryWorldPositionTexture = this._frameGraph.createDanglingHandle();\r\n        this.geometryAlbedoTexture = this._frameGraph.createDanglingHandle();\r\n        this.geometryReflectivityTexture = this._frameGraph.createDanglingHandle();\r\n        this.geometryVelocityTexture = this._frameGraph.createDanglingHandle();\r\n        this.geometryLinearVelocityTexture = this._frameGraph.createDanglingHandle();\r\n    }\r\n\r\n    /**\r\n     * Gets the list of excluded meshes from the velocity texture.\r\n     */\r\n    public get excludedSkinnedMeshFromVelocityTexture(): AbstractMesh[] {\r\n        return MaterialHelperGeometryRendering.GetConfiguration(this._rtt.renderPassId).excludedSkinnedMesh;\r\n    }\r\n\r\n    public override isReady() {\r\n        return this._rtt.isReadyForRendering();\r\n    }\r\n\r\n    public record() {\r\n        if (this.textureDescriptions.length === 0 || this.objectList === undefined) {\r\n            throw new Error(`FrameGraphGeometryRendererTask ${this.name}: object list and at least one geometry texture description must be provided`);\r\n        }\r\n\r\n        const outputTextureHandle = this._createMultiRenderTargetTexture();\r\n\r\n        const depthEnabled = this._checkDepthTextureCompatibility();\r\n\r\n        this._buildClearAttachmentsLayout();\r\n\r\n        this._registerForRenderPassId(this._rtt.renderPassId);\r\n\r\n        const outputTextureDescription = this._frameGraph.getTextureDescription(outputTextureHandle);\r\n\r\n        this._rtt._size = outputTextureDescription.size;\r\n\r\n        // Create pass\r\n        MaterialHelperGeometryRendering.MarkAsDirty(this._rtt.renderPassId, this.objectList.meshes || this._scene.meshes);\r\n\r\n        const pass = this._frameGraph.addRenderPass(this.name);\r\n\r\n        pass.setRenderTarget(outputTextureHandle);\r\n\r\n        let handle = outputTextureHandle + 1;\r\n        for (let i = 0; i < this.textureDescriptions.length; i++) {\r\n            const description = this.textureDescriptions[i];\r\n            const index = MaterialHelperGeometryRendering.GeometryTextureDescriptions.findIndex((f) => f.type === description.type);\r\n            const geometryDescription = MaterialHelperGeometryRendering.GeometryTextureDescriptions[index];\r\n\r\n            switch (geometryDescription.type) {\r\n                case Constants.PREPASS_DEPTH_TEXTURE_TYPE:\r\n                    this._frameGraph.resolveDanglingHandle(this.geometryViewDepthTexture, handle++);\r\n                    break;\r\n                case Constants.PREPASS_SCREENSPACE_DEPTH_TEXTURE_TYPE:\r\n                    this._frameGraph.resolveDanglingHandle(this.geometryScreenDepthTexture, handle++);\r\n                    break;\r\n                case Constants.PREPASS_NORMAL_TEXTURE_TYPE:\r\n                    this._frameGraph.resolveDanglingHandle(this.geometryViewNormalTexture, handle++);\r\n                    break;\r\n                case Constants.PREPASS_WORLD_NORMAL_TEXTURE_TYPE:\r\n                    this._frameGraph.resolveDanglingHandle(this.geometryWorldNormalTexture, handle++);\r\n                    break;\r\n                case Constants.PREPASS_LOCAL_POSITION_TEXTURE_TYPE:\r\n                    this._frameGraph.resolveDanglingHandle(this.geometryLocalPositionTexture, handle++);\r\n                    break;\r\n                case Constants.PREPASS_POSITION_TEXTURE_TYPE:\r\n                    this._frameGraph.resolveDanglingHandle(this.geometryWorldPositionTexture, handle++);\r\n                    break;\r\n                case Constants.PREPASS_ALBEDO_TEXTURE_TYPE:\r\n                    this._frameGraph.resolveDanglingHandle(this.geometryAlbedoTexture, handle++);\r\n                    break;\r\n                case Constants.PREPASS_REFLECTIVITY_TEXTURE_TYPE:\r\n                    this._frameGraph.resolveDanglingHandle(this.geometryReflectivityTexture, handle++);\r\n                    break;\r\n                case Constants.PREPASS_VELOCITY_TEXTURE_TYPE:\r\n                    this._frameGraph.resolveDanglingHandle(this.geometryVelocityTexture, handle++);\r\n                    break;\r\n                case Constants.PREPASS_VELOCITY_LINEAR_TEXTURE_TYPE:\r\n                    this._frameGraph.resolveDanglingHandle(this.geometryLinearVelocityTexture, handle++);\r\n                    break;\r\n            }\r\n        }\r\n\r\n        if (this.depthTexture !== undefined) {\r\n            pass.setRenderTargetDepth(this.depthTexture);\r\n        }\r\n\r\n        pass.setExecuteFunc((context) => {\r\n            this._rtt.renderList = this.objectList.meshes;\r\n            this._rtt.particleSystemList = this.objectList.particleSystems;\r\n\r\n            this._scene.incrementRenderId();\r\n            this._scene.resetCachedMaterial();\r\n\r\n            context.setDepthStates(this.depthTest && depthEnabled, this.depthWrite && depthEnabled);\r\n\r\n            this._clearAttachmentsLayout.forEach((layout, clearType) => {\r\n                context.clearColorAttachments(clearColors[clearType], layout);\r\n            });\r\n\r\n            context.bindAttachments(this._allAttachmentsLayout);\r\n\r\n            context.render(this._rtt);\r\n        });\r\n    }\r\n\r\n    public override dispose(): void {\r\n        MaterialHelperGeometryRendering.DeleteConfiguration(this._rtt.renderPassId);\r\n        this._rtt.dispose();\r\n        super.dispose();\r\n    }\r\n\r\n    private _createMultiRenderTargetTexture(): FrameGraphTextureHandle {\r\n        const types: number[] = [];\r\n        const formats: number[] = [];\r\n        const labels: string[] = [];\r\n        const useSRGBBuffers: boolean[] = [];\r\n\r\n        for (let i = 0; i < this.textureDescriptions.length; i++) {\r\n            const description = this.textureDescriptions[i];\r\n            const index = MaterialHelperGeometryRendering.GeometryTextureDescriptions.findIndex((f) => f.type === description.type);\r\n\r\n            if (index === -1) {\r\n                throw new Error(`FrameGraphGeometryRendererTask ${this.name}: unknown texture type ${description.type}`);\r\n            }\r\n\r\n            types[i] = description.textureType;\r\n            formats[i] = description.textureFormat;\r\n            labels[i] = MaterialHelperGeometryRendering.GeometryTextureDescriptions[index].name;\r\n            useSRGBBuffers[i] = false;\r\n        }\r\n\r\n        return this._frameGraph.createRenderTargetTexture(\r\n            this.name,\r\n            {\r\n                size: this.size,\r\n                sizeIsPercentage: this.sizeIsPercentage,\r\n                options: {\r\n                    createMipMaps: false,\r\n                    generateDepthBuffer: false,\r\n                    textureCount: this.textureDescriptions.length,\r\n                    samples: this.samples,\r\n                    types,\r\n                    formats,\r\n                    useSRGBBuffers,\r\n                    labels,\r\n                },\r\n            },\r\n            true\r\n        );\r\n    }\r\n\r\n    private _checkDepthTextureCompatibility(): boolean {\r\n        let depthEnabled = false;\r\n\r\n        if (this.depthTexture !== undefined) {\r\n            if (this.depthTexture === backbufferDepthStencilTextureHandle) {\r\n                throw new Error(`FrameGraphGeometryRendererTask ${this.name}: the depth/stencil back buffer is not allowed as a depth texture`);\r\n            }\r\n\r\n            const depthTextureDescription = this._frameGraph.getTextureDescription(this.depthTexture);\r\n            if (depthTextureDescription.options.samples !== this.samples) {\r\n                throw new Error(`FrameGraphGeometryRendererTask ${this.name}: the depth texture and the output texture must have the same number of samples`);\r\n            }\r\n\r\n            this._frameGraph.resolveDanglingHandle(this.outputDepthTexture, this.depthTexture);\r\n\r\n            depthEnabled = true;\r\n        }\r\n\r\n        return depthEnabled;\r\n    }\r\n\r\n    private _buildClearAttachmentsLayout() {\r\n        const clearAttachmentsLayout = new Map<GeometryRenderingTextureClearType, boolean[]>();\r\n        const allAttachmentsLayout: boolean[] = [];\r\n\r\n        for (let i = 0; i < this.textureDescriptions.length; i++) {\r\n            const description = this.textureDescriptions[i];\r\n            const index = MaterialHelperGeometryRendering.GeometryTextureDescriptions.findIndex((f) => f.type === description.type);\r\n            const geometryDescription = MaterialHelperGeometryRendering.GeometryTextureDescriptions[index];\r\n\r\n            let layout = clearAttachmentsLayout.get(geometryDescription.clearType);\r\n            if (layout === undefined) {\r\n                layout = [];\r\n                clearAttachmentsLayout.set(geometryDescription.clearType, layout);\r\n                for (let j = 0; j < i; j++) {\r\n                    layout[j] = false;\r\n                }\r\n            }\r\n\r\n            clearAttachmentsLayout.forEach((layout, clearType) => {\r\n                layout.push(clearType === geometryDescription.clearType);\r\n            });\r\n\r\n            allAttachmentsLayout.push(true);\r\n        }\r\n\r\n        this._clearAttachmentsLayout = new Map();\r\n\r\n        clearAttachmentsLayout.forEach((layout, clearType) => {\r\n            this._clearAttachmentsLayout.set(clearType, this._engine.buildTextureLayout(layout));\r\n        });\r\n\r\n        this._allAttachmentsLayout = this._engine.buildTextureLayout(allAttachmentsLayout);\r\n    }\r\n\r\n    private _registerForRenderPassId(renderPassId: number) {\r\n        const configuration = MaterialHelperGeometryRendering.CreateConfiguration(renderPassId);\r\n\r\n        for (let i = 0; i < this.textureDescriptions.length; i++) {\r\n            const description = this.textureDescriptions[i];\r\n            const index = MaterialHelperGeometryRendering.GeometryTextureDescriptions.findIndex((f) => f.type === description.type);\r\n            const geometryDescription = MaterialHelperGeometryRendering.GeometryTextureDescriptions[index];\r\n\r\n            configuration.defines[geometryDescription.defineIndex] = i;\r\n        }\r\n    }\r\n}\r\n"]}

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

@@ -0,0 +1,66 @@
+import type { FrameGraph, FrameGraphTextureHandle, Scene, Camera, FrameGraphObjectList, FrameGraphRenderContext } from "../../../index.js";
+import { RenderTargetTexture } from "../../../Materials/Textures/renderTargetTexture";
+import { FrameGraphTask } from "../../frameGraphTask";
+/**
+ * Task used to render objects to a texture.
+ */
+export declare class FrameGraphObjectRendererTask extends FrameGraphTask {
+    /**
+     * The destination texture where the objects will be rendered.
+     */
+    destinationTexture: FrameGraphTextureHandle;
+    /**
+     * The depth attachment texture where the objects will be rendered (optional).
+     */
+    depthTexture?: FrameGraphTextureHandle;
+    /**
+     * The dependencies of the task (optional).
+     */
+    dependencies?: FrameGraphTextureHandle[];
+    private _camera;
+    /**
+     * Gets or sets the camera used to render the objects.
+     */
+    get camera(): Camera;
+    set camera(camera: Camera);
+    /**
+     * The list of objects to render.
+     */
+    objectList: FrameGraphObjectList;
+    /**
+     * If depth testing should be enabled (default is true).
+     */
+    depthTest: boolean;
+    /**
+     * If depth writing should be enabled (default is true).
+     */
+    depthWrite: boolean;
+    /**
+     * The output texture.
+     */
+    readonly outputTexture: FrameGraphTextureHandle;
+    /**
+     * The output depth 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;
+    protected _scene: Scene;
+    protected _rtt: RenderTargetTexture;
+    /**
+     * The render target texture used to render the objects.
+     */
+    get renderTargetTexture(): RenderTargetTexture;
+    get name(): string;
+    set name(value: string);
+    /**
+     * Constructs a new object 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.
+     */
+    constructor(name: string, frameGraph: FrameGraph, scene: Scene);
+    isReady(): boolean;
+    record(skipCreationOfDisabledPasses?: boolean, additionalExecute?: (context: FrameGraphRenderContext) => void): void;
+    dispose(): void;
+}

package/FrameGraph/Tasks/Rendering/objectRendererTask.js

@@ -0,0 +1,127 @@
+import { backbufferColorTextureHandle, backbufferDepthStencilTextureHandle } from "../../frameGraphTypes.js";
+import { RenderTargetTexture } from "../../../Materials/Textures/renderTargetTexture.js";
+import { FrameGraphTask } from "../../frameGraphTask.js";
+/**
+ * Task used to render objects to a texture.
+ */
+export class FrameGraphObjectRendererTask extends FrameGraphTask {
+    /**
+     * Gets or sets the camera used to render the objects.
+     */
+    get camera() {
+        return this._camera;
+    }
+    set camera(camera) {
+        this._camera = camera;
+        this._rtt.activeCamera = this.camera;
+    }
+    /**
+     * The render target texture used to render the objects.
+     */
+    get renderTargetTexture() {
+        return this._rtt;
+    }
+    get name() {
+        return this._name;
+    }
+    set name(value) {
+        this._name = value;
+        if (this._rtt) {
+            this._rtt.name = value + "_internal_rtt";
+        }
+    }
+    /**
+     * Constructs a new object 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.
+     */
+    constructor(name, frameGraph, scene) {
+        super(name, frameGraph);
+        /**
+         * The dependencies of the task (optional).
+         */
+        this.dependencies = [];
+        /**
+         * If depth testing should be enabled (default is true).
+         */
+        this.depthTest = true;
+        /**
+         * If depth writing should be enabled (default is true).
+         */
+        this.depthWrite = true;
+        this._scene = scene;
+        this._rtt = new RenderTargetTexture(name, 1, scene, {
+            delayAllocation: true,
+        });
+        this._rtt.skipInitialClear = true;
+        this.name = name;
+        this.outputTexture = this._frameGraph.createDanglingHandle();
+        this.outputDepthTexture = this._frameGraph.createDanglingHandle();
+    }
+    isReady() {
+        return this._rtt.isReadyForRendering();
+    }
+    record(skipCreationOfDisabledPasses = false, additionalExecute) {
+        if (this.destinationTexture === undefined || this.objectList === undefined) {
+            throw new Error(`FrameGraphObjectRendererTask ${this.name}: destinationTexture and objectList are required`);
+        }
+        const outputTextureDescription = this._frameGraph.getTextureDescription(this.destinationTexture);
+        let depthEnabled = false;
+        if (this.depthTexture !== undefined) {
+            if (this.depthTexture === backbufferDepthStencilTextureHandle && this.destinationTexture !== backbufferColorTextureHandle) {
+                throw new Error(`FrameGraphObjectRendererTask ${this.name}: the back buffer color texture is the only color texture allowed when the depth is the back buffer depth/stencil`);
+            }
+            if (this.depthTexture !== backbufferDepthStencilTextureHandle && this.destinationTexture === backbufferColorTextureHandle) {
+                throw new Error(`FrameGraphObjectRendererTask ${this.name}: the back buffer depth/stencil texture is the only depth texture allowed when the destination is the back buffer color`);
+            }
+            const depthTextureDescription = this._frameGraph.getTextureDescription(this.depthTexture);
+            if (depthTextureDescription.options.samples !== outputTextureDescription.options.samples) {
+                throw new Error(`FrameGraphObjectRendererTask ${this.name}: the depth texture and the output texture must have the same number of samples`);
+            }
+            depthEnabled = true;
+        }
+        this._frameGraph.resolveDanglingHandle(this.outputTexture, this.destinationTexture);
+        if (this.depthTexture !== undefined) {
+            this._frameGraph.resolveDanglingHandle(this.outputDepthTexture, this.depthTexture);
+        }
+        this._rtt._size = outputTextureDescription.size;
+        const pass = this._frameGraph.addRenderPass(this.name);
+        pass.setRenderTarget(this.destinationTexture);
+        if (this.depthTexture !== undefined) {
+            pass.setRenderTargetDepth(this.depthTexture);
+        }
+        pass.setExecuteFunc((_context) => {
+            this._rtt.renderList = this.objectList.meshes;
+            this._rtt.particleSystemList = this.objectList.particleSystems;
+            this._scene.incrementRenderId();
+            this._scene.resetCachedMaterial();
+            _context.setDepthStates(this.depthTest && depthEnabled, this.depthWrite && depthEnabled);
+            _context.render(this._rtt);
+            additionalExecute?.(_context);
+        });
+        if (this.dependencies !== undefined) {
+            for (const handle of this.dependencies) {
+                pass.useTexture(handle);
+            }
+        }
+        if (!skipCreationOfDisabledPasses) {
+            const passDisabled = this._frameGraph.addRenderPass(this.name + "_disabled", true);
+            passDisabled.setRenderTarget(this.destinationTexture);
+            if (this.depthTexture !== undefined) {
+                passDisabled.setRenderTargetDepth(this.depthTexture);
+            }
+            passDisabled.setExecuteFunc((_context) => { });
+            if (this.dependencies !== undefined) {
+                for (const handle of this.dependencies) {
+                    passDisabled.useTexture(handle);
+                }
+            }
+        }
+    }
+    dispose() {
+        this._rtt.dispose();
+        super.dispose();
+    }
+}
+//# sourceMappingURL=objectRendererTask.js.map