@babylonjs/core 7.32.0 → 7.32.1

package/FrameGraph/Tasks/PostProcesses/depthOfFieldMergeTask.js

@@ -0,0 +1,29 @@
+import { ThinDepthOfFieldMergePostProcess } from "../../../PostProcesses/thinDepthOfFieldMergePostProcess.js";
+import { FrameGraphPostProcessTask } from "./postProcessTask.js";
+/**
+ * @internal
+ */
+export class FrameGraphDepthOfFieldMergeTask extends FrameGraphPostProcessTask {
+    constructor(name, frameGraph, thinPostProcess) {
+        super(name, frameGraph, thinPostProcess || new ThinDepthOfFieldMergePostProcess(name, frameGraph.engine));
+        this.blurSteps = [];
+    }
+    record(skipCreationOfDisabledPasses = false) {
+        if (this.sourceTexture === undefined || this.circleOfConfusionTexture === undefined || this.blurSteps.length === 0) {
+            throw new Error(`FrameGraphBloomMergeTask "${this.name}": sourceTexture, circleOfConfusionTexture and blurSteps are required`);
+        }
+        this.postProcess.updateEffect("#define BLUR_LEVEL " + (this.blurSteps.length - 1) + "\n");
+        const pass = super.record(skipCreationOfDisabledPasses, undefined, (context) => {
+            context.bindTextureHandle(this._postProcessDrawWrapper.effect, "circleOfConfusionSampler", this.circleOfConfusionTexture);
+            this.blurSteps.forEach((handle, index) => {
+                context.bindTextureHandle(this._postProcessDrawWrapper.effect, "blurStep" + (this.blurSteps.length - index - 1), handle);
+            });
+        });
+        pass.useTexture(this.circleOfConfusionTexture);
+        for (const handle of this.blurSteps) {
+            pass.useTexture(handle);
+        }
+        return pass;
+    }
+}
+//# sourceMappingURL=depthOfFieldMergeTask.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"depthOfFieldMergeTask.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FrameGraph/Tasks/PostProcesses/depthOfFieldMergeTask.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gCAAgC,EAAE,mEAA4D;AACvG,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAE9D;;GAEG;AACH,MAAM,OAAO,+BAAgC,SAAQ,yBAAyB;IAK1E,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;QAHvG,cAAS,GAA8B,EAAE,CAAC;IAIjD,CAAC;IAEe,MAAM,CAAC,4BAA4B,GAAG,KAAK;QACvD,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,IAAI,IAAI,CAAC,wBAAwB,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE;YAChH,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,CAAC,IAAI,uEAAuE,CAAC,CAAC;SAClI;QAED,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,qBAAqB,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAE1F,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,0BAA0B,EAAE,IAAI,CAAC,wBAAwB,CAAC,CAAC;YAC3H,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;gBACrC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,uBAAuB,CAAC,MAAO,EAAE,UAAU,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,KAAK,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YAC9H,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAC/C,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE;YACjC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;SAC3B;QAED,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 { ThinDepthOfFieldMergePostProcess } from \"core/PostProcesses/thinDepthOfFieldMergePostProcess\";\r\nimport { FrameGraphPostProcessTask } from \"./postProcessTask\";\r\n\r\n/**\r\n * @internal\r\n */\r\nexport class FrameGraphDepthOfFieldMergeTask extends FrameGraphPostProcessTask {\r\n    public circleOfConfusionTexture: FrameGraphTextureHandle;\r\n\r\n    public blurSteps: FrameGraphTextureHandle[] = [];\r\n\r\n    constructor(name: string, frameGraph: FrameGraph, thinPostProcess?: ThinDepthOfFieldMergePostProcess) {\r\n        super(name, frameGraph, thinPostProcess || new ThinDepthOfFieldMergePostProcess(name, frameGraph.engine));\r\n    }\r\n\r\n    public override record(skipCreationOfDisabledPasses = false): FrameGraphRenderPass {\r\n        if (this.sourceTexture === undefined || this.circleOfConfusionTexture === undefined || this.blurSteps.length === 0) {\r\n            throw new Error(`FrameGraphBloomMergeTask \"${this.name}\": sourceTexture, circleOfConfusionTexture and blurSteps are required`);\r\n        }\r\n\r\n        this.postProcess.updateEffect(\"#define BLUR_LEVEL \" + (this.blurSteps.length - 1) + \"\\n\");\r\n\r\n        const pass = super.record(skipCreationOfDisabledPasses, undefined, (context) => {\r\n            context.bindTextureHandle(this._postProcessDrawWrapper.effect!, \"circleOfConfusionSampler\", this.circleOfConfusionTexture);\r\n            this.blurSteps.forEach((handle, index) => {\r\n                context.bindTextureHandle(this._postProcessDrawWrapper.effect!, \"blurStep\" + (this.blurSteps.length - index - 1), handle);\r\n            });\r\n        });\r\n\r\n        pass.useTexture(this.circleOfConfusionTexture);\r\n        for (const handle of this.blurSteps) {\r\n            pass.useTexture(handle);\r\n        }\r\n\r\n        return pass;\r\n    }\r\n}\r\n"]}

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

