@onerjs/core 8.56.4 → 9.0.1

package/Materials/ditheredTileFadeMaterialPlugin.js

@@ -0,0 +1,509 @@
+import { InstancedMesh, RegisterInstancedMesh } from "../Meshes/instancedMesh.pure.js";
+import { Mesh } from "../Meshes/mesh.pure.js";
+import { RegisterThinInstanceMesh } from "../Meshes/thinInstanceMesh.pure.js";
+import { Vector4 } from "../Maths/math.vector.pure.js";
+import { MaterialPluginBase } from "./materialPluginBase.pure.js";
+import { PBRBaseMaterial } from "./PBR/pbrBaseMaterial.pure.js";
+import { StandardMaterial } from "./standardMaterial.pure.js";
+let GlslShaderLoadPromise;
+let WgslShaderLoadPromise;
+const DepthPrePassInjectionPoint = "!#include<depthPrePass>";
+async function _LoadGlslShaderIncludeAsync() {
+    await import("../Shaders/ShadersInclude/bayerDitherFunctions.js");
+}
+async function _LoadWgslShaderIncludeAsync() {
+    await import("../ShadersWGSL/ShadersInclude/bayerDitherFunctions.js");
+}
+async function _LoadShaderIncludeAsync(shaderLanguage) {
+    if (shaderLanguage === 1 /* ShaderLanguage.WGSL */) {
+        WgslShaderLoadPromise ?? (WgslShaderLoadPromise = _LoadWgslShaderIncludeAsync());
+        await WgslShaderLoadPromise;
+        return;
+    }
+    GlslShaderLoadPromise ?? (GlslShaderLoadPromise = _LoadGlslShaderIncludeAsync());
+    await GlslShaderLoadPromise;
+}
+/**
+ * Applies an opaque, screen-space dithered fade for tile LOD meshes that share a Standard or PBR material.
+ *
+ * The plugin keeps depth writing and the material's alpha mode unchanged. It affects the material color and integrated
+ * prepass outputs, but not standalone depth, shadow, picking, outline, or custom passes. Tile renderers using those passes
+ * must provide equivalent pass-specific coverage or exclude fading tiles from them.
+ *
+ * Per-mesh bounds are runtime state. Material cloning and serialization do not copy them; use {@link copyToMaterial} to
+ * copy the enabled state to a cloned material and then configure bounds for the cloned tile meshes.
+ * @see https://playground.babylonjs.com/#HI17VI#0
+ */
+export class DitheredTileFadeMaterialPlugin extends MaterialPluginBase {
+    /**
+     * Gets whether configured fades are applied. Disabling the plugin makes every mesh fully visible without discarding its stored bounds.
+     */
+    get isEnabled() {
+        return this._isEnabled;
+    }
+    /**
+     * Sets whether configured fades are applied. This uniform-only change does not recompile the material.
+     */
+    set isEnabled(value) {
+        this._isEnabled = value;
+    }
+    /**
+     * Creates and attaches a dithered fade plugin.
+     * @param material The Standard or PBR material that the plugin will extend.
+     * @throws If the material is unsupported or already has a dithered tile fade plugin. Use {@link GetOrCreate} when reuse is intended.
+     */
+    constructor(material) {
+        super(material, DitheredTileFadeMaterialPlugin.Name, 190, undefined, DitheredTileFadeMaterialPlugin._ValidateNewPlugin(material), false, true);
+        this._meshBounds = new WeakMap();
+        this._instancedBufferSources = new WeakSet();
+        this._thinInstanceFadeBuffers = new WeakMap();
+        this._generation = 1;
+        this._isEnabled = true;
+        this._shaderIncludeReady = false;
+        this.registerForExtraEvents = true;
+        this.doNotSerialize = true;
+        void this._loadShaderIncludeAsync(material.shaderLanguage);
+        this._enable(true);
+    }
+    /**
+     * Gets the plugin already attached to a material, or creates and attaches one.
+     * @param material The Standard or PBR material to extend.
+     * @returns The material's dithered fade plugin.
+     * @throws If the material is unsupported or another plugin uses the reserved plugin name.
+     */
+    static GetOrCreate(material) {
+        DitheredTileFadeMaterialPlugin._ValidateMaterial(material);
+        const existing = material.pluginManager?.getPlugin(DitheredTileFadeMaterialPlugin.Name);
+        if (existing) {
+            if (!(existing instanceof DitheredTileFadeMaterialPlugin)) {
+                throw new Error(`The material "${material.name}" already has an incompatible plugin named "${DitheredTileFadeMaterialPlugin.Name}".`);
+            }
+            return existing;
+        }
+        return new DitheredTileFadeMaterialPlugin(material);
+    }
+    /**
+     * Checks whether the plugin supports a shader language.
+     * @param shaderLanguage The shader language to check.
+     * @returns True for GLSL and WGSL.
+     */
+    isCompatible(shaderLanguage) {
+        return shaderLanguage === 0 /* ShaderLanguage.GLSL */ || shaderLanguage === 1 /* ShaderLanguage.WGSL */;
+    }
+    /**
+     * Sets both normalized Bayer interval bounds for a mesh.
+     * @param mesh The tile mesh or hardware instance whose draw calls use the bounds.
+     * @param lowerBound The inclusive lower bound in the range [0, 1].
+     * @param upperBound The exclusive upper bound in the range [0, 1].
+     * @remarks Bounds are independent. A lower bound greater than or equal to the upper bound intentionally produces an empty interval.
+     */
+    setFadeBounds(mesh, lowerBound, upperBound) {
+        this._validateMesh(mesh);
+        this._validateBound(lowerBound, "lowerBound");
+        this._validateBound(upperBound, "upperBound");
+        const bounds = this._meshBounds.get(mesh);
+        if (bounds) {
+            bounds.lowerBound = lowerBound;
+            bounds.upperBound = upperBound;
+        }
+        else {
+            this._meshBounds.set(mesh, { lowerBound, upperBound });
+        }
+        this._updateInstancedFadeBounds(mesh, lowerBound, upperBound, true);
+    }
+    /**
+     * Sets the normalized inclusive lower Bayer interval bound for a mesh.
+     * @param mesh The tile mesh or hardware instance whose draw calls use the bound.
+     * @param lowerBound The inclusive lower bound in the range [0, 1].
+     */
+    setFadeLowerBound(mesh, lowerBound) {
+        this.setFadeBounds(mesh, lowerBound, this._meshBounds.get(mesh)?.upperBound ?? 1);
+    }
+    /**
+     * Sets the normalized exclusive upper Bayer interval bound for a mesh.
+     * @param mesh The tile mesh or hardware instance whose draw calls use the bound.
+     * @param upperBound The exclusive upper bound in the range [0, 1].
+     */
+    setFadeUpperBound(mesh, upperBound) {
+        this.setFadeBounds(mesh, this._meshBounds.get(mesh)?.lowerBound ?? 0, upperBound);
+    }
+    /**
+     * Copies a mesh's current bounds without allocating.
+     * @param mesh The mesh whose bounds are queried.
+     * @param result The object that receives the bounds.
+     * @returns True when the mesh has explicit bounds. Otherwise false is returned with the source mesh's bounds for a hardware instance, or [0, 1].
+     */
+    getFadeBoundsToRef(mesh, result) {
+        this._validateMesh(mesh);
+        const explicitBounds = this._meshBounds.get(mesh);
+        const bounds = explicitBounds ?? (mesh instanceof InstancedMesh ? this._meshBounds.get(mesh.sourceMesh) : undefined);
+        result.lowerBound = bounds?.lowerBound ?? 0;
+        result.upperBound = bounds?.upperBound ?? 1;
+        return explicitBounds !== undefined;
+    }
+    /**
+     * Removes a mesh's explicit bounds. A hardware instance inherits its source mesh's bounds; a source mesh uses [0, 1].
+     * @param mesh The mesh to reset.
+     */
+    resetFade(mesh) {
+        this._validateMesh(mesh);
+        this._meshBounds.delete(mesh);
+        this._updateInstancedFadeBounds(mesh, 0, 1, false);
+    }
+    /**
+     * Sets normalized Bayer interval bounds for one thin instance.
+     * @param mesh The source mesh containing the thin instance.
+     * @param index The thin instance index.
+     * @param lowerBound The inclusive lower bound in the range [0, 1].
+     * @param upperBound The exclusive upper bound in the range [0, 1].
+     * @param refresh Whether to immediately upload the updated attribute buffer.
+     */
+    setThinInstanceFadeBounds(mesh, index, lowerBound, upperBound, refresh = true) {
+        this._validateBound(lowerBound, "lowerBound");
+        this._validateBound(upperBound, "upperBound");
+        this._validateThinInstanceIndex(mesh, index);
+        const buffer = this._ensureThinInstanceBuffer(mesh);
+        const offset = index * 4;
+        buffer[offset] = lowerBound;
+        buffer[offset + 1] = upperBound;
+        buffer[offset + 2] = 1;
+        buffer[offset + 3] = this._generation;
+        if (refresh) {
+            this.commitThinInstanceFadeBounds(mesh);
+        }
+    }
+    /**
+     * Sets normalized Bayer interval bounds for all thin instances from packed lower/upper pairs.
+     * @param mesh The source mesh containing the thin instances.
+     * @param bounds Packed lower/upper pairs, with two values per thin instance.
+     */
+    setThinInstanceFadeBoundsBuffer(mesh, bounds) {
+        RegisterThinInstanceMesh();
+        const instanceCount = mesh.thinInstanceCount;
+        if (bounds.length !== instanceCount * 2) {
+            throw new RangeError(`bounds must contain exactly ${instanceCount * 2} values.`);
+        }
+        for (let index = 0; index < instanceCount; index++) {
+            const lowerBound = bounds[index * 2];
+            const upperBound = bounds[index * 2 + 1];
+            this._validateBound(lowerBound, `bounds[${index * 2}]`);
+            this._validateBound(upperBound, `bounds[${index * 2 + 1}]`);
+        }
+        const attributeData = this._ensureThinInstanceBuffer(mesh);
+        for (let index = 0; index < instanceCount; index++) {
+            const attributeOffset = index * 4;
+            attributeData[attributeOffset] = bounds[index * 2];
+            attributeData[attributeOffset + 1] = bounds[index * 2 + 1];
+            attributeData[attributeOffset + 2] = 1;
+            attributeData[attributeOffset + 3] = this._generation;
+        }
+        this.commitThinInstanceFadeBounds(mesh);
+    }
+    /**
+     * Uploads thin-instance fade changes after one or more setters used `refresh = false`.
+     * @param mesh The source mesh whose fade attribute buffer changed.
+     */
+    commitThinInstanceFadeBounds(mesh) {
+        if (!this._thinInstanceFadeBuffers.has(mesh)) {
+            throw new Error("No thin-instance fade buffer has been created for this mesh.");
+        }
+        mesh.thinInstanceBufferUpdated(this._getInstanceAttributeName());
+    }
+    /**
+     * Removes one thin instance's explicit bounds so it inherits the source mesh's bounds.
+     * @param mesh The source mesh containing the thin instance.
+     * @param index The thin instance index.
+     * @param refresh Whether to immediately upload the updated attribute buffer.
+     */
+    resetThinInstanceFade(mesh, index, refresh = true) {
+        this._validateThinInstanceIndex(mesh, index);
+        const buffer = this._ensureThinInstanceBuffer(mesh);
+        const offset = index * 4;
+        buffer[offset] = 0;
+        buffer[offset + 1] = 1;
+        buffer[offset + 2] = 0;
+        buffer[offset + 3] = this._generation;
+        if (refresh) {
+            this.commitThinInstanceFadeBounds(mesh);
+        }
+    }
+    /**
+     * Removes all explicit mesh bounds while keeping the plugin enabled.
+     */
+    reset() {
+        this._meshBounds = new WeakMap();
+        this._generation++;
+    }
+    /**
+     * Copies material-level configuration to another supported material.
+     *
+     * Per-mesh bounds are intentionally not copied because they belong to the source tile meshes.
+     * @param material The destination material, including a material clone.
+     * @returns The destination material's dithered tile fade plugin.
+     */
+    copyToMaterial(material) {
+        const plugin = DitheredTileFadeMaterialPlugin.GetOrCreate(material);
+        plugin.isEnabled = this._isEnabled;
+        return plugin;
+    }
+    /** @internal */
+    isReadyForSubMesh(_defines, _scene, _engine, _subMesh) {
+        if (this._shaderIncludeError) {
+            throw this._shaderIncludeError;
+        }
+        return this._shaderIncludeReady;
+    }
+    /**
+     * Uploads the current mesh's bounds for every draw, including shared and frozen materials.
+     * @param _uniformBuffer The material uniform buffer.
+     * @param _scene The scene being rendered.
+     * @param _engine The engine being used.
+     * @param subMesh The submesh being bound.
+     */
+    hardBindForSubMesh(_uniformBuffer, _scene, _engine, subMesh) {
+        const effect = subMesh.effect;
+        if (!effect) {
+            return;
+        }
+        const mesh = subMesh.getMesh();
+        const bounds = this._meshBounds.get(mesh);
+        effect.setFloat4("ditheredFadeSettings", bounds?.lowerBound ?? 0, bounds?.upperBound ?? 1, this._isEnabled ? 1 : 0, this._generation);
+    }
+    /**
+     * Registers the per-instance fade attribute when a mesh is rendered as a hardware or thin instance batch.
+     * @param attributes The attributes used to compile the material.
+     * @param _scene The scene containing the mesh.
+     * @param mesh The mesh being compiled.
+     */
+    getAttributes(attributes, _scene, mesh) {
+        const source = mesh instanceof InstancedMesh ? mesh.sourceMesh : mesh;
+        if (!(source instanceof Mesh)) {
+            return;
+        }
+        if (source.instances.length > 0) {
+            this._ensureInstancedBuffer(source);
+        }
+        if (source.hasThinInstances) {
+            this._ensureThinInstanceBuffer(source);
+        }
+        if (source.instances.length > 0 || source.hasThinInstances) {
+            attributes.push(this._getInstanceAttributeName());
+        }
+    }
+    /**
+     * Gets the uniforms used by the plugin.
+     * @returns The external uniform names.
+     */
+    getUniforms() {
+        return {
+            externalUniforms: ["ditheredFadeSettings"],
+        };
+    }
+    /**
+     * Gets the shader code injected by the plugin.
+     * @param shaderType The shader stage being customized.
+     * @param shaderLanguage The material shader language.
+     * @returns Fragment customizations, or null for the vertex stage.
+     */
+    getCustomCode(shaderType, shaderLanguage = 0 /* ShaderLanguage.GLSL */) {
+        if (shaderType !== "fragment") {
+            const instanceAttributeName = this._getInstanceAttributeName();
+            if (shaderType !== "vertex") {
+                return null;
+            }
+            if (shaderLanguage === 1 /* ShaderLanguage.WGSL */) {
+                return {
+                    CUSTOM_VERTEX_DEFINITIONS: `
+#ifdef INSTANCES
+attribute ${instanceAttributeName}: vec4f;
+#endif
+varying vDitheredTileFade: vec4f;
+`,
+                    CUSTOM_VERTEX_MAIN_BEGIN: `
+#ifdef INSTANCES
+vertexOutputs.vDitheredTileFade = input.${instanceAttributeName};
+#else
+vertexOutputs.vDitheredTileFade = vec4f(0.0);
+#endif
+`,
+                };
+            }
+            return {
+                CUSTOM_VERTEX_DEFINITIONS: `
+#ifdef INSTANCES
+attribute vec4 ${instanceAttributeName};
+#endif
+varying vec4 vDitheredTileFade;
+`,
+                CUSTOM_VERTEX_MAIN_BEGIN: `
+#ifdef INSTANCES
+vDitheredTileFade = ${instanceAttributeName};
+#else
+vDitheredTileFade = vec4(0.0);
+#endif
+`,
+            };
+        }
+        if (shaderLanguage === 1 /* ShaderLanguage.WGSL */) {
+            return {
+                CUSTOM_FRAGMENT_DEFINITIONS: `
+#include<bayerDitherFunctions>
+uniform ditheredFadeSettings: vec4f;
+varying vDitheredTileFade: vec4f;
+
+fn shouldDiscardDitheredTileFragment(position: vec2f, materialSettings: vec4f, instanceSettings: vec4f) -> bool {
+    var bounds = materialSettings.xy;
+#ifdef INSTANCES
+    if (instanceSettings.z > 0.5 && instanceSettings.w == materialSettings.w) {
+        bounds = instanceSettings.xy;
+    }
+#endif
+    let ditheredFadeSample = bayerDither8(floor(position)) / 64.0;
+    return materialSettings.z > 0.5 && (ditheredFadeSample < bounds.x || ditheredFadeSample >= bounds.y);
+}
+`,
+                CUSTOM_FRAGMENT_BEFORE_FRAGCOLOR: `
+if (shouldDiscardDitheredTileFragment(fragmentInputs.position.xy, uniforms.ditheredFadeSettings, fragmentInputs.vDitheredTileFade)) {
+    discard;
+}
+`,
+                [DepthPrePassInjectionPoint]: `
+#ifdef DEPTHPREPASS
+if (shouldDiscardDitheredTileFragment(fragmentInputs.position.xy, uniforms.ditheredFadeSettings, fragmentInputs.vDitheredTileFade)) {
+    discard;
+}
+#endif
+#include<depthPrePass>
+`,
+            };
+        }
+        return {
+            CUSTOM_FRAGMENT_DEFINITIONS: `
+#include<bayerDitherFunctions>
+uniform vec4 ditheredFadeSettings;
+varying vec4 vDitheredTileFade;
+
+bool shouldDiscardDitheredTileFragment(vec2 position, vec4 materialSettings, vec4 instanceSettings) {
+    vec2 bounds = materialSettings.xy;
+#ifdef INSTANCES
+    if (instanceSettings.z > 0.5 && instanceSettings.w == materialSettings.w) {
+        bounds = instanceSettings.xy;
+    }
+#endif
+    float ditheredFadeSample = bayerDither8(floor(position)) / 64.0;
+    return materialSettings.z > 0.5 && (ditheredFadeSample < bounds.x || ditheredFadeSample >= bounds.y);
+}
+`,
+            CUSTOM_FRAGMENT_BEFORE_FRAGCOLOR: `
+if (shouldDiscardDitheredTileFragment(gl_FragCoord.xy, ditheredFadeSettings, vDitheredTileFade)) {
+    discard;
+}
+`,
+            [DepthPrePassInjectionPoint]: `
+#ifdef DEPTHPREPASS
+if (shouldDiscardDitheredTileFragment(gl_FragCoord.xy, ditheredFadeSettings, vDitheredTileFade)) {
+    discard;
+}
+#endif
+#include<depthPrePass>
+`,
+        };
+    }
+    /**
+     * Gets the class name.
+     * @returns The class name.
+     */
+    getClassName() {
+        return "DitheredTileFadeMaterialPlugin";
+    }
+    /**
+     * Releases all weakly held runtime fade state and disables fading.
+     *
+     * The plugin remains attached to its material and can be reused through {@link GetOrCreate}.
+     */
+    dispose() {
+        this.reset();
+        this._isEnabled = false;
+    }
+    static _ValidateNewPlugin(material) {
+        DitheredTileFadeMaterialPlugin._ValidateMaterial(material);
+        if (material.pluginManager?.getPlugin(DitheredTileFadeMaterialPlugin.Name)) {
+            throw new Error(`The material "${material.name}" already has a plugin named "${DitheredTileFadeMaterialPlugin.Name}". Use GetOrCreate to reuse it.`);
+        }
+        return true;
+    }
+    static _ValidateMaterial(material) {
+        if (!(material instanceof StandardMaterial) && !(material instanceof PBRBaseMaterial)) {
+            throw new TypeError("DitheredTileFadeMaterialPlugin supports only StandardMaterial and PBRBaseMaterial-derived materials.");
+        }
+    }
+    _validateMesh(mesh) {
+        if (!(mesh instanceof Mesh) && !(mesh instanceof InstancedMesh)) {
+            throw new TypeError("DitheredTileFadeMaterialPlugin supports only Mesh and InstancedMesh objects.");
+        }
+    }
+    _validateThinInstanceIndex(mesh, index) {
+        RegisterThinInstanceMesh();
+        if (!Number.isInteger(index) || index < 0 || index >= mesh.thinInstanceCount) {
+            throw new RangeError(`index must identify one of the mesh's ${mesh.thinInstanceCount} thin instances.`);
+        }
+    }
+    _getInstanceAttributeName() {
+        return `ditheredTileFade${this._material.uniqueId}`;
+    }
+    _ensureInstancedBuffer(source) {
+        if (this._instancedBufferSources.has(source)) {
+            return;
+        }
+        RegisterInstancedMesh();
+        source.registerInstancedBuffer(this._getInstanceAttributeName(), 4);
+        this._instancedBufferSources.add(source);
+    }
+    _ensureThinInstanceBuffer(source) {
+        const requiredLength = source.thinInstanceCount * 4;
+        const existingBuffer = this._thinInstanceFadeBuffers.get(source);
+        if (existingBuffer && existingBuffer.length >= requiredLength) {
+            return existingBuffer;
+        }
+        RegisterThinInstanceMesh();
+        const buffer = new Float32Array(Math.max(requiredLength, 32 * 4));
+        if (existingBuffer) {
+            buffer.set(existingBuffer);
+        }
+        source.thinInstanceSetBuffer(this._getInstanceAttributeName(), buffer, 4, false);
+        this._thinInstanceFadeBuffers.set(source, buffer);
+        return buffer;
+    }
+    _updateInstancedFadeBounds(mesh, lowerBound, upperBound, configured) {
+        const source = mesh instanceof InstancedMesh ? mesh.sourceMesh : mesh;
+        if (mesh instanceof InstancedMesh || source.instances.length > 0) {
+            this._ensureInstancedBuffer(source);
+            const current = mesh.instancedBuffers[this._getInstanceAttributeName()];
+            if (current instanceof Vector4) {
+                current.set(lowerBound, upperBound, configured ? 1 : 0, this._generation);
+            }
+            else {
+                mesh.instancedBuffers[this._getInstanceAttributeName()] = new Vector4(lowerBound, upperBound, configured ? 1 : 0, this._generation);
+            }
+        }
+    }
+    _validateBound(value, name) {
+        if (!Number.isFinite(value) || value < 0 || value > 1) {
+            throw new RangeError(`${name} must be a finite number in the range [0, 1].`);
+        }
+    }
+    async _loadShaderIncludeAsync(shaderLanguage) {
+        try {
+            await _LoadShaderIncludeAsync(shaderLanguage);
+            this._shaderIncludeReady = true;
+        }
+        catch (error) {
+            this._shaderIncludeError = error;
+        }
+    }
+}
+/**
+ * The name used to register the plugin on a material.
+ */
+DitheredTileFadeMaterialPlugin.Name = "DitheredTileFade";
+//# sourceMappingURL=ditheredTileFadeMaterialPlugin.js.map

package/Materials/ditheredTileFadeMaterialPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ditheredTileFadeMaterialPlugin.js","sourceRoot":"","sources":["../../../../dev/core/src/Materials/ditheredTileFadeMaterialPlugin.ts"],"names":[],"mappings":"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","sourcesContent":["import { type AbstractEngine } from \"../Engines/abstractEngine.pure\";\r\nimport { type AbstractMesh } from \"../Meshes/abstractMesh.pure\";\r\nimport { InstancedMesh, RegisterInstancedMesh } from \"../Meshes/instancedMesh.pure\";\r\nimport { Mesh } from \"../Meshes/mesh.pure\";\r\nimport { type SubMesh } from \"../Meshes/subMesh.pure\";\r\nimport { RegisterThinInstanceMesh } from \"../Meshes/thinInstanceMesh.pure\";\r\nimport { type Scene } from \"../scene.pure\";\r\nimport { type Nullable } from \"../types\";\r\nimport { Vector4 } from \"../Maths/math.vector.pure\";\r\nimport { MaterialPluginBase } from \"./materialPluginBase.pure\";\r\nimport { type MaterialDefines } from \"./materialDefines\";\r\nimport { PBRBaseMaterial } from \"./PBR/pbrBaseMaterial.pure\";\r\nimport { ShaderLanguage } from \"./shaderLanguage\";\r\nimport { StandardMaterial } from \"./standardMaterial.pure\";\r\nimport { type UniformBuffer } from \"./uniformBuffer\";\r\n\r\n/**\r\n * The material families supported by {@link DitheredTileFadeMaterialPlugin}.\r\n */\r\nexport type DitheredTileFadeSupportedMaterial = StandardMaterial | PBRBaseMaterial;\r\n\r\n/**\r\n * The mesh types that can store independent dithered tile fade bounds.\r\n */\r\nexport type DitheredTileFadeMesh = Mesh | InstancedMesh;\r\n\r\n/**\r\n * Defines a normalized interval in the 8x8 Bayer threshold domain.\r\n */\r\nexport interface IDitheredTileFadeBounds {\r\n    /**\r\n     * The inclusive lower bound.\r\n     */\r\n    lowerBound: number;\r\n\r\n    /**\r\n     * The exclusive upper bound.\r\n     */\r\n    upperBound: number;\r\n}\r\n\r\nlet GlslShaderLoadPromise: Promise<void> | undefined;\r\nlet WgslShaderLoadPromise: Promise<void> | undefined;\r\nconst DepthPrePassInjectionPoint = \"!#include<depthPrePass>\";\r\n\r\nasync function _LoadGlslShaderIncludeAsync(): Promise<void> {\r\n    await import(\"../Shaders/ShadersInclude/bayerDitherFunctions\");\r\n}\r\n\r\nasync function _LoadWgslShaderIncludeAsync(): Promise<void> {\r\n    await import(\"../ShadersWGSL/ShadersInclude/bayerDitherFunctions\");\r\n}\r\n\r\nasync function _LoadShaderIncludeAsync(shaderLanguage: ShaderLanguage): Promise<void> {\r\n    if (shaderLanguage === ShaderLanguage.WGSL) {\r\n        WgslShaderLoadPromise ??= _LoadWgslShaderIncludeAsync();\r\n        await WgslShaderLoadPromise;\r\n        return;\r\n    }\r\n\r\n    GlslShaderLoadPromise ??= _LoadGlslShaderIncludeAsync();\r\n    await GlslShaderLoadPromise;\r\n}\r\n\r\n/**\r\n * Applies an opaque, screen-space dithered fade for tile LOD meshes that share a Standard or PBR material.\r\n *\r\n * The plugin keeps depth writing and the material's alpha mode unchanged. It affects the material color and integrated\r\n * prepass outputs, but not standalone depth, shadow, picking, outline, or custom passes. Tile renderers using those passes\r\n * must provide equivalent pass-specific coverage or exclude fading tiles from them.\r\n *\r\n * Per-mesh bounds are runtime state. Material cloning and serialization do not copy them; use {@link copyToMaterial} to\r\n * copy the enabled state to a cloned material and then configure bounds for the cloned tile meshes.\r\n * @see https://playground.babylonjs.com/#HI17VI#0\r\n */\r\nexport class DitheredTileFadeMaterialPlugin extends MaterialPluginBase {\r\n    /**\r\n     * The name used to register the plugin on a material.\r\n     */\r\n    public static readonly Name = \"DitheredTileFade\";\r\n\r\n    private _meshBounds = new WeakMap<AbstractMesh, IDitheredTileFadeBounds>();\r\n    private _instancedBufferSources = new WeakSet<Mesh>();\r\n    private _thinInstanceFadeBuffers = new WeakMap<Mesh, Float32Array>();\r\n    private _generation = 1;\r\n    private _isEnabled = true;\r\n    private _shaderIncludeReady = false;\r\n    private _shaderIncludeError: unknown;\r\n\r\n    /**\r\n     * Gets whether configured fades are applied. Disabling the plugin makes every mesh fully visible without discarding its stored bounds.\r\n     */\r\n    public get isEnabled(): boolean {\r\n        return this._isEnabled;\r\n    }\r\n\r\n    /**\r\n     * Sets whether configured fades are applied. This uniform-only change does not recompile the material.\r\n     */\r\n    public set isEnabled(value: boolean) {\r\n        this._isEnabled = value;\r\n    }\r\n\r\n    /**\r\n     * Creates and attaches a dithered fade plugin.\r\n     * @param material The Standard or PBR material that the plugin will extend.\r\n     * @throws If the material is unsupported or already has a dithered tile fade plugin. Use {@link GetOrCreate} when reuse is intended.\r\n     */\r\n    public constructor(material: DitheredTileFadeSupportedMaterial) {\r\n        super(material, DitheredTileFadeMaterialPlugin.Name, 190, undefined, DitheredTileFadeMaterialPlugin._ValidateNewPlugin(material), false, true);\r\n\r\n        this.registerForExtraEvents = true;\r\n        this.doNotSerialize = true;\r\n        void this._loadShaderIncludeAsync(material.shaderLanguage);\r\n        this._enable(true);\r\n    }\r\n\r\n    /**\r\n     * Gets the plugin already attached to a material, or creates and attaches one.\r\n     * @param material The Standard or PBR material to extend.\r\n     * @returns The material's dithered fade plugin.\r\n     * @throws If the material is unsupported or another plugin uses the reserved plugin name.\r\n     */\r\n    public static GetOrCreate(material: DitheredTileFadeSupportedMaterial): DitheredTileFadeMaterialPlugin {\r\n        DitheredTileFadeMaterialPlugin._ValidateMaterial(material);\r\n        const existing = material.pluginManager?.getPlugin(DitheredTileFadeMaterialPlugin.Name);\r\n        if (existing) {\r\n            if (!(existing instanceof DitheredTileFadeMaterialPlugin)) {\r\n                throw new Error(`The material \"${material.name}\" already has an incompatible plugin named \"${DitheredTileFadeMaterialPlugin.Name}\".`);\r\n            }\r\n            return existing;\r\n        }\r\n        return new DitheredTileFadeMaterialPlugin(material);\r\n    }\r\n\r\n    /**\r\n     * Checks whether the plugin supports a shader language.\r\n     * @param shaderLanguage The shader language to check.\r\n     * @returns True for GLSL and WGSL.\r\n     */\r\n    public override isCompatible(shaderLanguage: ShaderLanguage): boolean {\r\n        return shaderLanguage === ShaderLanguage.GLSL || shaderLanguage === ShaderLanguage.WGSL;\r\n    }\r\n\r\n    /**\r\n     * Sets both normalized Bayer interval bounds for a mesh.\r\n     * @param mesh The tile mesh or hardware instance whose draw calls use the bounds.\r\n     * @param lowerBound The inclusive lower bound in the range [0, 1].\r\n     * @param upperBound The exclusive upper bound in the range [0, 1].\r\n     * @remarks Bounds are independent. A lower bound greater than or equal to the upper bound intentionally produces an empty interval.\r\n     */\r\n    public setFadeBounds(mesh: DitheredTileFadeMesh, lowerBound: number, upperBound: number): void {\r\n        this._validateMesh(mesh);\r\n        this._validateBound(lowerBound, \"lowerBound\");\r\n        this._validateBound(upperBound, \"upperBound\");\r\n\r\n        const bounds = this._meshBounds.get(mesh);\r\n        if (bounds) {\r\n            bounds.lowerBound = lowerBound;\r\n            bounds.upperBound = upperBound;\r\n        } else {\r\n            this._meshBounds.set(mesh, { lowerBound, upperBound });\r\n        }\r\n\r\n        this._updateInstancedFadeBounds(mesh, lowerBound, upperBound, true);\r\n    }\r\n\r\n    /**\r\n     * Sets the normalized inclusive lower Bayer interval bound for a mesh.\r\n     * @param mesh The tile mesh or hardware instance whose draw calls use the bound.\r\n     * @param lowerBound The inclusive lower bound in the range [0, 1].\r\n     */\r\n    public setFadeLowerBound(mesh: DitheredTileFadeMesh, lowerBound: number): void {\r\n        this.setFadeBounds(mesh, lowerBound, this._meshBounds.get(mesh)?.upperBound ?? 1);\r\n    }\r\n\r\n    /**\r\n     * Sets the normalized exclusive upper Bayer interval bound for a mesh.\r\n     * @param mesh The tile mesh or hardware instance whose draw calls use the bound.\r\n     * @param upperBound The exclusive upper bound in the range [0, 1].\r\n     */\r\n    public setFadeUpperBound(mesh: DitheredTileFadeMesh, upperBound: number): void {\r\n        this.setFadeBounds(mesh, this._meshBounds.get(mesh)?.lowerBound ?? 0, upperBound);\r\n    }\r\n\r\n    /**\r\n     * Copies a mesh's current bounds without allocating.\r\n     * @param mesh The mesh whose bounds are queried.\r\n     * @param result The object that receives the bounds.\r\n     * @returns True when the mesh has explicit bounds. Otherwise false is returned with the source mesh's bounds for a hardware instance, or [0, 1].\r\n     */\r\n    public getFadeBoundsToRef(mesh: DitheredTileFadeMesh, result: IDitheredTileFadeBounds): boolean {\r\n        this._validateMesh(mesh);\r\n        const explicitBounds = this._meshBounds.get(mesh);\r\n        const bounds = explicitBounds ?? (mesh instanceof InstancedMesh ? this._meshBounds.get(mesh.sourceMesh) : undefined);\r\n        result.lowerBound = bounds?.lowerBound ?? 0;\r\n        result.upperBound = bounds?.upperBound ?? 1;\r\n        return explicitBounds !== undefined;\r\n    }\r\n\r\n    /**\r\n     * Removes a mesh's explicit bounds. A hardware instance inherits its source mesh's bounds; a source mesh uses [0, 1].\r\n     * @param mesh The mesh to reset.\r\n     */\r\n    public resetFade(mesh: DitheredTileFadeMesh): void {\r\n        this._validateMesh(mesh);\r\n        this._meshBounds.delete(mesh);\r\n        this._updateInstancedFadeBounds(mesh, 0, 1, false);\r\n    }\r\n\r\n    /**\r\n     * Sets normalized Bayer interval bounds for one thin instance.\r\n     * @param mesh The source mesh containing the thin instance.\r\n     * @param index The thin instance index.\r\n     * @param lowerBound The inclusive lower bound in the range [0, 1].\r\n     * @param upperBound The exclusive upper bound in the range [0, 1].\r\n     * @param refresh Whether to immediately upload the updated attribute buffer.\r\n     */\r\n    public setThinInstanceFadeBounds(mesh: Mesh, index: number, lowerBound: number, upperBound: number, refresh = true): void {\r\n        this._validateBound(lowerBound, \"lowerBound\");\r\n        this._validateBound(upperBound, \"upperBound\");\r\n        this._validateThinInstanceIndex(mesh, index);\r\n        const buffer = this._ensureThinInstanceBuffer(mesh);\r\n        const offset = index * 4;\r\n        buffer[offset] = lowerBound;\r\n        buffer[offset + 1] = upperBound;\r\n        buffer[offset + 2] = 1;\r\n        buffer[offset + 3] = this._generation;\r\n        if (refresh) {\r\n            this.commitThinInstanceFadeBounds(mesh);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Sets normalized Bayer interval bounds for all thin instances from packed lower/upper pairs.\r\n     * @param mesh The source mesh containing the thin instances.\r\n     * @param bounds Packed lower/upper pairs, with two values per thin instance.\r\n     */\r\n    public setThinInstanceFadeBoundsBuffer(mesh: Mesh, bounds: Float32Array): void {\r\n        RegisterThinInstanceMesh();\r\n        const instanceCount = mesh.thinInstanceCount;\r\n        if (bounds.length !== instanceCount * 2) {\r\n            throw new RangeError(`bounds must contain exactly ${instanceCount * 2} values.`);\r\n        }\r\n\r\n        for (let index = 0; index < instanceCount; index++) {\r\n            const lowerBound = bounds[index * 2];\r\n            const upperBound = bounds[index * 2 + 1];\r\n            this._validateBound(lowerBound, `bounds[${index * 2}]`);\r\n            this._validateBound(upperBound, `bounds[${index * 2 + 1}]`);\r\n        }\r\n\r\n        const attributeData = this._ensureThinInstanceBuffer(mesh);\r\n        for (let index = 0; index < instanceCount; index++) {\r\n            const attributeOffset = index * 4;\r\n            attributeData[attributeOffset] = bounds[index * 2];\r\n            attributeData[attributeOffset + 1] = bounds[index * 2 + 1];\r\n            attributeData[attributeOffset + 2] = 1;\r\n            attributeData[attributeOffset + 3] = this._generation;\r\n        }\r\n\r\n        this.commitThinInstanceFadeBounds(mesh);\r\n    }\r\n\r\n    /**\r\n     * Uploads thin-instance fade changes after one or more setters used `refresh = false`.\r\n     * @param mesh The source mesh whose fade attribute buffer changed.\r\n     */\r\n    public commitThinInstanceFadeBounds(mesh: Mesh): void {\r\n        if (!this._thinInstanceFadeBuffers.has(mesh)) {\r\n            throw new Error(\"No thin-instance fade buffer has been created for this mesh.\");\r\n        }\r\n        mesh.thinInstanceBufferUpdated(this._getInstanceAttributeName());\r\n    }\r\n\r\n    /**\r\n     * Removes one thin instance's explicit bounds so it inherits the source mesh's bounds.\r\n     * @param mesh The source mesh containing the thin instance.\r\n     * @param index The thin instance index.\r\n     * @param refresh Whether to immediately upload the updated attribute buffer.\r\n     */\r\n    public resetThinInstanceFade(mesh: Mesh, index: number, refresh = true): void {\r\n        this._validateThinInstanceIndex(mesh, index);\r\n        const buffer = this._ensureThinInstanceBuffer(mesh);\r\n        const offset = index * 4;\r\n        buffer[offset] = 0;\r\n        buffer[offset + 1] = 1;\r\n        buffer[offset + 2] = 0;\r\n        buffer[offset + 3] = this._generation;\r\n        if (refresh) {\r\n            this.commitThinInstanceFadeBounds(mesh);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Removes all explicit mesh bounds while keeping the plugin enabled.\r\n     */\r\n    public reset(): void {\r\n        this._meshBounds = new WeakMap();\r\n        this._generation++;\r\n    }\r\n\r\n    /**\r\n     * Copies material-level configuration to another supported material.\r\n     *\r\n     * Per-mesh bounds are intentionally not copied because they belong to the source tile meshes.\r\n     * @param material The destination material, including a material clone.\r\n     * @returns The destination material's dithered tile fade plugin.\r\n     */\r\n    public copyToMaterial(material: DitheredTileFadeSupportedMaterial): DitheredTileFadeMaterialPlugin {\r\n        const plugin = DitheredTileFadeMaterialPlugin.GetOrCreate(material);\r\n        plugin.isEnabled = this._isEnabled;\r\n        return plugin;\r\n    }\r\n\r\n    /** @internal */\r\n    public override isReadyForSubMesh(_defines: MaterialDefines, _scene: Scene, _engine: AbstractEngine, _subMesh: SubMesh): boolean {\r\n        if (this._shaderIncludeError) {\r\n            throw this._shaderIncludeError;\r\n        }\r\n        return this._shaderIncludeReady;\r\n    }\r\n\r\n    /**\r\n     * Uploads the current mesh's bounds for every draw, including shared and frozen materials.\r\n     * @param _uniformBuffer The material uniform buffer.\r\n     * @param _scene The scene being rendered.\r\n     * @param _engine The engine being used.\r\n     * @param subMesh The submesh being bound.\r\n     */\r\n    public override hardBindForSubMesh(_uniformBuffer: UniformBuffer, _scene: Scene, _engine: AbstractEngine, subMesh: SubMesh): void {\r\n        const effect = subMesh.effect;\r\n        if (!effect) {\r\n            return;\r\n        }\r\n\r\n        const mesh = subMesh.getMesh();\r\n        const bounds = this._meshBounds.get(mesh);\r\n        effect.setFloat4(\"ditheredFadeSettings\", bounds?.lowerBound ?? 0, bounds?.upperBound ?? 1, this._isEnabled ? 1 : 0, this._generation);\r\n    }\r\n\r\n    /**\r\n     * Registers the per-instance fade attribute when a mesh is rendered as a hardware or thin instance batch.\r\n     * @param attributes The attributes used to compile the material.\r\n     * @param _scene The scene containing the mesh.\r\n     * @param mesh The mesh being compiled.\r\n     */\r\n    public override getAttributes(attributes: string[], _scene: Scene, mesh: AbstractMesh): void {\r\n        const source = mesh instanceof InstancedMesh ? mesh.sourceMesh : mesh;\r\n        if (!(source instanceof Mesh)) {\r\n            return;\r\n        }\r\n\r\n        if (source.instances.length > 0) {\r\n            this._ensureInstancedBuffer(source);\r\n        }\r\n        if (source.hasThinInstances) {\r\n            this._ensureThinInstanceBuffer(source);\r\n        }\r\n        if (source.instances.length > 0 || source.hasThinInstances) {\r\n            attributes.push(this._getInstanceAttributeName());\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Gets the uniforms used by the plugin.\r\n     * @returns The external uniform names.\r\n     */\r\n    public override getUniforms(): { externalUniforms: string[] } {\r\n        return {\r\n            externalUniforms: [\"ditheredFadeSettings\"],\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Gets the shader code injected by the plugin.\r\n     * @param shaderType The shader stage being customized.\r\n     * @param shaderLanguage The material shader language.\r\n     * @returns Fragment customizations, or null for the vertex stage.\r\n     */\r\n    public override getCustomCode(shaderType: string, shaderLanguage = ShaderLanguage.GLSL): Nullable<{ [pointName: string]: string }> {\r\n        if (shaderType !== \"fragment\") {\r\n            const instanceAttributeName = this._getInstanceAttributeName();\r\n            if (shaderType !== \"vertex\") {\r\n                return null;\r\n            }\r\n\r\n            if (shaderLanguage === ShaderLanguage.WGSL) {\r\n                return {\r\n                    CUSTOM_VERTEX_DEFINITIONS: `\r\n#ifdef INSTANCES\r\nattribute ${instanceAttributeName}: vec4f;\r\n#endif\r\nvarying vDitheredTileFade: vec4f;\r\n`,\r\n                    CUSTOM_VERTEX_MAIN_BEGIN: `\r\n#ifdef INSTANCES\r\nvertexOutputs.vDitheredTileFade = input.${instanceAttributeName};\r\n#else\r\nvertexOutputs.vDitheredTileFade = vec4f(0.0);\r\n#endif\r\n`,\r\n                };\r\n            }\r\n\r\n            return {\r\n                CUSTOM_VERTEX_DEFINITIONS: `\r\n#ifdef INSTANCES\r\nattribute vec4 ${instanceAttributeName};\r\n#endif\r\nvarying vec4 vDitheredTileFade;\r\n`,\r\n                CUSTOM_VERTEX_MAIN_BEGIN: `\r\n#ifdef INSTANCES\r\nvDitheredTileFade = ${instanceAttributeName};\r\n#else\r\nvDitheredTileFade = vec4(0.0);\r\n#endif\r\n`,\r\n            };\r\n        }\r\n\r\n        if (shaderLanguage === ShaderLanguage.WGSL) {\r\n            return {\r\n                CUSTOM_FRAGMENT_DEFINITIONS: `\r\n#include<bayerDitherFunctions>\r\nuniform ditheredFadeSettings: vec4f;\r\nvarying vDitheredTileFade: vec4f;\r\n\r\nfn shouldDiscardDitheredTileFragment(position: vec2f, materialSettings: vec4f, instanceSettings: vec4f) -> bool {\r\n    var bounds = materialSettings.xy;\r\n#ifdef INSTANCES\r\n    if (instanceSettings.z > 0.5 && instanceSettings.w == materialSettings.w) {\r\n        bounds = instanceSettings.xy;\r\n    }\r\n#endif\r\n    let ditheredFadeSample = bayerDither8(floor(position)) / 64.0;\r\n    return materialSettings.z > 0.5 && (ditheredFadeSample < bounds.x || ditheredFadeSample >= bounds.y);\r\n}\r\n`,\r\n                CUSTOM_FRAGMENT_BEFORE_FRAGCOLOR: `\r\nif (shouldDiscardDitheredTileFragment(fragmentInputs.position.xy, uniforms.ditheredFadeSettings, fragmentInputs.vDitheredTileFade)) {\r\n    discard;\r\n}\r\n`,\r\n                [DepthPrePassInjectionPoint]: `\r\n#ifdef DEPTHPREPASS\r\nif (shouldDiscardDitheredTileFragment(fragmentInputs.position.xy, uniforms.ditheredFadeSettings, fragmentInputs.vDitheredTileFade)) {\r\n    discard;\r\n}\r\n#endif\r\n#include<depthPrePass>\r\n`,\r\n            };\r\n        }\r\n\r\n        return {\r\n            CUSTOM_FRAGMENT_DEFINITIONS: `\r\n#include<bayerDitherFunctions>\r\nuniform vec4 ditheredFadeSettings;\r\nvarying vec4 vDitheredTileFade;\r\n\r\nbool shouldDiscardDitheredTileFragment(vec2 position, vec4 materialSettings, vec4 instanceSettings) {\r\n    vec2 bounds = materialSettings.xy;\r\n#ifdef INSTANCES\r\n    if (instanceSettings.z > 0.5 && instanceSettings.w == materialSettings.w) {\r\n        bounds = instanceSettings.xy;\r\n    }\r\n#endif\r\n    float ditheredFadeSample = bayerDither8(floor(position)) / 64.0;\r\n    return materialSettings.z > 0.5 && (ditheredFadeSample < bounds.x || ditheredFadeSample >= bounds.y);\r\n}\r\n`,\r\n            CUSTOM_FRAGMENT_BEFORE_FRAGCOLOR: `\r\nif (shouldDiscardDitheredTileFragment(gl_FragCoord.xy, ditheredFadeSettings, vDitheredTileFade)) {\r\n    discard;\r\n}\r\n`,\r\n            [DepthPrePassInjectionPoint]: `\r\n#ifdef DEPTHPREPASS\r\nif (shouldDiscardDitheredTileFragment(gl_FragCoord.xy, ditheredFadeSettings, vDitheredTileFade)) {\r\n    discard;\r\n}\r\n#endif\r\n#include<depthPrePass>\r\n`,\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Gets the class name.\r\n     * @returns The class name.\r\n     */\r\n    public override getClassName(): string {\r\n        return \"DitheredTileFadeMaterialPlugin\";\r\n    }\r\n\r\n    /**\r\n     * Releases all weakly held runtime fade state and disables fading.\r\n     *\r\n     * The plugin remains attached to its material and can be reused through {@link GetOrCreate}.\r\n     */\r\n    public override dispose(): void {\r\n        this.reset();\r\n        this._isEnabled = false;\r\n    }\r\n\r\n    private static _ValidateNewPlugin(material: DitheredTileFadeSupportedMaterial): true {\r\n        DitheredTileFadeMaterialPlugin._ValidateMaterial(material);\r\n        if (material.pluginManager?.getPlugin(DitheredTileFadeMaterialPlugin.Name)) {\r\n            throw new Error(`The material \"${material.name}\" already has a plugin named \"${DitheredTileFadeMaterialPlugin.Name}\". Use GetOrCreate to reuse it.`);\r\n        }\r\n        return true;\r\n    }\r\n\r\n    private static _ValidateMaterial(material: DitheredTileFadeSupportedMaterial): void {\r\n        if (!(material instanceof StandardMaterial) && !(material instanceof PBRBaseMaterial)) {\r\n            throw new TypeError(\"DitheredTileFadeMaterialPlugin supports only StandardMaterial and PBRBaseMaterial-derived materials.\");\r\n        }\r\n    }\r\n\r\n    private _validateMesh(mesh: AbstractMesh): asserts mesh is DitheredTileFadeMesh {\r\n        if (!(mesh instanceof Mesh) && !(mesh instanceof InstancedMesh)) {\r\n            throw new TypeError(\"DitheredTileFadeMaterialPlugin supports only Mesh and InstancedMesh objects.\");\r\n        }\r\n    }\r\n\r\n    private _validateThinInstanceIndex(mesh: Mesh, index: number): void {\r\n        RegisterThinInstanceMesh();\r\n        if (!Number.isInteger(index) || index < 0 || index >= mesh.thinInstanceCount) {\r\n            throw new RangeError(`index must identify one of the mesh's ${mesh.thinInstanceCount} thin instances.`);\r\n        }\r\n    }\r\n\r\n    private _getInstanceAttributeName(): string {\r\n        return `ditheredTileFade${this._material.uniqueId}`;\r\n    }\r\n\r\n    private _ensureInstancedBuffer(source: Mesh): void {\r\n        if (this._instancedBufferSources.has(source)) {\r\n            return;\r\n        }\r\n\r\n        RegisterInstancedMesh();\r\n        source.registerInstancedBuffer(this._getInstanceAttributeName(), 4);\r\n        this._instancedBufferSources.add(source);\r\n    }\r\n\r\n    private _ensureThinInstanceBuffer(source: Mesh): Float32Array {\r\n        const requiredLength = source.thinInstanceCount * 4;\r\n        const existingBuffer = this._thinInstanceFadeBuffers.get(source);\r\n        if (existingBuffer && existingBuffer.length >= requiredLength) {\r\n            return existingBuffer;\r\n        }\r\n\r\n        RegisterThinInstanceMesh();\r\n        const buffer = new Float32Array(Math.max(requiredLength, 32 * 4));\r\n        if (existingBuffer) {\r\n            buffer.set(existingBuffer);\r\n        }\r\n        source.thinInstanceSetBuffer(this._getInstanceAttributeName(), buffer, 4, false);\r\n        this._thinInstanceFadeBuffers.set(source, buffer);\r\n        return buffer;\r\n    }\r\n\r\n    private _updateInstancedFadeBounds(mesh: DitheredTileFadeMesh, lowerBound: number, upperBound: number, configured: boolean): void {\r\n        const source = mesh instanceof InstancedMesh ? mesh.sourceMesh : mesh;\r\n        if (mesh instanceof InstancedMesh || source.instances.length > 0) {\r\n            this._ensureInstancedBuffer(source);\r\n            const current = mesh.instancedBuffers[this._getInstanceAttributeName()];\r\n            if (current instanceof Vector4) {\r\n                current.set(lowerBound, upperBound, configured ? 1 : 0, this._generation);\r\n            } else {\r\n                mesh.instancedBuffers[this._getInstanceAttributeName()] = new Vector4(lowerBound, upperBound, configured ? 1 : 0, this._generation);\r\n            }\r\n        }\r\n    }\r\n\r\n    private _validateBound(value: number, name: string): void {\r\n        if (!Number.isFinite(value) || value < 0 || value > 1) {\r\n            throw new RangeError(`${name} must be a finite number in the range [0, 1].`);\r\n        }\r\n    }\r\n\r\n    private async _loadShaderIncludeAsync(shaderLanguage: ShaderLanguage): Promise<void> {\r\n        try {\r\n            await _LoadShaderIncludeAsync(shaderLanguage);\r\n            this._shaderIncludeReady = true;\r\n        } catch (error) {\r\n            this._shaderIncludeError = error;\r\n        }\r\n    }\r\n}\r\n"]}

