@babylonjs/core 8.38.0 → 8.39.1

package/FrameGraph/Node/Blocks/PostProcesses/volumetricLightingBlock.d.ts

@@ -0,0 +1,74 @@
+import type { FrameGraph, NodeRenderGraphBuildState, NodeRenderGraphConnectionPoint, Scene } from "../../../../index.js";
+import { NodeRenderGraphBlock } from "../../nodeRenderGraphBlock.js";
+import { FrameGraphVolumetricLightingTask } from "../../../Tasks/PostProcesses/volumetricLightingTask.js";
+import { Vector3 } from "../../../../Maths/math.vector.js";
+import { Color3 } from "../../../../Maths/math.color.js";
+/**
+ * Block that implements the volumetric lighting post process
+ */
+export declare class NodeRenderGraphVolumetricLightingBlock extends NodeRenderGraphBlock {
+    protected _frameGraphTask: FrameGraphVolumetricLightingTask;
+    _additionalConstructionParameters: [boolean];
+    /**
+     * Gets the frame graph task associated with this block
+     */
+    get task(): FrameGraphVolumetricLightingTask;
+    /**
+     * Create a new NodeRenderGraphVolumetricLightingBlock
+     * @param name defines the block name
+     * @param frameGraph defines the hosting frame graph
+     * @param scene defines the hosting scene
+     * @param enableExtinction defines whether to enable extinction coefficients
+     */
+    constructor(name: string, frameGraph: FrameGraph, scene: Scene, enableExtinction?: boolean);
+    private _createTask;
+    /** Gets or sets the phaseG parameter */
+    get phaseG(): number;
+    set phaseG(value: number);
+    /** If extinction coefficients should be used */
+    get enableExtinction(): boolean;
+    set enableExtinction(value: boolean);
+    /** Gets or sets the extinction color */
+    get extinction(): Vector3;
+    set extinction(value: Vector3);
+    /** Gets or sets the light power */
+    get lightPower(): Color3;
+    set lightPower(value: Color3);
+    /**
+     * Gets the current class name
+     * @returns the class name
+     */
+    getClassName(): string;
+    /**
+     * Gets the target input component
+     */
+    get target(): NodeRenderGraphConnectionPoint;
+    /**
+     * Gets the depth texture input component
+     */
+    get depth(): NodeRenderGraphConnectionPoint;
+    /**
+     * Gets the camera input component
+     */
+    get camera(): NodeRenderGraphConnectionPoint;
+    /**
+     * Gets the lighting volume mesh input component
+     */
+    get lightingVolumeMesh(): NodeRenderGraphConnectionPoint;
+    /**
+     * Gets the light input component
+     */
+    get light(): NodeRenderGraphConnectionPoint;
+    /**
+     * Gets the lighting volume texture input component
+     */
+    get lightingVolumeTexture(): NodeRenderGraphConnectionPoint;
+    /**
+     * Gets the output component
+     */
+    get output(): NodeRenderGraphConnectionPoint;
+    protected _buildBlock(state: NodeRenderGraphBuildState): void;
+    protected _dumpPropertiesCode(): string;
+    serialize(): any;
+    _deserialize(serializationObject: any): void;
+}

package/FrameGraph/Node/Blocks/PostProcesses/volumetricLightingBlock.js