@@ -0,0 +1,65 @@
+import type { FrameGraph, FrameGraphTextureHandle, AbstractEngine, Camera } from "../../../index.js";
+import { FrameGraphTask } from "../../frameGraphTask";
+import { ThinDepthOfFieldEffectBlurLevel } from "../../../PostProcesses/thinDepthOfFieldEffect.js";
+import { ThinDepthOfFieldEffect } from "../../../PostProcesses/thinDepthOfFieldEffect.js";
+/**
+ * Task which applies a depth of field effect.
+ */
+export declare class FrameGraphDepthOfFieldTask extends FrameGraphTask {
+    /**
+     * The source texture to apply the depth of field effect on.
+     */
+    sourceTexture: FrameGraphTextureHandle;
+    /**
+     * The sampling mode to use for the source texture.
+     */
+    sourceSamplingMode: number;
+    /**
+     * The depth texture to use for the depth of field effect.
+     * Should store camera space depth (Z coordinate).
+     */
+    depthTexture: FrameGraphTextureHandle;
+    /**
+     * The sampling mode to use for the depth texture.
+     */
+    depthSamplingMode: number;
+    /**
+     * The camera used to render the scene.
+     */
+    camera: Camera;
+    /**
+     * The destination texture to render the depth of field effect to.
+     */
+    destinationTexture?: FrameGraphTextureHandle;
+    /**
+     * The output texture of the depth of field effect.
+     */
+    readonly outputTexture: FrameGraphTextureHandle;
+    /**
+     * The depth of field effect.
+     */
+    readonly depthOfField: ThinDepthOfFieldEffect;
+    /**
+     * Whether the depth of field effect is applied on HDR textures.
+     * When true, the depth of field effect will use a higher precision texture format (half float or float). Else, it will use unsigned byte.
+     */
+    readonly hdr: boolean;
+    private _engine;
+    private _circleOfConfusion;
+    private _blurX;
+    private _blurY;
+    private _merge;
+    private _defaultPipelineTextureType;
+    /**
+     * Constructs a depth of field task.
+     * @param name The name of the task.
+     * @param frameGraph The frame graph this task belongs to.
+     * @param engine The engine to use for the depth of field effect.
+     * @param blurLevel The blur level of the depth of field effect (default: ThinDepthOfFieldEffectBlurLevel.Low).
+     * @param hdr Whether the depth of field effect is HDR.
+     */
+    constructor(name: string, frameGraph: FrameGraph, engine: AbstractEngine, blurLevel?: ThinDepthOfFieldEffectBlurLevel, hdr?: boolean);
+    isReady(): boolean;
+    record(): void;
+    dispose(): void;
+}

package/FrameGraph/Tasks/PostProcesses/depthOfFieldTask.js

