@babylonjs/core 7.31.2 → 7.32.1

package/FrameGraph/Passes/renderPass.d.ts

@@ -0,0 +1,49 @@
+import type { Nullable, FrameGraphRenderContext, AbstractEngine, IFrameGraphPass, FrameGraphTextureHandle, FrameGraphTask } from "../../index.js";
+import { FrameGraphPass } from "./pass";
+/**
+ * Render pass used to render objects.
+ */
+export declare class FrameGraphRenderPass extends FrameGraphPass<FrameGraphRenderContext> {
+    protected _engine: AbstractEngine;
+    protected _renderTarget: FrameGraphTextureHandle;
+    protected _renderTargetDepth: FrameGraphTextureHandle | undefined;
+    protected _usedTextures: FrameGraphTextureHandle[];
+    protected _depthShared: boolean;
+    /**
+     * Checks if a pass is a render pass.
+     * @param pass The pass to check.
+     * @returns True if the pass is a render pass, else false.
+     */
+    static IsRenderPass(pass: IFrameGraphPass): pass is FrameGraphRenderPass;
+    /**
+     * Gets the render target used by the render pass.
+     */
+    get renderTarget(): FrameGraphTextureHandle;
+    /**
+     * Gets the render target depth used by the render pass.
+     */
+    get renderTargetDepth(): FrameGraphTextureHandle | undefined;
+    /** @internal */
+    constructor(name: string, parentTask: FrameGraphTask, context: FrameGraphRenderContext, engine: AbstractEngine);
+    /**
+     * Indicates that the pass will use the given texture.
+     * Use this method to indicate that the pass will use a texture so that the frame graph can handle the texture's lifecycle.
+     * You don't have to call this method for the render target / render target depth textures.
+     * @param texture The texture used.
+     */
+    useTexture(texture: FrameGraphTextureHandle): void;
+    /**
+     * Sets the render target to use for rendering.
+     * @param renderTargetHandle The render target to use for rendering.
+     */
+    setRenderTarget(renderTargetHandle: FrameGraphTextureHandle): void;
+    /**
+     * Sets the render target depth to use for rendering.
+     * @param renderTargetHandle The render target depth to use for rendering.
+     */
+    setRenderTargetDepth(renderTargetHandle?: FrameGraphTextureHandle): void;
+    /** @internal */
+    _execute(): void;
+    /** @internal */
+    _isValid(): Nullable<string>;
+}

package/FrameGraph/Passes/renderPass.js

@@ -0,0 +1,72 @@
+import { FrameGraphPass } from "./pass.js";
+/**
+ * Render pass used to render objects.
+ */
+export class FrameGraphRenderPass extends FrameGraphPass {
+    /**
+     * Checks if a pass is a render pass.
+     * @param pass The pass to check.
+     * @returns True if the pass is a render pass, else false.
+     */
+    static IsRenderPass(pass) {
+        return pass.setRenderTarget !== undefined;
+    }
+    /**
+     * Gets the render target used by the render pass.
+     */
+    get renderTarget() {
+        return this._renderTarget;
+    }
+    /**
+     * Gets the render target depth used by the render pass.
+     */
+    get renderTargetDepth() {
+        return this._renderTargetDepth;
+    }
+    /** @internal */
+    constructor(name, parentTask, context, engine) {
+        super(name, parentTask, context);
+        this._usedTextures = [];
+        this._depthShared = false;
+        this._engine = engine;
+    }
+    /**
+     * Indicates that the pass will use the given texture.
+     * Use this method to indicate that the pass will use a texture so that the frame graph can handle the texture's lifecycle.
+     * You don't have to call this method for the render target / render target depth textures.
+     * @param texture The texture used.
+     */
+    useTexture(texture) {
+        this._usedTextures.push(texture);
+    }
+    /**
+     * Sets the render target to use for rendering.
+     * @param renderTargetHandle The render target to use for rendering.
+     */
+    setRenderTarget(renderTargetHandle) {
+        this._renderTarget = renderTargetHandle;
+    }
+    /**
+     * Sets the render target depth to use for rendering.
+     * @param renderTargetHandle The render target depth to use for rendering.
+     */
+    setRenderTargetDepth(renderTargetHandle) {
+        this._renderTargetDepth = renderTargetHandle;
+    }
+    /** @internal */
+    _execute() {
+        if (this._renderTargetDepth && !this._depthShared) {
+            this._context._shareDepth(this._renderTargetDepth, this._renderTarget);
+            this._depthShared = true;
+        }
+        this._context._bindRenderTarget(this._renderTarget, `frame graph - render pass '${this.name}'`);
+        super._execute();
+        this._context._flushDebugMessages();
+    }
+    /** @internal */
+    _isValid() {
+        const errMsg = super._isValid();
+        return errMsg ? errMsg : this._renderTarget !== undefined ? null : "Render target is not set (call setRenderTarget to set it)";
+    }
+}
+//# sourceMappingURL=renderPass.js.map