@@ -0,0 +1,179 @@
+import { __decorate } from "../../../../tslib.es6.js";
+import { RegisterClass } from "../../../../Misc/typeStore.js";
+import { editableInPropertyPage } from "../../../../Decorators/nodeDecorator.js";
+import { NodeRenderGraphBlock } from "../../nodeRenderGraphBlock.js";
+import { FrameGraphVolumetricLightingTask } from "../../../Tasks/PostProcesses/volumetricLightingTask.js";
+import { NodeRenderGraphBlockConnectionPointTypes } from "../../Types/nodeRenderGraphTypes.js";
+import { Vector3 } from "../../../../Maths/math.vector.js";
+import { Color3 } from "../../../../Maths/math.color.js";
+/**
+ * Block that implements the volumetric lighting post process
+ */
+export class NodeRenderGraphVolumetricLightingBlock extends NodeRenderGraphBlock {
+    /**
+     * Gets the frame graph task associated with this block
+     */
+    get task() {
+        return this._frameGraphTask;
+    }
+    /**
+     * Create a new NodeRenderGraphVolumetricLightingBlock
+     * @param name defines the block name
+     * @param frameGraph defines the hosting frame graph
+     * @param scene defines the hosting scene
+     * @param enableExtinction defines whether to enable extinction coefficients
+     */
+    constructor(name, frameGraph, scene, enableExtinction = false) {
+        super(name, frameGraph, scene);
+        this._additionalConstructionParameters = [enableExtinction];
+        this.registerInput("target", NodeRenderGraphBlockConnectionPointTypes.AutoDetect);
+        this.registerInput("depth", NodeRenderGraphBlockConnectionPointTypes.AutoDetect);
+        this.registerInput("camera", NodeRenderGraphBlockConnectionPointTypes.Camera);
+        this.registerInput("lightingVolumeMesh", NodeRenderGraphBlockConnectionPointTypes.ObjectList);
+        this.registerInput("light", NodeRenderGraphBlockConnectionPointTypes.ShadowLight);
+        this.registerInput("lightingVolumeTexture", NodeRenderGraphBlockConnectionPointTypes.AutoDetect, true);
+        this.target.addExcludedConnectionPointFromAllowedTypes(NodeRenderGraphBlockConnectionPointTypes.TextureAllButBackBuffer);
+        this.lightingVolumeTexture.addExcludedConnectionPointFromAllowedTypes(NodeRenderGraphBlockConnectionPointTypes.TextureAllButBackBuffer);
+        this.depth.addExcludedConnectionPointFromAllowedTypes(NodeRenderGraphBlockConnectionPointTypes.TextureDepthStencilAttachment | NodeRenderGraphBlockConnectionPointTypes.TextureScreenDepth);
+        this._addDependenciesInput();
+        this.registerOutput("output", NodeRenderGraphBlockConnectionPointTypes.BasedOnInput);
+        this.output._typeConnectionSource = () => {
+            return this.target;
+        };
+        this._frameGraphTask = new FrameGraphVolumetricLightingTask(name, frameGraph, enableExtinction);
+    }
+    _createTask(enableExtinction) {
+        const sourceSamplingMode = this._frameGraphTask.sourceSamplingMode;
+        const phaseG = this._frameGraphTask.phaseG;
+        const extinction = this._frameGraphTask.extinction;
+        const lightPower = this._frameGraphTask.lightPower;
+        this._frameGraphTask.dispose();
+        this._frameGraphTask = new FrameGraphVolumetricLightingTask(this.name, this._frameGraph, enableExtinction);
+        this._frameGraphTask.sourceSamplingMode = sourceSamplingMode;
+        this._frameGraphTask.phaseG = phaseG;
+        this._frameGraphTask.extinction = extinction;
+        this._frameGraphTask.lightPower = lightPower;
+        this._additionalConstructionParameters = [enableExtinction];
+    }
+    /** Gets or sets the phaseG parameter */
+    get phaseG() {
+        return this._frameGraphTask.phaseG;
+    }
+    set phaseG(value) {
+        this._frameGraphTask.phaseG = value;
+    }
+    /** If extinction coefficients should be used */
+    get enableExtinction() {
+        return this._frameGraphTask.enableExtinction;
+    }
+    set enableExtinction(value) {
+        this._createTask(value);
+    }
+    /** Gets or sets the extinction color */
+    get extinction() {
+        return this._frameGraphTask.extinction;
+    }
+    set extinction(value) {
+        this._frameGraphTask.extinction = value;
+    }
+    /** Gets or sets the light power */
+    get lightPower() {
+        return this._frameGraphTask.lightPower;
+    }
+    set lightPower(value) {
+        this._frameGraphTask.lightPower = value;
+    }
+    /**
+     * Gets the current class name
+     * @returns the class name
+     */
+    getClassName() {
+        return "NodeRenderGraphVolumetricLightingBlock";
+    }
+    /**
+     * Gets the target input component
+     */
+    get target() {
+        return this._inputs[0];
+    }
+    /**
+     * Gets the depth texture input component
+     */
+    get depth() {
+        return this._inputs[1];
+    }
+    /**
+     * Gets the camera input component
+     */
+    get camera() {
+        return this._inputs[2];
+    }
+    /**
+     * Gets the lighting volume mesh input component
+     */
+    get lightingVolumeMesh() {
+        return this._inputs[3];
+    }
+    /**
+     * Gets the light input component
+     */
+    get light() {
+        return this._inputs[4];
+    }
+    /**
+     * Gets the lighting volume texture input component
+     */
+    get lightingVolumeTexture() {
+        return this._inputs[5];
+    }
+    /**
+     * Gets the output component
+     */
+    get output() {
+        return this._outputs[0];
+    }
+    _buildBlock(state) {
+        super._buildBlock(state);
+        this.output.value = this._frameGraphTask.outputTexture;
+        this._frameGraphTask.targetTexture = this.target.connectedPoint?.value;
+        this._frameGraphTask.depthTexture = this.depth.connectedPoint?.value;
+        this._frameGraphTask.camera = this.camera.connectedPoint?.value;
+        this._frameGraphTask.lightingVolumeMesh = this.lightingVolumeMesh.connectedPoint?.value;
+        this._frameGraphTask.light = this.light.connectedPoint?.value;
+        this._frameGraphTask.lightingVolumeTexture = this.lightingVolumeTexture.connectedPoint?.value;
+    }
+    _dumpPropertiesCode() {
+        const codes = [];
+        codes.push(`${this._codeVariableName}.phaseG = ${this.phaseG};`);
+        codes.push(`${this._codeVariableName}.extinction = new BABYLON.Vector3(${this.extinction.x}, ${this.extinction.y}, ${this.extinction.z});`);
+        codes.push(`${this._codeVariableName}.lightPower = new Color3(${this.lightPower.r}, ${this.lightPower.g}, ${this.lightPower.b});`);
+        return super._dumpPropertiesCode() + codes.join("\n");
+    }
+    serialize() {
+        const serializationObject = super.serialize();
+        serializationObject.phaseG = this.phaseG;
+        serializationObject.extinction = this.extinction.asArray();
+        serializationObject.lightPower = this.lightPower.asArray();
+        return serializationObject;
+    }
+    _deserialize(serializationObject) {
+        super._deserialize(serializationObject);
+        this.phaseG = serializationObject.phaseG;
+        this.extinction = Vector3.FromArray(serializationObject.extinction);
+        this.lightPower = Color3.FromArray(serializationObject.lightPower);
+    }
+}
+__decorate([
+    editableInPropertyPage("PhaseG", 1 /* PropertyTypeForEdition.Float */, "PROPERTIES", { min: -0.9, max: 0.9 })
+], NodeRenderGraphVolumetricLightingBlock.prototype, "phaseG", null);
+__decorate([
+    editableInPropertyPage("Enable extinction", 0 /* PropertyTypeForEdition.Boolean */, "PROPERTIES")
+], NodeRenderGraphVolumetricLightingBlock.prototype, "enableExtinction", null);
+__decorate([
+    editableInPropertyPage("Extinction", 4 /* PropertyTypeForEdition.Vector3 */, "PROPERTIES")
+], NodeRenderGraphVolumetricLightingBlock.prototype, "extinction", null);
+__decorate([
+    editableInPropertyPage("Light power", 6 /* PropertyTypeForEdition.Color3 */, "PROPERTIES")
+], NodeRenderGraphVolumetricLightingBlock.prototype, "lightPower", null);
+RegisterClass("BABYLON.NodeRenderGraphVolumetricLightingBlock", NodeRenderGraphVolumetricLightingBlock);
+//# sourceMappingURL=volumetricLightingBlock.js.map

