@onerjs/core 8.56.4 → 9.0.0

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"]}

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

@@ -1,4 +1,4 @@
-import { type FrameGraphTextureHandle, type Scene, type FrameGraph, type AbstractMesh, type ObjectRendererOptions, type FrameGraphRenderContext, type FrameGraphRenderPass, type ObjectRenderer } from "../../../index.js";
+import { type FrameGraphTextureHandle, type Scene, type FrameGraph, type AbstractMesh, type ObjectRendererOptions, type FrameGraphRenderContext, type FrameGraphRenderPass, type ObjectRenderer, type GeometryRenderingMeshBlendTagProvider } from "../../../index.js";
 import { type GeometryRenderingObjectIdProvider } from "../../../Materials/materialHelper.geometryrendering.js";
 import { FrameGraphObjectRendererTask } from "./objectRendererTask.js";
 /**
@@ -61,6 +61,7 @@ export declare class FrameGraphGeometryRendererTask extends FrameGraphObjectRend
      */
     textureDescriptions: IFrameGraphGeometryRendererTextureDescription[];
     private _objectIdProvider?;
+    private _meshBlendTagProvider?;
     /**
      * Provides the object ID written for each rendered mesh.
      *
@@ -70,10 +71,20 @@ export declare class FrameGraphGeometryRendererTask extends FrameGraphObjectRend
      * Instances use the ID of their source mesh. Default IDs are only stable for the lifetime of the current scene and should not be persisted.
      * When using a RED texture, provide a custom ID if mesh unique IDs can exceed 0xFF.
      * The provider runs in the render hot path and may be called multiple times for the same mesh in a frame.
-     * @see https://playground.babylonjs.com/#00T6WJ#0
+     * @see https://playground.babylonjs.com/?version=preview#00T6WJ#0
      */
     get objectIdProvider(): GeometryRenderingObjectIdProvider | undefined;
     set objectIdProvider(value: GeometryRenderingObjectIdProvider | undefined);
+    /**
+     * Provides the packed mesh-blending tag written for each rendered mesh.
+     *
+     * Tags must be 0 or contain a group ID between 1 and 63 in their low six bits. Tag 0 disables mesh blending.
+     * By default, meshes use their `meshBlendingTag` property. Instances and thin instances use the source mesh tag.
+     * The provider runs in the render hot path and receives the source mesh for instanced draws.
+     * It should avoid allocations and return a consistent value for a mesh during a render.
+     */
+    get meshBlendTagProvider(): GeometryRenderingMeshBlendTagProvider | undefined;
+    set meshBlendTagProvider(value: GeometryRenderingMeshBlendTagProvider | undefined);
     /**
      * The irradiance output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!
      */
@@ -96,7 +107,8 @@ export declare class FrameGraphGeometryRendererTask extends FrameGraphObjectRend
      */
     readonly geometryViewNormalTexture: FrameGraphTextureHandle;
     /**
-     * The normal (in world space) output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!
+     * The normal (in world space, encoded from [-1, 1] to [0, 1]) output texture.
+     * Will point to a valid texture only if that texture has been requested in textureDescriptions!
      */
     readonly geometryWorldNormalTexture: FrameGraphTextureHandle;
     /**
@@ -117,10 +129,12 @@ export declare class FrameGraphGeometryRendererTask extends FrameGraphObjectRend
     readonly geometryReflectivityTexture: FrameGraphTextureHandle;
     /**
      * The velocity output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!
+     * Built-in CPU/GPU particles write neutral velocity (0.5, 0.5); their motion is not represented.
      */
     readonly geometryVelocityTexture: FrameGraphTextureHandle;
     /**
      * The linear velocity output texture. Will point to a valid texture only if that texture has been requested in textureDescriptions!
+     * Built-in CPU/GPU particles write neutral velocity (0, 0); their motion is not represented.
      */
     readonly geometryLinearVelocityTexture: FrameGraphTextureHandle;
     /**
@@ -129,6 +143,12 @@ export declare class FrameGraphGeometryRendererTask extends FrameGraphObjectRend
      * Decode RED values with `round(value * 255.0)`.
      */
     readonly geometryObjectIdTexture: FrameGraphTextureHandle;
+    /**
+     * The packed, single-sample R8UI mesh-blending tag output texture for WebGL2 and WebGPU.
+     *
+     * Opaque, alpha-tested, and caller-selected transparent meshes are supported.
+     */
+    readonly geometryMeshBlendTagTexture: FrameGraphTextureHandle;
     /**
      * Gets or sets the name of the task.
      */
