@onerjs/core 8.56.4 → 9.0.1

package/FrameGraph/Tasks/Misc/minMaxReducerTask.d.ts

@@ -0,0 +1,62 @@
+import { type FrameGraph, type FrameGraphTextureHandle } from "../../../index.js";
+import { DepthTextureType } from "../../../Misc/thinMinMaxReducer.js";
+import { FrameGraphTask } from "../../frameGraphTask.js";
+/**
+ * Task which computes the minimum and maximum values in the red channel of a frame graph texture,
+ * or in the depth aspect of a WebGPU depth/stencil attachment.
+ * Set sourceTexture to a handle from an earlier task (for example, a geometry renderer's geometryNormViewDepthTexture)
+ * to reuse its output without rendering another depth map. The reduction is performed on each graph execution.
+ */
+export declare class FrameGraphMinMaxReducerTask extends FrameGraphTask {
+    /**
+     * The 2D texture to reduce. If generated by a graph task, that task must execute before this one.
+     * WebGPU can reduce the depth aspect of a single-sampled depth/stencil attachment; backbuffer depth,
+     * stencil-only attachments and integer color formats are not supported.
+     */
+    sourceTexture: FrameGraphTextureHandle;
+    /**
+     * Whether to ignore the clear value of a depth-as-color texture during reduction (default: false).
+     * For normalized view or forward screen depth, the clear value is 1; for view depth or reverse screen depth, it is 0.
+     * Always enabled for a depth/stencil attachment, which stores screen depth.
+     */
+    depthRedux: boolean;
+    /**
+     * The type of depth values stored in the source texture when depthRedux is true (default: normalized view depth).
+     */
+    depthTextureType: DepthTextureType;
+    /**
+     * The type of the intermediate and output textures (default: half float).
+     * Supported types are FLOAT, HALF_FLOAT, and UNSIGNED_BYTE.
+     */
+    textureType: number;
+    /**
+     * Wait for WebGPU texture readback before notifying observers (default: false).
+     * This delays the notification; it does not block graph execution.
+     */
+    get waitForReadback(): boolean;
+    set waitForReadback(value: boolean);
+    /**
+     * The 1x1 RG texture containing the minimum in red and maximum in green.
+     */
+    readonly outputTexture: FrameGraphTextureHandle;
+    /**
+     * Observable triggered after the reduced texture has been read back.
+     * With depthRedux enabled, an empty or equal-valued depth range falls back to [0, 1].
+     */
+    get onAfterReductionPerformed(): import("../../../index.js").Observable<{
+        min: number;
+        max: number;
+    }>;
+    private readonly _reducer;
+    private _stepCount;
+    /**
+     * Creates a min/max reduction task.
+     * @param name The name of the task.
+     * @param frameGraph The frame graph to add the task to.
+     */
+    constructor(name: string, frameGraph: FrameGraph);
+    getClassName(): string;
+    isReady(): boolean;
+    record(): void;
+    dispose(): void;
+}

package/FrameGraph/Tasks/Misc/minMaxReducerTask.js

@@ -0,0 +1,159 @@
+
+import { ThinMinMaxReducer } from "../../../Misc/thinMinMaxReducer.js";
+import { IsDepthTexture, IsIntegerTextureFormat } from "../../../Materials/Textures/textureHelper.functions.js";
+import { FrameGraphTask } from "../../frameGraphTask.js";
+import { FrameGraphPostProcessTask } from "../PostProcesses/postProcessTask.js";
+/**
+ * Task which computes the minimum and maximum values in the red channel of a frame graph texture,
+ * or in the depth aspect of a WebGPU depth/stencil attachment.
+ * Set sourceTexture to a handle from an earlier task (for example, a geometry renderer's geometryNormViewDepthTexture)
+ * to reuse its output without rendering another depth map. The reduction is performed on each graph execution.
+ */
+export class FrameGraphMinMaxReducerTask extends FrameGraphTask {
+    /**
+     * Wait for WebGPU texture readback before notifying observers (default: false).
+     * This delays the notification; it does not block graph execution.
+     */
+    get waitForReadback() {
+        return this._reducer.waitForReadback;
+    }
+    set waitForReadback(value) {
+        this._reducer.waitForReadback = value;
+    }
+    /**
+     * Observable triggered after the reduced texture has been read back.
+     * With depthRedux enabled, an empty or equal-valued depth range falls back to [0, 1].
+     */
+    get onAfterReductionPerformed() {
+        return this._reducer.onAfterReductionPerformed;
+    }
+    /**
+     * Creates a min/max reduction task.
+     * @param name The name of the task.
+     * @param frameGraph The frame graph to add the task to.
+     */
+    constructor(name, frameGraph) {
+        super(name, frameGraph);
+        /**
+         * Whether to ignore the clear value of a depth-as-color texture during reduction (default: false).
+         * For normalized view or forward screen depth, the clear value is 1; for view depth or reverse screen depth, it is 0.
+         * Always enabled for a depth/stencil attachment, which stores screen depth.
+         */
+        this.depthRedux = false;
+        /**
+         * The type of depth values stored in the source texture when depthRedux is true (default: normalized view depth).
+         */
+        this.depthTextureType = 0 /* DepthTextureType.NormalizedViewDepth */;
+        /**
+         * The type of the intermediate and output textures (default: half float).
+         * Supported types are FLOAT, HALF_FLOAT, and UNSIGNED_BYTE.
+         */
+        this.textureType = 2;
+        this._stepCount = 0;
+        this._reducer = new ThinMinMaxReducer(frameGraph.scene, false);
+        this.outputTexture = frameGraph.textureManager.createDanglingHandle();
+    }
+    getClassName() {
+        return "FrameGraphMinMaxReducerTask";
+    }
+    isReady() {
+        for (let i = 0; i < this._stepCount; i++) {
+            if (!this._reducer.reductionSteps[i].isReady()) {
+                return false;
+            }
+        }
+        return true;
+    }
+    record() {
+        if (this.sourceTexture === undefined) {
+            throw new Error(`FrameGraphMinMaxReducerTask ${this.name}: sourceTexture is required`);
+        }
+        const description = this._frameGraph.textureManager.getTextureDescription(this.sourceTexture);
+        const { width, height } = description.size;
+        if (!Number.isInteger(width) || !Number.isInteger(height) || width < 1 || height < 1) {
+            throw new Error(`FrameGraphMinMaxReducerTask ${this.name}: sourceTexture must have positive integer dimensions`);
+        }
+        if ((description.options.targetTypes?.[0] ?? 3553) !== 3553) {
+            throw new Error(`FrameGraphMinMaxReducerTask ${this.name}: sourceTexture must be a 2D texture`);
+        }
+        const format = description.options.formats?.[0];
+        const sourceIsDepthTexture = format !== undefined && IsDepthTexture(format);
+        if (sourceIsDepthTexture) {
+            if (!this._frameGraph.engine.isWebGPU) {
+                throw new Error(`FrameGraphMinMaxReducerTask ${this.name}: depth/stencil sources require WebGPU`);
+            }
+            if (this._frameGraph.textureManager.isBackbufferDepthStencil(this.sourceTexture)) {
+                throw new Error(`FrameGraphMinMaxReducerTask ${this.name}: backbuffer depth cannot be sampled`);
+            }
+            if (format !== 15 &&
+                format !== 16 &&
+                format !== 13 &&
+                format !== 14 &&
+                format !== 18) {
+                throw new Error(`FrameGraphMinMaxReducerTask ${this.name}: sourceTexture must have a supported depth aspect`);
+            }
+            const samples = description.options.samples;
+            if (samples !== undefined && samples !== 0 && samples !== 1) {
+                throw new Error(`FrameGraphMinMaxReducerTask ${this.name}: depth/stencil sources must be single-sampled`);
+            }
+        }
+        else if (format !== undefined && IsIntegerTextureFormat(format)) {
+            throw new Error(`FrameGraphMinMaxReducerTask ${this.name}: sourceTexture must have a non-integer color format`);
+        }
+        if (this.textureType !== 1 && this.textureType !== 2 && this.textureType !== 0) {
+            throw new Error(`FrameGraphMinMaxReducerTask ${this.name}: textureType must be FLOAT, HALF_FLOAT, or UNSIGNED_BYTE`);
+        }
+        const depthRedux = this.depthRedux || sourceIsDepthTexture;
+        this._reducer.depthRedux = depthRedux;
+        const sourceDepthTextureType = sourceIsDepthTexture ? 2 /* DepthTextureType.ScreenDepth */ : this.depthTextureType;
+        const depthTextureType = depthRedux && sourceDepthTextureType === 2 /* DepthTextureType.ScreenDepth */ && this._frameGraph.engine.useReverseDepthBuffer
+            ? 1 /* DepthTextureType.ViewDepth */
+            : sourceDepthTextureType;
+        this._reducer.setTextureDimensions(width, height, depthTextureType, sourceIsDepthTexture);
+        const steps = this._reducer.reductionSteps;
+        const stepCount = Math.max(1, steps.length - 1);
+        this._stepCount = stepCount;
+        let sourceTexture = this.sourceTexture;
+        for (let i = 0; i < stepCount; i++) {
+            const step = steps[i];
+            const nextStep = steps[i + 1];
+            const targetTexture = this._frameGraph.textureManager.createRenderTargetTexture(`${this.name} ${step.name}`, {
+                size: { width: nextStep?.textureWidth ?? 1, height: nextStep?.textureHeight ?? 1 },
+                sizeIsPercentage: false,
+                options: {
+                    createMipMaps: false,
+                    samples: 1,
+                    types: [this.textureType],
+                    formats: [7],
+                    useSRGBBuffers: [false],
+                },
+            });
+            const pass = new FrameGraphPostProcessTask(`${this.name} ${step.name}`, this._frameGraph, step);
+            pass.sourceTexture = sourceTexture;
+            pass.sourceSamplingMode = 1;
+            pass.targetTexture = targetTexture;
+            pass.record(true);
+            sourceTexture = pass.outputTexture;
+        }
+        this._frameGraph.textureManager.resolveDanglingHandle(this.outputTexture, sourceTexture);
+        const readPass = this._frameGraph.addPass(`${this.name} Read min/max`);
+        readPass.setExecuteFunc((context) => {
+            if (!this._reducer.onAfterReductionPerformed.hasObservers()) {
+                return;
+            }
+            const texture = context.getTextureFromHandle(this.outputTexture);
+            if (!texture) {
+                throw new Error(`FrameGraphMinMaxReducerTask ${this.name}: output texture is unavailable`);
+            }
+            this._reducer.readMinMax(texture, depthRedux);
+        });
+        const passDisabled = this._frameGraph.addRenderPass(`${this.name}_disabled`, true);
+        passDisabled.setRenderTarget(this.outputTexture);
+        passDisabled.setExecuteFunc(() => { });
+    }
+    dispose() {
+        this._reducer.dispose();
+        super.dispose();
+    }
+}
+//# sourceMappingURL=minMaxReducerTask.js.map