package/FrameGraph/Node/Blocks/PostProcesses/volumetricLightingBlock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"volumetricLightingBlock.js","sourceRoot":"","sources":["../../../../../../../dev/core/src/FrameGraph/Node/Blocks/PostProcesses/volumetricLightingBlock.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\r\n    Camera,\r\n    DirectionalLight,\r\n    FrameGraph,\r\n    FrameGraphObjectList,\r\n    FrameGraphTextureHandle,\r\n    NodeRenderGraphBuildState,\r\n    NodeRenderGraphConnectionPoint,\r\n    Scene,\r\n} from \"core/index\";\r\nimport { RegisterClass } from \"../../../../Misc/typeStore\";\r\nimport { editableInPropertyPage, PropertyTypeForEdition } from \"../../../../Decorators/nodeDecorator\";\r\nimport { NodeRenderGraphBlock } from \"../../nodeRenderGraphBlock\";\r\nimport { FrameGraphVolumetricLightingTask } from \"core/FrameGraph/Tasks/PostProcesses/volumetricLightingTask\";\r\nimport { NodeRenderGraphBlockConnectionPointTypes } from \"../../Types/nodeRenderGraphTypes\";\r\nimport { Vector3 } from \"core/Maths/math.vector\";\r\nimport { Color3 } from \"core/Maths/math.color\";\r\n\r\n/**\r\n * Block that implements the volumetric lighting post process\r\n */\r\nexport class NodeRenderGraphVolumetricLightingBlock extends NodeRenderGraphBlock {\r\n    protected override _frameGraphTask: FrameGraphVolumetricLightingTask;\r\n\r\n    public override _additionalConstructionParameters: [boolean];\r\n\r\n    /**\r\n     * Gets the frame graph task associated with this block\r\n     */\r\n    public override get task() {\r\n        return this._frameGraphTask;\r\n    }\r\n\r\n    /**\r\n     * Create a new NodeRenderGraphVolumetricLightingBlock\r\n     * @param name defines the block name\r\n     * @param frameGraph defines the hosting frame graph\r\n     * @param scene defines the hosting scene\r\n     * @param enableExtinction defines whether to enable extinction coefficients\r\n     */\r\n    public constructor(name: string, frameGraph: FrameGraph, scene: Scene, enableExtinction = false) {\r\n        super(name, frameGraph, scene);\r\n\r\n        this._additionalConstructionParameters = [enableExtinction];\r\n\r\n        this.registerInput(\"target\", NodeRenderGraphBlockConnectionPointTypes.AutoDetect);\r\n        this.registerInput(\"depth\", NodeRenderGraphBlockConnectionPointTypes.AutoDetect);\r\n        this.registerInput(\"camera\", NodeRenderGraphBlockConnectionPointTypes.Camera);\r\n        this.registerInput(\"lightingVolumeMesh\", NodeRenderGraphBlockConnectionPointTypes.ObjectList);\r\n        this.registerInput(\"light\", NodeRenderGraphBlockConnectionPointTypes.ShadowLight);\r\n        this.registerInput(\"lightingVolumeTexture\", NodeRenderGraphBlockConnectionPointTypes.AutoDetect, true);\r\n\r\n        this.target.addExcludedConnectionPointFromAllowedTypes(NodeRenderGraphBlockConnectionPointTypes.TextureAllButBackBuffer);\r\n        this.lightingVolumeTexture.addExcludedConnectionPointFromAllowedTypes(NodeRenderGraphBlockConnectionPointTypes.TextureAllButBackBuffer);\r\n\r\n        this.depth.addExcludedConnectionPointFromAllowedTypes(\r\n            NodeRenderGraphBlockConnectionPointTypes.TextureDepthStencilAttachment | NodeRenderGraphBlockConnectionPointTypes.TextureScreenDepth\r\n        );\r\n\r\n        this._addDependenciesInput();\r\n\r\n        this.registerOutput(\"output\", NodeRenderGraphBlockConnectionPointTypes.BasedOnInput);\r\n\r\n        this.output._typeConnectionSource = () => {\r\n            return this.target;\r\n        };\r\n\r\n        this._frameGraphTask = new FrameGraphVolumetricLightingTask(name, frameGraph, enableExtinction);\r\n    }\r\n\r\n    private _createTask(enableExtinction: boolean) {\r\n        const sourceSamplingMode = this._frameGraphTask.sourceSamplingMode;\r\n        const phaseG = this._frameGraphTask.phaseG;\r\n        const extinction = this._frameGraphTask.extinction;\r\n        const lightPower = this._frameGraphTask.lightPower;\r\n\r\n        this._frameGraphTask.dispose();\r\n\r\n        this._frameGraphTask = new FrameGraphVolumetricLightingTask(this.name, this._frameGraph, enableExtinction);\r\n        this._frameGraphTask.sourceSamplingMode = sourceSamplingMode;\r\n        this._frameGraphTask.phaseG = phaseG;\r\n        this._frameGraphTask.extinction = extinction;\r\n        this._frameGraphTask.lightPower = lightPower;\r\n\r\n        this._additionalConstructionParameters = [enableExtinction];\r\n    }\r\n\r\n    /** Gets or sets the phaseG parameter */\r\n    @editableInPropertyPage(\"PhaseG\", PropertyTypeForEdition.Float, \"PROPERTIES\", { min: -0.9, max: 0.9 })\r\n    public get phaseG(): number {\r\n        return this._frameGraphTask.phaseG;\r\n    }\r\n\r\n    public set phaseG(value: number) {\r\n        this._frameGraphTask.phaseG = value;\r\n    }\r\n\r\n    /** If extinction coefficients should be used */\r\n    @editableInPropertyPage(\"Enable extinction\", PropertyTypeForEdition.Boolean, \"PROPERTIES\")\r\n    public get enableExtinction(): boolean {\r\n        return this._frameGraphTask.enableExtinction;\r\n    }\r\n\r\n    public set enableExtinction(value: boolean) {\r\n        this._createTask(value);\r\n    }\r\n\r\n    /** Gets or sets the extinction color */\r\n    @editableInPropertyPage(\"Extinction\", PropertyTypeForEdition.Vector3, \"PROPERTIES\")\r\n    public get extinction(): Vector3 {\r\n        return this._frameGraphTask.extinction;\r\n    }\r\n\r\n    public set extinction(value: Vector3) {\r\n        this._frameGraphTask.extinction = value;\r\n    }\r\n\r\n    /** Gets or sets the light power */\r\n    @editableInPropertyPage(\"Light power\", PropertyTypeForEdition.Color3, \"PROPERTIES\")\r\n    public get lightPower(): Color3 {\r\n        return this._frameGraphTask.lightPower;\r\n    }\r\n\r\n    public set lightPower(value: Color3) {\r\n        this._frameGraphTask.lightPower = value;\r\n    }\r\n\r\n    /**\r\n     * Gets the current class name\r\n     * @returns the class name\r\n     */\r\n    public override getClassName() {\r\n        return \"NodeRenderGraphVolumetricLightingBlock\";\r\n    }\r\n\r\n    /**\r\n     * Gets the target input component\r\n     */\r\n    public get target(): NodeRenderGraphConnectionPoint {\r\n        return this._inputs[0];\r\n    }\r\n\r\n    /**\r\n     * Gets the depth texture input component\r\n     */\r\n    public get depth(): NodeRenderGraphConnectionPoint {\r\n        return this._inputs[1];\r\n    }\r\n\r\n    /**\r\n     * Gets the camera input component\r\n     */\r\n    public get camera(): NodeRenderGraphConnectionPoint {\r\n        return this._inputs[2];\r\n    }\r\n\r\n    /**\r\n     * Gets the lighting volume mesh input component\r\n     */\r\n    public get lightingVolumeMesh(): NodeRenderGraphConnectionPoint {\r\n        return this._inputs[3];\r\n    }\r\n\r\n    /**\r\n     * Gets the light input component\r\n     */\r\n    public get light(): NodeRenderGraphConnectionPoint {\r\n        return this._inputs[4];\r\n    }\r\n\r\n    /**\r\n     * Gets the lighting volume texture input component\r\n     */\r\n    public get lightingVolumeTexture(): NodeRenderGraphConnectionPoint {\r\n        return this._inputs[5];\r\n    }\r\n\r\n    /**\r\n     * Gets the output component\r\n     */\r\n    public get output(): NodeRenderGraphConnectionPoint {\r\n        return this._outputs[0];\r\n    }\r\n\r\n    protected override _buildBlock(state: NodeRenderGraphBuildState) {\r\n        super._buildBlock(state);\r\n\r\n        this.output.value = this._frameGraphTask.outputTexture;\r\n\r\n        this._frameGraphTask.targetTexture = this.target.connectedPoint?.value as FrameGraphTextureHandle;\r\n        this._frameGraphTask.depthTexture = this.depth.connectedPoint?.value as FrameGraphTextureHandle;\r\n        this._frameGraphTask.camera = this.camera.connectedPoint?.value as Camera;\r\n        this._frameGraphTask.lightingVolumeMesh = this.lightingVolumeMesh.connectedPoint?.value as FrameGraphObjectList;\r\n        this._frameGraphTask.light = this.light.connectedPoint?.value as DirectionalLight;\r\n        this._frameGraphTask.lightingVolumeTexture = this.lightingVolumeTexture.connectedPoint?.value as FrameGraphTextureHandle;\r\n    }\r\n\r\n    protected override _dumpPropertiesCode() {\r\n        const codes: string[] = [];\r\n        codes.push(`${this._codeVariableName}.phaseG = ${this.phaseG};`);\r\n        codes.push(`${this._codeVariableName}.extinction = new BABYLON.Vector3(${this.extinction.x}, ${this.extinction.y}, ${this.extinction.z});`);\r\n        codes.push(`${this._codeVariableName}.lightPower = new Color3(${this.lightPower.r}, ${this.lightPower.g}, ${this.lightPower.b});`);\r\n        return super._dumpPropertiesCode() + codes.join(\"\\n\");\r\n    }\r\n\r\n    public override serialize(): any {\r\n        const serializationObject = super.serialize();\r\n        serializationObject.phaseG = this.phaseG;\r\n        serializationObject.extinction = this.extinction.asArray();\r\n        serializationObject.lightPower = this.lightPower.asArray();\r\n        return serializationObject;\r\n    }\r\n\r\n    public override _deserialize(serializationObject: any) {\r\n        super._deserialize(serializationObject);\r\n        this.phaseG = serializationObject.phaseG;\r\n        this.extinction = Vector3.FromArray(serializationObject.extinction);\r\n        this.lightPower = Color3.FromArray(serializationObject.lightPower);\r\n    }\r\n}\r\n\r\nRegisterClass(\"BABYLON.NodeRenderGraphVolumetricLightingBlock\", NodeRenderGraphVolumetricLightingBlock);\r\n"]}