package/FrameGraph/Passes/renderPass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderPass.js","sourceRoot":"","sources":["../../../../../dev/core/src/FrameGraph/Passes/renderPass.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAExC;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,cAAuC;IAO7E;;;;OAIG;IACI,MAAM,CAAC,YAAY,CAAC,IAAqB;QAC5C,OAAQ,IAA6B,CAAC,eAAe,KAAK,SAAS,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,IAAW,YAAY;QACnB,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,IAAW,iBAAiB;QACxB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACnC,CAAC;IAED,gBAAgB;IAChB,YAAY,IAAY,EAAE,UAA0B,EAAE,OAAgC,EAAE,MAAsB;QAC1G,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QA5B3B,kBAAa,GAA8B,EAAE,CAAC;QAC9C,iBAAY,GAAG,KAAK,CAAC;QA4B3B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACI,UAAU,CAAC,OAAgC;QAC9C,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACI,eAAe,CAAC,kBAA2C;QAC9D,IAAI,CAAC,aAAa,GAAG,kBAAkB,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACI,oBAAoB,CAAC,kBAA4C;QACpE,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;IACjD,CAAC;IAED,gBAAgB;IACA,QAAQ;QACpB,IAAI,IAAI,CAAC,kBAAkB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE;YAC/C,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YACvE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;SAC5B;QAED,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,aAAa,EAAE,8BAA8B,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QAEhG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAEjB,IAAI,CAAC,QAAQ,CAAC,mBAAmB,EAAE,CAAC;IACxC,CAAC;IAED,gBAAgB;IACA,QAAQ;QACpB,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,2DAA2D,CAAC;IACnI,CAAC;CACJ","sourcesContent":["// eslint-disable-next-line import/no-internal-modules\r\nimport type { Nullable, FrameGraphRenderContext, AbstractEngine, IFrameGraphPass, FrameGraphTextureHandle, FrameGraphTask } from \"core/index\";\r\nimport { FrameGraphPass } from \"./pass\";\r\n\r\n/**\r\n * Render pass used to render objects.\r\n */\r\nexport class FrameGraphRenderPass extends FrameGraphPass<FrameGraphRenderContext> {\r\n    protected _engine: AbstractEngine;\r\n    protected _renderTarget: FrameGraphTextureHandle;\r\n    protected _renderTargetDepth: FrameGraphTextureHandle | undefined;\r\n    protected _usedTextures: FrameGraphTextureHandle[] = [];\r\n    protected _depthShared = false;\r\n\r\n    /**\r\n     * Checks if a pass is a render pass.\r\n     * @param pass The pass to check.\r\n     * @returns True if the pass is a render pass, else false.\r\n     */\r\n    public static IsRenderPass(pass: IFrameGraphPass): pass is FrameGraphRenderPass {\r\n        return (pass as FrameGraphRenderPass).setRenderTarget !== undefined;\r\n    }\r\n\r\n    /**\r\n     * Gets the render target used by the render pass.\r\n     */\r\n    public get renderTarget(): FrameGraphTextureHandle {\r\n        return this._renderTarget;\r\n    }\r\n\r\n    /**\r\n     * Gets the render target depth used by the render pass.\r\n     */\r\n    public get renderTargetDepth(): FrameGraphTextureHandle | undefined {\r\n        return this._renderTargetDepth;\r\n    }\r\n\r\n    /** @internal */\r\n    constructor(name: string, parentTask: FrameGraphTask, context: FrameGraphRenderContext, engine: AbstractEngine) {\r\n        super(name, parentTask, context);\r\n        this._engine = engine;\r\n    }\r\n\r\n    /**\r\n     * Indicates that the pass will use the given texture.\r\n     * Use this method to indicate that the pass will use a texture so that the frame graph can handle the texture's lifecycle.\r\n     * You don't have to call this method for the render target / render target depth textures.\r\n     * @param texture The texture used.\r\n     */\r\n    public useTexture(texture: FrameGraphTextureHandle) {\r\n        this._usedTextures.push(texture);\r\n    }\r\n\r\n    /**\r\n     * Sets the render target to use for rendering.\r\n     * @param renderTargetHandle The render target to use for rendering.\r\n     */\r\n    public setRenderTarget(renderTargetHandle: FrameGraphTextureHandle) {\r\n        this._renderTarget = renderTargetHandle;\r\n    }\r\n\r\n    /**\r\n     * Sets the render target depth to use for rendering.\r\n     * @param renderTargetHandle The render target depth to use for rendering.\r\n     */\r\n    public setRenderTargetDepth(renderTargetHandle?: FrameGraphTextureHandle) {\r\n        this._renderTargetDepth = renderTargetHandle;\r\n    }\r\n\r\n    /** @internal */\r\n    public override _execute() {\r\n        if (this._renderTargetDepth && !this._depthShared) {\r\n            this._context._shareDepth(this._renderTargetDepth, this._renderTarget);\r\n            this._depthShared = true;\r\n        }\r\n\r\n        this._context._bindRenderTarget(this._renderTarget, `frame graph - render pass '${this.name}'`);\r\n\r\n        super._execute();\r\n\r\n        this._context._flushDebugMessages();\r\n    }\r\n\r\n    /** @internal */\r\n    public override _isValid(): Nullable<string> {\r\n        const errMsg = super._isValid();\r\n        return errMsg ? errMsg : this._renderTarget !== undefined ? null : \"Render target is not set (call setRenderTarget to set it)\";\r\n    }\r\n}\r\n"]}

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

@@ -0,0 +1,16 @@
+import type { FrameGraph } from "../../frameGraph.js";
+import { ThinBlackAndWhitePostProcess } from "../../../PostProcesses/thinBlackAndWhitePostProcess.js";
+import { FrameGraphPostProcessTask } from "./postProcessTask";
+/**
+ * Task which applies a black and white post process.
+ */
+export declare class FrameGraphBlackAndWhiteTask extends FrameGraphPostProcessTask {
+    readonly postProcess: ThinBlackAndWhitePostProcess;
+    /**
+     * Constructs a new black and white task.
+     * @param name The name of the task.
+     * @param frameGraph The frame graph this task is associated with.
+     * @param thinPostProcess The thin post process to use for the black and white effect. If not provided, a new one will be created.
+     */
+    constructor(name: string, frameGraph: FrameGraph, thinPostProcess?: ThinBlackAndWhitePostProcess);
+}

package/FrameGraph/Tasks/PostProcesses/blackAndWhiteTask.js

@@ -0,0 +1,17 @@
+import { ThinBlackAndWhitePostProcess } from "../../../PostProcesses/thinBlackAndWhitePostProcess.js";
+import { FrameGraphPostProcessTask } from "./postProcessTask.js";
+/**
+ * Task which applies a black and white post process.
+ */
+export class FrameGraphBlackAndWhiteTask extends FrameGraphPostProcessTask {
+    /**
+     * Constructs a new black and white task.
+     * @param name The name of the task.
+     * @param frameGraph The frame graph this task is associated with.
+     * @param thinPostProcess The thin post process to use for the black and white effect. If not provided, a new one will be created.
+     */
+    constructor(name, frameGraph, thinPostProcess) {
+        super(name, frameGraph, thinPostProcess || new ThinBlackAndWhitePostProcess(name, frameGraph.engine));
+    }
+}
+//# sourceMappingURL=blackAndWhiteTask.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blackAndWhiteTask.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FrameGraph/Tasks/PostProcesses/blackAndWhiteTask.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,+DAAwD;AAC/F,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAE9D;;GAEG;AACH,MAAM,OAAO,2BAA4B,SAAQ,yBAAyB;IAGtE;;;;;OAKG;IACH,YAAY,IAAY,EAAE,UAAsB,EAAE,eAA8C;QAC5F,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,eAAe,IAAI,IAAI,4BAA4B,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1G,CAAC;CACJ","sourcesContent":["import type { FrameGraph } from \"core/FrameGraph/frameGraph\";\r\nimport { ThinBlackAndWhitePostProcess } from \"core/PostProcesses/thinBlackAndWhitePostProcess\";\r\nimport { FrameGraphPostProcessTask } from \"./postProcessTask\";\r\n\r\n/**\r\n * Task which applies a black and white post process.\r\n */\r\nexport class FrameGraphBlackAndWhiteTask extends FrameGraphPostProcessTask {\r\n    public override readonly postProcess: ThinBlackAndWhitePostProcess;\r\n\r\n    /**\r\n     * Constructs a new black and white task.\r\n     * @param name The name of the task.\r\n     * @param frameGraph The frame graph this task is associated with.\r\n     * @param thinPostProcess The thin post process to use for the black and white effect. If not provided, a new one will be created.\r\n     */\r\n    constructor(name: string, frameGraph: FrameGraph, thinPostProcess?: ThinBlackAndWhitePostProcess) {\r\n        super(name, frameGraph, thinPostProcess || new ThinBlackAndWhitePostProcess(name, frameGraph.engine));\r\n    }\r\n}\r\n"]}

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

