@babylonjs/core 8.24.2 → 8.25.1

package/Materials/material.d.ts

@@ -361,7 +361,7 @@ export declare class Material implements IAnimatable, IClipPlanesHolder {
     /**
      * Stores the value of the alpha mode
      */
-    protected _alphaMode: number[];
+    private _alphaMode;
     /**
      * Sets the value of the alpha mode.
      *
@@ -522,6 +522,16 @@ export declare class Material implements IAnimatable, IClipPlanesHolder {
      */
     get useLogarithmicDepth(): boolean;
     set useLogarithmicDepth(value: boolean);
+    protected _setVertexOutputInvariant: boolean;
+    /**
+     * Gets or sets the vertex output invariant state
+     * Setting this property to true will force the shader compiler to disable some optimization to make sure the vertex output is always calculated
+     * the same way across different compilation units.
+     * You may need to enable this option if you are seeing some depth artifacts when using a depth pre-pass, for e.g.
+     * Note that this may have an impact on performance, so leave this option disabled if not needed.
+     */
+    get setVertexOutputInvariant(): boolean;
+    set setVertexOutputInvariant(value: boolean);
     /**
      * @internal
      * Stores the effects for the material
@@ -905,6 +915,12 @@ export declare class Material implements IAnimatable, IClipPlanesHolder {
      */
     serialize(): any;
     protected _serializePlugins(serializationObject: any): void;
+    /**
+     * Parses the alpha mode from the material data to parse
+     * @param parsedMaterial defines the material data to parse
+     * @param material defines the material to update
+     */
+    static ParseAlphaMode(parsedMaterial: any, material: Material): void;
     /**
      * Creates a material from parsed material data
      * @param parsedMaterial defines parsed material data

package/Materials/material.js

@@ -353,6 +353,23 @@ export class Material {
         this._useLogarithmicDepth = value && fragmentDepthSupported;
         this._markAllSubMeshesAsMiscDirty();
     }
+    /**
+     * Gets or sets the vertex output invariant state
+     * Setting this property to true will force the shader compiler to disable some optimization to make sure the vertex output is always calculated
+     * the same way across different compilation units.
+     * You may need to enable this option if you are seeing some depth artifacts when using a depth pre-pass, for e.g.
+     * Note that this may have an impact on performance, so leave this option disabled if not needed.
+     */
+    get setVertexOutputInvariant() {
+        return this._setVertexOutputInvariant;
+    }
+    set setVertexOutputInvariant(value) {
+        if (this._setVertexOutputInvariant === value) {
+            return;
+        }
+        this._setVertexOutputInvariant = value;
+        this._markAllSubMeshesAsMiscDirty();
+    }
     /** @internal */
     _getDrawWrapper() {
         return this._drawWrapper;
@@ -507,6 +524,7 @@ export class Material {
          * Gives access to the stencil properties of the material
          */
         this.stencil = new MaterialStencilState();
+        this._setVertexOutputInvariant = false;
         /**
          * Specifies if uniform buffers should be used
          */
@@ -1402,7 +1420,6 @@ export class Material {
      */
     serialize() {
         const serializationObject = SerializationHelper.Serialize(this);
-        serializationObject.alphaMode = this._alphaMode;
         serializationObject.stencil = this.stencil.serialize();
         serializationObject.uniqueId = this.uniqueId;
         this._serializePlugins(serializationObject);
@@ -1418,6 +1435,22 @@ export class Material {
             }
         }
     }
+    /**
+     * Parses the alpha mode from the material data to parse
+     * @param parsedMaterial defines the material data to parse
+     * @param material defines the material to update
+     */
+    static ParseAlphaMode(parsedMaterial, material) {
+        if (parsedMaterial._alphaMode !== undefined) {
+            material._alphaMode = Array.isArray(parsedMaterial._alphaMode) ? parsedMaterial._alphaMode : [parsedMaterial._alphaMode];
+        }
+        else if (parsedMaterial.alphaMode !== undefined) {
+            material._alphaMode = Array.isArray(parsedMaterial.alphaMode) ? parsedMaterial.alphaMode : [parsedMaterial.alphaMode];
+        }
+        else {
+            material._alphaMode = [2];
+        }
+    }
     /**
      * Creates a material from parsed material data
      * @param parsedMaterial defines parsed material data
@@ -1439,12 +1472,7 @@ export class Material {
         const materialType = Tools.Instantiate(parsedMaterial.customType);
         const material = materialType.Parse(parsedMaterial, scene, rootUrl);
         material._loadedUniqueId = parsedMaterial.uniqueId;
-        if (!Array.isArray(parsedMaterial.alphaMode)) {
-            material._alphaMode = [parsedMaterial.alphaMode ?? 2];
-        }
-        else {
-            material._alphaMode = parsedMaterial.alphaMode;
-        }
+        Material.ParseAlphaMode(parsedMaterial, material);
         return material;
     }
     static _ParsePlugins(serializationObject, material, scene, rootUrl) {
@@ -1668,6 +1696,9 @@ __decorate([
 __decorate([
     serialize()
 ], Material.prototype, "useLogarithmicDepth", null);
+__decorate([
+    serialize()
+], Material.prototype, "_setVertexOutputInvariant", void 0);
 __decorate([
     serialize()
 ], Material.prototype, "transparencyMode", null);