package/FrameGraph/Node/Blocks/index.d.ts

@@ -3,6 +3,7 @@ export * from "./cullObjectsBlock.js";
 export * from "./elbowBlock.js";
 export * from "./executeBlock.js";
 export * from "./inputBlock.js";
+export * from "./lightingVolumeBlock.js";
 export * from "./outputBlock.js";
 export * from "./resourceContainerBlock.js";
 export * from "./Layers/glowLayerBlock.js";
@@ -31,6 +32,7 @@ export * from "./PostProcesses/ssao2PostProcessBlock.js";
 export * from "./PostProcesses/ssrPostProcessBlock.js";
 export * from "./PostProcesses/taaPostProcessBlock.js";
 export * from "./PostProcesses/tonemapPostProcessBlock.js";
+export * from "./PostProcesses/volumetricLightingBlock.js";
 export * from "./Rendering/csmShadowGeneratorBlock.js";
 export * from "./Rendering/geometryRendererBlock.js";
 export * from "./Rendering/objectRendererBlock.js";

package/FrameGraph/Node/Blocks/index.js

@@ -3,6 +3,7 @@ export * from "./cullObjectsBlock.js";
 export * from "./elbowBlock.js";
 export * from "./executeBlock.js";
 export * from "./inputBlock.js";
+export * from "./lightingVolumeBlock.js";
 export * from "./outputBlock.js";
 export * from "./resourceContainerBlock.js";
 export * from "./Layers/glowLayerBlock.js";
@@ -31,6 +32,7 @@ export * from "./PostProcesses/ssao2PostProcessBlock.js";
 export * from "./PostProcesses/ssrPostProcessBlock.js";
 export * from "./PostProcesses/taaPostProcessBlock.js";
 export * from "./PostProcesses/tonemapPostProcessBlock.js";
+export * from "./PostProcesses/volumetricLightingBlock.js";
 export * from "./Rendering/csmShadowGeneratorBlock.js";
 export * from "./Rendering/geometryRendererBlock.js";
 export * from "./Rendering/objectRendererBlock.js";