@@ -0,0 +1,134 @@
+
+import { FrameGraphTask } from "../../frameGraphTask.js";
+import { FrameGraphDepthOfFieldMergeTask } from "./depthOfFieldMergeTask.js";
+import { FrameGraphCircleOfConfusionTask } from "./circleOfConfusionTask.js";
+import { FrameGraphDepthOfFieldBlurTask } from "./depthOfFieldBlurTask.js";
+import { ThinDepthOfFieldEffect } from "../../../PostProcesses/thinDepthOfFieldEffect.js";
+/**
+ * Task which applies a depth of field effect.
+ */
+export class FrameGraphDepthOfFieldTask extends FrameGraphTask {
+    /**
+     * Constructs a depth of field task.
+     * @param name The name of the task.
+     * @param frameGraph The frame graph this task belongs to.
+     * @param engine The engine to use for the depth of field effect.
+     * @param blurLevel The blur level of the depth of field effect (default: ThinDepthOfFieldEffectBlurLevel.Low).
+     * @param hdr Whether the depth of field effect is HDR.
+     */
+    constructor(name, frameGraph, engine, blurLevel = 0 /* ThinDepthOfFieldEffectBlurLevel.Low */, hdr = false) {
+        super(name, frameGraph);
+        /**
+         * The sampling mode to use for the source texture.
+         */
+        this.sourceSamplingMode = 2;
+        /**
+         * The sampling mode to use for the depth texture.
+         */
+        this.depthSamplingMode = 2;
+        this._blurX = [];
+        this._blurY = [];
+        this._engine = engine;
+        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.depthOfField = new ThinDepthOfFieldEffect(name, engine, blurLevel, true);
+        this._circleOfConfusion = new FrameGraphCircleOfConfusionTask(`${name} Circle of Confusion`, this._frameGraph, this.depthOfField._circleOfConfusion);
+        const blurCount = this.depthOfField._depthOfFieldBlurX.length;
+        for (let i = 0; i < blurCount; i++) {
+            this._blurX.push(new FrameGraphDepthOfFieldBlurTask(`${name} Blur X`, this._frameGraph, this.depthOfField._depthOfFieldBlurX[i][0]));
+            this._blurY.push(new FrameGraphDepthOfFieldBlurTask(`${name} Blur Y`, this._frameGraph, this.depthOfField._depthOfFieldBlurY[i][0]));
+        }
+        this._merge = new FrameGraphDepthOfFieldMergeTask(`${name} Merge`, this._frameGraph, this.depthOfField._dofMerge);
+        this.outputTexture = this._frameGraph.createDanglingHandle();
+    }
+    isReady() {
+        return this.depthOfField.isReady();
+    }
+    record() {
+        if (this.sourceTexture === undefined || this.depthTexture === undefined || this.camera === undefined) {
+            throw new Error("FrameGraphDepthOfFieldTask: sourceTexture, depthTexture and camera are required");
+        }
+        const sourceTextureDescription = this._frameGraph.getTextureDescription(this.sourceTexture);
+        const textureSize = {
+            width: sourceTextureDescription.size.width,
+            height: sourceTextureDescription.size.height,
+        };
+        const circleOfConfusionTextureFormat = this._engine.isWebGPU || this._engine.version > 1 ? 6 : 5;
+        const textureCreationOptions = {
+            size: textureSize,
+            options: {
+                createMipMaps: false,
+                generateMipMaps: false,
+                types: [this._defaultPipelineTextureType],
+                formats: [circleOfConfusionTextureFormat],
+                samples: 1,
+                useSRGBBuffers: [false],
+                generateDepthBuffer: false,
+                generateStencilBuffer: false,
+                label: "",
+            },
+            sizeIsPercentage: false,
+        };
+        const circleOfConfusionTextureHandle = this._frameGraph.createRenderTargetTexture(this._circleOfConfusion.name, textureCreationOptions);
+        this._circleOfConfusion.sourceTexture = this.sourceTexture; // texture not used by the CoC shader
+        this._circleOfConfusion.depthTexture = this.depthTexture;
+        this._circleOfConfusion.depthSamplingMode = this.depthSamplingMode;
+        this._circleOfConfusion.camera = this.camera;
+        this._circleOfConfusion.destinationTexture = circleOfConfusionTextureHandle;
+        this._circleOfConfusion.record(true);
+        textureCreationOptions.options.formats = [5];
+        const blurSteps = [];
+        for (let i = 0; i < this._blurX.length; i++) {
+            const ratio = this.depthOfField._depthOfFieldBlurX[i][1];
+            textureSize.width = Math.floor(sourceTextureDescription.size.width * ratio);
+            textureSize.height = Math.floor(sourceTextureDescription.size.height * ratio);
+            const blurYTextureHandle = this._frameGraph.createRenderTargetTexture(this._blurY[i].name, textureCreationOptions);
+            this._blurY[i].sourceTexture = i === 0 ? this.sourceTexture : this._blurX[i - 1].outputTexture;
+            this._blurY[i].sourceSamplingMode = 2;
+            this._blurY[i].circleOfConfusionTexture = circleOfConfusionTextureHandle;
+            this._blurY[i].destinationTexture = blurYTextureHandle;
+            this._blurY[i].record(true);
+            const blurXTextureHandle = this._frameGraph.createRenderTargetTexture(this._blurX[i].name, textureCreationOptions);
+            this._blurX[i].sourceTexture = this._blurY[i].outputTexture;
+            this._blurX[i].sourceSamplingMode = 2;
+            this._blurX[i].circleOfConfusionTexture = circleOfConfusionTextureHandle;
+            this._blurX[i].destinationTexture = blurXTextureHandle;
+            this._blurX[i].record(true);
+            blurSteps.push(blurXTextureHandle);
+        }
+        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.circleOfConfusionTexture = circleOfConfusionTextureHandle;
+        this._merge.blurSteps = blurSteps;
+        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._circleOfConfusion.dispose();
+        for (let i = 0; i < this._blurX.length; i++) {
+            this._blurX[i].dispose();
+            this._blurY[i].dispose();
+        }
+        this._merge.dispose();
+        super.dispose();
+    }
+}
+//# sourceMappingURL=depthOfFieldTask.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"depthOfFieldTask.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FrameGraph/Tasks/PostProcesses/depthOfFieldTask.ts"],"names":[],"mappings":"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","sourcesContent":["// eslint-disable-next-line import/no-internal-modules\r\nimport type { FrameGraph, FrameGraphTextureCreationOptions, FrameGraphTextureHandle, AbstractEngine, Camera } from \"core/index\";\r\nimport { Constants } from \"core/Engines/constants\";\r\nimport { FrameGraphTask } from \"../../frameGraphTask\";\r\nimport { ThinDepthOfFieldEffectBlurLevel } from \"core/PostProcesses/thinDepthOfFieldEffect\";\r\nimport { FrameGraphDepthOfFieldMergeTask } from \"./depthOfFieldMergeTask\";\r\nimport { FrameGraphCircleOfConfusionTask } from \"./circleOfConfusionTask\";\r\nimport { FrameGraphDepthOfFieldBlurTask } from \"./depthOfFieldBlurTask\";\r\nimport { ThinDepthOfFieldEffect } from \"core/PostProcesses/thinDepthOfFieldEffect\";\r\n\r\n/**\r\n * Task which applies a depth of field effect.\r\n */\r\nexport class FrameGraphDepthOfFieldTask extends FrameGraphTask {\r\n    /**\r\n     * The source texture to apply the depth of field 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 depth texture to use for the depth of field effect.\r\n     * Should 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 used to render the scene.\r\n     */\r\n    public camera: Camera;\r\n\r\n    /**\r\n     * The destination texture to render the depth of field effect to.\r\n     */\r\n    public destinationTexture?: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * The output texture of the depth of field effect.\r\n     */\r\n    public readonly outputTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * The depth of field effect.\r\n     */\r\n    public readonly depthOfField: ThinDepthOfFieldEffect;\r\n\r\n    /**\r\n     * Whether the depth of field effect is applied on HDR textures.\r\n     * When true, the depth of field 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 _engine: AbstractEngine;\r\n    private _circleOfConfusion: FrameGraphCircleOfConfusionTask;\r\n    private _blurX: FrameGraphDepthOfFieldBlurTask[] = [];\r\n    private _blurY: FrameGraphDepthOfFieldBlurTask[] = [];\r\n    private _merge: FrameGraphDepthOfFieldMergeTask;\r\n    private _defaultPipelineTextureType: number;\r\n\r\n    /**\r\n     * Constructs a depth of field task.\r\n     * @param name The name of the task.\r\n     * @param frameGraph The frame graph this task belongs to.\r\n     * @param engine The engine to use for the depth of field effect.\r\n     * @param blurLevel The blur level of the depth of field effect (default: ThinDepthOfFieldEffectBlurLevel.Low).\r\n     * @param hdr Whether the depth of field effect is HDR.\r\n     */\r\n    constructor(name: string, frameGraph: FrameGraph, engine: AbstractEngine, blurLevel: ThinDepthOfFieldEffectBlurLevel = ThinDepthOfFieldEffectBlurLevel.Low, hdr = false) {\r\n        super(name, frameGraph);\r\n\r\n        this._engine = engine;\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.depthOfField = new ThinDepthOfFieldEffect(name, engine, blurLevel, true);\r\n\r\n        this._circleOfConfusion = new FrameGraphCircleOfConfusionTask(`${name} Circle of Confusion`, this._frameGraph, this.depthOfField._circleOfConfusion);\r\n\r\n        const blurCount = this.depthOfField._depthOfFieldBlurX.length;\r\n\r\n        for (let i = 0; i < blurCount; i++) {\r\n            this._blurX.push(new FrameGraphDepthOfFieldBlurTask(`${name} Blur X`, this._frameGraph, this.depthOfField._depthOfFieldBlurX[i][0]));\r\n            this._blurY.push(new FrameGraphDepthOfFieldBlurTask(`${name} Blur Y`, this._frameGraph, this.depthOfField._depthOfFieldBlurY[i][0]));\r\n        }\r\n\r\n        this._merge = new FrameGraphDepthOfFieldMergeTask(`${name} Merge`, this._frameGraph, this.depthOfField._dofMerge);\r\n\r\n        this.outputTexture = this._frameGraph.createDanglingHandle();\r\n    }\r\n\r\n    public override isReady() {\r\n        return this.depthOfField.isReady();\r\n    }\r\n\r\n    public record(): void {\r\n        if (this.sourceTexture === undefined || this.depthTexture === undefined || this.camera === undefined) {\r\n            throw new Error(\"FrameGraphDepthOfFieldTask: sourceTexture, depthTexture and camera are required\");\r\n        }\r\n\r\n        const sourceTextureDescription = this._frameGraph.getTextureDescription(this.sourceTexture);\r\n\r\n        const textureSize = {\r\n            width: sourceTextureDescription.size.width,\r\n            height: sourceTextureDescription.size.height,\r\n        };\r\n        const circleOfConfusionTextureFormat = this._engine.isWebGPU || this._engine.version > 1 ? Constants.TEXTUREFORMAT_RED : Constants.TEXTUREFORMAT_RGBA;\r\n        const textureCreationOptions: FrameGraphTextureCreationOptions = {\r\n            size: textureSize,\r\n            options: {\r\n                createMipMaps: false,\r\n                generateMipMaps: false,\r\n                types: [this._defaultPipelineTextureType],\r\n                formats: [circleOfConfusionTextureFormat],\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 circleOfConfusionTextureHandle = this._frameGraph.createRenderTargetTexture(this._circleOfConfusion.name, textureCreationOptions);\r\n\r\n        this._circleOfConfusion.sourceTexture = this.sourceTexture; // texture not used by the CoC shader\r\n        this._circleOfConfusion.depthTexture = this.depthTexture;\r\n        this._circleOfConfusion.depthSamplingMode = this.depthSamplingMode;\r\n        this._circleOfConfusion.camera = this.camera;\r\n        this._circleOfConfusion.destinationTexture = circleOfConfusionTextureHandle;\r\n        this._circleOfConfusion.record(true);\r\n\r\n        textureCreationOptions.options.formats = [Constants.TEXTUREFORMAT_RGBA];\r\n\r\n        const blurSteps: FrameGraphTextureHandle[] = [];\r\n\r\n        for (let i = 0; i < this._blurX.length; i++) {\r\n            const ratio = this.depthOfField._depthOfFieldBlurX[i][1];\r\n\r\n            textureSize.width = Math.floor(sourceTextureDescription.size.width * ratio);\r\n            textureSize.height = Math.floor(sourceTextureDescription.size.height * ratio);\r\n\r\n            const blurYTextureHandle = this._frameGraph.createRenderTargetTexture(this._blurY[i].name, textureCreationOptions);\r\n\r\n            this._blurY[i].sourceTexture = i === 0 ? this.sourceTexture : this._blurX[i - 1].outputTexture;\r\n            this._blurY[i].sourceSamplingMode = Constants.TEXTURE_BILINEAR_SAMPLINGMODE;\r\n            this._blurY[i].circleOfConfusionTexture = circleOfConfusionTextureHandle;\r\n            this._blurY[i].destinationTexture = blurYTextureHandle;\r\n            this._blurY[i].record(true);\r\n\r\n            const blurXTextureHandle = this._frameGraph.createRenderTargetTexture(this._blurX[i].name, textureCreationOptions);\r\n\r\n            this._blurX[i].sourceTexture = this._blurY[i].outputTexture;\r\n            this._blurX[i].sourceSamplingMode = Constants.TEXTURE_BILINEAR_SAMPLINGMODE;\r\n            this._blurX[i].circleOfConfusionTexture = circleOfConfusionTextureHandle;\r\n            this._blurX[i].destinationTexture = blurXTextureHandle;\r\n            this._blurX[i].record(true);\r\n\r\n            blurSteps.push(blurXTextureHandle);\r\n        }\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.circleOfConfusionTexture = circleOfConfusionTextureHandle;\r\n        this._merge.blurSteps = blurSteps;\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._circleOfConfusion.dispose();\r\n        for (let i = 0; i < this._blurX.length; i++) {\r\n            this._blurX[i].dispose();\r\n            this._blurY[i].dispose();\r\n        }\r\n        this._merge.dispose();\r\n        super.dispose();\r\n    }\r\n}\r\n"]}

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