package/Materials/effectRenderer.pure.d.ts

@@ -171,6 +171,10 @@ export interface EffectWrapperCreationOptions {
      * Callback when effect is compiled
      */
     onCompiled?: Nullable<(effect: Effect) => void>;
+    /**
+     * Callback when there is an error compiling the effect
+     */
+    onError?: (effect: Effect, errors: string) => void;
     /**
      * The friendly name of the effect (default: "effectWrapper")
      */

package/Materials/effectRenderer.pure.js

@@ -226,6 +226,7 @@ export class EffectWrapper {
             blockCompilation: creationOptions.blockCompilation || false,
             shaderLanguage: creationOptions.shaderLanguage || 0 /* ShaderLanguage.GLSL */,
             onCompiled: creationOptions.onCompiled || undefined,
+            onError: creationOptions.onError || undefined,
             extraInitializations: creationOptions.extraInitializations || undefined,
             extraInitializationsAsync: creationOptions.extraInitializationsAsync || undefined,
             useAsPostProcess: creationOptions.useAsPostProcess ?? false,
@@ -352,7 +353,7 @@ export class EffectWrapper {
                 defines: defines !== null ? defines : "",
                 fallbacks: null,
                 onCompiled: onCompiled ?? this.options.onCompiled,
-                onError: onError ?? null,
+                onError: onError ?? this.options.onError,
                 indexParameters: indexParameters || this.options.indexParameters,
                 processCodeAfterIncludes: customShaderCodeProcessing?.processCodeAfterIncludes
                     ? (shaderType, code) => customShaderCodeProcessing.processCodeAfterIncludes(this.name, shaderType, code)
@@ -365,7 +366,7 @@ export class EffectWrapper {
             }, this.options.engine);
         }
         else {
-            this._drawWrapper.effect = new Effect(this._shaderPath, this.options.attributeNames, uniforms || this.options.uniforms, samplers || this.options.samplerNames, this.options.engine, defines, undefined, onCompiled || this.options.onCompiled, undefined, undefined, undefined, this.options.shaderLanguage, extraInitializationsAsync);
+            this._drawWrapper.effect = new Effect(this._shaderPath, this.options.attributeNames, uniforms || this.options.uniforms, samplers || this.options.samplerNames, this.options.engine, defines, undefined, onCompiled || this.options.onCompiled, onError ?? this.options.onError, undefined, undefined, this.options.shaderLanguage, extraInitializationsAsync);
         }
         this.onEffectCreatedObservable.notifyObservers(this._drawWrapper.effect);
     }