package/FrameGraph/Node/Blocks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FrameGraph/Node/Blocks/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AAEzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAE7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,sCAAsC,CAAC;AACrD,cAAc,oDAAoD,CAAC;AACnE,cAAc,+CAA+C,CAAC;AAC9D,cAAc,uCAAuC,CAAC;AACtD,cAAc,sCAAsC,CAAC;AACrD,cAAc,qDAAqD,CAAC;AACpE,cAAc,mDAAmD,CAAC;AAClE,cAAc,iDAAiD,CAAC;AAChE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,mDAAmD,CAAC;AAClE,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,iDAAiD,CAAC;AAChE,cAAc,4CAA4C,CAAC;AAC3D,cAAc,sCAAsC,CAAC;AACrD,cAAc,yCAAyC,CAAC;AACxD,cAAc,sDAAsD,CAAC;AACrE,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,yCAAyC,CAAC;AAExD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,uCAAuC,CAAC;AAEtD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAE5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC","sourcesContent":["export * from \"./computeShaderBlock\";\r\nexport * from \"./cullObjectsBlock\";\r\nexport * from \"./elbowBlock\";\r\nexport * from \"./executeBlock\";\r\nexport * from \"./inputBlock\";\r\nexport * from \"./outputBlock\";\r\nexport * from \"./resourceContainerBlock\";\r\n\r\nexport * from \"./Layers/glowLayerBlock\";\r\nexport * from \"./Layers/highlightLayerBlock\";\r\n\r\nexport * from \"./PostProcesses/anaglyphPostProcessBlock\";\r\nexport * from \"./PostProcesses/basePostProcessBlock\";\r\nexport * from \"./PostProcesses/baseWithPropertiesPostProcessBlock\";\r\nexport * from \"./PostProcesses/blackAndWhitePostProcessBlock\";\r\nexport * from \"./PostProcesses/bloomPostProcessBlock\";\r\nexport * from \"./PostProcesses/blurPostProcessBlock\";\r\nexport * from \"./PostProcesses/chromaticAberrationPostProcessBlock\";\r\nexport * from \"./PostProcesses/circleOfConfusionPostProcessBlock\";\r\nexport * from \"./PostProcesses/colorCorrectionPostProcessBlock\";\r\nexport * from \"./PostProcesses/convolutionPostProcessBlock\";\r\nexport * from \"./PostProcesses/depthOfFieldPostProcessBlock\";\r\nexport * from \"./PostProcesses/extractHighlightsPostProcessBlock\";\r\nexport * from \"./PostProcesses/filterPostProcessBlock\";\r\nexport * from \"./PostProcesses/fxaaPostProcessBlock\";\r\nexport * from \"./PostProcesses/grainPostProcessBlock\";\r\nexport * from \"./PostProcesses/imageProcessingPostProcessBlock\";\r\nexport * from \"./PostProcesses/motionBlurPostProcessBlock\";\r\nexport * from \"./PostProcesses/passPostProcessBlock\";\r\nexport * from \"./PostProcesses/sharpenPostProcessBlock\";\r\nexport * from \"./PostProcesses/screenSpaceCurvaturePostProcessBlock\";\r\nexport * from \"./PostProcesses/ssao2PostProcessBlock\";\r\nexport * from \"./PostProcesses/ssrPostProcessBlock\";\r\nexport * from \"./PostProcesses/taaPostProcessBlock\";\r\nexport * from \"./PostProcesses/tonemapPostProcessBlock\";\r\n\r\nexport * from \"./Rendering/csmShadowGeneratorBlock\";\r\nexport * from \"./Rendering/geometryRendererBlock\";\r\nexport * from \"./Rendering/objectRendererBlock\";\r\nexport * from \"./Rendering/shadowGeneratorBlock\";\r\nexport * from \"./Rendering/utilityLayerRendererBlock\";\r\n\r\nexport * from \"./Teleport/teleportInBlock\";\r\nexport * from \"./Teleport/teleportOutBlock\";\r\n\r\nexport * from \"./Textures/clearBlock\";\r\nexport * from \"./Textures/copyTextureBlock\";\r\nexport * from \"./Textures/generateMipmapsBlock\";\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FrameGraph/Node/Blocks/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AAEzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAE7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,sCAAsC,CAAC;AACrD,cAAc,oDAAoD,CAAC;AACnE,cAAc,+CAA+C,CAAC;AAC9D,cAAc,uCAAuC,CAAC;AACtD,cAAc,sCAAsC,CAAC;AACrD,cAAc,qDAAqD,CAAC;AACpE,cAAc,mDAAmD,CAAC;AAClE,cAAc,iDAAiD,CAAC;AAChE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,mDAAmD,CAAC;AAClE,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,iDAAiD,CAAC;AAChE,cAAc,4CAA4C,CAAC;AAC3D,cAAc,sCAAsC,CAAC;AACrD,cAAc,yCAAyC,CAAC;AACxD,cAAc,sDAAsD,CAAC;AACrE,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,yCAAyC,CAAC;AACxD,cAAc,yCAAyC,CAAC;AAExD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,uCAAuC,CAAC;AAEtD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAE5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC","sourcesContent":["export * from \"./computeShaderBlock\";\r\nexport * from \"./cullObjectsBlock\";\r\nexport * from \"./elbowBlock\";\r\nexport * from \"./executeBlock\";\r\nexport * from \"./inputBlock\";\r\nexport * from \"./lightingVolumeBlock\";\r\nexport * from \"./outputBlock\";\r\nexport * from \"./resourceContainerBlock\";\r\n\r\nexport * from \"./Layers/glowLayerBlock\";\r\nexport * from \"./Layers/highlightLayerBlock\";\r\n\r\nexport * from \"./PostProcesses/anaglyphPostProcessBlock\";\r\nexport * from \"./PostProcesses/basePostProcessBlock\";\r\nexport * from \"./PostProcesses/baseWithPropertiesPostProcessBlock\";\r\nexport * from \"./PostProcesses/blackAndWhitePostProcessBlock\";\r\nexport * from \"./PostProcesses/bloomPostProcessBlock\";\r\nexport * from \"./PostProcesses/blurPostProcessBlock\";\r\nexport * from \"./PostProcesses/chromaticAberrationPostProcessBlock\";\r\nexport * from \"./PostProcesses/circleOfConfusionPostProcessBlock\";\r\nexport * from \"./PostProcesses/colorCorrectionPostProcessBlock\";\r\nexport * from \"./PostProcesses/convolutionPostProcessBlock\";\r\nexport * from \"./PostProcesses/depthOfFieldPostProcessBlock\";\r\nexport * from \"./PostProcesses/extractHighlightsPostProcessBlock\";\r\nexport * from \"./PostProcesses/filterPostProcessBlock\";\r\nexport * from \"./PostProcesses/fxaaPostProcessBlock\";\r\nexport * from \"./PostProcesses/grainPostProcessBlock\";\r\nexport * from \"./PostProcesses/imageProcessingPostProcessBlock\";\r\nexport * from \"./PostProcesses/motionBlurPostProcessBlock\";\r\nexport * from \"./PostProcesses/passPostProcessBlock\";\r\nexport * from \"./PostProcesses/sharpenPostProcessBlock\";\r\nexport * from \"./PostProcesses/screenSpaceCurvaturePostProcessBlock\";\r\nexport * from \"./PostProcesses/ssao2PostProcessBlock\";\r\nexport * from \"./PostProcesses/ssrPostProcessBlock\";\r\nexport * from \"./PostProcesses/taaPostProcessBlock\";\r\nexport * from \"./PostProcesses/tonemapPostProcessBlock\";\r\nexport * from \"./PostProcesses/volumetricLightingBlock\";\r\n\r\nexport * from \"./Rendering/csmShadowGeneratorBlock\";\r\nexport * from \"./Rendering/geometryRendererBlock\";\r\nexport * from \"./Rendering/objectRendererBlock\";\r\nexport * from \"./Rendering/shadowGeneratorBlock\";\r\nexport * from \"./Rendering/utilityLayerRendererBlock\";\r\n\r\nexport * from \"./Teleport/teleportInBlock\";\r\nexport * from \"./Teleport/teleportOutBlock\";\r\n\r\nexport * from \"./Textures/clearBlock\";\r\nexport * from \"./Textures/copyTextureBlock\";\r\nexport * from \"./Textures/generateMipmapsBlock\";\r\n"]}

