@babylonjs/core 8.23.1 → 8.23.2

package/FrameGraph/frameGraph.js.map

@@ -1 +1 @@
-{"version":3,"file":"frameGraph.js","sourceRoot":"","sources":["../../../../dev/core/src/FrameGraph/frameGraph.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Scene, AbstractEngine, FrameGraphTask, Nullable, NodeRenderGraph } from \"core/index\";\r\nimport { FrameGraphPass } from \"./Passes/pass\";\r\nimport { FrameGraphRenderPass } from \"./Passes/renderPass\";\r\nimport { FrameGraphCullPass } from \"./Passes/cullPass\";\r\nimport { FrameGraphRenderContext } from \"./frameGraphRenderContext\";\r\nimport { FrameGraphContext } from \"./frameGraphContext\";\r\nimport { FrameGraphTextureManager } from \"./frameGraphTextureManager\";\r\nimport { Observable } from \"core/Misc/observable\";\r\nimport { _RetryWithInterval } from \"core/Misc/timingTools\";\r\nimport { Logger } from \"core/Misc/logger\";\r\nimport { UniqueIdGenerator } from \"core/Misc/uniqueIdGenerator\";\r\nimport { FindMainObjectRenderer } from \"./frameGraphUtils\";\r\n\r\nimport \"core/Engines/Extensions/engine.multiRender\";\r\nimport \"core/Engines/WebGPU/Extensions/engine.multiRender\";\r\n\r\nenum FrameGraphPassType {\r\n    Normal = 0,\r\n    Render = 1,\r\n    Cull = 2,\r\n}\r\n\r\n/**\r\n * Class used to implement a frame graph\r\n * @experimental\r\n */\r\nexport class FrameGraph {\r\n    /**\r\n     * Gets the texture manager used by the frame graph\r\n     */\r\n    public readonly textureManager: FrameGraphTextureManager;\r\n\r\n    private readonly _engine: AbstractEngine;\r\n    private readonly _scene: Scene;\r\n    private readonly _tasks: FrameGraphTask[] = [];\r\n    private readonly _passContext: FrameGraphContext;\r\n    private readonly _renderContext: FrameGraphRenderContext;\r\n    private _currentProcessedTask: FrameGraphTask | null = null;\r\n    private _whenReadyAsyncCancel: Nullable<() => void> = null;\r\n\r\n    /**\r\n     * Name of the frame graph\r\n     */\r\n    public name = \"Frame Graph\";\r\n\r\n    /**\r\n     * Gets the unique id of the frame graph\r\n     */\r\n    public readonly uniqueId = UniqueIdGenerator.UniqueId;\r\n\r\n    /**\r\n     * Gets or sets a boolean indicating that texture allocation should be optimized (that is, reuse existing textures when possible to limit GPU memory usage) (default: true)\r\n     */\r\n    public optimizeTextureAllocation = true;\r\n\r\n    /**\r\n     * Observable raised when the node render graph is built\r\n     */\r\n    public onBuildObservable = new Observable<FrameGraph>();\r\n\r\n    /**\r\n     * Gets the engine used by the frame graph\r\n     */\r\n    public get engine() {\r\n        return this._engine;\r\n    }\r\n\r\n    /**\r\n     * Gets the scene used by the frame graph\r\n     */\r\n    public get scene() {\r\n        return this._scene;\r\n    }\r\n\r\n    /**\r\n     * Gets the list of tasks in the frame graph\r\n     */\r\n    public get tasks() {\r\n        return this._tasks;\r\n    }\r\n\r\n    /**\r\n     * Gets the node render graph linked to the frame graph (if any)\r\n     * @returns the linked node render graph or null if none\r\n     */\r\n    public getLinkedNodeRenderGraph(): Nullable<NodeRenderGraph> {\r\n        return this._linkedNodeRenderGraph;\r\n    }\r\n\r\n    /**\r\n     * Constructs the frame graph\r\n     * @param scene defines the scene the frame graph is associated with\r\n     * @param debugTextures defines a boolean indicating that textures created by the frame graph should be visible in the inspector (default is false)\r\n     * @param _linkedNodeRenderGraph defines the linked node render graph (if any)\r\n     */\r\n    constructor(\r\n        scene: Scene,\r\n        debugTextures = false,\r\n        private readonly _linkedNodeRenderGraph: Nullable<NodeRenderGraph> = null\r\n    ) {\r\n        this._scene = scene;\r\n        this._engine = scene.getEngine();\r\n        this.textureManager = new FrameGraphTextureManager(this._engine, debugTextures, scene);\r\n        this._passContext = new FrameGraphContext(this._engine, this.textureManager, scene);\r\n        this._renderContext = new FrameGraphRenderContext(this._engine, this.textureManager, scene);\r\n\r\n        this._scene.addFrameGraph(this);\r\n    }\r\n\r\n    /**\r\n     * Gets the class name of the frame graph\r\n     * @returns the class name\r\n     */\r\n    public getClassName() {\r\n        return \"FrameGraph\";\r\n    }\r\n\r\n    /**\r\n     * Gets a task by name\r\n     * @param name Name of the task to get\r\n     * @returns The task or undefined if not found\r\n     */\r\n    public getTaskByName<T extends FrameGraphTask>(name: string): T | undefined {\r\n        return this._tasks.find((t) => t.name === name) as T;\r\n    }\r\n\r\n    /**\r\n     * Gets all tasks of a specific type\r\n     * @param taskType Type of the task(s) to get\r\n     * @returns The list of tasks of the specified type\r\n     */\r\n    public getTasksByType<T extends FrameGraphTask>(taskType: new (...args: any[]) => T): T[] {\r\n        return this._tasks.filter((t) => t instanceof taskType) as T[];\r\n    }\r\n\r\n    /**\r\n     * Adds a task to the frame graph\r\n     * @param task Task to add\r\n     */\r\n    public addTask(task: FrameGraphTask): void {\r\n        if (this._currentProcessedTask !== null) {\r\n            throw new Error(`FrameGraph.addTask: Can't add the task \"${task.name}\" while another task is currently building (task: ${this._currentProcessedTask.name}).`);\r\n        }\r\n\r\n        this._tasks.push(task);\r\n    }\r\n\r\n    /**\r\n     * Adds a pass to a task. This method can only be called during a Task.record execution.\r\n     * @param name The name of the pass\r\n     * @param whenTaskDisabled If true, the pass will be added to the list of passes to execute when the task is disabled (default is false)\r\n     * @returns The render pass created\r\n     */\r\n    public addPass(name: string, whenTaskDisabled = false): FrameGraphPass<FrameGraphContext> {\r\n        return this._addPass(name, FrameGraphPassType.Normal, whenTaskDisabled) as FrameGraphPass<FrameGraphContext>;\r\n    }\r\n\r\n    /**\r\n     * Adds a render pass to a task. This method can only be called during a Task.record execution.\r\n     * @param name The name of the pass\r\n     * @param whenTaskDisabled If true, the pass will be added to the list of passes to execute when the task is disabled (default is false)\r\n     * @returns The render pass created\r\n     */\r\n    public addRenderPass(name: string, whenTaskDisabled = false): FrameGraphRenderPass {\r\n        return this._addPass(name, FrameGraphPassType.Render, whenTaskDisabled) as FrameGraphRenderPass;\r\n    }\r\n\r\n    /**\r\n     * Adds a cull pass to a task. This method can only be called during a Task.record execution.\r\n     * @param name The name of the pass\r\n     * @param whenTaskDisabled If true, the pass will be added to the list of passes to execute when the task is disabled (default is false)\r\n     * @returns The cull pass created\r\n     */\r\n    public addCullPass(name: string, whenTaskDisabled = false): FrameGraphCullPass {\r\n        return this._addPass(name, FrameGraphPassType.Cull, whenTaskDisabled) as FrameGraphCullPass;\r\n    }\r\n\r\n    private _addPass(name: string, passType: FrameGraphPassType, whenTaskDisabled = false): FrameGraphPass<FrameGraphContext> | FrameGraphRenderPass {\r\n        if (!this._currentProcessedTask) {\r\n            throw new Error(\"FrameGraph: A pass must be created during a Task.record execution only.\");\r\n        }\r\n\r\n        let pass: FrameGraphPass<FrameGraphContext> | FrameGraphRenderPass;\r\n\r\n        switch (passType) {\r\n            case FrameGraphPassType.Render:\r\n                pass = new FrameGraphRenderPass(name, this._currentProcessedTask, this._renderContext, this._engine);\r\n                break;\r\n            case FrameGraphPassType.Cull:\r\n                pass = new FrameGraphCullPass(name, this._currentProcessedTask, this._passContext, this._engine);\r\n                break;\r\n            default:\r\n                pass = new FrameGraphPass(name, this._currentProcessedTask, this._passContext);\r\n                break;\r\n        }\r\n\r\n        this._currentProcessedTask._addPass(pass, whenTaskDisabled);\r\n\r\n        return pass;\r\n    }\r\n\r\n    /**\r\n     * Builds the frame graph.\r\n     * This method should be called after all tasks have been added to the frame graph (FrameGraph.addTask) and before the graph is executed (FrameGraph.execute).\r\n     */\r\n    public build(): void {\r\n        this.textureManager._releaseTextures(false);\r\n\r\n        try {\r\n            for (const task of this._tasks) {\r\n                task._reset();\r\n\r\n                this._currentProcessedTask = task;\r\n                this.textureManager._isRecordingTask = true;\r\n\r\n                task.record();\r\n\r\n                this.textureManager._isRecordingTask = false;\r\n                this._currentProcessedTask = null;\r\n            }\r\n\r\n            // The user expects bouding boxes to render for the main object renderer\r\n            // It also lets the \"show bounding box\" option in the inspector work\r\n            const mainObjectRenderer = FindMainObjectRenderer(this);\r\n            if (mainObjectRenderer) {\r\n                mainObjectRenderer.objectRenderer.enableBoundingBoxRendering = true;\r\n            }\r\n\r\n            this.textureManager._allocateTextures(this.optimizeTextureAllocation ? this._tasks : undefined);\r\n\r\n            for (const task of this._tasks) {\r\n                task._checkTask();\r\n            }\r\n\r\n            for (const task of this._tasks) {\r\n                task.onTexturesAllocatedObservable.notifyObservers(this._renderContext);\r\n            }\r\n\r\n            this.onBuildObservable.notifyObservers(this);\r\n        } catch (e) {\r\n            this._tasks.length = 0;\r\n            this._currentProcessedTask = null;\r\n            this.textureManager._isRecordingTask = false;\r\n            throw e;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Returns a promise that resolves when the frame graph is ready to be executed\r\n     * This method must be called after the graph has been built (FrameGraph.build called)!\r\n     * @param timeStep Time step in ms between retries (default is 16)\r\n     * @param maxTimeout Maximum time in ms to wait for the graph to be ready (default is 30000)\r\n     * @returns The promise that resolves when the graph is ready\r\n     */\r\n    public async whenReadyAsync(timeStep = 16, maxTimeout = 30000): Promise<void> {\r\n        let firstNotReadyTask: FrameGraphTask | null = null;\r\n        return await new Promise((resolve) => {\r\n            this._whenReadyAsyncCancel = _RetryWithInterval(\r\n                () => {\r\n                    let ready = this._renderContext._isReady();\r\n                    for (const task of this._tasks) {\r\n                        const taskIsReady = task.isReady();\r\n                        if (!taskIsReady && !firstNotReadyTask) {\r\n                            firstNotReadyTask = task;\r\n                        }\r\n                        ready &&= taskIsReady;\r\n                    }\r\n                    return ready;\r\n                },\r\n                () => {\r\n                    this._whenReadyAsyncCancel = null;\r\n                    resolve();\r\n                },\r\n                (err, isTimeout) => {\r\n                    this._whenReadyAsyncCancel = null;\r\n                    if (!isTimeout) {\r\n                        Logger.Error(\"FrameGraph: An unexpected error occurred while waiting for the frame graph to be ready.\");\r\n                        if (err) {\r\n                            Logger.Error(err);\r\n                            if (err.stack) {\r\n                                Logger.Error(err.stack);\r\n                            }\r\n                        }\r\n                    } else {\r\n                        Logger.Error(\r\n                            `FrameGraph: Timeout while waiting for the frame graph to be ready.${firstNotReadyTask ? ` First task not ready: ${firstNotReadyTask.name}` : \"\"}`\r\n                        );\r\n                        if (err) {\r\n                            Logger.Error(err);\r\n                        }\r\n                    }\r\n                },\r\n                timeStep,\r\n                maxTimeout\r\n            );\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Executes the frame graph.\r\n     */\r\n    public execute(): void {\r\n        this._renderContext.bindRenderTarget();\r\n\r\n        this.textureManager._updateHistoryTextures();\r\n\r\n        for (const task of this._tasks) {\r\n            const passes = task._getPasses();\r\n\r\n            for (const pass of passes) {\r\n                pass._execute();\r\n            }\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Clears the frame graph (remove the tasks and release the textures).\r\n     * The frame graph can be built again after this method is called.\r\n     */\r\n    public clear(): void {\r\n        this._whenReadyAsyncCancel?.();\r\n        this._whenReadyAsyncCancel = null;\r\n\r\n        for (const task of this._tasks) {\r\n            task._reset();\r\n        }\r\n\r\n        this._tasks.length = 0;\r\n        this.textureManager._releaseTextures();\r\n        this._currentProcessedTask = null;\r\n    }\r\n\r\n    /**\r\n     * Disposes the frame graph\r\n     */\r\n    public dispose(): void {\r\n        this._whenReadyAsyncCancel?.();\r\n        this._whenReadyAsyncCancel = null;\r\n        this.clear();\r\n        this.textureManager._dispose();\r\n        this._renderContext._dispose();\r\n\r\n        this._scene.removeFrameGraph(this);\r\n    }\r\n}\r\n"]}
+{"version":3,"file":"frameGraph.js","sourceRoot":"","sources":["../../../../dev/core/src/FrameGraph/frameGraph.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Scene, AbstractEngine, FrameGraphTask, Nullable, NodeRenderGraph } from \"core/index\";\r\nimport { FrameGraphPass } from \"./Passes/pass\";\r\nimport { FrameGraphRenderPass } from \"./Passes/renderPass\";\r\nimport { FrameGraphCullPass } from \"./Passes/cullPass\";\r\nimport { FrameGraphRenderContext } from \"./frameGraphRenderContext\";\r\nimport { FrameGraphContext } from \"./frameGraphContext\";\r\nimport { FrameGraphTextureManager } from \"./frameGraphTextureManager\";\r\nimport { Observable } from \"core/Misc/observable\";\r\nimport { _RetryWithInterval } from \"core/Misc/timingTools\";\r\nimport { Logger } from \"core/Misc/logger\";\r\nimport { UniqueIdGenerator } from \"core/Misc/uniqueIdGenerator\";\r\n\r\nimport \"core/Engines/Extensions/engine.multiRender\";\r\nimport \"core/Engines/WebGPU/Extensions/engine.multiRender\";\r\n\r\nenum FrameGraphPassType {\r\n    Normal = 0,\r\n    Render = 1,\r\n    Cull = 2,\r\n}\r\n\r\n/**\r\n * Class used to implement a frame graph\r\n * @experimental\r\n */\r\nexport class FrameGraph {\r\n    /**\r\n     * Gets the texture manager used by the frame graph\r\n     */\r\n    public readonly textureManager: FrameGraphTextureManager;\r\n\r\n    private readonly _engine: AbstractEngine;\r\n    private readonly _scene: Scene;\r\n    private readonly _tasks: FrameGraphTask[] = [];\r\n    private readonly _passContext: FrameGraphContext;\r\n    private readonly _renderContext: FrameGraphRenderContext;\r\n    private _currentProcessedTask: FrameGraphTask | null = null;\r\n    private _whenReadyAsyncCancel: Nullable<() => void> = null;\r\n\r\n    /**\r\n     * Name of the frame graph\r\n     */\r\n    public name = \"Frame Graph\";\r\n\r\n    /**\r\n     * Gets the unique id of the frame graph\r\n     */\r\n    public readonly uniqueId = UniqueIdGenerator.UniqueId;\r\n\r\n    /**\r\n     * Gets or sets a boolean indicating that texture allocation should be optimized (that is, reuse existing textures when possible to limit GPU memory usage) (default: true)\r\n     */\r\n    public optimizeTextureAllocation = true;\r\n\r\n    /**\r\n     * Observable raised when the node render graph is built\r\n     */\r\n    public onBuildObservable = new Observable<FrameGraph>();\r\n\r\n    /**\r\n     * Gets the engine used by the frame graph\r\n     */\r\n    public get engine() {\r\n        return this._engine;\r\n    }\r\n\r\n    /**\r\n     * Gets the scene used by the frame graph\r\n     */\r\n    public get scene() {\r\n        return this._scene;\r\n    }\r\n\r\n    /**\r\n     * Gets the list of tasks in the frame graph\r\n     */\r\n    public get tasks() {\r\n        return this._tasks;\r\n    }\r\n\r\n    /**\r\n     * Gets the node render graph linked to the frame graph (if any)\r\n     * @returns the linked node render graph or null if none\r\n     */\r\n    public getLinkedNodeRenderGraph(): Nullable<NodeRenderGraph> {\r\n        return this._linkedNodeRenderGraph;\r\n    }\r\n\r\n    /**\r\n     * Constructs the frame graph\r\n     * @param scene defines the scene the frame graph is associated with\r\n     * @param debugTextures defines a boolean indicating that textures created by the frame graph should be visible in the inspector (default is false)\r\n     * @param _linkedNodeRenderGraph defines the linked node render graph (if any)\r\n     */\r\n    constructor(\r\n        scene: Scene,\r\n        debugTextures = false,\r\n        private readonly _linkedNodeRenderGraph: Nullable<NodeRenderGraph> = null\r\n    ) {\r\n        this._scene = scene;\r\n        this._engine = scene.getEngine();\r\n        this.textureManager = new FrameGraphTextureManager(this._engine, debugTextures, scene);\r\n        this._passContext = new FrameGraphContext(this._engine, this.textureManager, scene);\r\n        this._renderContext = new FrameGraphRenderContext(this._engine, this.textureManager, scene);\r\n\r\n        this._scene.addFrameGraph(this);\r\n    }\r\n\r\n    /**\r\n     * Gets the class name of the frame graph\r\n     * @returns the class name\r\n     */\r\n    public getClassName() {\r\n        return \"FrameGraph\";\r\n    }\r\n\r\n    /**\r\n     * Gets a task by name\r\n     * @param name Name of the task to get\r\n     * @returns The task or undefined if not found\r\n     */\r\n    public getTaskByName<T extends FrameGraphTask>(name: string): T | undefined {\r\n        return this._tasks.find((t) => t.name === name) as T;\r\n    }\r\n\r\n    /**\r\n     * Gets all tasks of a specific type\r\n     * @param taskType Type of the task(s) to get\r\n     * @returns The list of tasks of the specified type\r\n     */\r\n    public getTasksByType<T extends FrameGraphTask>(taskType: new (...args: any[]) => T): T[] {\r\n        return this._tasks.filter((t) => t instanceof taskType) as T[];\r\n    }\r\n\r\n    /**\r\n     * Adds a task to the frame graph\r\n     * @param task Task to add\r\n     */\r\n    public addTask(task: FrameGraphTask): void {\r\n        if (this._currentProcessedTask !== null) {\r\n            throw new Error(`FrameGraph.addTask: Can't add the task \"${task.name}\" while another task is currently building (task: ${this._currentProcessedTask.name}).`);\r\n        }\r\n\r\n        this._tasks.push(task);\r\n    }\r\n\r\n    /**\r\n     * Adds a pass to a task. This method can only be called during a Task.record execution.\r\n     * @param name The name of the pass\r\n     * @param whenTaskDisabled If true, the pass will be added to the list of passes to execute when the task is disabled (default is false)\r\n     * @returns The render pass created\r\n     */\r\n    public addPass(name: string, whenTaskDisabled = false): FrameGraphPass<FrameGraphContext> {\r\n        return this._addPass(name, FrameGraphPassType.Normal, whenTaskDisabled) as FrameGraphPass<FrameGraphContext>;\r\n    }\r\n\r\n    /**\r\n     * Adds a render pass to a task. This method can only be called during a Task.record execution.\r\n     * @param name The name of the pass\r\n     * @param whenTaskDisabled If true, the pass will be added to the list of passes to execute when the task is disabled (default is false)\r\n     * @returns The render pass created\r\n     */\r\n    public addRenderPass(name: string, whenTaskDisabled = false): FrameGraphRenderPass {\r\n        return this._addPass(name, FrameGraphPassType.Render, whenTaskDisabled) as FrameGraphRenderPass;\r\n    }\r\n\r\n    /**\r\n     * Adds a cull pass to a task. This method can only be called during a Task.record execution.\r\n     * @param name The name of the pass\r\n     * @param whenTaskDisabled If true, the pass will be added to the list of passes to execute when the task is disabled (default is false)\r\n     * @returns The cull pass created\r\n     */\r\n    public addCullPass(name: string, whenTaskDisabled = false): FrameGraphCullPass {\r\n        return this._addPass(name, FrameGraphPassType.Cull, whenTaskDisabled) as FrameGraphCullPass;\r\n    }\r\n\r\n    private _addPass(name: string, passType: FrameGraphPassType, whenTaskDisabled = false): FrameGraphPass<FrameGraphContext> | FrameGraphRenderPass {\r\n        if (!this._currentProcessedTask) {\r\n            throw new Error(\"FrameGraph: A pass must be created during a Task.record execution only.\");\r\n        }\r\n\r\n        let pass: FrameGraphPass<FrameGraphContext> | FrameGraphRenderPass;\r\n\r\n        switch (passType) {\r\n            case FrameGraphPassType.Render:\r\n                pass = new FrameGraphRenderPass(name, this._currentProcessedTask, this._renderContext, this._engine);\r\n                break;\r\n            case FrameGraphPassType.Cull:\r\n                pass = new FrameGraphCullPass(name, this._currentProcessedTask, this._passContext, this._engine);\r\n                break;\r\n            default:\r\n                pass = new FrameGraphPass(name, this._currentProcessedTask, this._passContext);\r\n                break;\r\n        }\r\n\r\n        this._currentProcessedTask._addPass(pass, whenTaskDisabled);\r\n\r\n        return pass;\r\n    }\r\n\r\n    /**\r\n     * Builds the frame graph.\r\n     * This method should be called after all tasks have been added to the frame graph (FrameGraph.addTask) and before the graph is executed (FrameGraph.execute).\r\n     */\r\n    public build(): void {\r\n        this.textureManager._releaseTextures(false);\r\n\r\n        try {\r\n            for (const task of this._tasks) {\r\n                task._reset();\r\n\r\n                this._currentProcessedTask = task;\r\n                this.textureManager._isRecordingTask = true;\r\n\r\n                task.record();\r\n\r\n                this.textureManager._isRecordingTask = false;\r\n                this._currentProcessedTask = null;\r\n            }\r\n\r\n            this.textureManager._allocateTextures(this.optimizeTextureAllocation ? this._tasks : undefined);\r\n\r\n            for (const task of this._tasks) {\r\n                task._checkTask();\r\n            }\r\n\r\n            for (const task of this._tasks) {\r\n                task.onTexturesAllocatedObservable.notifyObservers(this._renderContext);\r\n            }\r\n\r\n            this.onBuildObservable.notifyObservers(this);\r\n        } catch (e) {\r\n            this._tasks.length = 0;\r\n            this._currentProcessedTask = null;\r\n            this.textureManager._isRecordingTask = false;\r\n            throw e;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Returns a promise that resolves when the frame graph is ready to be executed\r\n     * This method must be called after the graph has been built (FrameGraph.build called)!\r\n     * @param timeStep Time step in ms between retries (default is 16)\r\n     * @param maxTimeout Maximum time in ms to wait for the graph to be ready (default is 30000)\r\n     * @returns The promise that resolves when the graph is ready\r\n     */\r\n    public async whenReadyAsync(timeStep = 16, maxTimeout = 30000): Promise<void> {\r\n        let firstNotReadyTask: FrameGraphTask | null = null;\r\n        return await new Promise((resolve) => {\r\n            this._whenReadyAsyncCancel = _RetryWithInterval(\r\n                () => {\r\n                    let ready = this._renderContext._isReady();\r\n                    for (const task of this._tasks) {\r\n                        const taskIsReady = task.isReady();\r\n                        if (!taskIsReady && !firstNotReadyTask) {\r\n                            firstNotReadyTask = task;\r\n                        }\r\n                        ready &&= taskIsReady;\r\n                    }\r\n                    return ready;\r\n                },\r\n                () => {\r\n                    this._whenReadyAsyncCancel = null;\r\n                    resolve();\r\n                },\r\n                (err, isTimeout) => {\r\n                    this._whenReadyAsyncCancel = null;\r\n                    if (!isTimeout) {\r\n                        Logger.Error(\"FrameGraph: An unexpected error occurred while waiting for the frame graph to be ready.\");\r\n                        if (err) {\r\n                            Logger.Error(err);\r\n                            if (err.stack) {\r\n                                Logger.Error(err.stack);\r\n                            }\r\n                        }\r\n                    } else {\r\n                        Logger.Error(\r\n                            `FrameGraph: Timeout while waiting for the frame graph to be ready.${firstNotReadyTask ? ` First task not ready: ${firstNotReadyTask.name}` : \"\"}`\r\n                        );\r\n                        if (err) {\r\n                            Logger.Error(err);\r\n                        }\r\n                    }\r\n                },\r\n                timeStep,\r\n                maxTimeout\r\n            );\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Executes the frame graph.\r\n     */\r\n    public execute(): void {\r\n        this._renderContext.bindRenderTarget();\r\n\r\n        this.textureManager._updateHistoryTextures();\r\n\r\n        for (const task of this._tasks) {\r\n            const passes = task._getPasses();\r\n\r\n            for (const pass of passes) {\r\n                pass._execute();\r\n            }\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Clears the frame graph (remove the tasks and release the textures).\r\n     * The frame graph can be built again after this method is called.\r\n     */\r\n    public clear(): void {\r\n        this._whenReadyAsyncCancel?.();\r\n        this._whenReadyAsyncCancel = null;\r\n\r\n        for (const task of this._tasks) {\r\n            task._reset();\r\n        }\r\n\r\n        this._tasks.length = 0;\r\n        this.textureManager._releaseTextures();\r\n        this._currentProcessedTask = null;\r\n    }\r\n\r\n    /**\r\n     * Disposes the frame graph\r\n     */\r\n    public dispose(): void {\r\n        this._whenReadyAsyncCancel?.();\r\n        this._whenReadyAsyncCancel = null;\r\n        this.clear();\r\n        this.textureManager._dispose();\r\n        this._renderContext._dispose();\r\n\r\n        this._scene.removeFrameGraph(this);\r\n    }\r\n}\r\n"]}