package/FrameGraph/Tasks/Misc/minMaxReducerTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"minMaxReducerTask.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FrameGraph/Tasks/Misc/minMaxReducerTask.ts"],"names":[],"mappings":"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","sourcesContent":["import { type FrameGraph, type FrameGraphTextureHandle } from \"core/index\";\r\nimport { Constants } from \"core/Engines/constants\";\r\nimport { DepthTextureType, ThinMinMaxReducer } from \"core/Misc/thinMinMaxReducer\";\r\nimport { IsDepthTexture, IsIntegerTextureFormat } from \"core/Materials/Textures/textureHelper.functions\";\r\nimport { FrameGraphTask } from \"../../frameGraphTask\";\r\nimport { FrameGraphPostProcessTask } from \"../PostProcesses/postProcessTask\";\r\n\r\n/**\r\n * Task which computes the minimum and maximum values in the red channel of a frame graph texture,\r\n * or in the depth aspect of a WebGPU depth/stencil attachment.\r\n * Set sourceTexture to a handle from an earlier task (for example, a geometry renderer's geometryNormViewDepthTexture)\r\n * to reuse its output without rendering another depth map. The reduction is performed on each graph execution.\r\n */\r\nexport class FrameGraphMinMaxReducerTask extends FrameGraphTask {\r\n    /**\r\n     * The 2D texture to reduce. If generated by a graph task, that task must execute before this one.\r\n     * WebGPU can reduce the depth aspect of a single-sampled depth/stencil attachment; backbuffer depth,\r\n     * stencil-only attachments and integer color formats are not supported.\r\n     */\r\n    public sourceTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * Whether to ignore the clear value of a depth-as-color texture during reduction (default: false).\r\n     * For normalized view or forward screen depth, the clear value is 1; for view depth or reverse screen depth, it is 0.\r\n     * Always enabled for a depth/stencil attachment, which stores screen depth.\r\n     */\r\n    public depthRedux = false;\r\n\r\n    /**\r\n     * The type of depth values stored in the source texture when depthRedux is true (default: normalized view depth).\r\n     */\r\n    public depthTextureType = DepthTextureType.NormalizedViewDepth;\r\n\r\n    /**\r\n     * The type of the intermediate and output textures (default: half float).\r\n     * Supported types are FLOAT, HALF_FLOAT, and UNSIGNED_BYTE.\r\n     */\r\n    public textureType = Constants.TEXTURETYPE_HALF_FLOAT;\r\n\r\n    /**\r\n     * Wait for WebGPU texture readback before notifying observers (default: false).\r\n     * This delays the notification; it does not block graph execution.\r\n     */\r\n    public get waitForReadback(): boolean {\r\n        return this._reducer.waitForReadback;\r\n    }\r\n\r\n    public set waitForReadback(value: boolean) {\r\n        this._reducer.waitForReadback = value;\r\n    }\r\n\r\n    /**\r\n     * The 1x1 RG texture containing the minimum in red and maximum in green.\r\n     */\r\n    public readonly outputTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * Observable triggered after the reduced texture has been read back.\r\n     * With depthRedux enabled, an empty or equal-valued depth range falls back to [0, 1].\r\n     */\r\n    public get onAfterReductionPerformed() {\r\n        return this._reducer.onAfterReductionPerformed;\r\n    }\r\n\r\n    private readonly _reducer: ThinMinMaxReducer;\r\n    private _stepCount = 0;\r\n\r\n    /**\r\n     * Creates a min/max reduction task.\r\n     * @param name The name of the task.\r\n     * @param frameGraph The frame graph to add the task to.\r\n     */\r\n    constructor(name: string, frameGraph: FrameGraph) {\r\n        super(name, frameGraph);\r\n        this._reducer = new ThinMinMaxReducer(frameGraph.scene, false);\r\n        this.outputTexture = frameGraph.textureManager.createDanglingHandle();\r\n    }\r\n\r\n    public override getClassName(): string {\r\n        return \"FrameGraphMinMaxReducerTask\";\r\n    }\r\n\r\n    public override isReady(): boolean {\r\n        for (let i = 0; i < this._stepCount; i++) {\r\n            if (!this._reducer.reductionSteps[i].isReady()) {\r\n                return false;\r\n            }\r\n        }\r\n        return true;\r\n    }\r\n\r\n    public override record(): void {\r\n        if (this.sourceTexture === undefined) {\r\n            throw new Error(`FrameGraphMinMaxReducerTask ${this.name}: sourceTexture is required`);\r\n        }\r\n\r\n        const description = this._frameGraph.textureManager.getTextureDescription(this.sourceTexture);\r\n        const { width, height } = description.size;\r\n        if (!Number.isInteger(width) || !Number.isInteger(height) || width < 1 || height < 1) {\r\n            throw new Error(`FrameGraphMinMaxReducerTask ${this.name}: sourceTexture must have positive integer dimensions`);\r\n        }\r\n        if ((description.options.targetTypes?.[0] ?? Constants.TEXTURE_2D) !== Constants.TEXTURE_2D) {\r\n            throw new Error(`FrameGraphMinMaxReducerTask ${this.name}: sourceTexture must be a 2D texture`);\r\n        }\r\n        const format = description.options.formats?.[0];\r\n        const sourceIsDepthTexture = format !== undefined && IsDepthTexture(format);\r\n        if (sourceIsDepthTexture) {\r\n            if (!this._frameGraph.engine.isWebGPU) {\r\n                throw new Error(`FrameGraphMinMaxReducerTask ${this.name}: depth/stencil sources require WebGPU`);\r\n            }\r\n            if (this._frameGraph.textureManager.isBackbufferDepthStencil(this.sourceTexture)) {\r\n                throw new Error(`FrameGraphMinMaxReducerTask ${this.name}: backbuffer depth cannot be sampled`);\r\n            }\r\n            if (\r\n                format !== Constants.TEXTUREFORMAT_DEPTH16 &&\r\n                format !== Constants.TEXTUREFORMAT_DEPTH24 &&\r\n                format !== Constants.TEXTUREFORMAT_DEPTH24_STENCIL8 &&\r\n                format !== Constants.TEXTUREFORMAT_DEPTH32_FLOAT &&\r\n                format !== Constants.TEXTUREFORMAT_DEPTH32FLOAT_STENCIL8\r\n            ) {\r\n                throw new Error(`FrameGraphMinMaxReducerTask ${this.name}: sourceTexture must have a supported depth aspect`);\r\n            }\r\n            const samples = description.options.samples;\r\n            if (samples !== undefined && samples !== 0 && samples !== 1) {\r\n                throw new Error(`FrameGraphMinMaxReducerTask ${this.name}: depth/stencil sources must be single-sampled`);\r\n            }\r\n        } else if (format !== undefined && IsIntegerTextureFormat(format)) {\r\n            throw new Error(`FrameGraphMinMaxReducerTask ${this.name}: sourceTexture must have a non-integer color format`);\r\n        }\r\n        if (this.textureType !== Constants.TEXTURETYPE_FLOAT && this.textureType !== Constants.TEXTURETYPE_HALF_FLOAT && this.textureType !== Constants.TEXTURETYPE_UNSIGNED_BYTE) {\r\n            throw new Error(`FrameGraphMinMaxReducerTask ${this.name}: textureType must be FLOAT, HALF_FLOAT, or UNSIGNED_BYTE`);\r\n        }\r\n\r\n        const depthRedux = this.depthRedux || sourceIsDepthTexture;\r\n        this._reducer.depthRedux = depthRedux;\r\n        const sourceDepthTextureType = sourceIsDepthTexture ? DepthTextureType.ScreenDepth : this.depthTextureType;\r\n        const depthTextureType =\r\n            depthRedux && sourceDepthTextureType === DepthTextureType.ScreenDepth && this._frameGraph.engine.useReverseDepthBuffer\r\n                ? DepthTextureType.ViewDepth\r\n                : sourceDepthTextureType;\r\n        this._reducer.setTextureDimensions(width, height, depthTextureType, sourceIsDepthTexture);\r\n\r\n        const steps = this._reducer.reductionSteps;\r\n        const stepCount = Math.max(1, steps.length - 1);\r\n        this._stepCount = stepCount;\r\n        let sourceTexture = this.sourceTexture;\r\n\r\n        for (let i = 0; i < stepCount; i++) {\r\n            const step = steps[i];\r\n            const nextStep = steps[i + 1];\r\n            const targetTexture = this._frameGraph.textureManager.createRenderTargetTexture(`${this.name} ${step.name}`, {\r\n                size: { width: nextStep?.textureWidth ?? 1, height: nextStep?.textureHeight ?? 1 },\r\n                sizeIsPercentage: false,\r\n                options: {\r\n                    createMipMaps: false,\r\n                    samples: 1,\r\n                    types: [this.textureType],\r\n                    formats: [Constants.TEXTUREFORMAT_RG],\r\n                    useSRGBBuffers: [false],\r\n                },\r\n            });\r\n            const pass = new FrameGraphPostProcessTask(`${this.name} ${step.name}`, this._frameGraph, step);\r\n            pass.sourceTexture = sourceTexture;\r\n            pass.sourceSamplingMode = Constants.TEXTURE_NEAREST_NEAREST;\r\n            pass.targetTexture = targetTexture;\r\n            pass.record(true);\r\n\r\n            sourceTexture = pass.outputTexture;\r\n        }\r\n\r\n        this._frameGraph.textureManager.resolveDanglingHandle(this.outputTexture, sourceTexture);\r\n\r\n        const readPass = this._frameGraph.addPass(`${this.name} Read min/max`);\r\n        readPass.setExecuteFunc((context) => {\r\n            if (!this._reducer.onAfterReductionPerformed.hasObservers()) {\r\n                return;\r\n            }\r\n            const texture = context.getTextureFromHandle(this.outputTexture);\r\n            if (!texture) {\r\n                throw new Error(`FrameGraphMinMaxReducerTask ${this.name}: output texture is unavailable`);\r\n            }\r\n            this._reducer.readMinMax(texture, depthRedux);\r\n        });\r\n\r\n        const passDisabled = this._frameGraph.addRenderPass(`${this.name}_disabled`, true);\r\n        passDisabled.setRenderTarget(this.outputTexture);\r\n        passDisabled.setExecuteFunc(() => {});\r\n    }\r\n\r\n    public override dispose(): void {\r\n        this._reducer.dispose();\r\n        super.dispose();\r\n    }\r\n}\r\n"]}

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