@@ -0,0 +1,12 @@
+import type { FrameGraph, FrameGraphTextureHandle, FrameGraphRenderPass } from "../../../index.js";
+import { ThinBloomMergePostProcess } from "../../../PostProcesses/thinBloomMergePostProcess.js";
+import { FrameGraphPostProcessTask } from "./postProcessTask";
+/**
+ * @internal
+ */
+export declare class FrameGraphBloomMergeTask extends FrameGraphPostProcessTask {
+    blurTexture: FrameGraphTextureHandle;
+    readonly postProcess: ThinBloomMergePostProcess;
+    constructor(name: string, frameGraph: FrameGraph, thinPostProcess?: ThinBloomMergePostProcess);
+    record(skipCreationOfDisabledPasses?: boolean): FrameGraphRenderPass;
+}

package/FrameGraph/Tasks/PostProcesses/bloomMergeTask.js

@@ -0,0 +1,21 @@
+import { ThinBloomMergePostProcess } from "../../../PostProcesses/thinBloomMergePostProcess.js";
+import { FrameGraphPostProcessTask } from "./postProcessTask.js";
+/**
+ * @internal
+ */
+export class FrameGraphBloomMergeTask extends FrameGraphPostProcessTask {
+    constructor(name, frameGraph, thinPostProcess) {
+        super(name, frameGraph, thinPostProcess || new ThinBloomMergePostProcess(name, frameGraph.engine));
+    }
+    record(skipCreationOfDisabledPasses = false) {
+        if (this.sourceTexture === undefined || this.blurTexture === undefined) {
+            throw new Error(`FrameGraphBloomMergeTask "${this.name}": sourceTexture and blurTexture are required`);
+        }
+        const pass = super.record(skipCreationOfDisabledPasses, undefined, (context) => {
+            context.bindTextureHandle(this._postProcessDrawWrapper.effect, "bloomBlur", this.blurTexture);
+        });
+        pass.useTexture(this.blurTexture);
+        return pass;
+    }
+}
+//# sourceMappingURL=bloomMergeTask.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bloomMergeTask.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FrameGraph/Tasks/PostProcesses/bloomMergeTask.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,4DAAqD;AACzF,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAE9D;;GAEG;AACH,MAAM,OAAO,wBAAyB,SAAQ,yBAAyB;IAKnE,YAAY,IAAY,EAAE,UAAsB,EAAE,eAA2C;QACzF,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,eAAe,IAAI,IAAI,yBAAyB,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACvG,CAAC;IAEe,MAAM,CAAC,4BAA4B,GAAG,KAAK;QACvD,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE;YACpE,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,CAAC,IAAI,+CAA+C,CAAC,CAAC;SAC1G;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,4BAA4B,EAAE,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;YAC3E,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,uBAAuB,CAAC,MAAO,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACnG,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAElC,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ","sourcesContent":["// eslint-disable-next-line import/no-internal-modules\r\nimport type { FrameGraph, FrameGraphTextureHandle, FrameGraphRenderPass } from \"core/index\";\r\nimport { ThinBloomMergePostProcess } from \"core/PostProcesses/thinBloomMergePostProcess\";\r\nimport { FrameGraphPostProcessTask } from \"./postProcessTask\";\r\n\r\n/**\r\n * @internal\r\n */\r\nexport class FrameGraphBloomMergeTask extends FrameGraphPostProcessTask {\r\n    public blurTexture: FrameGraphTextureHandle;\r\n\r\n    public override readonly postProcess: ThinBloomMergePostProcess;\r\n\r\n    constructor(name: string, frameGraph: FrameGraph, thinPostProcess?: ThinBloomMergePostProcess) {\r\n        super(name, frameGraph, thinPostProcess || new ThinBloomMergePostProcess(name, frameGraph.engine));\r\n    }\r\n\r\n    public override record(skipCreationOfDisabledPasses = false): FrameGraphRenderPass {\r\n        if (this.sourceTexture === undefined || this.blurTexture === undefined) {\r\n            throw new Error(`FrameGraphBloomMergeTask \"${this.name}\": sourceTexture and blurTexture are required`);\r\n        }\r\n\r\n        const pass = super.record(skipCreationOfDisabledPasses, undefined, (context) => {\r\n            context.bindTextureHandle(this._postProcessDrawWrapper.effect!, \"bloomBlur\", this.blurTexture);\r\n        });\r\n\r\n        pass.useTexture(this.blurTexture);\r\n\r\n        return pass;\r\n    }\r\n}\r\n"]}

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

@@ -0,0 +1,54 @@
+import type { FrameGraph, FrameGraphTextureHandle, AbstractEngine } from "../../../index.js";
+import { FrameGraphTask } from "../../frameGraphTask";
+import { ThinBloomEffect } from "../../../PostProcesses/thinBloomEffect.js";
+/**
+ * Task which applies a bloom render effect.
+ */
+export declare class FrameGraphBloomTask extends FrameGraphTask {
+    /**
+     * The source texture to apply the bloom effect on.
+     */
+    sourceTexture: FrameGraphTextureHandle;
+    /**
+     * The sampling mode to use for the source texture.
+     */
+    sourceSamplingMode: number;
+    /**
+     * The destination texture to render the bloom effect to.
+     * If not supplied, a texture with the same configuration as the source texture will be created.
+     */
+    destinationTexture?: FrameGraphTextureHandle;
+    /**
+     * The output texture of the bloom effect.
+     */
+    readonly outputTexture: FrameGraphTextureHandle;
+    /**
+     * The bloom effect to apply.
+     */
+    readonly bloom: ThinBloomEffect;
+    /**
+     * Whether the bloom effect is HDR.
+     * When true, the bloom effect will use a higher precision texture format (half float or float). Else, it will use unsigned byte.
+     */
+    readonly hdr: boolean;
+    private _downscale;
+    private _blurX;
+    private _blurY;
+    private _merge;
+    private _defaultPipelineTextureType;
+    /**
+     * Constructs a new bloom task.
+     * @param name Name of the task.
+     * @param frameGraph The frame graph this task is associated with.
+     * @param engine The engine to use for the bloom effect.
+     * @param weight Weight of the bloom effect.
+     * @param kernel Kernel size of the bloom effect.
+     * @param threshold Threshold of the bloom effect.
+     * @param hdr Whether the bloom effect is HDR.
+     * @param bloomScale The scale of the bloom effect. This value is multiplied by the source texture size to determine the bloom texture size.
+     */
+    constructor(name: string, frameGraph: FrameGraph, engine: AbstractEngine, weight: number, kernel: number, threshold: number, hdr?: boolean, bloomScale?: number);
+    isReady(): boolean;
+    record(): void;
+    dispose(): void;
+}