package/FrameGraph/Node/Blocks/lightingVolumeBlock.d.ts

@@ -0,0 +1,46 @@
+import type { FrameGraph, NodeRenderGraphBuildState, NodeRenderGraphConnectionPoint, Scene } from "../../../index.js";
+import { FrameGraphLightingVolumeTask } from "../../Tasks/Misc/lightingVolumeTask.js";
+import { NodeRenderGraphBlock } from "../nodeRenderGraphBlock.js";
+/**
+ * Block that implements the lighting volume
+ */
+export declare class NodeRenderGraphLightingVolumeBlock extends NodeRenderGraphBlock {
+    protected _frameGraphTask: FrameGraphLightingVolumeTask;
+    /**
+     * Gets the frame graph task associated with this block
+     */
+    get task(): FrameGraphLightingVolumeTask;
+    /**
+     * Create a new NodeRenderGraphLightingVolumeBlock
+     * @param name defines the block name
+     * @param frameGraph defines the hosting frame graph
+     * @param scene defines the hosting scene
+     */
+    constructor(name: string, frameGraph: FrameGraph, scene: Scene);
+    /** Gets or sets the tesselation parameter */
+    get tesselation(): number;
+    set tesselation(value: number);
+    /** Gets or sets the refresh frequency parameter */
+    get frequency(): number;
+    set frequency(value: number);
+    /** Indicates whether to build the full volume (true) or only the far plane (false). Default is false. */
+    get buildFullVolume(): boolean;
+    set buildFullVolume(value: boolean);
+    /**
+     * Gets the current class name
+     * @returns the class name
+     */
+    getClassName(): string;
+    /**
+     * Gets the shadow generator input component
+     */
+    get shadowGenerator(): NodeRenderGraphConnectionPoint;
+    /**
+     * Gets the output component
+     */
+    get output(): NodeRenderGraphConnectionPoint;
+    protected _buildBlock(state: NodeRenderGraphBuildState): void;
+    protected _dumpPropertiesCode(): string;
+    serialize(): any;
+    _deserialize(serializationObject: any): void;
+}

package/FrameGraph/Node/Blocks/lightingVolumeBlock.js

@@ -0,0 +1,106 @@
+import { __decorate } from "../../../tslib.es6.js";
+import { FrameGraphLightingVolumeTask } from "../../Tasks/Misc/lightingVolumeTask.js";
+import { RegisterClass } from "../../../Misc/typeStore.js";
+import { editableInPropertyPage } from "../../../Decorators/nodeDecorator.js";
+import { NodeRenderGraphBlock } from "../nodeRenderGraphBlock.js";
+import { NodeRenderGraphBlockConnectionPointTypes } from "../Types/nodeRenderGraphTypes.js";
+/**
+ * Block that implements the lighting volume
+ */
+export class NodeRenderGraphLightingVolumeBlock extends NodeRenderGraphBlock {
+    /**
+     * Gets the frame graph task associated with this block
+     */
+    get task() {
+        return this._frameGraphTask;
+    }
+    /**
+     * Create a new NodeRenderGraphLightingVolumeBlock
+     * @param name defines the block name
+     * @param frameGraph defines the hosting frame graph
+     * @param scene defines the hosting scene
+     */
+    constructor(name, frameGraph, scene) {
+        super(name, frameGraph, scene);
+        this.registerInput("shadowGenerator", NodeRenderGraphBlockConnectionPointTypes.ShadowGenerator);
+        this._addDependenciesInput();
+        this.registerOutput("output", NodeRenderGraphBlockConnectionPointTypes.ObjectList);
+        this._frameGraphTask = new FrameGraphLightingVolumeTask(name, frameGraph);
+    }
+    /** Gets or sets the tesselation parameter */
+    get tesselation() {
+        return this._frameGraphTask.lightingVolume.tesselation;
+    }
+    set tesselation(value) {
+        this._frameGraphTask.lightingVolume.tesselation = value;
+    }
+    /** Gets or sets the refresh frequency parameter */
+    get frequency() {
+        return this._frameGraphTask.lightingVolume.frequency;
+    }
+    set frequency(value) {
+        this._frameGraphTask.lightingVolume.frequency = value;
+    }
+    /** Indicates whether to build the full volume (true) or only the far plane (false). Default is false. */
+    get buildFullVolume() {
+        return this._frameGraphTask.lightingVolume.buildFullVolume;
+    }
+    set buildFullVolume(value) {
+        this._frameGraphTask.lightingVolume.buildFullVolume = value;
+    }
+    /**
+     * Gets the current class name
+     * @returns the class name
+     */
+    getClassName() {
+        return "NodeRenderGraphLightingVolumeBlock";
+    }
+    /**
+     * Gets the shadow generator input component
+     */
+    get shadowGenerator() {
+        return this._inputs[0];
+    }
+    /**
+     * Gets the output component
+     */
+    get output() {
+        return this._outputs[0];
+    }
+    _buildBlock(state) {
+        super._buildBlock(state);
+        this.output.value = this._frameGraphTask.outputMeshLightingVolume;
+        this._frameGraphTask.shadowGenerator = this.shadowGenerator.connectedPoint?.value;
+    }
+    _dumpPropertiesCode() {
+        const codes = [];
+        codes.push(`${this._codeVariableName}.tesselation = ${this.tesselation};`);
+        codes.push(`${this._codeVariableName}.frequency = ${this.frequency};`);
+        codes.push(`${this._codeVariableName}.buildFullVolume = ${this.buildFullVolume};`);
+        return super._dumpPropertiesCode() + codes.join("\n");
+    }
+    serialize() {
+        const serializationObject = super.serialize();
+        serializationObject.tesselation = this.tesselation;
+        serializationObject.frequency = this.frequency;
+        serializationObject.buildFullVolume = this.buildFullVolume;
+        return serializationObject;
+    }
+    _deserialize(serializationObject) {
+        super._deserialize(serializationObject);
+        this.tesselation = serializationObject.tesselation;
+        this.frequency = serializationObject.frequency;
+        this.buildFullVolume = !!serializationObject.buildFullVolume;
+    }
+}
+__decorate([
+    editableInPropertyPage("Tesselation", 2 /* PropertyTypeForEdition.Int */, "PROPERTIES", { min: 1, max: 4096 })
+], NodeRenderGraphLightingVolumeBlock.prototype, "tesselation", null);
+__decorate([
+    editableInPropertyPage("Refresh frequency", 2 /* PropertyTypeForEdition.Int */, "PROPERTIES")
+], NodeRenderGraphLightingVolumeBlock.prototype, "frequency", null);
+__decorate([
+    editableInPropertyPage("Build full volume", 0 /* PropertyTypeForEdition.Boolean */, "PROPERTIES")
+], NodeRenderGraphLightingVolumeBlock.prototype, "buildFullVolume", null);
+RegisterClass("BABYLON.NodeRenderGraphLightingVolumeBlock", NodeRenderGraphLightingVolumeBlock);
+//# sourceMappingURL=lightingVolumeBlock.js.map