@@ -0,0 +1,69 @@
+import { type Camera } from "../../../Cameras/camera.pure.js";
+import { type FrameGraph } from "../../frameGraph.js";
+import { type FrameGraphRenderPass } from "../../Passes/renderPass.js";
+import { type FrameGraphTextureHandle } from "../../frameGraphTypes.js";
+import { type IMeshBlendConfiguration, type MeshBlendDebugMode, MeshBlendDepthType, type MeshBlendQuality, type MeshBlendRadiusDefinitions, ThinMeshBlendingPostProcess } from "../../../PostProcesses/thinMeshBlendingPostProcess.js";
+import { FrameGraphPostProcessTask } from "./postProcessTask.js";
+/**
+ * Frame-graph task which visually blends SceneColor across validated contacts between opaque or alpha-tested meshes.
+ *
+ * This WebGL2 and WebGPU task uses the same effect and configuration as MeshBlendingPostProcess. It does not modify
+ * geometry, collision queries, depth, normals, or shadows. All source and geometry textures must have matching
+ * physical dimensions and sample counts. Transparent rendering is caller-controlled; overlapping transparent
+ * surfaces can make SceneColor inconsistent with the single-layer geometry inputs. On WebGL2, rendering transparent
+ * meshes into the integer tag attachment requires per-target blend parameters.
+ * @see https://playground.babylonjs.com/?version=preview#O05LI8#6
+ */
+export declare class FrameGraphMeshBlendingTask extends FrameGraphPostProcessTask {
+    /**
+     * The packed R8UI mesh-blending tag texture used to locate seams.
+     */
+    meshBlendTagTexture: FrameGraphTextureHandle;
+    /**
+     * The view-depth or screen-depth texture aligned with the packed tag texture.
+     */
+    depthTexture: FrameGraphTextureHandle;
+    /**
+     * Optional linear base-color/albedo geometry texture aligned with SceneColor.
+     *
+     * When omitted, shadow estimation is compiled out.
+     */
+    baseColorTexture?: FrameGraphTextureHandle;
+    /**
+     * Camera used to project radii and reconstruct view-space positions.
+     */
+    camera: Camera;
+    /**
+     * The thin post process containing the shared quality variant and blend configuration.
+     */
+    readonly postProcess: ThinMeshBlendingPostProcess;
+    /** Gets or sets the compile-time mesh-blending quality variant. */
+    get quality(): MeshBlendQuality;
+    set quality(value: MeshBlendQuality);
+    /** Gets the four configurable radius definitions indexed by packed radius class. */
+    get radiusClasses(): MeshBlendRadiusDefinitions;
+    /** Gets or sets the contact-slope narrowing factor. A value of 1 disables narrowing. */
+    get slopeFactor(): number;
+    set slopeFactor(value: number);
+    /** Gets or sets the representation stored in depthTexture. */
+    get depthType(): MeshBlendDepthType;
+    set depthType(value: MeshBlendDepthType);
+    /** Gets or sets the compiled debug visualization. */
+    get debugMode(): MeshBlendDebugMode;
+    set debugMode(value: MeshBlendDebugMode);
+    /**
+     * Constructs a mesh-blending 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. A new one is created when omitted.
+     */
+    constructor(name: string, frameGraph: FrameGraph, thinPostProcess?: ThinMeshBlendingPostProcess);
+    dispose(): void;
+    /**
+     * Applies the same configuration accepted by the classic MeshBlendingPostProcess wrapper.
+     * @param options Values to apply. Omitted values retain their current settings.
+     */
+    configure(options?: IMeshBlendConfiguration): void;
+    getClassName(): string;
+    record(skipCreationOfDisabledPasses?: boolean): FrameGraphRenderPass;
+}