package/FrameGraph/Tasks/PostProcesses/bloomTask.js

@@ -0,0 +1,114 @@
+
+import { FrameGraphBloomMergeTask } from "./bloomMergeTask.js";
+import { FrameGraphTask } from "../../frameGraphTask.js";
+import { ThinBloomEffect } from "../../../PostProcesses/thinBloomEffect.js";
+import { FrameGraphExtractHighlightsTask } from "./extractHighlightsTask.js";
+import { FrameGraphBlurTask } from "./blurTask.js";
+/**
+ * Task which applies a bloom render effect.
+ */
+export class FrameGraphBloomTask extends FrameGraphTask {
+    /**
+     * Constructs a new bloom task.
+     * @param name Name of the task.
+     * @param frameGraph The frame graph this task is associated with.
+     * @param engine The engine to use for the bloom effect.
+     * @param weight Weight of the bloom effect.
+     * @param kernel Kernel size of the bloom effect.
+     * @param threshold Threshold of the bloom effect.
+     * @param hdr Whether the bloom effect is HDR.
+     * @param bloomScale The scale of the bloom effect. This value is multiplied by the source texture size to determine the bloom texture size.
+     */
+    constructor(name, frameGraph, engine, weight, kernel, threshold, hdr = false, bloomScale = 0.5) {
+        super(name, frameGraph);
+        /**
+         * The sampling mode to use for the source texture.
+         */
+        this.sourceSamplingMode = 2;
+        this.hdr = hdr;
+        this._defaultPipelineTextureType = 0;
+        if (hdr) {
+            const caps = engine.getCaps();
+            if (caps.textureHalfFloatRender) {
+                this._defaultPipelineTextureType = 2;
+            }
+            else if (caps.textureFloatRender) {
+                this._defaultPipelineTextureType = 1;
+            }
+        }
+        this.bloom = new ThinBloomEffect(name, engine, bloomScale);
+        this.bloom.threshold = threshold;
+        this.bloom.kernel = kernel;
+        this.bloom.weight = weight;
+        this._downscale = new FrameGraphExtractHighlightsTask(`${name} Downscale`, this._frameGraph, this.bloom._downscale);
+        this._blurX = new FrameGraphBlurTask(`${name} Blur X`, this._frameGraph, this.bloom._blurX);
+        this._blurY = new FrameGraphBlurTask(`${name} Blur Y`, this._frameGraph, this.bloom._blurY);
+        this._merge = new FrameGraphBloomMergeTask(`${name} Merge`, this._frameGraph, this.bloom._merge);
+        this.outputTexture = this._frameGraph.createDanglingHandle();
+    }
+    isReady() {
+        return this.bloom.isReady();
+    }
+    record() {
+        if (this.sourceTexture === undefined) {
+            throw new Error("FrameGraphBloomTask: sourceTexture is required");
+        }
+        const sourceTextureDescription = this._frameGraph.getTextureDescription(this.sourceTexture);
+        const textureCreationOptions = {
+            size: {
+                width: Math.floor(sourceTextureDescription.size.width * this.bloom.scale),
+                height: Math.floor(sourceTextureDescription.size.height * this.bloom.scale),
+            },
+            options: {
+                createMipMaps: false,
+                generateMipMaps: false,
+                types: [this._defaultPipelineTextureType],
+                samplingModes: [2],
+                formats: [5],
+                samples: 1,
+                useSRGBBuffers: [false],
+                generateDepthBuffer: false,
+                generateStencilBuffer: false,
+                label: "",
+            },
+            sizeIsPercentage: false,
+        };
+        const downscaleTextureHandle = this._frameGraph.createRenderTargetTexture(this._downscale.name, textureCreationOptions);
+        this._downscale.sourceTexture = this.sourceTexture;
+        this._downscale.sourceSamplingMode = 2;
+        this._downscale.destinationTexture = downscaleTextureHandle;
+        this._downscale.record(true);
+        const blurXTextureHandle = this._frameGraph.createRenderTargetTexture(this._blurX.name, textureCreationOptions);
+        this._blurX.sourceTexture = downscaleTextureHandle;
+        this._blurX.sourceSamplingMode = 2;
+        this._blurX.destinationTexture = blurXTextureHandle;
+        this._blurX.record(true);
+        const blurYTextureHandle = this._frameGraph.createRenderTargetTexture(this._blurY.name, textureCreationOptions);
+        this._blurY.sourceTexture = blurXTextureHandle;
+        this._blurY.sourceSamplingMode = 2;
+        this._blurY.destinationTexture = blurYTextureHandle;
+        this._blurY.record(true);
+        const sourceTextureCreationOptions = this._frameGraph.getTextureCreationOptions(this.sourceTexture, true);
+        sourceTextureCreationOptions.options.generateDepthBuffer = false;
+        sourceTextureCreationOptions.options.generateStencilBuffer = false;
+        this._frameGraph.resolveDanglingHandle(this.outputTexture, this.destinationTexture, this._merge.name, sourceTextureCreationOptions);
+        this._merge.sourceTexture = this.sourceTexture;
+        this._merge.sourceSamplingMode = this.sourceSamplingMode;
+        this._merge.blurTexture = blurYTextureHandle;
+        this._merge.destinationTexture = this.outputTexture;
+        this._merge.record(true);
+        const passDisabled = this._frameGraph.addRenderPass(this.name + "_disabled", true);
+        passDisabled.setRenderTarget(this.outputTexture);
+        passDisabled.setExecuteFunc((context) => {
+            context.copyTexture(this.sourceTexture);
+        });
+    }
+    dispose() {
+        this._downscale.dispose();
+        this._blurX.dispose();
+        this._blurY.dispose();
+        this._merge.dispose();
+        super.dispose();
+    }
+}
+//# sourceMappingURL=bloomTask.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bloomTask.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FrameGraph/Tasks/PostProcesses/bloomTask.ts"],"names":[],"mappings":"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","sourcesContent":["// eslint-disable-next-line import/no-internal-modules\r\nimport type { FrameGraph, FrameGraphTextureCreationOptions, FrameGraphTextureHandle, AbstractEngine } from \"core/index\";\r\nimport { Constants } from \"core/Engines/constants\";\r\nimport { FrameGraphBloomMergeTask } from \"./bloomMergeTask\";\r\nimport { FrameGraphTask } from \"../../frameGraphTask\";\r\nimport { ThinBloomEffect } from \"core/PostProcesses/thinBloomEffect\";\r\nimport { FrameGraphExtractHighlightsTask } from \"./extractHighlightsTask\";\r\nimport { FrameGraphBlurTask } from \"./blurTask\";\r\n\r\n/**\r\n * Task which applies a bloom render effect.\r\n */\r\nexport class FrameGraphBloomTask extends FrameGraphTask {\r\n    /**\r\n     * The source texture to apply the bloom effect on.\r\n     */\r\n    public sourceTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * The sampling mode to use for the source texture.\r\n     */\r\n    public sourceSamplingMode = Constants.TEXTURE_BILINEAR_SAMPLINGMODE;\r\n\r\n    /**\r\n     * The destination texture to render the bloom effect to.\r\n     * If not supplied, a texture with the same configuration as the source texture will be created.\r\n     */\r\n    public destinationTexture?: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * The output texture of the bloom effect.\r\n     */\r\n    public readonly outputTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * The bloom effect to apply.\r\n     */\r\n    public readonly bloom: ThinBloomEffect;\r\n\r\n    /**\r\n     * Whether the bloom effect is HDR.\r\n     * When true, the bloom effect will use a higher precision texture format (half float or float). Else, it will use unsigned byte.\r\n     */\r\n    public readonly hdr: boolean;\r\n\r\n    private _downscale: FrameGraphExtractHighlightsTask;\r\n    private _blurX: FrameGraphBlurTask;\r\n    private _blurY: FrameGraphBlurTask;\r\n    private _merge: FrameGraphBloomMergeTask;\r\n    private _defaultPipelineTextureType: number;\r\n\r\n    /**\r\n     * Constructs a new bloom task.\r\n     * @param name Name of the task.\r\n     * @param frameGraph The frame graph this task is associated with.\r\n     * @param engine The engine to use for the bloom effect.\r\n     * @param weight Weight of the bloom effect.\r\n     * @param kernel Kernel size of the bloom effect.\r\n     * @param threshold Threshold of the bloom effect.\r\n     * @param hdr Whether the bloom effect is HDR.\r\n     * @param bloomScale The scale of the bloom effect. This value is multiplied by the source texture size to determine the bloom texture size.\r\n     */\r\n    constructor(name: string, frameGraph: FrameGraph, engine: AbstractEngine, weight: number, kernel: number, threshold: number, hdr = false, bloomScale = 0.5) {\r\n        super(name, frameGraph);\r\n\r\n        this.hdr = hdr;\r\n\r\n        this._defaultPipelineTextureType = Constants.TEXTURETYPE_UNSIGNED_BYTE;\r\n        if (hdr) {\r\n            const caps = engine.getCaps();\r\n            if (caps.textureHalfFloatRender) {\r\n                this._defaultPipelineTextureType = Constants.TEXTURETYPE_HALF_FLOAT;\r\n            } else if (caps.textureFloatRender) {\r\n                this._defaultPipelineTextureType = Constants.TEXTURETYPE_FLOAT;\r\n            }\r\n        }\r\n\r\n        this.bloom = new ThinBloomEffect(name, engine, bloomScale);\r\n        this.bloom.threshold = threshold;\r\n        this.bloom.kernel = kernel;\r\n        this.bloom.weight = weight;\r\n\r\n        this._downscale = new FrameGraphExtractHighlightsTask(`${name} Downscale`, this._frameGraph, this.bloom._downscale);\r\n        this._blurX = new FrameGraphBlurTask(`${name} Blur X`, this._frameGraph, this.bloom._blurX);\r\n        this._blurY = new FrameGraphBlurTask(`${name} Blur Y`, this._frameGraph, this.bloom._blurY);\r\n        this._merge = new FrameGraphBloomMergeTask(`${name} Merge`, this._frameGraph, this.bloom._merge);\r\n\r\n        this.outputTexture = this._frameGraph.createDanglingHandle();\r\n    }\r\n\r\n    public override isReady() {\r\n        return this.bloom.isReady();\r\n    }\r\n\r\n    public record(): void {\r\n        if (this.sourceTexture === undefined) {\r\n            throw new Error(\"FrameGraphBloomTask: sourceTexture is required\");\r\n        }\r\n\r\n        const sourceTextureDescription = this._frameGraph.getTextureDescription(this.sourceTexture);\r\n\r\n        const textureCreationOptions: FrameGraphTextureCreationOptions = {\r\n            size: {\r\n                width: Math.floor(sourceTextureDescription.size.width * this.bloom.scale),\r\n                height: Math.floor(sourceTextureDescription.size.height * this.bloom.scale),\r\n            },\r\n            options: {\r\n                createMipMaps: false,\r\n                generateMipMaps: false,\r\n                types: [this._defaultPipelineTextureType],\r\n                samplingModes: [Constants.TEXTURE_BILINEAR_SAMPLINGMODE],\r\n                formats: [Constants.TEXTUREFORMAT_RGBA],\r\n                samples: 1,\r\n                useSRGBBuffers: [false],\r\n                generateDepthBuffer: false,\r\n                generateStencilBuffer: false,\r\n                label: \"\",\r\n            },\r\n            sizeIsPercentage: false,\r\n        };\r\n\r\n        const downscaleTextureHandle = this._frameGraph.createRenderTargetTexture(this._downscale.name, textureCreationOptions);\r\n\r\n        this._downscale.sourceTexture = this.sourceTexture;\r\n        this._downscale.sourceSamplingMode = Constants.TEXTURE_BILINEAR_SAMPLINGMODE;\r\n        this._downscale.destinationTexture = downscaleTextureHandle;\r\n        this._downscale.record(true);\r\n\r\n        const blurXTextureHandle = this._frameGraph.createRenderTargetTexture(this._blurX.name, textureCreationOptions);\r\n\r\n        this._blurX.sourceTexture = downscaleTextureHandle;\r\n        this._blurX.sourceSamplingMode = Constants.TEXTURE_BILINEAR_SAMPLINGMODE;\r\n        this._blurX.destinationTexture = blurXTextureHandle;\r\n        this._blurX.record(true);\r\n\r\n        const blurYTextureHandle = this._frameGraph.createRenderTargetTexture(this._blurY.name, textureCreationOptions);\r\n\r\n        this._blurY.sourceTexture = blurXTextureHandle;\r\n        this._blurY.sourceSamplingMode = Constants.TEXTURE_BILINEAR_SAMPLINGMODE;\r\n        this._blurY.destinationTexture = blurYTextureHandle;\r\n        this._blurY.record(true);\r\n\r\n        const sourceTextureCreationOptions = this._frameGraph.getTextureCreationOptions(this.sourceTexture, true);\r\n        sourceTextureCreationOptions.options.generateDepthBuffer = false;\r\n        sourceTextureCreationOptions.options.generateStencilBuffer = false;\r\n\r\n        this._frameGraph.resolveDanglingHandle(this.outputTexture, this.destinationTexture, this._merge.name, sourceTextureCreationOptions);\r\n\r\n        this._merge.sourceTexture = this.sourceTexture;\r\n        this._merge.sourceSamplingMode = this.sourceSamplingMode;\r\n        this._merge.blurTexture = blurYTextureHandle;\r\n        this._merge.destinationTexture = this.outputTexture;\r\n        this._merge.record(true);\r\n\r\n        const passDisabled = this._frameGraph.addRenderPass(this.name + \"_disabled\", true);\r\n\r\n        passDisabled.setRenderTarget(this.outputTexture);\r\n        passDisabled.setExecuteFunc((context) => {\r\n            context.copyTexture(this.sourceTexture);\r\n        });\r\n    }\r\n\r\n    public override dispose(): void {\r\n        this._downscale.dispose();\r\n        this._blurX.dispose();\r\n        this._blurY.dispose();\r\n        this._merge.dispose();\r\n        super.dispose();\r\n    }\r\n}\r\n"]}

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