@@ -136,6 +156,7 @@ export declare class FrameGraphGeometryRendererTask extends FrameGraphObjectRend
     set name(value: string);
     private _clearAttachmentsLayout;
     private _allAttachmentsLayout;
+    private _colorAttachmentsLayout;
     /**
      * Constructs a new geometry renderer task.
      * @param name The name of the task.
@@ -175,6 +196,7 @@ export declare class FrameGraphGeometryRendererTask extends FrameGraphObjectRend
     protected _checkTextureCompatibility(targetTextures: FrameGraphTextureHandle[]): boolean;
     protected _getTargetHandles(): FrameGraphTextureHandle[];
     protected _prepareRendering(context: FrameGraphRenderContext, depthEnabled: boolean): number[];
+    private _getTargetTextureCount;
     private _buildClearAttachmentsLayout;
     private _registerForRenderPassId;
 }

package/FrameGraph/Tasks/Rendering/geometryRendererTask.js

@@ -1,6 +1,7 @@
 import { Color4 } from "../../../Maths/math.color.pure.js";
 import { MaterialHelperGeometryRendering } from "../../../Materials/materialHelper.geometryrendering.js";
 
+import { _IsMeshBlendingSupported } from "../../../Meshes/meshBlendingTag.js";
 import { FrameGraphObjectRendererTask } from "./objectRendererTask.js";
 const ClearColors = [new Color4(0, 0, 0, 0), new Color4(1, 1, 1, 1), new Color4(0, 0, 0, 0)];
 /**
@@ -41,7 +42,7 @@ export class FrameGraphGeometryRendererTask extends FrameGraphObjectRendererTask
      * Instances use the ID of their source mesh. Default IDs are only stable for the lifetime of the current scene and should not be persisted.
      * When using a RED texture, provide a custom ID if mesh unique IDs can exceed 0xFF.
      * The provider runs in the render hot path and may be called multiple times for the same mesh in a frame.
-     * @see https://playground.babylonjs.com/#00T6WJ#0
+     * @see https://playground.babylonjs.com/?version=preview#00T6WJ#0
      */
     get objectIdProvider() {
         return this._objectIdProvider;
@@ -53,6 +54,24 @@ export class FrameGraphGeometryRendererTask extends FrameGraphObjectRendererTask
             configuration.objectIdProvider = value;
         }
     }
+    /**
+     * Provides the packed mesh-blending tag written for each rendered mesh.
+     *
+     * Tags must be 0 or contain a group ID between 1 and 63 in their low six bits. Tag 0 disables mesh blending.
+     * By default, meshes use their `meshBlendingTag` property. Instances and thin instances use the source mesh tag.
+     * The provider runs in the render hot path and receives the source mesh for instanced draws.
+     * It should avoid allocations and return a consistent value for a mesh during a render.
+     */
+    get meshBlendTagProvider() {
+        return this._meshBlendTagProvider;
+    }
+    set meshBlendTagProvider(value) {
+        this._meshBlendTagProvider = value;
+        const configuration = MaterialHelperGeometryRendering.GetConfiguration(this._renderer.renderPassId);
+        if (configuration) {
+            configuration.meshBlendTagProvider = value;
+        }
+    }
     /**
      * Gets or sets the name of the task.
      */
@@ -106,7 +125,7 @@ export class FrameGraphGeometryRendererTask extends FrameGraphObjectRendererTask
             if (this.dontRenderWhenMaterialDepthWriteIsDisabled && mesh.material && mesh.material.disableDepthWrite) {
                 return !!preWarm;
             }