package/FrameGraph/Tasks/PostProcesses/meshBlendingTask.js

@@ -0,0 +1,223 @@
+
+import { MeshBlendDepthType, ThinMeshBlendingPostProcess, _ClaimMeshBlendingEffectWrapper, _IsMeshBlendingEffectWrapperOwned, _ReleaseMeshBlendingEffectWrapper, } from "../../../PostProcesses/thinMeshBlendingPostProcess.js";
+import { FrameGraphPostProcessTask } from "./postProcessTask.js";
+import { _IsMeshBlendingSupported } from "../../../Meshes/meshBlendingTag.js";
+function _Is2DTexture(creationOptions) {
+    return (creationOptions.options.targetTypes?.[0] ?? 3553) === 3553;
+}
+function _GetTextureType(creationOptions) {
+    return creationOptions.options.types?.[0] ?? 0;
+}
+function _GetTextureFormat(creationOptions) {
+    return creationOptions.options.formats?.[0] ?? 5;
+}
+/**
+ * Frame-graph task which visually blends SceneColor across validated contacts between opaque or alpha-tested meshes.
+ *
+ * This WebGL2 and WebGPU task uses the same effect and configuration as MeshBlendingPostProcess. It does not modify
+ * geometry, collision queries, depth, normals, or shadows. All source and geometry textures must have matching
+ * physical dimensions and sample counts. Transparent rendering is caller-controlled; overlapping transparent
+ * surfaces can make SceneColor inconsistent with the single-layer geometry inputs. On WebGL2, rendering transparent
+ * meshes into the integer tag attachment requires per-target blend parameters.
+ * @see https://playground.babylonjs.com/?version=preview#O05LI8#6
+ */
+export class FrameGraphMeshBlendingTask extends FrameGraphPostProcessTask {
+    /** Gets or sets the compile-time mesh-blending quality variant. */
+    get quality() {
+        return this.postProcess.quality;
+    }
+    set quality(value) {
+        this.postProcess.quality = value;
+    }
+    /** Gets the four configurable radius definitions indexed by packed radius class. */
+    get radiusClasses() {
+        return this.postProcess.radiusClasses;
+    }
+    /** Gets or sets the contact-slope narrowing factor. A value of 1 disables narrowing. */
+    get slopeFactor() {
+        return this.postProcess.slopeFactor;
+    }
+    set slopeFactor(value) {
+        this.postProcess.slopeFactor = value;
+    }
+    /** Gets or sets the representation stored in depthTexture. */
+    get depthType() {
+        return this.postProcess.depthType;
+    }
+    set depthType(value) {
+        this.postProcess.depthType = value;
+    }
+    /** Gets or sets the compiled debug visualization. */
+    get debugMode() {
+        return this.postProcess.debugMode;
+    }
+    set debugMode(value) {
+        this.postProcess.debugMode = value;
+    }
+    /**
+     * Constructs a mesh-blending 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. A new one is created when omitted.
+     */
+    constructor(name, frameGraph, thinPostProcess) {
+        if (thinPostProcess && thinPostProcess.options.engine !== frameGraph.engine) {
+            throw new Error(`FrameGraphMeshBlendingTask "${name}": thinPostProcess must use the frame graph engine`);
+        }
+        if (thinPostProcess && _IsMeshBlendingEffectWrapperOwned(thinPostProcess)) {
+            throw new Error(`FrameGraphMeshBlendingTask "${name}": thinPostProcess is already attached to another owner`);
+        }
+        super(name, frameGraph, thinPostProcess || new ThinMeshBlendingPostProcess(name, frameGraph.engine));
+        _ClaimMeshBlendingEffectWrapper(this.postProcess, this);
+        this.sourceSamplingMode = 1;
+    }
+    dispose() {
+        _ReleaseMeshBlendingEffectWrapper(this.postProcess, this);
+        super.dispose();
+    }
+    /**
+     * Applies the same configuration accepted by the classic MeshBlendingPostProcess wrapper.
+     * @param options Values to apply. Omitted values retain their current settings.
+     */
+    configure(options) {
+        this.postProcess.configure(options);
+    }
+    getClassName() {
+        return "FrameGraphMeshBlendingTask";
+    }
+    record(skipCreationOfDisabledPasses = false) {
+        this.sourceSamplingMode = 1;
+        if (this.sourceTexture === undefined || this.meshBlendTagTexture === undefined || this.depthTexture === undefined || this.camera === undefined) {
+            throw new Error(`FrameGraphMeshBlendingTask "${this.name}": sourceTexture, meshBlendTagTexture, depthTexture and camera are required`);
+        }
+        const engine = this._frameGraph.engine;
+        if (!_IsMeshBlendingSupported(engine)) {
+            throw new Error(`FrameGraphMeshBlendingTask "${this.name}": mesh blending requires WebGL2 or WebGPU`);
+        }
+        if (this.depthType !== MeshBlendDepthType.View && this.depthType !== MeshBlendDepthType.Screen) {
+            throw new Error(`FrameGraphMeshBlendingTask "${this.name}": depthType must be View or Screen`);
+        }
+        const meshBlendTagCreationOptions = this._frameGraph.textureManager.getTextureCreationOptions(this.meshBlendTagTexture);
+        const meshBlendTagType = _GetTextureType(meshBlendTagCreationOptions);
+        const meshBlendTagFormat = _GetTextureFormat(meshBlendTagCreationOptions);
+        const meshBlendTagSamples = meshBlendTagCreationOptions.options.samples ?? 1;
+        if (meshBlendTagType !== 0 || meshBlendTagFormat !== 8) {
+            throw new Error(`FrameGraphMeshBlendingTask "${this.name}": meshBlendTagTexture must use TEXTURETYPE_UNSIGNED_BYTE with TEXTUREFORMAT_RED_INTEGER`);
+        }
+        if (!_Is2DTexture(meshBlendTagCreationOptions)) {
+            throw new Error(`FrameGraphMeshBlendingTask "${this.name}": meshBlendTagTexture must be a 2D texture`);
+        }
+        if (meshBlendTagSamples !== 1) {
+            throw new Error(`FrameGraphMeshBlendingTask "${this.name}": meshBlendTagTexture must be single-sampled`);
+        }
+        if (meshBlendTagCreationOptions.options.createMipMaps) {
+            throw new Error(`FrameGraphMeshBlendingTask "${this.name}": meshBlendTagTexture must not use mipmaps`);
+        }
+        const depthCreationOptions = this._frameGraph.textureManager.getTextureCreationOptions(this.depthTexture);
+        const depthType = _GetTextureType(depthCreationOptions);
+        const depthFormat = _GetTextureFormat(depthCreationOptions);
+        const depthSamples = depthCreationOptions.options.samples ?? 1;
+        const validDepthFormat = depthFormat === 6 || depthFormat === 7 || depthFormat === 5;
+        const validDepthType = depthType === 1 ||
+            depthType === 2 ||
+            (this.depthType === MeshBlendDepthType.Screen && depthType === 0);
+        if (!validDepthFormat || !validDepthType) {
+            throw new Error(`FrameGraphMeshBlendingTask "${this.name}": ${this.depthType === MeshBlendDepthType.View ? "view" : "screen"} depthTexture has an incompatible type or format`);
+        }
+        if (!_Is2DTexture(depthCreationOptions)) {
+            throw new Error(`FrameGraphMeshBlendingTask "${this.name}": depthTexture must be a 2D texture`);
+        }
+        if (depthSamples !== 1) {
+            throw new Error(`FrameGraphMeshBlendingTask "${this.name}": depthTexture must be single-sampled`);
+        }
+        if (depthCreationOptions.options.createMipMaps) {
+            throw new Error(`FrameGraphMeshBlendingTask "${this.name}": depthTexture must not use mipmaps`);
+        }
+        let baseColorSamples;
+        if (this.baseColorTexture !== undefined) {
+            const baseColorCreationOptions = this._frameGraph.textureManager.getTextureCreationOptions(this.baseColorTexture);
+            const baseColorType = _GetTextureType(baseColorCreationOptions);
+            const baseColorFormat = _GetTextureFormat(baseColorCreationOptions);
+            baseColorSamples = baseColorCreationOptions.options.samples ?? 1;
+            const validBaseColorFormat = baseColorFormat === 4 || baseColorFormat === 5;
+            const validBaseColorType = baseColorType === 0 || baseColorType === 2 || baseColorType === 1;
+            if (!validBaseColorFormat || !validBaseColorType) {
+                throw new Error(`FrameGraphMeshBlendingTask "${this.name}": baseColorTexture must use a non-integer RGB or RGBA color format`);
+            }
+            if (!_Is2DTexture(baseColorCreationOptions)) {
+                throw new Error(`FrameGraphMeshBlendingTask "${this.name}": baseColorTexture must be a 2D texture`);
+            }
+            if (baseColorCreationOptions.options.createMipMaps) {
+                throw new Error(`FrameGraphMeshBlendingTask "${this.name}": baseColorTexture must not use mipmaps`);
+            }
+        }
+        const sourceCreationOptions = this._frameGraph.textureManager.getTextureCreationOptions(this.sourceTexture);
+        const sourceType = _GetTextureType(sourceCreationOptions);
+        const sourceFormat = _GetTextureFormat(sourceCreationOptions);
+        const sourceSamples = sourceCreationOptions.options.samples ?? 1;
+        const validSourceFormat = sourceFormat === 4 || sourceFormat === 5;
+        const validSourceType = sourceType === 0 || sourceType === 2 || sourceType === 1;
+        if (!validSourceFormat || !validSourceType) {
+            throw new Error(`FrameGraphMeshBlendingTask "${this.name}": sourceTexture must use a non-integer RGB or RGBA color format`);
+        }
+        if (!_Is2DTexture(sourceCreationOptions)) {
+            throw new Error(`FrameGraphMeshBlendingTask "${this.name}": sourceTexture must be a 2D texture`);
+        }
+        if (sourceSamples !== meshBlendTagSamples || sourceSamples !== depthSamples || (baseColorSamples !== undefined && sourceSamples !== baseColorSamples)) {
+            throw new Error(`FrameGraphMeshBlendingTask "${this.name}": sourceTexture, meshBlendTagTexture, depthTexture and baseColorTexture when provided must have matching sample counts`);
+        }
+        const sourceSize = this._frameGraph.textureManager.getTextureDescription(this.sourceTexture).size;
+        const meshBlendTagSize = this._frameGraph.textureManager.getTextureDescription(this.meshBlendTagTexture).size;
+        const depthSize = this._frameGraph.textureManager.getTextureDescription(this.depthTexture).size;
+        const baseColorSize = this.baseColorTexture === undefined ? undefined : this._frameGraph.textureManager.getTextureDescription(this.baseColorTexture).size;
+        if (sourceSize.width !== meshBlendTagSize.width ||
+            sourceSize.height !== meshBlendTagSize.height ||
+            sourceSize.width !== depthSize.width ||
+            sourceSize.height !== depthSize.height ||
+            (baseColorSize !== undefined && (sourceSize.width !== baseColorSize.width || sourceSize.height !== baseColorSize.height))) {
+            throw new Error(`FrameGraphMeshBlendingTask "${this.name}": sourceTexture, meshBlendTagTexture, depthTexture and baseColorTexture when provided must have matching dimensions`);
+        }
+        if (this.targetTexture !== undefined) {
+            const targetCreationOptions = this._frameGraph.textureManager.getTextureCreationOptions(this.targetTexture);
+            const targetType = _GetTextureType(targetCreationOptions);
+            const targetFormat = _GetTextureFormat(targetCreationOptions);
+            const targetSamples = targetCreationOptions.options.samples ?? 1;
+            const validTargetFormat = targetFormat === 4 || targetFormat === 5;
+            const validTargetType = targetType === 0 || targetType === 2 || targetType === 1;
+            if (!validTargetFormat || !validTargetType) {
+                throw new Error(`FrameGraphMeshBlendingTask "${this.name}": targetTexture must use a non-integer RGB or RGBA color format`);
+            }
+            if (!_Is2DTexture(targetCreationOptions)) {
+                throw new Error(`FrameGraphMeshBlendingTask "${this.name}": targetTexture must be a 2D texture`);
+            }
+            if (targetSamples !== sourceSamples) {
+                throw new Error(`FrameGraphMeshBlendingTask "${this.name}": targetTexture and sourceTexture must have matching sample counts`);
+            }
+            const targetSize = this._frameGraph.textureManager.getTextureDescription(this.targetTexture).size;
+            if (targetSize.width !== sourceSize.width || targetSize.height !== sourceSize.height) {
+                throw new Error(`FrameGraphMeshBlendingTask "${this.name}": targetTexture and sourceTexture must have matching dimensions`);
+            }
+        }
+        this.postProcess.camera = this.camera;
+        this.postProcess.hasBaseColorTexture = this.baseColorTexture !== undefined;
+        const pass = super.record(skipCreationOfDisabledPasses, (context) => {
+            context.setTextureSamplingMode(this.meshBlendTagTexture, 1);
+            context.setTextureSamplingMode(this.depthTexture, 1);
+            if (this.baseColorTexture !== undefined) {
+                context.setTextureSamplingMode(this.baseColorTexture, 1);
+            }
+        }, (context) => {
+            context.bindTextureHandle(this._postProcessDrawWrapper.effect, "meshBlendTagSampler", this.meshBlendTagTexture);
+            context.bindTextureHandle(this._postProcessDrawWrapper.effect, "meshBlendDepthSampler", this.depthTexture);
+            if (this.baseColorTexture !== undefined) {
+                context.bindTextureHandle(this._postProcessDrawWrapper.effect, "meshBlendBaseColorSampler", this.baseColorTexture);
+            }
+        });
+        pass.addDependencies([this.meshBlendTagTexture, this.depthTexture]);
+        if (this.baseColorTexture !== undefined) {
+            pass.addDependencies(this.baseColorTexture);
+        }
+        return pass;
+    }
+}
+//# sourceMappingURL=meshBlendingTask.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meshBlendingTask.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FrameGraph/Tasks/PostProcesses/meshBlendingTask.ts"],"names":[],"mappings":"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","sourcesContent":["import { Constants } from \"../../../Engines/constants\";\r\nimport { type Camera } from \"../../../Cameras/camera.pure\";\r\nimport { type FrameGraph } from \"../../frameGraph\";\r\nimport { type FrameGraphRenderPass } from \"../../Passes/renderPass\";\r\nimport { type FrameGraphTextureCreationOptions, type FrameGraphTextureHandle } from \"../../frameGraphTypes\";\r\nimport {\r\n    type IMeshBlendConfiguration,\r\n    type MeshBlendDebugMode,\r\n    MeshBlendDepthType,\r\n    type MeshBlendQuality,\r\n    type MeshBlendRadiusDefinitions,\r\n    ThinMeshBlendingPostProcess,\r\n    _ClaimMeshBlendingEffectWrapper,\r\n    _IsMeshBlendingEffectWrapperOwned,\r\n    _ReleaseMeshBlendingEffectWrapper,\r\n} from \"../../../PostProcesses/thinMeshBlendingPostProcess\";\r\nimport { FrameGraphPostProcessTask } from \"./postProcessTask\";\r\nimport { _IsMeshBlendingSupported } from \"../../../Meshes/meshBlendingTag\";\r\n\r\nfunction _Is2DTexture(creationOptions: FrameGraphTextureCreationOptions): boolean {\r\n    return (creationOptions.options.targetTypes?.[0] ?? Constants.TEXTURE_2D) === Constants.TEXTURE_2D;\r\n}\r\n\r\nfunction _GetTextureType(creationOptions: FrameGraphTextureCreationOptions): number {\r\n    return creationOptions.options.types?.[0] ?? Constants.TEXTURETYPE_UNSIGNED_BYTE;\r\n}\r\n\r\nfunction _GetTextureFormat(creationOptions: FrameGraphTextureCreationOptions): number {\r\n    return creationOptions.options.formats?.[0] ?? Constants.TEXTUREFORMAT_RGBA;\r\n}\r\n\r\n/**\r\n * Frame-graph task which visually blends SceneColor across validated contacts between opaque or alpha-tested meshes.\r\n *\r\n * This WebGL2 and WebGPU task uses the same effect and configuration as MeshBlendingPostProcess. It does not modify\r\n * geometry, collision queries, depth, normals, or shadows. All source and geometry textures must have matching\r\n * physical dimensions and sample counts. Transparent rendering is caller-controlled; overlapping transparent\r\n * surfaces can make SceneColor inconsistent with the single-layer geometry inputs. On WebGL2, rendering transparent\r\n * meshes into the integer tag attachment requires per-target blend parameters.\r\n * @see https://playground.babylonjs.com/?version=preview#O05LI8#6\r\n */\r\nexport class FrameGraphMeshBlendingTask extends FrameGraphPostProcessTask {\r\n    /**\r\n     * The packed R8UI mesh-blending tag texture used to locate seams.\r\n     */\r\n    public meshBlendTagTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * The view-depth or screen-depth texture aligned with the packed tag texture.\r\n     */\r\n    public depthTexture: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * Optional linear base-color/albedo geometry texture aligned with SceneColor.\r\n     *\r\n     * When omitted, shadow estimation is compiled out.\r\n     */\r\n    public baseColorTexture?: FrameGraphTextureHandle;\r\n\r\n    /**\r\n     * Camera used to project radii and reconstruct view-space positions.\r\n     */\r\n    public camera: Camera;\r\n\r\n    /**\r\n     * The thin post process containing the shared quality variant and blend configuration.\r\n     */\r\n    public override readonly postProcess: ThinMeshBlendingPostProcess;\r\n\r\n    /** Gets or sets the compile-time mesh-blending quality variant. */\r\n    public get quality(): MeshBlendQuality {\r\n        return this.postProcess.quality;\r\n    }\r\n\r\n    public set quality(value: MeshBlendQuality) {\r\n        this.postProcess.quality = value;\r\n    }\r\n\r\n    /** Gets the four configurable radius definitions indexed by packed radius class. */\r\n    public get radiusClasses(): MeshBlendRadiusDefinitions {\r\n        return this.postProcess.radiusClasses;\r\n    }\r\n\r\n    /** Gets or sets the contact-slope narrowing factor. A value of 1 disables narrowing. */\r\n    public get slopeFactor(): number {\r\n        return this.postProcess.slopeFactor;\r\n    }\r\n\r\n    public set slopeFactor(value: number) {\r\n        this.postProcess.slopeFactor = value;\r\n    }\r\n\r\n    /** Gets or sets the representation stored in depthTexture. */\r\n    public get depthType(): MeshBlendDepthType {\r\n        return this.postProcess.depthType;\r\n    }\r\n\r\n    public set depthType(value: MeshBlendDepthType) {\r\n        this.postProcess.depthType = value;\r\n    }\r\n\r\n    /** Gets or sets the compiled debug visualization. */\r\n    public get debugMode(): MeshBlendDebugMode {\r\n        return this.postProcess.debugMode;\r\n    }\r\n\r\n    public set debugMode(value: MeshBlendDebugMode) {\r\n        this.postProcess.debugMode = value;\r\n    }\r\n\r\n    /**\r\n     * Constructs a mesh-blending 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. A new one is created when omitted.\r\n     */\r\n    constructor(name: string, frameGraph: FrameGraph, thinPostProcess?: ThinMeshBlendingPostProcess) {\r\n        if (thinPostProcess && thinPostProcess.options.engine !== frameGraph.engine) {\r\n            throw new Error(`FrameGraphMeshBlendingTask \"${name}\": thinPostProcess must use the frame graph engine`);\r\n        }\r\n        if (thinPostProcess && _IsMeshBlendingEffectWrapperOwned(thinPostProcess)) {\r\n            throw new Error(`FrameGraphMeshBlendingTask \"${name}\": thinPostProcess is already attached to another owner`);\r\n        }\r\n        super(name, frameGraph, thinPostProcess || new ThinMeshBlendingPostProcess(name, frameGraph.engine));\r\n        _ClaimMeshBlendingEffectWrapper(this.postProcess, this);\r\n        this.sourceSamplingMode = Constants.TEXTURE_NEAREST_SAMPLINGMODE;\r\n    }\r\n\r\n    public override dispose(): void {\r\n        _ReleaseMeshBlendingEffectWrapper(this.postProcess, this);\r\n        super.dispose();\r\n    }\r\n\r\n    /**\r\n     * Applies the same configuration accepted by the classic MeshBlendingPostProcess wrapper.\r\n     * @param options Values to apply. Omitted values retain their current settings.\r\n     */\r\n    public configure(options?: IMeshBlendConfiguration): void {\r\n        this.postProcess.configure(options);\r\n    }\r\n\r\n    public override getClassName(): string {\r\n        return \"FrameGraphMeshBlendingTask\";\r\n    }\r\n\r\n    public override record(skipCreationOfDisabledPasses = false): FrameGraphRenderPass {\r\n        this.sourceSamplingMode = Constants.TEXTURE_NEAREST_SAMPLINGMODE;\r\n\r\n        if (this.sourceTexture === undefined || this.meshBlendTagTexture === undefined || this.depthTexture === undefined || this.camera === undefined) {\r\n            throw new Error(`FrameGraphMeshBlendingTask \"${this.name}\": sourceTexture, meshBlendTagTexture, depthTexture and camera are required`);\r\n        }\r\n\r\n        const engine = this._frameGraph.engine;\r\n        if (!_IsMeshBlendingSupported(engine)) {\r\n            throw new Error(`FrameGraphMeshBlendingTask \"${this.name}\": mesh blending requires WebGL2 or WebGPU`);\r\n        }\r\n        if (this.depthType !== MeshBlendDepthType.View && this.depthType !== MeshBlendDepthType.Screen) {\r\n            throw new Error(`FrameGraphMeshBlendingTask \"${this.name}\": depthType must be View or Screen`);\r\n        }\r\n\r\n        const meshBlendTagCreationOptions = this._frameGraph.textureManager.getTextureCreationOptions(this.meshBlendTagTexture);\r\n        const meshBlendTagType = _GetTextureType(meshBlendTagCreationOptions);\r\n        const meshBlendTagFormat = _GetTextureFormat(meshBlendTagCreationOptions);\r\n        const meshBlendTagSamples = meshBlendTagCreationOptions.options.samples ?? 1;\r\n\r\n        if (meshBlendTagType !== Constants.TEXTURETYPE_UNSIGNED_BYTE || meshBlendTagFormat !== Constants.TEXTUREFORMAT_RED_INTEGER) {\r\n            throw new Error(`FrameGraphMeshBlendingTask \"${this.name}\": meshBlendTagTexture must use TEXTURETYPE_UNSIGNED_BYTE with TEXTUREFORMAT_RED_INTEGER`);\r\n        }\r\n        if (!_Is2DTexture(meshBlendTagCreationOptions)) {\r\n            throw new Error(`FrameGraphMeshBlendingTask \"${this.name}\": meshBlendTagTexture must be a 2D texture`);\r\n        }\r\n        if (meshBlendTagSamples !== 1) {\r\n            throw new Error(`FrameGraphMeshBlendingTask \"${this.name}\": meshBlendTagTexture must be single-sampled`);\r\n        }\r\n        if (meshBlendTagCreationOptions.options.createMipMaps) {\r\n            throw new Error(`FrameGraphMeshBlendingTask \"${this.name}\": meshBlendTagTexture must not use mipmaps`);\r\n        }\r\n\r\n        const depthCreationOptions = this._frameGraph.textureManager.getTextureCreationOptions(this.depthTexture);\r\n        const depthType = _GetTextureType(depthCreationOptions);\r\n        const depthFormat = _GetTextureFormat(depthCreationOptions);\r\n        const depthSamples = depthCreationOptions.options.samples ?? 1;\r\n        const validDepthFormat = depthFormat === Constants.TEXTUREFORMAT_RED || depthFormat === Constants.TEXTUREFORMAT_RG || depthFormat === Constants.TEXTUREFORMAT_RGBA;\r\n        const validDepthType =\r\n            depthType === Constants.TEXTURETYPE_FLOAT ||\r\n            depthType === Constants.TEXTURETYPE_HALF_FLOAT ||\r\n            (this.depthType === MeshBlendDepthType.Screen && depthType === Constants.TEXTURETYPE_UNSIGNED_BYTE);\r\n\r\n        if (!validDepthFormat || !validDepthType) {\r\n            throw new Error(\r\n                `FrameGraphMeshBlendingTask \"${this.name}\": ${this.depthType === MeshBlendDepthType.View ? \"view\" : \"screen\"} depthTexture has an incompatible type or format`\r\n            );\r\n        }\r\n        if (!_Is2DTexture(depthCreationOptions)) {\r\n            throw new Error(`FrameGraphMeshBlendingTask \"${this.name}\": depthTexture must be a 2D texture`);\r\n        }\r\n        if (depthSamples !== 1) {\r\n            throw new Error(`FrameGraphMeshBlendingTask \"${this.name}\": depthTexture must be single-sampled`);\r\n        }\r\n        if (depthCreationOptions.options.createMipMaps) {\r\n            throw new Error(`FrameGraphMeshBlendingTask \"${this.name}\": depthTexture must not use mipmaps`);\r\n        }\r\n\r\n        let baseColorSamples: number | undefined;\r\n        if (this.baseColorTexture !== undefined) {\r\n            const baseColorCreationOptions = this._frameGraph.textureManager.getTextureCreationOptions(this.baseColorTexture);\r\n            const baseColorType = _GetTextureType(baseColorCreationOptions);\r\n            const baseColorFormat = _GetTextureFormat(baseColorCreationOptions);\r\n            baseColorSamples = baseColorCreationOptions.options.samples ?? 1;\r\n            const validBaseColorFormat = baseColorFormat === Constants.TEXTUREFORMAT_RGB || baseColorFormat === Constants.TEXTUREFORMAT_RGBA;\r\n            const validBaseColorType =\r\n                baseColorType === Constants.TEXTURETYPE_UNSIGNED_BYTE || baseColorType === Constants.TEXTURETYPE_HALF_FLOAT || baseColorType === Constants.TEXTURETYPE_FLOAT;\r\n            if (!validBaseColorFormat || !validBaseColorType) {\r\n                throw new Error(`FrameGraphMeshBlendingTask \"${this.name}\": baseColorTexture must use a non-integer RGB or RGBA color format`);\r\n            }\r\n            if (!_Is2DTexture(baseColorCreationOptions)) {\r\n                throw new Error(`FrameGraphMeshBlendingTask \"${this.name}\": baseColorTexture must be a 2D texture`);\r\n            }\r\n            if (baseColorCreationOptions.options.createMipMaps) {\r\n                throw new Error(`FrameGraphMeshBlendingTask \"${this.name}\": baseColorTexture must not use mipmaps`);\r\n            }\r\n        }\r\n\r\n        const sourceCreationOptions = this._frameGraph.textureManager.getTextureCreationOptions(this.sourceTexture);\r\n        const sourceType = _GetTextureType(sourceCreationOptions);\r\n        const sourceFormat = _GetTextureFormat(sourceCreationOptions);\r\n        const sourceSamples = sourceCreationOptions.options.samples ?? 1;\r\n        const validSourceFormat = sourceFormat === Constants.TEXTUREFORMAT_RGB || sourceFormat === Constants.TEXTUREFORMAT_RGBA;\r\n        const validSourceType = sourceType === Constants.TEXTURETYPE_UNSIGNED_BYTE || sourceType === Constants.TEXTURETYPE_HALF_FLOAT || sourceType === Constants.TEXTURETYPE_FLOAT;\r\n        if (!validSourceFormat || !validSourceType) {\r\n            throw new Error(`FrameGraphMeshBlendingTask \"${this.name}\": sourceTexture must use a non-integer RGB or RGBA color format`);\r\n        }\r\n        if (!_Is2DTexture(sourceCreationOptions)) {\r\n            throw new Error(`FrameGraphMeshBlendingTask \"${this.name}\": sourceTexture must be a 2D texture`);\r\n        }\r\n        if (sourceSamples !== meshBlendTagSamples || sourceSamples !== depthSamples || (baseColorSamples !== undefined && sourceSamples !== baseColorSamples)) {\r\n            throw new Error(\r\n                `FrameGraphMeshBlendingTask \"${this.name}\": sourceTexture, meshBlendTagTexture, depthTexture and baseColorTexture when provided must have matching sample counts`\r\n            );\r\n        }\r\n\r\n        const sourceSize = this._frameGraph.textureManager.getTextureDescription(this.sourceTexture).size;\r\n        const meshBlendTagSize = this._frameGraph.textureManager.getTextureDescription(this.meshBlendTagTexture).size;\r\n        const depthSize = this._frameGraph.textureManager.getTextureDescription(this.depthTexture).size;\r\n        const baseColorSize = this.baseColorTexture === undefined ? undefined : this._frameGraph.textureManager.getTextureDescription(this.baseColorTexture).size;\r\n        if (\r\n            sourceSize.width !== meshBlendTagSize.width ||\r\n            sourceSize.height !== meshBlendTagSize.height ||\r\n            sourceSize.width !== depthSize.width ||\r\n            sourceSize.height !== depthSize.height ||\r\n            (baseColorSize !== undefined && (sourceSize.width !== baseColorSize.width || sourceSize.height !== baseColorSize.height))\r\n        ) {\r\n            throw new Error(\r\n                `FrameGraphMeshBlendingTask \"${this.name}\": sourceTexture, meshBlendTagTexture, depthTexture and baseColorTexture when provided must have matching dimensions`\r\n            );\r\n        }\r\n\r\n        if (this.targetTexture !== undefined) {\r\n            const targetCreationOptions = this._frameGraph.textureManager.getTextureCreationOptions(this.targetTexture);\r\n            const targetType = _GetTextureType(targetCreationOptions);\r\n            const targetFormat = _GetTextureFormat(targetCreationOptions);\r\n            const targetSamples = targetCreationOptions.options.samples ?? 1;\r\n            const validTargetFormat = targetFormat === Constants.TEXTUREFORMAT_RGB || targetFormat === Constants.TEXTUREFORMAT_RGBA;\r\n            const validTargetType =\r\n                targetType === Constants.TEXTURETYPE_UNSIGNED_BYTE || targetType === Constants.TEXTURETYPE_HALF_FLOAT || targetType === Constants.TEXTURETYPE_FLOAT;\r\n            if (!validTargetFormat || !validTargetType) {\r\n                throw new Error(`FrameGraphMeshBlendingTask \"${this.name}\": targetTexture must use a non-integer RGB or RGBA color format`);\r\n            }\r\n            if (!_Is2DTexture(targetCreationOptions)) {\r\n                throw new Error(`FrameGraphMeshBlendingTask \"${this.name}\": targetTexture must be a 2D texture`);\r\n            }\r\n            if (targetSamples !== sourceSamples) {\r\n                throw new Error(`FrameGraphMeshBlendingTask \"${this.name}\": targetTexture and sourceTexture must have matching sample counts`);\r\n            }\r\n\r\n            const targetSize = this._frameGraph.textureManager.getTextureDescription(this.targetTexture).size;\r\n            if (targetSize.width !== sourceSize.width || targetSize.height !== sourceSize.height) {\r\n                throw new Error(`FrameGraphMeshBlendingTask \"${this.name}\": targetTexture and sourceTexture must have matching dimensions`);\r\n            }\r\n        }\r\n\r\n        this.postProcess.camera = this.camera;\r\n        this.postProcess.hasBaseColorTexture = this.baseColorTexture !== undefined;\r\n\r\n        const pass = super.record(\r\n            skipCreationOfDisabledPasses,\r\n            (context) => {\r\n                context.setTextureSamplingMode(this.meshBlendTagTexture, Constants.TEXTURE_NEAREST_SAMPLINGMODE);\r\n                context.setTextureSamplingMode(this.depthTexture, Constants.TEXTURE_NEAREST_SAMPLINGMODE);\r\n                if (this.baseColorTexture !== undefined) {\r\n                    context.setTextureSamplingMode(this.baseColorTexture, Constants.TEXTURE_NEAREST_SAMPLINGMODE);\r\n                }\r\n            },\r\n            (context) => {\r\n                context.bindTextureHandle(this._postProcessDrawWrapper.effect!, \"meshBlendTagSampler\", this.meshBlendTagTexture);\r\n                context.bindTextureHandle(this._postProcessDrawWrapper.effect!, \"meshBlendDepthSampler\", this.depthTexture);\r\n                if (this.baseColorTexture !== undefined) {\r\n                    context.bindTextureHandle(this._postProcessDrawWrapper.effect!, \"meshBlendBaseColorSampler\", this.baseColorTexture);\r\n                }\r\n            }\r\n        );\r\n\r\n        pass.addDependencies([this.meshBlendTagTexture, this.depthTexture]);\r\n        if (this.baseColorTexture !== undefined) {\r\n            pass.addDependencies(this.baseColorTexture);\r\n        }\r\n\r\n        return pass;\r\n    }\r\n}\r\n"]}