package/FrameGraph/frameGraphRenderTarget.js

@@ -17,7 +17,7 @@ export class FrameGraphRenderTarget {
         if (!this._renderTargetWrapper) {
             const engine = this._textureManager.engine;
             // _renderTargets and _renderTargetDepth cannot both be undefined
-            const textureHandle = this._renderTargets === undefined ? this._renderTargetDepth : this._renderTargets[0];
+            const textureHandle = this._renderTargets === undefined || this._renderTargets.length === 0 ? this._renderTargetDepth : this._renderTargets[0];
             if (this._textureManager.isBackbuffer(textureHandle)) {
                 this._isBackBuffer = true;
                 return undefined;

package/FrameGraph/frameGraphRenderTarget.js.map

@@ -1 +1 @@
-{"version":3,"file":"frameGraphRenderTarget.js","sourceRoot":"","sources":["../../../../dev/core/src/FrameGraph/frameGraphRenderTarget.ts"],"names":[],"mappings":"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","sourcesContent":["import type { FrameGraphTextureHandle, FrameGraphTextureManager, IMultiRenderTargetOptions, RenderTargetWrapper } from \"core/index\";\r\n\r\n/**\r\n * @internal\r\n * @experimental\r\n */\r\nexport class FrameGraphRenderTarget {\r\n    protected readonly _textureManager: FrameGraphTextureManager;\r\n    protected readonly _renderTargets: FrameGraphTextureHandle[] | undefined;\r\n    protected readonly _renderTargetDepth: FrameGraphTextureHandle | undefined;\r\n    protected _renderTargetWrapper: RenderTargetWrapper | undefined;\r\n    protected _isBackBuffer = false;\r\n\r\n    public readonly name: string;\r\n\r\n    constructor(\r\n        name: string,\r\n        textureManager: FrameGraphTextureManager,\r\n        renderTargets?: FrameGraphTextureHandle | FrameGraphTextureHandle[],\r\n        renderTargetDepth?: FrameGraphTextureHandle\r\n    ) {\r\n        this.name = name;\r\n        this._textureManager = textureManager;\r\n        this._renderTargets = renderTargets === undefined ? undefined : Array.isArray(renderTargets) ? renderTargets : [renderTargets];\r\n        this._renderTargetDepth = renderTargetDepth;\r\n    }\r\n\r\n    public get renderTargetWrapper() {\r\n        if (this._isBackBuffer) {\r\n            return undefined;\r\n        }\r\n\r\n        if (!this._renderTargetWrapper) {\r\n            const engine = this._textureManager.engine;\r\n\r\n            // _renderTargets and _renderTargetDepth cannot both be undefined\r\n            const textureHandle = this._renderTargets === undefined ? this._renderTargetDepth! : this._renderTargets[0];\r\n\r\n            if (this._textureManager.isBackbuffer(textureHandle)) {\r\n                this._isBackBuffer = true;\r\n                return undefined;\r\n            }\r\n\r\n            const textureDescription = this._textureManager.getTextureDescription(textureHandle);\r\n\r\n            const creationOptionsForTexture: IMultiRenderTargetOptions = {\r\n                textureCount: this._renderTargets?.length ?? 0,\r\n                generateDepthBuffer: false,\r\n                label: this.name,\r\n                samples: textureDescription.options.samples ?? 1,\r\n                dontCreateTextures: true,\r\n            };\r\n\r\n            this._renderTargetWrapper = engine.createMultipleRenderTarget(textureDescription.size, creationOptionsForTexture, true);\r\n\r\n            for (let i = 0; i < creationOptionsForTexture.textureCount!; i++) {\r\n                const handle = this._renderTargets![i];\r\n                const texture = this._textureManager.getTextureFromHandle(handle);\r\n\r\n                if (!texture) {\r\n                    throw new Error(\r\n                        `FrameGraphRenderTarget.renderTargetWrapper: Failed to get texture from handle. handle: ${handle}, name: ${this.name}, index: ${i}, renderTargets: ${this._renderTargets}`\r\n                    );\r\n                }\r\n\r\n                this._renderTargetWrapper.setTexture(texture, i, false);\r\n            }\r\n\r\n            if (this._renderTargetDepth !== undefined) {\r\n                this._renderTargetWrapper.setDepthStencilTexture(this._textureManager.getTextureFromHandle(this._renderTargetDepth), false);\r\n            }\r\n        }\r\n\r\n        return this._renderTargetWrapper;\r\n    }\r\n\r\n    public equals(other: FrameGraphRenderTarget): boolean {\r\n        const src = this._renderTargets;\r\n        const dst = other._renderTargets;\r\n\r\n        if (src !== undefined && dst !== undefined) {\r\n            if (src.length !== dst.length) {\r\n                return false;\r\n            }\r\n\r\n            for (let i = 0; i < src.length; i++) {\r\n                if (src[i] !== dst[i]) {\r\n                    return false;\r\n                }\r\n            }\r\n        } else if ((src === undefined && dst !== undefined) || (src !== undefined && dst === undefined)) {\r\n            return false;\r\n        }\r\n\r\n        return this._renderTargetDepth === other._renderTargetDepth;\r\n    }\r\n}\r\n"]}
+{"version":3,"file":"frameGraphRenderTarget.js","sourceRoot":"","sources":["../../../../dev/core/src/FrameGraph/frameGraphRenderTarget.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,sBAAsB;IAS/B,YACI,IAAY,EACZ,cAAwC,EACxC,aAAmE,EACnE,iBAA2C;QARrC,kBAAa,GAAG,KAAK,CAAC;QAU5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;QACtC,IAAI,CAAC,cAAc,GAAG,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;QAC/H,IAAI,CAAC,kBAAkB,GAAG,iBAAiB,CAAC;IAChD,CAAC;IAED,IAAW,mBAAmB;QAC1B,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACrB,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC;YAE3C,iEAAiE;YACjE,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,KAAK,SAAS,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;YAEhJ,IAAI,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,CAAC;gBACnD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;gBAC1B,OAAO,SAAS,CAAC;YACrB,CAAC;YAED,MAAM,kBAAkB,GAAG,IAAI,CAAC,eAAe,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC;YAErF,MAAM,yBAAyB,GAA8B;gBACzD,YAAY,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC;gBAC9C,mBAAmB,EAAE,KAAK;gBAC1B,KAAK,EAAE,IAAI,CAAC,IAAI;gBAChB,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC;gBAChD,kBAAkB,EAAE,IAAI;aAC3B,CAAC;YAEF,IAAI,CAAC,oBAAoB,GAAG,MAAM,CAAC,0BAA0B,CAAC,kBAAkB,CAAC,IAAI,EAAE,yBAAyB,EAAE,IAAI,CAAC,CAAC;YAExH,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,yBAAyB,CAAC,YAAa,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,cAAe,CAAC,CAAC,CAAC,CAAC;gBACvC,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;gBAElE,IAAI,CAAC,OAAO,EAAE,CAAC;oBACX,MAAM,IAAI,KAAK,CACX,0FAA0F,MAAM,WAAW,IAAI,CAAC,IAAI,YAAY,CAAC,oBAAoB,IAAI,CAAC,cAAc,EAAE,CAC7K,CAAC;gBACN,CAAC;gBAED,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;YAC5D,CAAC;YAED,IAAI,IAAI,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;gBACxC,IAAI,CAAC,oBAAoB,CAAC,sBAAsB,CAAC,IAAI,CAAC,eAAe,CAAC,oBAAoB,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,KAAK,CAAC,CAAC;YAChI,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC,oBAAoB,CAAC;IACrC,CAAC;IAEM,MAAM,CAAC,KAA6B;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC;QAChC,MAAM,GAAG,GAAG,KAAK,CAAC,cAAc,CAAC;QAEjC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACzC,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC;gBAC5B,OAAO,KAAK,CAAC;YACjB,CAAC;YAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAClC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBACpB,OAAO,KAAK,CAAC;gBACjB,CAAC;YACL,CAAC;QACL,CAAC;aAAM,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,CAAC,EAAE,CAAC;YAC9F,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,OAAO,IAAI,CAAC,kBAAkB,KAAK,KAAK,CAAC,kBAAkB,CAAC;IAChE,CAAC;CACJ","sourcesContent":["import type { FrameGraphTextureHandle, FrameGraphTextureManager, IMultiRenderTargetOptions, RenderTargetWrapper } from \"core/index\";\r\n\r\n/**\r\n * @internal\r\n * @experimental\r\n */\r\nexport class FrameGraphRenderTarget {\r\n    protected readonly _textureManager: FrameGraphTextureManager;\r\n    protected readonly _renderTargets: FrameGraphTextureHandle[] | undefined;\r\n    protected readonly _renderTargetDepth: FrameGraphTextureHandle | undefined;\r\n    protected _renderTargetWrapper: RenderTargetWrapper | undefined;\r\n    protected _isBackBuffer = false;\r\n\r\n    public readonly name: string;\r\n\r\n    constructor(\r\n        name: string,\r\n        textureManager: FrameGraphTextureManager,\r\n        renderTargets?: FrameGraphTextureHandle | FrameGraphTextureHandle[],\r\n        renderTargetDepth?: FrameGraphTextureHandle\r\n    ) {\r\n        this.name = name;\r\n        this._textureManager = textureManager;\r\n        this._renderTargets = renderTargets === undefined ? undefined : Array.isArray(renderTargets) ? renderTargets : [renderTargets];\r\n        this._renderTargetDepth = renderTargetDepth;\r\n    }\r\n\r\n    public get renderTargetWrapper() {\r\n        if (this._isBackBuffer) {\r\n            return undefined;\r\n        }\r\n\r\n        if (!this._renderTargetWrapper) {\r\n            const engine = this._textureManager.engine;\r\n\r\n            // _renderTargets and _renderTargetDepth cannot both be undefined\r\n            const textureHandle = this._renderTargets === undefined || this._renderTargets.length === 0 ? this._renderTargetDepth! : this._renderTargets[0];\r\n\r\n            if (this._textureManager.isBackbuffer(textureHandle)) {\r\n                this._isBackBuffer = true;\r\n                return undefined;\r\n            }\r\n\r\n            const textureDescription = this._textureManager.getTextureDescription(textureHandle);\r\n\r\n            const creationOptionsForTexture: IMultiRenderTargetOptions = {\r\n                textureCount: this._renderTargets?.length ?? 0,\r\n                generateDepthBuffer: false,\r\n                label: this.name,\r\n                samples: textureDescription.options.samples ?? 1,\r\n                dontCreateTextures: true,\r\n            };\r\n\r\n            this._renderTargetWrapper = engine.createMultipleRenderTarget(textureDescription.size, creationOptionsForTexture, true);\r\n\r\n            for (let i = 0; i < creationOptionsForTexture.textureCount!; i++) {\r\n                const handle = this._renderTargets![i];\r\n                const texture = this._textureManager.getTextureFromHandle(handle);\r\n\r\n                if (!texture) {\r\n                    throw new Error(\r\n                        `FrameGraphRenderTarget.renderTargetWrapper: Failed to get texture from handle. handle: ${handle}, name: ${this.name}, index: ${i}, renderTargets: ${this._renderTargets}`\r\n                    );\r\n                }\r\n\r\n                this._renderTargetWrapper.setTexture(texture, i, false);\r\n            }\r\n\r\n            if (this._renderTargetDepth !== undefined) {\r\n                this._renderTargetWrapper.setDepthStencilTexture(this._textureManager.getTextureFromHandle(this._renderTargetDepth), false);\r\n            }\r\n        }\r\n\r\n        return this._renderTargetWrapper;\r\n    }\r\n\r\n    public equals(other: FrameGraphRenderTarget): boolean {\r\n        const src = this._renderTargets;\r\n        const dst = other._renderTargets;\r\n\r\n        if (src !== undefined && dst !== undefined) {\r\n            if (src.length !== dst.length) {\r\n                return false;\r\n            }\r\n\r\n            for (let i = 0; i < src.length; i++) {\r\n                if (src[i] !== dst[i]) {\r\n                    return false;\r\n                }\r\n            }\r\n        } else if ((src === undefined && dst !== undefined) || (src !== undefined && dst === undefined)) {\r\n            return false;\r\n        }\r\n\r\n        return this._renderTargetDepth === other._renderTargetDepth;\r\n    }\r\n}\r\n"]}

package/Lights/Clustered/clusteredLightContainer.d.ts

@@ -0,0 +1,90 @@
+import type { Effect } from "../../Materials/effect.js";
+import { RenderTargetTexture } from "../../Materials/Textures/renderTargetTexture.js";
+import type { Scene } from "../../scene.js";
+import { Light } from "../light.js";
+import "../../Meshes/thinInstanceMesh.js";
+/**
+ * A special light that renders all its associated spot or point lights using a clustered or forward+ system.
+ */
+export declare class ClusteredLightContainer extends Light {
+    private static _GetEngineBatchSize;
+    /**
+     * Checks if the clustered lighting system supports the given light with its current parameters.
+     * This will also check if the light's associated engine supports clustered lighting.
+     *
+     * @param light The light to test
+     * @returns true if the light and its engine is supported
+     */
+    static IsLightSupported(light: Light): boolean;
+    /** @internal */
+    static _SceneComponentInitialization: (scene: Scene) => void;
+    private readonly _batchSize;
+    /**
+     * True if clustered lighting is supported.
+     */
+    get isSupported(): boolean;
+    private readonly _lights;
+    /**
+     * Gets the current list of lights added to this clustering system.
+     */
+    get lights(): readonly Light[];
+    private _lightDataBuffer;
+    private _lightDataTexture;
+    private _tileMaskBatches;
+    private _tileMaskTexture;
+    private _tileMaskBuffer;
+    private _horizontalTiles;
+    /**
+     * The number of tiles in the horizontal direction to cluster lights into.
+     * A lower value will reduce memory and make the clustering step faster, while a higher value increases memory and makes the rendering step faster.
+     */
+    get horizontalTiles(): number;
+    set horizontalTiles(horizontal: number);
+    private _verticalTiles;
+    /**
+     * The number of tiles in the vertical direction to cluster lights into.
+     * A lower value will reduce memory and make the clustering step faster, while a higher value increases memory and makes the rendering step faster.
+     */
+    get verticalTiles(): number;
+    set verticalTiles(vertical: number);
+    private readonly _proxyMaterial;
+    private readonly _proxyMesh;
+    private _maxRange;
+    private _minInverseSquaredRange;
+    /**
+     * This limits the range of all the added lights, so even lights with extreme ranges will still have bounds for clustering.
+     */
+    get maxRange(): number;
+    set maxRange(range: number);
+    /**
+     * Creates a new clustered light system with an initial set of lights.
+     *
+     * @param name The name of the clustered light container
+     * @param lights The initial set of lights to add
+     * @param scene The scene the clustered light container belongs to
+     */
+    constructor(name: string, lights?: Light[], scene?: Scene);
+    getClassName(): string;
+    getTypeID(): number;
+    /** @internal */
+    _updateBatches(): RenderTargetTexture;
+    private _updateLightData;
+    dispose(doNotRecurse?: boolean, disposeMaterialAndTextures?: boolean): void;
+    /**
+     * Adds a light to the clustering system.
+     * @param light The light to add
+     */
+    addLight(light: Light): void;
+    /**
+     * Removes a light from the clustering system.
+     * @param light The light to remove
+     * @returns the index where the light was in the light list
+     */
+    removeLight(light: Light): number;
+    protected _buildUniformLayout(): void;
+    transferToEffect(effect: Effect, lightIndex: string): Light;
+    transferTexturesToEffect(effect: Effect, lightIndex: string): Light;
+    transferToNodeMaterialEffect(): Light;
+    prepareLightSpecificDefines(defines: any, lightIndex: number): void;
+    _isReady(): boolean;
+}

package/Lights/Clustered/clusteredLightContainer.js

@@ -0,0 +1,401 @@
+import { __decorate } from "../../tslib.es6.js";
+import { StorageBuffer } from "../../Buffers/storageBuffer.js";
+
+import { ShaderMaterial } from "../../Materials/shaderMaterial.js";
+import { RawTexture } from "../../Materials/Textures/rawTexture.js";
+import { RenderTargetTexture } from "../../Materials/Textures/renderTargetTexture.js";
+import { TmpColors } from "../../Maths/math.color.js";
+import { TmpVectors, Vector3 } from "../../Maths/math.vector.js";
+import { CreatePlane } from "../../Meshes/Builders/planeBuilder.js";
+import { _WarnImport } from "../../Misc/devTools.js";
+import { serialize } from "../../Misc/decorators.js";
+import { Logger } from "../../Misc/logger.js";
+import { RegisterClass } from "../../Misc/typeStore.js";
+import { Node } from "../../node.js";
+import { Light } from "../light.js";
+import { LightConstants } from "../lightConstants.js";
+import "../../Meshes/thinInstanceMesh.js";
+Node.AddNodeConstructor("Light_Type_5", (name, scene) => {
+    return () => new ClusteredLightContainer(name, [], scene);
+});
+/**
+ * A special light that renders all its associated spot or point lights using a clustered or forward+ system.
+ */
+export class ClusteredLightContainer extends Light {
+    static _GetEngineBatchSize(engine) {
+        const caps = engine._caps;
+        if (!caps.texelFetch) {
+            return 0;
+        }
+        else if (engine.isWebGPU) {
+            // On WebGPU we use atomic writes to storage textures
+            return 32;
+        }
+        else if (engine.version > 1) {
+            // On WebGL 2 we use additive float blending as the light mask
+            if (!caps.colorBufferFloat || !caps.blendFloat) {
+                return 0;
+            }
+            // Due to the use of floats we want to limit lights to the precision of floats
+            return caps.shaderFloatPrecision;
+        }
+        else {
+            // WebGL 1 is not supported due to lack of dynamic for loops
+            return 0;
+        }
+    }
+    /**
+     * Checks if the clustered lighting system supports the given light with its current parameters.
+     * This will also check if the light's associated engine supports clustered lighting.
+     *
+     * @param light The light to test
+     * @returns true if the light and its engine is supported
+     */
+    static IsLightSupported(light) {
+        if (ClusteredLightContainer._GetEngineBatchSize(light.getEngine()) === 0) {
+            return false;
+        }
+        else if (light.shadowEnabled && light._scene.shadowsEnabled && light.getShadowGenerators()) {
+            // Shadows are not supported
+            return false;
+        }
+        else if (light.falloffType !== Light.FALLOFF_DEFAULT) {
+            // Only the default falloff is supported
+            return false;
+        }
+        else if (light.getTypeID() === LightConstants.LIGHTTYPEID_POINTLIGHT) {
+            return true;
+        }
+        else if (light.getTypeID() === LightConstants.LIGHTTYPEID_SPOTLIGHT) {
+            // Extra texture bindings per light are not supported
+            return !light.projectionTexture && !light.iesProfileTexture;
+        }
+        else {
+            // Currently only point and spot lights are supported
+            return false;
+        }
+    }
+    /**
+     * True if clustered lighting is supported.
+     */
+    get isSupported() {
+        return this._batchSize > 0;
+    }
+    /**
+     * Gets the current list of lights added to this clustering system.
+     */
+    get lights() {
+        return this._lights;
+    }
+    /**
+     * The number of tiles in the horizontal direction to cluster lights into.
+     * A lower value will reduce memory and make the clustering step faster, while a higher value increases memory and makes the rendering step faster.
+     */
+    get horizontalTiles() {
+        return this._horizontalTiles;
+    }
+    set horizontalTiles(horizontal) {
+        if (this._horizontalTiles === horizontal) {
+            return;
+        }
+        this._horizontalTiles = horizontal;
+        // Force the batch data to be recreated
+        this._tileMaskBatches = -1;
+    }
+    /**
+     * The number of tiles in the vertical direction to cluster lights into.
+     * A lower value will reduce memory and make the clustering step faster, while a higher value increases memory and makes the rendering step faster.
+     */
+    get verticalTiles() {
+        return this._verticalTiles;
+    }
+    set verticalTiles(vertical) {
+        if (this._verticalTiles === vertical) {
+            return;
+        }
+        this._verticalTiles = vertical;
+        // Force the batch data to be recreated
+        this._tileMaskBatches = -1;
+    }
+    /**
+     * This limits the range of all the added lights, so even lights with extreme ranges will still have bounds for clustering.
+     */
+    get maxRange() {
+        return this._maxRange;
+    }
+    set maxRange(range) {
+        if (this._maxRange === range) {
+            return;
+        }
+        this._maxRange = range;
+        this._minInverseSquaredRange = 1 / (range * range);
+    }
+    /**
+     * Creates a new clustered light system with an initial set of lights.
+     *
+     * @param name The name of the clustered light container
+     * @param lights The initial set of lights to add
+     * @param scene The scene the clustered light container belongs to
+     */
+    constructor(name, lights = [], scene) {
+        super(name, scene);
+        this._lights = [];
+        this._tileMaskBatches = -1;
+        this._horizontalTiles = 64;
+        this._verticalTiles = 64;
+        this._maxRange = 16383;
+        this._minInverseSquaredRange = 1 / (this._maxRange * this._maxRange);
+        const engine = this.getEngine();
+        this._batchSize = ClusteredLightContainer._GetEngineBatchSize(engine);
+        const proxyShader = { vertex: "lightProxy", fragment: "lightProxy" };
+        this._proxyMaterial = new ShaderMaterial("ProxyMaterial", this._scene, proxyShader, {
+            attributes: ["position"],
+            uniforms: ["view", "projection", "tileMaskResolution"],
+            samplers: ["lightDataTexture"],
+            uniformBuffers: ["Scene"],
+            storageBuffers: ["tileMaskBuffer"],
+            defines: [`CLUSTLIGHT_BATCH ${this._batchSize}`],
+            shaderLanguage: engine.isWebGPU ? 1 /* ShaderLanguage.WGSL */ : 0 /* ShaderLanguage.GLSL */,
+            extraInitializationsAsync: async () => {
+                if (engine.isWebGPU) {
+                    await Promise.all([import("../../ShadersWGSL/lightProxy.vertex.js"), import("../../ShadersWGSL/lightProxy.fragment.js")]);
+                }
+                else {
+                    await Promise.all([import("../../Shaders/lightProxy.vertex.js"), import("../../Shaders/lightProxy.fragment.js")]);
+                }
+            },
+        });
+        // Additive blending is for merging masks on WebGL
+        this._proxyMaterial.transparencyMode = ShaderMaterial.MATERIAL_ALPHABLEND;
+        this._proxyMaterial.alphaMode = 1;
+        this._proxyMesh = CreatePlane("ProxyMesh", { size: 2 });
+        // Make sure it doesn't render for the default scene
+        this._scene.removeMesh(this._proxyMesh);
+        this._proxyMesh.material = this._proxyMaterial;
+        this._updateBatches();
+        if (this._batchSize > 0) {
+            ClusteredLightContainer._SceneComponentInitialization(this._scene);
+            for (const light of lights) {
+                this.addLight(light);
+            }
+        }
+    }
+    getClassName() {
+        return "ClusteredLightContainer";
+    }
+    // eslint-disable-next-line @typescript-eslint/naming-convention
+    getTypeID() {
+        return LightConstants.LIGHTTYPEID_CLUSTERED_CONTAINER;
+    }
+    /** @internal */
+    _updateBatches() {
+        this._proxyMesh.isVisible = this._lights.length > 0;
+        // Ensure space for atleast 1 batch
+        const batches = Math.max(Math.ceil(this._lights.length / this._batchSize), 1);
+        if (this._tileMaskBatches >= batches) {
+            this._proxyMesh.thinInstanceCount = this._lights.length;
+            return this._tileMaskTexture;
+        }
+        const engine = this.getEngine();
+        // Round up to a batch size so we don't have to reallocate as often
+        const maxLights = batches * this._batchSize;
+        this._lightDataBuffer = new Float32Array(20 * maxLights);
+        this._lightDataTexture?.dispose();
+        this._lightDataTexture = new RawTexture(this._lightDataBuffer, 5, maxLights, 5, this._scene, false, false, 1, 1);
+        this._proxyMaterial.setTexture("lightDataTexture", this._lightDataTexture);
+        this._tileMaskTexture?.dispose();
+        const textureSize = { width: this._horizontalTiles, height: this._verticalTiles };
+        if (!engine.isWebGPU) {
+            // In WebGL we shift the light proxy by the batch number
+            textureSize.height *= batches;
+        }
+        this._tileMaskTexture = new RenderTargetTexture("TileMaskTexture", textureSize, this._scene, {
+            // We don't write anything on WebGPU so make it as small as possible
+            type: engine.isWebGPU ? 0 : 1,
+            format: 6,
+            generateDepthBuffer: false,
+        });
+        this._tileMaskTexture.renderParticles = false;
+        this._tileMaskTexture.renderSprites = false;
+        this._tileMaskTexture.noPrePassRenderer = true;
+        this._tileMaskTexture.renderList = [this._proxyMesh];
+        this._tileMaskTexture.onBeforeBindObservable.add(() => {
+            this._updateLightData();
+        });
+        this._tileMaskTexture.onClearObservable.add(() => {
+            if (engine.isWebGPU) {
+                // Clear the storage buffer for WebGPU
+                this._tileMaskBuffer?.clear();
+            }
+            else {
+                // Only clear the texture on WebGL
+                engine.clear({ r: 0, g: 0, b: 0, a: 1 }, true, false);
+            }
+        });
+        if (engine.isWebGPU) {
+            // WebGPU also needs a storage buffer to write to
+            this._tileMaskBuffer?.dispose();
+            const bufferSize = this._horizontalTiles * this._verticalTiles * batches * 4;
+            this._tileMaskBuffer = new StorageBuffer(engine, bufferSize);
+            this._proxyMaterial.setStorageBuffer("tileMaskBuffer", this._tileMaskBuffer);
+        }
+        this._proxyMaterial.setVector3("tileMaskResolution", new Vector3(this._horizontalTiles, this.verticalTiles, batches));
+        // We don't actually use the matrix data but we need enough capacity for the lights
+        this._proxyMesh.thinInstanceSetBuffer("matrix", new Float32Array(maxLights * 16));
+        this._proxyMesh.thinInstanceCount = this._lights.length;
+        this._tileMaskBatches = batches;
+        return this._tileMaskTexture;
+    }
+    _updateLightData() {
+        const buf = this._lightDataBuffer;
+        for (let i = 0; i < this._lights.length; i += 1) {
+            const light = this._lights[i];
+            const off = i * 20;
+            const computed = light.computeTransformedInformation();
+            const scaledIntensity = light.getScaledIntensity();
+            const position = computed ? light.transformedPosition : light.position;
+            const diffuse = light.diffuse.scaleToRef(scaledIntensity, TmpColors.Color3[0]);
+            const specular = light.specular.scaleToRef(scaledIntensity, TmpColors.Color3[1]);
+            const range = Math.min(light.range, this.maxRange);
+            const inverseSquaredRange = Math.max(light._inverseSquaredRange, this._minInverseSquaredRange);
+            // vLightData
+            buf[off + 0] = position.x;
+            buf[off + 1] = position.y;
+            buf[off + 2] = position.z;
+            buf[off + 3] = 0;
+            // vLightDiffuse
+            buf[off + 4] = diffuse.r;
+            buf[off + 5] = diffuse.g;
+            buf[off + 6] = diffuse.b;
+            buf[off + 7] = range;
+            // vLightSpecular
+            buf[off + 8] = specular.r;
+            buf[off + 9] = specular.g;
+            buf[off + 10] = specular.b;
+            buf[off + 11] = light.radius;
+            // vLightDirection
+            buf[off + 12] = 0;
+            buf[off + 13] = 0;
+            buf[off + 14] = 0;
+            buf[off + 15] = -1;
+            // vLightFalloff
+            buf[off + 16] = range;
+            buf[off + 17] = inverseSquaredRange;
+            buf[off + 18] = 0;
+            buf[off + 19] = 0;
+            if (light.getTypeID() === LightConstants.LIGHTTYPEID_SPOTLIGHT) {
+                const spotLight = light;
+                const direction = Vector3.NormalizeToRef(computed ? spotLight.transformedDirection : spotLight.direction, TmpVectors.Vector3[0]);
+                // vLightData.a
+                buf[off + 3] = spotLight.exponent;
+                // vLightDirection
+                buf[off + 12] = direction.x;
+                buf[off + 13] = direction.y;
+                buf[off + 14] = direction.z;
+                buf[off + 15] = spotLight._cosHalfAngle;
+                // vLightFalloff.zw
+                buf[off + 18] = spotLight._lightAngleScale;
+                buf[off + 19] = spotLight._lightAngleOffset;
+            }
+        }
+        this._lightDataTexture.update(this._lightDataBuffer);
+    }
+    dispose(doNotRecurse, disposeMaterialAndTextures) {
+        for (const light of this._lights) {
+            light.dispose(doNotRecurse, disposeMaterialAndTextures);
+        }
+        this._lightDataTexture.dispose();
+        this._tileMaskTexture.dispose();
+        this._tileMaskBuffer?.dispose();
+        this._proxyMesh.dispose(doNotRecurse, disposeMaterialAndTextures);
+        super.dispose(doNotRecurse, disposeMaterialAndTextures);
+    }
+    /**
+     * Adds a light to the clustering system.
+     * @param light The light to add
+     */
+    addLight(light) {
+        if (!ClusteredLightContainer.IsLightSupported(light)) {
+            Logger.Warn("Attempting to add a light to cluster that does not support clustering");
+            return;
+        }
+        this._scene.removeLight(light);
+        this._lights.push(light);
+        this._proxyMesh.isVisible = true;
+        this._proxyMesh.thinInstanceCount = this._lights.length;
+    }
+    /**
+     * Removes a light from the clustering system.
+     * @param light The light to remove
+     * @returns the index where the light was in the light list
+     */
+    removeLight(light) {
+        const index = this.lights.indexOf(light);
+        if (index === -1) {
+            return index;
+        }
+        this._lights.splice(index, 1);
+        this._scene.addLight(light);
+        this._proxyMesh.thinInstanceCount = this._lights.length;
+        if (this._lights.length === 0) {
+            this._proxyMesh.isVisible = false;
+        }
+        return index;
+    }
+    _buildUniformLayout() {
+        this._uniformBuffer.addUniform("vLightData", 4);
+        this._uniformBuffer.addUniform("vLightDiffuse", 4);
+        this._uniformBuffer.addUniform("vLightSpecular", 4);
+        this._uniformBuffer.addUniform("vNumLights", 1);
+        this._uniformBuffer.addUniform("shadowsInfo", 3);
+        this._uniformBuffer.addUniform("depthValues", 2);
+        this._uniformBuffer.create();
+    }
+    transferToEffect(effect, lightIndex) {
+        const engine = this.getEngine();
+        const hscale = this._horizontalTiles / engine.getRenderWidth();
+        const vscale = this._verticalTiles / engine.getRenderHeight();
+        this._uniformBuffer.updateFloat4("vLightData", hscale, vscale, this._verticalTiles, this._tileMaskBatches, lightIndex);
+        this._uniformBuffer.updateFloat("vNumLights", this._lights.length, lightIndex);
+        return this;
+    }
+    transferTexturesToEffect(effect, lightIndex) {
+        const engine = this.getEngine();
+        effect.setTexture("lightDataTexture" + lightIndex, this._lightDataTexture);
+        if (engine.isWebGPU) {
+            engine.setStorageBuffer("tileMaskBuffer" + lightIndex, this._tileMaskBuffer);
+        }
+        else {
+            effect.setTexture("tileMaskTexture" + lightIndex, this._tileMaskTexture);
+        }
+        return this;
+    }
+    transferToNodeMaterialEffect() {
+        // TODO: ????
+        return this;
+    }
+    prepareLightSpecificDefines(defines, lightIndex) {
+        defines["CLUSTLIGHT" + lightIndex] = true;
+        defines["CLUSTLIGHT_BATCH"] = this._batchSize;
+    }
+    _isReady() {
+        this._updateBatches();
+        return this._proxyMesh.isReady(true, true);
+    }
+}
+/** @internal */
+ClusteredLightContainer._SceneComponentInitialization = () => {
+    throw _WarnImport("ClusteredLightingSceneComponent");
+};
+__decorate([
+    serialize()
+], ClusteredLightContainer.prototype, "horizontalTiles", null);
+__decorate([
+    serialize()
+], ClusteredLightContainer.prototype, "verticalTiles", null);
+__decorate([
+    serialize()
+], ClusteredLightContainer.prototype, "maxRange", null);
+// Register Class Name
+RegisterClass("BABYLON.ClusteredLightContainer", ClusteredLightContainer);
+//# sourceMappingURL=clusteredLightContainer.js.map