-            return mesh.isReady(refreshRate === 0);
+            return mesh.isReady(!!preWarm || refreshRate === 0);
         };
         this._renderer.onBeforeRenderingManagerRenderObservable.add(() => {
             if (!this._renderer.options.doNotChangeAspectRatio) {
@@ -115,6 +134,7 @@ export class FrameGraphGeometryRendererTask extends FrameGraphObjectRendererTask
         });
         this._clearAttachmentsLayout = new Map();
         this._allAttachmentsLayout = [];
+        this._colorAttachmentsLayout = [];
         this.geometryIrradianceTexture = this._frameGraph.textureManager.createDanglingHandle();
         this.geometryViewDepthTexture = this._frameGraph.textureManager.createDanglingHandle();
         this.geometryNormViewDepthTexture = this._frameGraph.textureManager.createDanglingHandle();
@@ -128,6 +148,7 @@ export class FrameGraphGeometryRendererTask extends FrameGraphObjectRendererTask
         this.geometryVelocityTexture = this._frameGraph.textureManager.createDanglingHandle();
         this.geometryLinearVelocityTexture = this._frameGraph.textureManager.createDanglingHandle();
         this.geometryObjectIdTexture = this._frameGraph.textureManager.createDanglingHandle();
+        this.geometryMeshBlendTagTexture = this._frameGraph.textureManager.createDanglingHandle();
     }
     /**
      * Gets the list of excluded meshes from the velocity texture.
@@ -175,10 +196,11 @@ export class FrameGraphGeometryRendererTask extends FrameGraphObjectRendererTask
         MaterialHelperGeometryRendering.MarkAsDirty(this._renderer.renderPassId, this.objectList.meshes || this._scene.meshes);
         const pass = super.record(skipCreationOfDisabledPasses, additionalExecute);
         const outputTextureHandles = pass.renderTarget;
+        const targetTextureCount = this._getTargetTextureCount();
         let needPreviousWorldMatrices = false;
         for (let i = 0; i < this.textureDescriptions.length; i++) {
             const description = this.textureDescriptions[i];
-            const handle = outputTextureHandles[i];
+            const handle = outputTextureHandles[targetTextureCount + i];
             const index = MaterialHelperGeometryRendering.GeometryTextureDescriptions.findIndex((f) => f.type === description.type);
             const geometryDescription = MaterialHelperGeometryRendering.GeometryTextureDescriptions[index];
             switch (geometryDescription.type) {
@@ -223,6 +245,9 @@ export class FrameGraphGeometryRendererTask extends FrameGraphObjectRendererTask
                 case 15:
                     this._frameGraph.textureManager.resolveDanglingHandle(this.geometryObjectIdTexture, handle);
                     break;
+                case 16:
+                    this._frameGraph.textureManager.resolveDanglingHandle(this.geometryMeshBlendTagTexture, handle);
+                    break;
             }
         }
         this._scene.needsPreviousWorldMatrices = needPreviousWorldMatrices;
@@ -255,6 +280,23 @@ export class FrameGraphGeometryRendererTask extends FrameGraphObjectRendererTask
                 throw new Error(`FrameGraphGeometryRendererTask ${this.name}: object ID textures must use TEXTURETYPE_UNSIGNED_BYTE with TEXTUREFORMAT_RGBA or TEXTUREFORMAT_RED`);
             }
         }
+        const meshBlendTagIndex = this.textureDescriptions.findIndex((description) => description.type === 16);
+        if (meshBlendTagIndex !== -1) {
+            const description = this.textureDescriptions[meshBlendTagIndex];
+            const engine = this._engine;
+            if (!_IsMeshBlendingSupported(engine)) {
+                throw new Error(`FrameGraphGeometryRendererTask ${this.name}: mesh-blending tag textures require WebGL2 or WebGPU`);
+            }
+            if ((this.renderTransparentMeshes || this.renderSprites || this.renderParticles) && !engine.isWebGPU && !engine.getCaps().blendParametersPerTarget) {
+                throw new Error(`FrameGraphGeometryRendererTask ${this.name}: transparent mesh-blending tags require per-target blend parameters`);
+            }
+            if (this.samples !== 1) {
+                throw new Error(`FrameGraphGeometryRendererTask ${this.name}: mesh-blending tag textures require samples to be 1`);
+            }
+            if (description.textureType !== 0 || description.textureFormat !== 8) {
+                throw new Error(`FrameGraphGeometryRendererTask ${this.name}: mesh-blending tag textures must use TEXTURETYPE_UNSIGNED_BYTE with TEXTUREFORMAT_RED_INTEGER`);
+            }
+        }
         const targetTextureCount = this.targetTexture === undefined ? 0 : Array.isArray(this.targetTexture) ? this.targetTexture.length : 1;
         const attachmentCount = this.textureDescriptions.length + targetTextureCount;
         const maxDrawBuffers = Math.min(this._engine.getCaps().maxDrawBuffers ?? 1, 8);
@@ -307,6 +349,14 @@ export class FrameGraphGeometryRendererTask extends FrameGraphObjectRendererTask
             useSRGBBuffers[i] = false;
         }
         const handles = [];
+        if (this.targetTexture !== undefined) {
+            if (Array.isArray(this.targetTexture)) {
+                handles.push(...this.targetTexture);
+            }
+            else {
+                handles.push(this.targetTexture);
+            }
+        }
         if (this.textureDescriptions.length > 0) {
             const baseHandle = this._frameGraph.textureManager.createRenderTargetTexture(this.name, {
                 size: this.size,
@@ -324,14 +374,6 @@ export class FrameGraphGeometryRendererTask extends FrameGraphObjectRendererTask
                 handles.push(baseHandle + i);
             }
         }
-        if (this.targetTexture !== undefined) {
-            if (Array.isArray(this.targetTexture)) {
-                handles.push(...this.targetTexture);
-            }
-            else {
-                handles.push(this.targetTexture);
-            }
-        }
         return handles;
     }
     _prepareRendering(context, depthEnabled) {
@@ -342,11 +384,15 @@ export class FrameGraphGeometryRendererTask extends FrameGraphObjectRendererTask
         });
         context.restoreDefaultFramebuffer();
         context.popDebugGroup();
-        return this._allAttachmentsLayout;
+        return this._colorAttachmentsLayout;
+    }
+    _getTargetTextureCount() {
+        return this.targetTexture === undefined ? 0 : Array.isArray(this.targetTexture) ? this.targetTexture.length : 1;
     }
     _buildClearAttachmentsLayout() {
         const clearAttachmentsLayout = new Map();
-        const allAttachmentsLayout = [];
+        const targetTextureCount = this._getTargetTextureCount();
+        const allAttachmentsLayout = new Array(targetTextureCount).fill(true);
         for (let i = 0; i < this.textureDescriptions.length; i++) {
             const description = this.textureDescriptions[i];
             const index = MaterialHelperGeometryRendering.GeometryTextureDescriptions.findIndex((f) => f.type === description.type);
@@ -358,7 +404,7 @@ export class FrameGraphGeometryRendererTask extends FrameGraphObjectRendererTask
             if (layout === undefined) {
                 layout = [];
                 clearAttachmentsLayout.set(clearType, layout);
-                for (let j = 0; j < i; j++) {
+                for (let j = 0; j < targetTextureCount + i; j++) {
                     layout[j] = false;
                 }
             }
@@ -367,44 +413,34 @@ export class FrameGraphGeometryRendererTask extends FrameGraphObjectRendererTask
             });
             allAttachmentsLayout.push(true);
         }
-        if (this.targetTexture !== undefined) {
-            // We don't clear the target texture, but we need to add a layout for it in clearAttachmentsLayout to be able to use clearColorAttachments with the correct number of attachments in _prepareRendering.
-            // We also need to add a value in allAttachmentsLayout for the target texture.
-            let layout = clearAttachmentsLayout.get(0 /* GeometryRenderingTextureClearType.Zero */);
-            if (layout === undefined) {
-                layout = [];
-                clearAttachmentsLayout.set(0 /* GeometryRenderingTextureClearType.Zero */, layout);
-                for (let j = 0; j < this.textureDescriptions.length - 1; j++) {
-                    layout[j] = false;
-                }
-            }
-            clearAttachmentsLayout.forEach((layout) => {
-                layout.push(false);
-            });
-            allAttachmentsLayout.push(true);
-        }
         this._clearAttachmentsLayout = new Map();
         clearAttachmentsLayout.forEach((layout, clearType) => {
             this._clearAttachmentsLayout.set(clearType, this._engine.buildTextureLayout(layout));
         });
         this._allAttachmentsLayout = this._engine.buildTextureLayout(allAttachmentsLayout);