@@ -0,0 +1,17 @@
+import type { FrameGraph, FrameGraphRenderContext, FrameGraphRenderPass } from "../../../index.js";
+import { ThinBlurPostProcess } from "../../../PostProcesses/thinBlurPostProcess.js";
+import { FrameGraphPostProcessTask } from "./postProcessTask";
+/**
+ * Task which applies a blur post process.
+ */
+export declare class FrameGraphBlurTask extends FrameGraphPostProcessTask {
+    readonly postProcess: ThinBlurPostProcess;
+    /**
+     * Constructs a new blur task.
+     * @param name Name of the task.
+     * @param frameGraph Frame graph this task is associated with.
+     * @param thinPostProcess The thin post process to use for the blur effect.
+     */
+    constructor(name: string, frameGraph: FrameGraph, thinPostProcess?: ThinBlurPostProcess);
+    record(skipCreationOfDisabledPasses?: boolean, additionalExecute?: (context: FrameGraphRenderContext) => void, additionalBindings?: (context: FrameGraphRenderContext) => void): FrameGraphRenderPass;
+}

package/FrameGraph/Tasks/PostProcesses/blurTask.js

@@ -0,0 +1,24 @@
+import { ThinBlurPostProcess } from "../../../PostProcesses/thinBlurPostProcess.js";
+import { FrameGraphPostProcessTask } from "./postProcessTask.js";
+import { Vector2 } from "../../../Maths/math.vector.js";
+/**
+ * Task which applies a blur post process.
+ */
+export class FrameGraphBlurTask extends FrameGraphPostProcessTask {
+    /**
+     * Constructs a new blur task.
+     * @param name Name of the task.
+     * @param frameGraph Frame graph this task is associated with.
+     * @param thinPostProcess The thin post process to use for the blur effect.
+     */
+    constructor(name, frameGraph, thinPostProcess) {
+        super(name, frameGraph, thinPostProcess || new ThinBlurPostProcess(name, frameGraph.engine, new Vector2(1, 0), 10));
+    }
+    record(skipCreationOfDisabledPasses = false, additionalExecute, additionalBindings) {
+        const pass = super.record(skipCreationOfDisabledPasses, additionalExecute, additionalBindings);
+        this.postProcess.textureWidth = this._outputWidth;
+        this.postProcess.textureHeight = this._outputHeight;
+        return pass;
+    }
+}
+//# sourceMappingURL=blurTask.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blurTask.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FrameGraph/Tasks/PostProcesses/blurTask.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,sDAA+C;AAC7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,sCAA+B;AAEjD;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,yBAAyB;IAG7D;;;;;OAKG;IACH,YAAY,IAAY,EAAE,UAAsB,EAAE,eAAqC;QACnF,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,eAAe,IAAI,IAAI,mBAAmB,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,EAAE,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACxH,CAAC;IAEe,MAAM,CAClB,4BAA4B,GAAG,KAAK,EACpC,iBAA8D,EAC9D,kBAA+D;QAE/D,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,4BAA4B,EAAE,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;QAE/F,IAAI,CAAC,WAAW,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QAClD,IAAI,CAAC,WAAW,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QAEpD,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ","sourcesContent":["// eslint-disable-next-line import/no-internal-modules\r\nimport type { FrameGraph, FrameGraphRenderContext, FrameGraphRenderPass } from \"core/index\";\r\nimport { ThinBlurPostProcess } from \"core/PostProcesses/thinBlurPostProcess\";\r\nimport { FrameGraphPostProcessTask } from \"./postProcessTask\";\r\nimport { Vector2 } from \"core/Maths/math.vector\";\r\n\r\n/**\r\n * Task which applies a blur post process.\r\n */\r\nexport class FrameGraphBlurTask extends FrameGraphPostProcessTask {\r\n    public override readonly postProcess: ThinBlurPostProcess;\r\n\r\n    /**\r\n     * Constructs a new blur task.\r\n     * @param name Name of the task.\r\n     * @param frameGraph Frame graph this task is associated with.\r\n     * @param thinPostProcess The thin post process to use for the blur effect.\r\n     */\r\n    constructor(name: string, frameGraph: FrameGraph, thinPostProcess?: ThinBlurPostProcess) {\r\n        super(name, frameGraph, thinPostProcess || new ThinBlurPostProcess(name, frameGraph.engine, new Vector2(1, 0), 10));\r\n    }\r\n\r\n    public override record(\r\n        skipCreationOfDisabledPasses = false,\r\n        additionalExecute?: (context: FrameGraphRenderContext) => void,\r\n        additionalBindings?: (context: FrameGraphRenderContext) => void\r\n    ): FrameGraphRenderPass {\r\n        const pass = super.record(skipCreationOfDisabledPasses, additionalExecute, additionalBindings);\r\n\r\n        this.postProcess.textureWidth = this._outputWidth;\r\n        this.postProcess.textureHeight = this._outputHeight;\r\n\r\n        return pass;\r\n    }\r\n}\r\n"]}

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