package/FrameGraph/Node/Blocks/lightingVolumeBlock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lightingVolumeBlock.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FrameGraph/Node/Blocks/lightingVolumeBlock.ts"],"names":[],"mappings":"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","sourcesContent":["import type { FrameGraph, FrameGraphShadowGeneratorTask, NodeRenderGraphBuildState, NodeRenderGraphConnectionPoint, Scene } from \"core/index\";\r\nimport { FrameGraphLightingVolumeTask } from \"core/FrameGraph/Tasks/Misc/lightingVolumeTask\";\r\nimport { RegisterClass } from \"../../../Misc/typeStore\";\r\nimport { editableInPropertyPage, PropertyTypeForEdition } from \"../../../Decorators/nodeDecorator\";\r\nimport { NodeRenderGraphBlock } from \"../nodeRenderGraphBlock\";\r\nimport { NodeRenderGraphBlockConnectionPointTypes } from \"../Types/nodeRenderGraphTypes\";\r\n\r\n/**\r\n * Block that implements the lighting volume\r\n */\r\nexport class NodeRenderGraphLightingVolumeBlock extends NodeRenderGraphBlock {\r\n    protected override _frameGraphTask: FrameGraphLightingVolumeTask;\r\n\r\n    /**\r\n     * Gets the frame graph task associated with this block\r\n     */\r\n    public override get task() {\r\n        return this._frameGraphTask;\r\n    }\r\n\r\n    /**\r\n     * Create a new NodeRenderGraphLightingVolumeBlock\r\n     * @param name defines the block name\r\n     * @param frameGraph defines the hosting frame graph\r\n     * @param scene defines the hosting scene\r\n     */\r\n    public constructor(name: string, frameGraph: FrameGraph, scene: Scene) {\r\n        super(name, frameGraph, scene);\r\n\r\n        this.registerInput(\"shadowGenerator\", NodeRenderGraphBlockConnectionPointTypes.ShadowGenerator);\r\n\r\n        this._addDependenciesInput();\r\n\r\n        this.registerOutput(\"output\", NodeRenderGraphBlockConnectionPointTypes.ObjectList);\r\n\r\n        this._frameGraphTask = new FrameGraphLightingVolumeTask(name, frameGraph);\r\n    }\r\n\r\n    /** Gets or sets the tesselation parameter */\r\n    @editableInPropertyPage(\"Tesselation\", PropertyTypeForEdition.Int, \"PROPERTIES\", { min: 1, max: 4096 })\r\n    public get tesselation(): number {\r\n        return this._frameGraphTask.lightingVolume.tesselation;\r\n    }\r\n\r\n    public set tesselation(value: number) {\r\n        this._frameGraphTask.lightingVolume.tesselation = value;\r\n    }\r\n\r\n    /** Gets or sets the refresh frequency parameter */\r\n    @editableInPropertyPage(\"Refresh frequency\", PropertyTypeForEdition.Int, \"PROPERTIES\")\r\n    public get frequency(): number {\r\n        return this._frameGraphTask.lightingVolume.frequency;\r\n    }\r\n\r\n    public set frequency(value: number) {\r\n        this._frameGraphTask.lightingVolume.frequency = value;\r\n    }\r\n\r\n    /** Indicates whether to build the full volume (true) or only the far plane (false). Default is false. */\r\n    @editableInPropertyPage(\"Build full volume\", PropertyTypeForEdition.Boolean, \"PROPERTIES\")\r\n    public get buildFullVolume(): boolean {\r\n        return this._frameGraphTask.lightingVolume.buildFullVolume;\r\n    }\r\n\r\n    public set buildFullVolume(value: boolean) {\r\n        this._frameGraphTask.lightingVolume.buildFullVolume = value;\r\n    }\r\n\r\n    /**\r\n     * Gets the current class name\r\n     * @returns the class name\r\n     */\r\n    public override getClassName() {\r\n        return \"NodeRenderGraphLightingVolumeBlock\";\r\n    }\r\n\r\n    /**\r\n     * Gets the shadow generator input component\r\n     */\r\n    public get shadowGenerator(): NodeRenderGraphConnectionPoint {\r\n        return this._inputs[0];\r\n    }\r\n\r\n    /**\r\n     * Gets the output component\r\n     */\r\n    public get output(): NodeRenderGraphConnectionPoint {\r\n        return this._outputs[0];\r\n    }\r\n\r\n    protected override _buildBlock(state: NodeRenderGraphBuildState) {\r\n        super._buildBlock(state);\r\n\r\n        this.output.value = this._frameGraphTask.outputMeshLightingVolume;\r\n\r\n        this._frameGraphTask.shadowGenerator = this.shadowGenerator.connectedPoint?.value as FrameGraphShadowGeneratorTask;\r\n    }\r\n\r\n    protected override _dumpPropertiesCode() {\r\n        const codes: string[] = [];\r\n        codes.push(`${this._codeVariableName}.tesselation = ${this.tesselation};`);\r\n        codes.push(`${this._codeVariableName}.frequency = ${this.frequency};`);\r\n        codes.push(`${this._codeVariableName}.buildFullVolume = ${this.buildFullVolume};`);\r\n        return super._dumpPropertiesCode() + codes.join(\"\\n\");\r\n    }\r\n\r\n    public override serialize(): any {\r\n        const serializationObject = super.serialize();\r\n        serializationObject.tesselation = this.tesselation;\r\n        serializationObject.frequency = this.frequency;\r\n        serializationObject.buildFullVolume = this.buildFullVolume;\r\n        return serializationObject;\r\n    }\r\n\r\n    public override _deserialize(serializationObject: any) {\r\n        super._deserialize(serializationObject);\r\n        this.tesselation = serializationObject.tesselation;\r\n        this.frequency = serializationObject.frequency;\r\n        this.buildFullVolume = !!serializationObject.buildFullVolume;\r\n    }\r\n}\r\n\r\nRegisterClass(\"BABYLON.NodeRenderGraphLightingVolumeBlock\", NodeRenderGraphLightingVolumeBlock);\r\n"]}