+        this._colorAttachmentsLayout = this._engine.buildTextureLayout(allAttachmentsLayout.map((_, index) => targetTextureCount > 0 && index === 0));
     }
     _registerForRenderPassId(renderPassId) {
         const configuration = MaterialHelperGeometryRendering.CreateConfiguration(renderPassId);
+        const targetTextureCount = this._getTargetTextureCount();
         for (let i = 0; i < this.textureDescriptions.length; i++) {
             const description = this.textureDescriptions[i];
             const index = MaterialHelperGeometryRendering.GeometryTextureDescriptions.findIndex((f) => f.type === description.type);
             const geometryDescription = MaterialHelperGeometryRendering.GeometryTextureDescriptions[index];
-            configuration.defines[geometryDescription.defineIndex] = i;
+            configuration.defines[geometryDescription.defineIndex] = targetTextureCount + i;
             if (description.type === 15) {
                 configuration.objectIdIsRedFormat = description.textureFormat === 6;
             }
+            else if (description.type === 16) {
+                configuration.meshBlendTagProvider = this.meshBlendTagProvider;
+            }
         }
-        if (this.targetTexture !== undefined) {
-            configuration.defines["PREPASS_COLOR_INDEX"] = this.textureDescriptions.length;
+        if (targetTextureCount > 0) {
+            configuration.defines["PREPASS_COLOR_INDEX"] = 0;
         }
         configuration.reverseCulling = this.reverseCulling;
         configuration.objectIdProvider = this.objectIdProvider;
+        MaterialHelperGeometryRendering._PrepareConfiguration(renderPassId, this._allAttachmentsLayout, this._colorAttachmentsLayout);
     }
 }
 //# sourceMappingURL=geometryRendererTask.js.map