@@ -0,0 +1,30 @@
+import type { FrameGraph, FrameGraphTextureHandle, FrameGraphRenderPass, Camera } from "../../../index.js";
+import { FrameGraphPostProcessTask } from "./postProcessTask";
+import { ThinCircleOfConfusionPostProcess } from "../../../PostProcesses/thinCircleOfConfusionPostProcess.js";
+/**
+ * Task which applies a circle of confusion post process.
+ */
+export declare class FrameGraphCircleOfConfusionTask extends FrameGraphPostProcessTask {
+    /**
+     * The depth texture to use for the circle of confusion effect.
+     * It must store camera space depth (Z coordinate)
+     */
+    depthTexture: FrameGraphTextureHandle;
+    /**
+     * The sampling mode to use for the depth texture.
+     */
+    depthSamplingMode: number;
+    /**
+     * The camera to use for the circle of confusion effect.
+     */
+    camera: Camera;
+    readonly postProcess: ThinCircleOfConfusionPostProcess;
+    /**
+     * Constructs a new circle of confusion task.
+     * @param name The name of the task.
+     * @param frameGraph The frame graph this task belongs to.
+     * @param thinPostProcess The thin post process to use for the task. If not provided, a new one will be created.
+     */
+    constructor(name: string, frameGraph: FrameGraph, thinPostProcess?: ThinCircleOfConfusionPostProcess);
+    record(skipCreationOfDisabledPasses?: boolean): FrameGraphRenderPass;
+}