package/FrameGraph/Node/nodeRenderGraph.d.ts

@@ -1,4 +1,4 @@
-import type { Nullable, NodeRenderGraphBlock, INodeRenderGraphCreateOptions, INodeRenderGraphEditorOptions, Scene, INodeRenderGraphCustomBlockDescription } from "../../index.js";
+import type { Nullable, NodeRenderGraphBlock, INodeRenderGraphCreateOptions, INodeRenderGraphEditorOptions, Scene, INodeRenderGraphCustomBlockDescription, Immutable } from "../../index.js";
 import { Observable } from "../../Misc/observable.js";
 import { NodeRenderGraphOutputBlock } from "./Blocks/outputBlock.js";
 import { FrameGraph } from "../frameGraph.js";
@@ -28,7 +28,11 @@ export declare class NodeRenderGraph {
      */
     attachedBlocks: NodeRenderGraphBlock[];
     /**
-     * Observable raised when the node render graph is built
+     * Observable raised before the node render graph is built
+     */
+    onBeforeBuildObservable: Observable<FrameGraph>;
+    /**
+     * Observable raised after the node render graph is built
      * Note that this is the same observable as the one in the underlying FrameGraph!
      */
     get onBuildObservable(): Observable<FrameGraph>;
@@ -64,6 +68,10 @@ export declare class NodeRenderGraph {
      * @returns the scene used by this node render graph
      */
     getScene(): Scene;
+    /**
+     * Gets the options used to create this node render graph
+     */
+    get options(): Immutable<INodeRenderGraphCreateOptions>;
     /**
      * Creates a new node render graph
      * @param name defines the name of the node render graph
@@ -111,16 +119,24 @@ export declare class NodeRenderGraph {
      */
     private _createNodeEditor;
     /**
-     * Build the final list of blocks that will be executed by the "execute" method
+     * @deprecated Use buildAsync instead
      * @param dontBuildFrameGraph If the underlying frame graph should not be built (default: false)
      */
     build(dontBuildFrameGraph?: boolean): void;
+    /**
+     * Build the final list of blocks that will be executed by the "execute" method.
+     * It also builds the underlying frame graph unless specified otherwise.
+     * @param dontBuildFrameGraph If the underlying frame graph should not be built (default: false)
+     * @param waitForReadiness If the method should wait for the frame graph to be ready before resolving (default: true). Note that this parameter has no effect if "dontBuildFrameGraph" is true.
+     * @param setAsSceneFrameGraph If the built frame graph must be set as the scene's frame graph (default: true)
+     */
+    buildAsync(dontBuildFrameGraph?: boolean, waitForReadiness?: boolean, setAsSceneFrameGraph?: boolean): Promise<void>;
     private _autoFillExternalInputs;
     /**
      * Returns a promise that resolves when the node render graph is ready to be executed
      * This method must be called after the graph has been built (NodeRenderGraph.build called)!
      * @param timeStep Time step in ms between retries (default is 16)
-     * @param maxTimeout Maximum time in ms to wait for the graph to be ready (default is 5000)
+     * @param maxTimeout Maximum time in ms to wait for the graph to be ready (default is 10000)
      * @returns The promise that resolves when the graph is ready
      */
     whenReadyAsync(timeStep?: number, maxTimeout?: number): Promise<void>;
@@ -157,6 +173,7 @@ export declare class NodeRenderGraph {
     setToDefault(): void;
     /**
      * Makes a duplicate of the current node render graph.
+     * Note that you should call buildAsync() on the returned graph to make it usable.
      * @param name defines the name to use for the new node render graph
      * @returns the new node render graph
      */
@@ -178,7 +195,7 @@ export declare class NodeRenderGraph {
      * @param nodeRenderGraphOptions defines options to use when creating the node render graph
      * @returns a new NodeRenderGraph
      */
-    static CreateDefault(name: string, scene: Scene, nodeRenderGraphOptions?: INodeRenderGraphCreateOptions): NodeRenderGraph;
+    static CreateDefaultAsync(name: string, scene: Scene, nodeRenderGraphOptions?: INodeRenderGraphCreateOptions): Promise<NodeRenderGraph>;
     /**
      * Creates a node render graph from parsed graph data
      * @param source defines the JSON representation of the node render graph