@@ -0,0 +1,16 @@
+import type { FrameGraph } from "../../../index.js";
+import { ThinExtractHighlightsPostProcess } from "../../../PostProcesses/thinExtractHighlightsPostProcess.js";
+import { FrameGraphPostProcessTask } from "./postProcessTask";
+/**
+ * Task used to extract highlights from a scene.
+ */
+export declare class FrameGraphExtractHighlightsTask extends FrameGraphPostProcessTask {
+    readonly postProcess: ThinExtractHighlightsPostProcess;
+    /**
+     * Constructs a new extract highlights task.
+     * @param name The name of the task.
+     * @param frameGraph The frame graph the 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?: ThinExtractHighlightsPostProcess);
+}

package/FrameGraph/Tasks/PostProcesses/extractHighlightsTask.js

@@ -0,0 +1,17 @@
+import { ThinExtractHighlightsPostProcess } from "../../../PostProcesses/thinExtractHighlightsPostProcess.js";
+import { FrameGraphPostProcessTask } from "./postProcessTask.js";
+/**
+ * Task used to extract highlights from a scene.
+ */
+export class FrameGraphExtractHighlightsTask extends FrameGraphPostProcessTask {
+    /**
+     * Constructs a new extract highlights task.
+     * @param name The name of the task.
+     * @param frameGraph The frame graph the 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 ThinExtractHighlightsPostProcess(name, frameGraph.engine));
+    }
+}
+//# sourceMappingURL=extractHighlightsTask.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractHighlightsTask.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FrameGraph/Tasks/PostProcesses/extractHighlightsTask.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gCAAgC,EAAE,mEAA4D;AACvG,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAE9D;;GAEG;AACH,MAAM,OAAO,+BAAgC,SAAQ,yBAAyB;IAG1E;;;;;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;IAC9G,CAAC;CACJ","sourcesContent":["// eslint-disable-next-line import/no-internal-modules\r\nimport type { FrameGraph } from \"core/index\";\r\nimport { ThinExtractHighlightsPostProcess } from \"core/PostProcesses/thinExtractHighlightsPostProcess\";\r\nimport { FrameGraphPostProcessTask } from \"./postProcessTask\";\r\n\r\n/**\r\n * Task used to extract highlights from a scene.\r\n */\r\nexport class FrameGraphExtractHighlightsTask extends FrameGraphPostProcessTask {\r\n    public override readonly postProcess: ThinExtractHighlightsPostProcess;\r\n\r\n    /**\r\n     * Constructs a new extract highlights task.\r\n     * @param name The name of the task.\r\n     * @param frameGraph The frame graph the 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?: ThinExtractHighlightsPostProcess) {\r\n        super(name, frameGraph, thinPostProcess || new ThinExtractHighlightsPostProcess(name, frameGraph.engine));\r\n    }\r\n}\r\n"]}

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

@@ -0,0 +1,41 @@
+import type { FrameGraph, FrameGraphTextureHandle, DrawWrapper, FrameGraphRenderPass, FrameGraphRenderContext, EffectWrapper } from "../../../index.js";
+import { FrameGraphTask } from "../../frameGraphTask";
+/**
+ * Task which applies a post process.
+ */
+export declare class FrameGraphPostProcessTask extends FrameGraphTask {
+    /**
+     * The source texture to apply the post process on.
+     */
+    sourceTexture: FrameGraphTextureHandle;
+    /**
+     * The sampling mode to use for the source texture.
+     */
+    sourceSamplingMode: number;
+    /**
+     * The destination texture to render the post process to.
+     * If not supplied, a texture with the same configuration as the source texture will be created.
+     */
+    destinationTexture?: FrameGraphTextureHandle;
+    /**
+     * The output texture of the post process.
+     */
+    readonly outputTexture: FrameGraphTextureHandle;
+    /**
+     * The post process to apply.
+     */
+    readonly postProcess: EffectWrapper;
+    protected readonly _postProcessDrawWrapper: DrawWrapper;
+    protected _outputWidth: number;
+    protected _outputHeight: number;
+    /**
+     * Constructs a new post process task.
+     * @param name Name of the task.
+     * @param frameGraph The frame graph this task is associated with.
+     * @param postProcess The post process to apply.
+     */
+    constructor(name: string, frameGraph: FrameGraph, postProcess: EffectWrapper);
+    isReady(): boolean;
+    record(skipCreationOfDisabledPasses?: boolean, additionalExecute?: (context: FrameGraphRenderContext) => void, additionalBindings?: (context: FrameGraphRenderContext) => void): FrameGraphRenderPass;
+    dispose(): void;
+}

package/FrameGraph/Tasks/PostProcesses/postProcessTask.js

@@ -0,0 +1,64 @@
+
+import { FrameGraphTask } from "../../frameGraphTask.js";
+/**
+ * Task which applies a post process.
+ */
+export class FrameGraphPostProcessTask extends FrameGraphTask {
+    /**
+     * Constructs a new post process task.
+     * @param name Name of the task.
+     * @param frameGraph The frame graph this task is associated with.
+     * @param postProcess The post process to apply.
+     */
+    constructor(name, frameGraph, postProcess) {
+        super(name, frameGraph);
+        /**
+         * The sampling mode to use for the source texture.
+         */
+        this.sourceSamplingMode = 2;
+        this.postProcess = postProcess;
+        this._postProcessDrawWrapper = this.postProcess.drawWrapper;
+        this.outputTexture = this._frameGraph.createDanglingHandle();
+    }
+    isReady() {
+        return this.postProcess.isReady();
+    }
+    record(skipCreationOfDisabledPasses = false, additionalExecute, additionalBindings) {
+        if (this.sourceTexture === undefined) {
+            throw new Error(`FrameGraphPostProcessTask "${this.name}": sourceTexture is required`);
+        }
+        const sourceTextureCreationOptions = this._frameGraph.getTextureCreationOptions(this.sourceTexture, true);
+        sourceTextureCreationOptions.options.generateDepthBuffer = false;
+        sourceTextureCreationOptions.options.generateStencilBuffer = false;
+        sourceTextureCreationOptions.options.samples = 1;
+        this._frameGraph.resolveDanglingHandle(this.outputTexture, this.destinationTexture, this.name, sourceTextureCreationOptions);
+        const outputTextureDescription = this._frameGraph.getTextureDescription(this.outputTexture);
+        this._outputWidth = outputTextureDescription.size.width;
+        this._outputHeight = outputTextureDescription.size.height;
+        const pass = this._frameGraph.addRenderPass(this.name);
+        pass.useTexture(this.sourceTexture);
+        pass.setRenderTarget(this.outputTexture);
+        pass.setExecuteFunc((context) => {
+            context.setTextureSamplingMode(this.sourceTexture, this.sourceSamplingMode);
+            additionalExecute?.(context);
+            context.applyFullScreenEffect(this._postProcessDrawWrapper, () => {
+                context.bindTextureHandle(this._postProcessDrawWrapper.effect, "textureSampler", this.sourceTexture);
+                additionalBindings?.(context);
+                this.postProcess.bind();
+            });
+        });
+        if (!skipCreationOfDisabledPasses) {
+            const passDisabled = this._frameGraph.addRenderPass(this.name + "_disabled", true);
+            passDisabled.setRenderTarget(this.outputTexture);
+            passDisabled.setExecuteFunc((context) => {
+                context.copyTexture(this.sourceTexture);
+            });
+        }
+        return pass;
+    }
+    dispose() {
+        this.postProcess.dispose();
+        super.dispose();
+    }
+}
+//# sourceMappingURL=postProcessTask.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postProcessTask.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FrameGraph/Tasks/PostProcesses/postProcessTask.ts"],"names":[],"mappings":"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","sourcesContent":["// eslint-disable-next-line import/no-internal-modules\r\nimport type { FrameGraph, FrameGraphTextureHandle, DrawWrapper, FrameGraphRenderPass, FrameGraphRenderContext, EffectWrapper } from \"core/index\";\r\nimport { Constants } from \"core/Engines/constants\";\r\nimport { FrameGraphTask } from \"../../frameGraphTask\";\r\n\r\n/**\r\n * Task which applies a post process.\r\n */\r\nexport class FrameGraphPostProcessTask extends FrameGraphTask {\r\n    /**\r\n     * The source texture to apply the post process 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 post process 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 post process.\r\n     */\r\n    public readonly outputTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * The post process to apply.\r\n     */\r\n    public readonly postProcess: EffectWrapper;\r\n\r\n    protected readonly _postProcessDrawWrapper: DrawWrapper;\r\n    protected _outputWidth: number;\r\n    protected _outputHeight: number;\r\n\r\n    /**\r\n     * Constructs a new post process task.\r\n     * @param name Name of the task.\r\n     * @param frameGraph The frame graph this task is associated with.\r\n     * @param postProcess The post process to apply.\r\n     */\r\n    constructor(name: string, frameGraph: FrameGraph, postProcess: EffectWrapper) {\r\n        super(name, frameGraph);\r\n\r\n        this.postProcess = postProcess;\r\n        this._postProcessDrawWrapper = this.postProcess.drawWrapper;\r\n\r\n        this.outputTexture = this._frameGraph.createDanglingHandle();\r\n    }\r\n\r\n    public override isReady() {\r\n        return this.postProcess.isReady();\r\n    }\r\n\r\n    public record(\r\n        skipCreationOfDisabledPasses = false,\r\n        additionalExecute?: (context: FrameGraphRenderContext) => void,\r\n        additionalBindings?: (context: FrameGraphRenderContext) => void\r\n    ): FrameGraphRenderPass {\r\n        if (this.sourceTexture === undefined) {\r\n            throw new Error(`FrameGraphPostProcessTask \"${this.name}\": sourceTexture is required`);\r\n        }\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        sourceTextureCreationOptions.options.samples = 1;\r\n\r\n        this._frameGraph.resolveDanglingHandle(this.outputTexture, this.destinationTexture, this.name, sourceTextureCreationOptions);\r\n\r\n        const outputTextureDescription = this._frameGraph.getTextureDescription(this.outputTexture);\r\n\r\n        this._outputWidth = outputTextureDescription.size.width;\r\n        this._outputHeight = outputTextureDescription.size.height;\r\n\r\n        const pass = this._frameGraph.addRenderPass(this.name);\r\n\r\n        pass.useTexture(this.sourceTexture);\r\n        pass.setRenderTarget(this.outputTexture);\r\n        pass.setExecuteFunc((context) => {\r\n            context.setTextureSamplingMode(this.sourceTexture, this.sourceSamplingMode);\r\n            additionalExecute?.(context);\r\n            context.applyFullScreenEffect(this._postProcessDrawWrapper, () => {\r\n                context.bindTextureHandle(this._postProcessDrawWrapper.effect!, \"textureSampler\", this.sourceTexture);\r\n                additionalBindings?.(context);\r\n                this.postProcess.bind();\r\n            });\r\n        });\r\n\r\n        if (!skipCreationOfDisabledPasses) {\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        return pass;\r\n    }\r\n\r\n    public override dispose(): void {\r\n        this.postProcess.dispose();\r\n        super.dispose();\r\n    }\r\n}\r\n"]}

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

@@ -0,0 +1,28 @@
+import type { Scene, Camera, FrameGraph, FrameGraphObjectList } from "../../../index.js";
+import { FrameGraphTask } from "../../frameGraphTask";
+/**
+ * Task used to cull objects that are not visible.
+ */
+export declare class FrameGraphCullObjectsTask extends FrameGraphTask {
+    /**
+     * The object list to cull.
+     */
+    objectList: FrameGraphObjectList;
+    /**
+     * The camera to use for culling.
+     */
+    camera: Camera;
+    /**
+     * The output object list containing the culled objects.
+     */
+    readonly outputObjectList: FrameGraphObjectList;
+    private _scene;
+    /**
+     * Creates a new cull objects task.
+     * @param name The name of the task.
+     * @param frameGraph The frame graph the task belongs to.
+     * @param scene The scene to cull objects from.
+     */
+    constructor(name: string, frameGraph: FrameGraph, scene: Scene);
+    record(): void;
+}

package/FrameGraph/Tasks/Rendering/cullObjectsTask.js

@@ -0,0 +1,52 @@
+import { FrameGraphTask } from "../../frameGraphTask.js";
+/**
+ * Task used to cull objects that are not visible.
+ */
+export class FrameGraphCullObjectsTask extends FrameGraphTask {
+    /**
+     * Creates a new cull objects task.
+     * @param name The name of the task.
+     * @param frameGraph The frame graph the task belongs to.
+     * @param scene The scene to cull objects from.
+     */
+    constructor(name, frameGraph, scene) {
+        super(name, frameGraph);
+        this._scene = scene;
+        this.outputObjectList = {
+            meshes: [],
+            particleSystems: [],
+        };
+    }
+    record() {
+        if (this.objectList === undefined || this.camera === undefined) {
+            throw new Error(`FrameGraphCullObjectsTask ${this.name}: objectList and camera are required`);
+        }
+        const pass = this._frameGraph.addCullPass(this.name);
+        pass.setObjectList(this.outputObjectList);
+        pass.setExecuteFunc((_context) => {
+            this.outputObjectList.meshes = [];
+            this.camera._updateFrustumPlanes();
+            const frustumPlanes = this.camera._frustumPlanes;
+            const meshes = this.objectList.meshes || this._scene.meshes;
+            for (let i = 0; i < meshes.length; i++) {
+                const mesh = meshes[i];
+                if (mesh.isBlocked || !mesh.isReady() || !mesh.isEnabled() || mesh.scaling.hasAZeroComponent) {
+                    continue;
+                }
+                if (mesh.isVisible &&
+                    mesh.visibility > 0 &&
+                    (mesh.layerMask & this.camera.layerMask) !== 0 &&
+                    (this._scene.skipFrustumClipping || mesh.alwaysSelectAsActiveMesh || mesh.isInFrustum(frustumPlanes))) {
+                    this.outputObjectList.meshes.push(mesh);
+                }
+            }
+        });
+        const passDisabled = this._frameGraph.addCullPass(this.name + "_disabled", true);
+        passDisabled.setObjectList(this.outputObjectList);
+        passDisabled.setExecuteFunc((_context) => {
+            this.outputObjectList.meshes = this.objectList.meshes;
+            this.outputObjectList.particleSystems = this.objectList.particleSystems;
+        });
+    }
+}
+//# sourceMappingURL=cullObjectsTask.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cullObjectsTask.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FrameGraph/Tasks/Rendering/cullObjectsTask.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;GAEG;AACH,MAAM,OAAO,yBAA0B,SAAQ,cAAc;IAkBzD;;;;;OAKG;IACH,YAAY,IAAY,EAAE,UAAsB,EAAE,KAAY;QAC1D,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,gBAAgB,GAAG;YACpB,MAAM,EAAE,EAAE;YACV,eAAe,EAAE,EAAE;SACtB,CAAC;IACN,CAAC;IAEM,MAAM;QACT,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE;YAC5D,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,CAAC,IAAI,sCAAsC,CAAC,CAAC;SACjG;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAErD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC1C,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE,EAAE;YAC7B,IAAI,CAAC,gBAAgB,CAAC,MAAM,GAAG,EAAE,CAAC;YAElC,IAAI,CAAC,MAAM,CAAC,oBAAoB,EAAE,CAAC;YAEnC,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;YAEjD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;YAC5D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;gBACpC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBACvB,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE;oBAC1F,SAAS;iBACZ;gBAED,IACI,IAAI,CAAC,SAAS;oBACd,IAAI,CAAC,UAAU,GAAG,CAAC;oBACnB,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;oBAC9C,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,IAAI,IAAI,CAAC,wBAAwB,IAAI,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,EACvG;oBACE,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;iBAC3C;aACJ;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,GAAG,WAAW,EAAE,IAAI,CAAC,CAAC;QAEjF,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAClD,YAAY,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE,EAAE;YACrC,IAAI,CAAC,gBAAgB,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YACtD,IAAI,CAAC,gBAAgB,CAAC,eAAe,GAAG,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC;QAC5E,CAAC,CAAC,CAAC;IACP,CAAC;CACJ","sourcesContent":["// eslint-disable-next-line import/no-internal-modules\r\nimport type { Scene, Camera, FrameGraph, FrameGraphObjectList } from \"core/index\";\r\nimport { FrameGraphTask } from \"../../frameGraphTask\";\r\n\r\n/**\r\n * Task used to cull objects that are not visible.\r\n */\r\nexport class FrameGraphCullObjectsTask extends FrameGraphTask {\r\n    /**\r\n     * The object list to cull.\r\n     */\r\n    public objectList: FrameGraphObjectList;\r\n\r\n    /**\r\n     * The camera to use for culling.\r\n     */\r\n    public camera: Camera;\r\n\r\n    /**\r\n     * The output object list containing the culled objects.\r\n     */\r\n    public readonly outputObjectList: FrameGraphObjectList;\r\n\r\n    private _scene: Scene;\r\n\r\n    /**\r\n     * Creates a new cull objects task.\r\n     * @param name The name of the task.\r\n     * @param frameGraph The frame graph the task belongs to.\r\n     * @param scene The scene to cull objects from.\r\n     */\r\n    constructor(name: string, frameGraph: FrameGraph, scene: Scene) {\r\n        super(name, frameGraph);\r\n        this._scene = scene;\r\n        this.outputObjectList = {\r\n            meshes: [],\r\n            particleSystems: [],\r\n        };\r\n    }\r\n\r\n    public record() {\r\n        if (this.objectList === undefined || this.camera === undefined) {\r\n            throw new Error(`FrameGraphCullObjectsTask ${this.name}: objectList and camera are required`);\r\n        }\r\n\r\n        const pass = this._frameGraph.addCullPass(this.name);\r\n\r\n        pass.setObjectList(this.outputObjectList);\r\n        pass.setExecuteFunc((_context) => {\r\n            this.outputObjectList.meshes = [];\r\n\r\n            this.camera._updateFrustumPlanes();\r\n\r\n            const frustumPlanes = this.camera._frustumPlanes;\r\n\r\n            const meshes = this.objectList.meshes || this._scene.meshes;\r\n            for (let i = 0; i < meshes.length; i++) {\r\n                const mesh = meshes[i];\r\n                if (mesh.isBlocked || !mesh.isReady() || !mesh.isEnabled() || mesh.scaling.hasAZeroComponent) {\r\n                    continue;\r\n                }\r\n\r\n                if (\r\n                    mesh.isVisible &&\r\n                    mesh.visibility > 0 &&\r\n                    (mesh.layerMask & this.camera.layerMask) !== 0 &&\r\n                    (this._scene.skipFrustumClipping || mesh.alwaysSelectAsActiveMesh || mesh.isInFrustum(frustumPlanes))\r\n                ) {\r\n                    this.outputObjectList.meshes.push(mesh);\r\n                }\r\n            }\r\n        });\r\n\r\n        const passDisabled = this._frameGraph.addCullPass(this.name + \"_disabled\", true);\r\n\r\n        passDisabled.setObjectList(this.outputObjectList);\r\n        passDisabled.setExecuteFunc((_context) => {\r\n            this.outputObjectList.meshes = this.objectList.meshes;\r\n            this.outputObjectList.particleSystems = this.objectList.particleSystems;\r\n        });\r\n    }\r\n}\r\n"]}