package/FrameGraph/Tasks/PostProcesses/circleOfConfusionTask.js

@@ -0,0 +1,35 @@
+import { FrameGraphPostProcessTask } from "./postProcessTask.js";
+
+import { ThinCircleOfConfusionPostProcess } from "../../../PostProcesses/thinCircleOfConfusionPostProcess.js";
+/**
+ * Task which applies a circle of confusion post process.
+ */
+export class FrameGraphCircleOfConfusionTask extends FrameGraphPostProcessTask {
+    /**
+     * Constructs a new circle of confusion task.
+     * @param name The name of the task.
+     * @param frameGraph The frame graph this task belongs to.
+     * @param thinPostProcess The thin post process to use for the task. If not provided, a new one will be created.
+     */
+    constructor(name, frameGraph, thinPostProcess) {
+        super(name, frameGraph, thinPostProcess || new ThinCircleOfConfusionPostProcess(name, frameGraph.engine));
+        /**
+         * The sampling mode to use for the depth texture.
+         */
+        this.depthSamplingMode = 2;
+    }
+    record(skipCreationOfDisabledPasses = false) {
+        if (this.sourceTexture === undefined || this.depthTexture === undefined || this.camera === undefined) {
+            throw new Error(`FrameGraphCircleOfConfusionTask "${this.name}": sourceTexture, depthTexture and camera are required`);
+        }
+        const pass = super.record(skipCreationOfDisabledPasses, (context) => {
+            context.setTextureSamplingMode(this.depthTexture, this.depthSamplingMode);
+        }, (context) => {
+            this.postProcess.camera = this.camera;
+            context.bindTextureHandle(this._postProcessDrawWrapper.effect, "depthSampler", this.depthTexture);
+        });
+        pass.useTexture(this.depthTexture);
+        return pass;
+    }
+}
+//# sourceMappingURL=circleOfConfusionTask.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"circleOfConfusionTask.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FrameGraph/Tasks/PostProcesses/circleOfConfusionTask.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,sCAA+B;AACnD,OAAO,EAAE,gCAAgC,EAAE,mEAA4D;AAEvG;;GAEG;AACH,MAAM,OAAO,+BAAgC,SAAQ,yBAAyB;IAmB1E;;;;;OAKG;IACH,YAAY,IAAY,EAAE,UAAsB,EAAE,eAAkD;QAChG,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,eAAe,IAAI,IAAI,gCAAgC,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QAnB9G;;WAEG;QACI,sBAAiB,GAAG,SAAS,CAAC,6BAA6B,CAAC;IAiBnE,CAAC;IAEe,MAAM,CAAC,4BAA4B,GAAG,KAAK;QACvD,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE;YAClG,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,CAAC,IAAI,wDAAwD,CAAC,CAAC;SAC1H;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CACrB,4BAA4B,EAC5B,CAAC,OAAO,EAAE,EAAE;YACR,OAAO,CAAC,sBAAsB,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC9E,CAAC,EACD,CAAC,OAAO,EAAE,EAAE;YACR,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YACtC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,uBAAuB,CAAC,MAAO,EAAE,cAAc,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACvG,CAAC,CACJ,CAAC;QAEF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAEnC,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ","sourcesContent":["// eslint-disable-next-line import/no-internal-modules\r\nimport type { FrameGraph, FrameGraphTextureHandle, FrameGraphRenderPass, Camera } from \"core/index\";\r\nimport { FrameGraphPostProcessTask } from \"./postProcessTask\";\r\nimport { Constants } from \"core/Engines/constants\";\r\nimport { ThinCircleOfConfusionPostProcess } from \"core/PostProcesses/thinCircleOfConfusionPostProcess\";\r\n\r\n/**\r\n * Task which applies a circle of confusion post process.\r\n */\r\nexport class FrameGraphCircleOfConfusionTask extends FrameGraphPostProcessTask {\r\n    /**\r\n     * The depth texture to use for the circle of confusion effect.\r\n     * It must store camera space depth (Z coordinate)\r\n     */\r\n    public depthTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * The sampling mode to use for the depth texture.\r\n     */\r\n    public depthSamplingMode = Constants.TEXTURE_BILINEAR_SAMPLINGMODE;\r\n\r\n    /**\r\n     * The camera to use for the circle of confusion effect.\r\n     */\r\n    public camera: Camera;\r\n\r\n    public override readonly postProcess: ThinCircleOfConfusionPostProcess;\r\n\r\n    /**\r\n     * Constructs a new circle of confusion task.\r\n     * @param name The name of the task.\r\n     * @param frameGraph The frame graph this task belongs to.\r\n     * @param thinPostProcess The thin post process to use for the task. If not provided, a new one will be created.\r\n     */\r\n    constructor(name: string, frameGraph: FrameGraph, thinPostProcess?: ThinCircleOfConfusionPostProcess) {\r\n        super(name, frameGraph, thinPostProcess || new ThinCircleOfConfusionPostProcess(name, frameGraph.engine));\r\n    }\r\n\r\n    public override record(skipCreationOfDisabledPasses = false): FrameGraphRenderPass {\r\n        if (this.sourceTexture === undefined || this.depthTexture === undefined || this.camera === undefined) {\r\n            throw new Error(`FrameGraphCircleOfConfusionTask \"${this.name}\": sourceTexture, depthTexture and camera are required`);\r\n        }\r\n\r\n        const pass = super.record(\r\n            skipCreationOfDisabledPasses,\r\n            (context) => {\r\n                context.setTextureSamplingMode(this.depthTexture, this.depthSamplingMode);\r\n            },\r\n            (context) => {\r\n                this.postProcess.camera = this.camera;\r\n                context.bindTextureHandle(this._postProcessDrawWrapper.effect!, \"depthSampler\", this.depthTexture);\r\n            }\r\n        );\r\n\r\n        pass.useTexture(this.depthTexture);\r\n\r\n        return pass;\r\n    }\r\n}\r\n"]}

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

@@ -0,0 +1,12 @@
+import type { FrameGraph, FrameGraphTextureHandle, FrameGraphRenderPass } from "../../../index.js";
+import { FrameGraphBlurTask } from "./blurTask";
+import { ThinDepthOfFieldBlurPostProcess } from "../../../PostProcesses/thinDepthOfFieldBlurPostProcess.js";
+/**
+ * @internal
+ */
+export declare class FrameGraphDepthOfFieldBlurTask extends FrameGraphBlurTask {
+    circleOfConfusionTexture: FrameGraphTextureHandle;
+    circleOfConfusionSamplingMode: number;
+    constructor(name: string, frameGraph: FrameGraph, thinPostProcess?: ThinDepthOfFieldBlurPostProcess);
+    record(skipCreationOfDisabledPasses?: boolean): FrameGraphRenderPass;
+}

package/FrameGraph/Tasks/PostProcesses/depthOfFieldBlurTask.js

@@ -0,0 +1,26 @@
+
+import { FrameGraphBlurTask } from "./blurTask.js";
+import { ThinDepthOfFieldBlurPostProcess } from "../../../PostProcesses/thinDepthOfFieldBlurPostProcess.js";
+import { Vector2 } from "../../../Maths/math.vector.js";
+/**
+ * @internal
+ */
+export class FrameGraphDepthOfFieldBlurTask extends FrameGraphBlurTask {
+    constructor(name, frameGraph, thinPostProcess) {
+        super(name, frameGraph, thinPostProcess || new ThinDepthOfFieldBlurPostProcess(name, frameGraph.engine, new Vector2(1, 0), 10));
+        this.circleOfConfusionSamplingMode = 2;
+    }
+    record(skipCreationOfDisabledPasses = false) {
+        if (this.sourceTexture === undefined || this.circleOfConfusionTexture === undefined) {
+            throw new Error(`FrameGraphDepthOfFieldBlurTask "${this.name}": sourceTexture and circleOfConfusionTexture are required`);
+        }
+        const pass = super.record(skipCreationOfDisabledPasses, (context) => {
+            context.setTextureSamplingMode(this.circleOfConfusionTexture, this.circleOfConfusionSamplingMode);
+        }, (context) => {
+            context.bindTextureHandle(this._postProcessDrawWrapper.effect, "circleOfConfusionSampler", this.circleOfConfusionTexture);
+        });
+        pass.useTexture(this.circleOfConfusionTexture);
+        return pass;
+    }
+}
+//# sourceMappingURL=depthOfFieldBlurTask.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"depthOfFieldBlurTask.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FrameGraph/Tasks/PostProcesses/depthOfFieldBlurTask.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,sCAA+B;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,+BAA+B,EAAE,kEAA2D;AACrG,OAAO,EAAE,OAAO,EAAE,sCAA+B;AAEjD;;GAEG;AACH,MAAM,OAAO,8BAA+B,SAAQ,kBAAkB;IAKlE,YAAY,IAAY,EAAE,UAAsB,EAAE,eAAiD;QAC/F,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,eAAe,IAAI,IAAI,+BAA+B,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,EAAE,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAH7H,kCAA6B,GAAG,SAAS,CAAC,6BAA6B,CAAC;IAI/E,CAAC;IAEe,MAAM,CAAC,4BAA4B,GAAG,KAAK;QACvD,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,IAAI,IAAI,CAAC,wBAAwB,KAAK,SAAS,EAAE;YACjF,MAAM,IAAI,KAAK,CAAC,mCAAmC,IAAI,CAAC,IAAI,4DAA4D,CAAC,CAAC;SAC7H;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CACrB,4BAA4B,EAC5B,CAAC,OAAO,EAAE,EAAE;YACR,OAAO,CAAC,sBAAsB,CAAC,IAAI,CAAC,wBAAwB,EAAE,IAAI,CAAC,6BAA6B,CAAC,CAAC;QACtG,CAAC,EACD,CAAC,OAAO,EAAE,EAAE;YACR,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,uBAAuB,CAAC,MAAO,EAAE,0BAA0B,EAAE,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAC/H,CAAC,CACJ,CAAC;QAEF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAE/C,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ","sourcesContent":["// eslint-disable-next-line import/no-internal-modules\r\nimport type { FrameGraph, FrameGraphTextureHandle, FrameGraphRenderPass } from \"core/index\";\r\nimport { Constants } from \"core/Engines/constants\";\r\nimport { FrameGraphBlurTask } from \"./blurTask\";\r\nimport { ThinDepthOfFieldBlurPostProcess } from \"core/PostProcesses/thinDepthOfFieldBlurPostProcess\";\r\nimport { Vector2 } from \"core/Maths/math.vector\";\r\n\r\n/**\r\n * @internal\r\n */\r\nexport class FrameGraphDepthOfFieldBlurTask extends FrameGraphBlurTask {\r\n    public circleOfConfusionTexture: FrameGraphTextureHandle;\r\n\r\n    public circleOfConfusionSamplingMode = Constants.TEXTURE_BILINEAR_SAMPLINGMODE;\r\n\r\n    constructor(name: string, frameGraph: FrameGraph, thinPostProcess?: ThinDepthOfFieldBlurPostProcess) {\r\n        super(name, frameGraph, thinPostProcess || new ThinDepthOfFieldBlurPostProcess(name, frameGraph.engine, new Vector2(1, 0), 10));\r\n    }\r\n\r\n    public override record(skipCreationOfDisabledPasses = false): FrameGraphRenderPass {\r\n        if (this.sourceTexture === undefined || this.circleOfConfusionTexture === undefined) {\r\n            throw new Error(`FrameGraphDepthOfFieldBlurTask \"${this.name}\": sourceTexture and circleOfConfusionTexture are required`);\r\n        }\r\n\r\n        const pass = super.record(\r\n            skipCreationOfDisabledPasses,\r\n            (context) => {\r\n                context.setTextureSamplingMode(this.circleOfConfusionTexture, this.circleOfConfusionSamplingMode);\r\n            },\r\n            (context) => {\r\n                context.bindTextureHandle(this._postProcessDrawWrapper.effect!, \"circleOfConfusionSampler\", this.circleOfConfusionTexture);\r\n            }\r\n        );\r\n\r\n        pass.useTexture(this.circleOfConfusionTexture);\r\n\r\n        return pass;\r\n    }\r\n}\r\n"]}

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

@@ -0,0 +1,12 @@
+import type { FrameGraph, FrameGraphTextureHandle, FrameGraphRenderPass } from "../../../index.js";
+import { ThinDepthOfFieldMergePostProcess } from "../../../PostProcesses/thinDepthOfFieldMergePostProcess.js";
+import { FrameGraphPostProcessTask } from "./postProcessTask";
+/**
+ * @internal
+ */
+export declare class FrameGraphDepthOfFieldMergeTask extends FrameGraphPostProcessTask {
+    circleOfConfusionTexture: FrameGraphTextureHandle;
+    blurSteps: FrameGraphTextureHandle[];
+    constructor(name: string, frameGraph: FrameGraph, thinPostProcess?: ThinDepthOfFieldMergePostProcess);
+    record(skipCreationOfDisabledPasses?: boolean): FrameGraphRenderPass;
+}