@babylonjs/core 8.15.0 → 8.16.0

package/Materials/material.js

@@ -179,32 +179,60 @@ export class Material {
      *
      * | Value | Type | Description |
      * | --- | --- | --- |
-     * | 0 | ALPHA_DISABLE |   |
-     * | 1 | ALPHA_ADD |   |
-     * | 2 | ALPHA_COMBINE |   |
-     * | 3 | ALPHA_SUBTRACT |   |
-     * | 4 | ALPHA_MULTIPLY |   |
-     * | 5 | ALPHA_MAXIMIZED |   |
-     * | 6 | ALPHA_ONEONE |   |
-     * | 7 | ALPHA_PREMULTIPLIED |   |
-     * | 8 | ALPHA_PREMULTIPLIED_PORTERDUFF |   |
-     * | 9 | ALPHA_INTERPOLATE |   |
-     * | 10 | ALPHA_SCREENMODE |   |
+     * | 0 | ALPHA_DISABLE |  |
+     * | 1 | ALPHA_ADD | Defines that alpha blending is COLOR=SRC_ALPHA * SRC + DEST, ALPHA=DEST_ALPHA |
+     * | 2 | ALPHA_COMBINE | Defines that alpha blending is COLOR=SRC_ALPHA * SRC + (1 - SRC_ALPHA) * DEST, ALPHA=SRC_ALPHA + DEST_ALPHA |
+     * | 3 | ALPHA_SUBTRACT | Defines that alpha blending is COLOR=(1 - SRC) * DEST, ALPHA=SRC_ALPHA - DEST_ALPHA |
+     * | 4 | ALPHA_MULTIPLY | Defines that alpha blending is COLOR=DEST * SRC, ALPHA=SRC_ALPHA + DEST_ALPHA |
+     * | 5 | ALPHA_MAXIMIZED | Defines that alpha blending is COLOR=SRC_ALPHA * SRC + (1 - SRC) * DEST, ALPHA=SRC_ALPHA + DEST_ALPHA |
+     * | 6 | ALPHA_ONEONE | Defines that alpha blending is COLOR=SRC + DEST, ALPHA=DEST_ALPHA |
+     * | 7 | ALPHA_PREMULTIPLIED | Defines that alpha blending is COLOR=SRC + (1 - SRC_ALPHA) * DEST, ALPHA=SRC_ALPHA + DEST_ALPHA |
+     * | 8 | ALPHA_PREMULTIPLIED_PORTERDUFF | Defines that alpha blending is COLOR=SRC + (1 - SRC_ALPHA) * DEST, ALPHA=SRC_ALPHA + (1 - SRC_ALPHA) * DEST_ALPHA |
+     * | 9 | ALPHA_INTERPOLATE | Defines that alpha blending is COLOR=CST * SRC + (1 - CST) * DEST, ALPHA=CST_ALPHA * SRC + (1 - CST_ALPHA) * DEST_ALPHA |
+     * | 10 | ALPHA_SCREENMODE | Defines that alpha blending is COLOR=SRC + (1 - SRC) * DEST, ALPHA=SRC_ALPHA + (1 - SRC_ALPHA) * DEST_ALPHA |
+     * | 11 | ALPHA_ONEONE_ONEONE | Defines that alpha blending is COLOR=SRC + DST, ALPHA=SRC_ALPHA + DEST_ALPHA |
+     * | 12 | ALPHA_ALPHATOCOLOR | Defines that alpha blending is COLOR=DEST_ALPHA * SRC + DST, ALPHA=0 |
+     * | 13 | ALPHA_REVERSEONEMINUS | Defines that alpha blending is COLOR=(1 - DEST) * SRC + (1 - SRC) * DEST, ALPHA=(1 - DEST_ALPHA) * SRC_ALPHA + (1 - SRC_ALPHA) * DEST_ALPHA |
+     * | 14 | ALPHA_SRC_DSTONEMINUSSRCALPHA | Defines that alpha blending is ALPHA=SRC + (1 - SRC ALPHA) * DEST, ALPHA=SRC_ALPHA + (1 - SRC ALPHA) * DEST_ALPHA |
+     * | 15 | ALPHA_ONEONE_ONEZERO | Defines that alpha blending is COLOR=SRC + DST, ALPHA=SRC_ALPHA |
+     * | 16 | ALPHA_EXCLUSION | Defines that alpha blending is COLOR=(1 - DEST) * SRC + (1 - SRC) * DEST, ALPHA=DEST_ALPHA |
+     * | 17 | ALPHA_LAYER_ACCUMULATE | Defines that alpha blending is COLOR=SRC_ALPHA * SRC + (1 - SRC ALPHA) * DEST, ALPHA=SRC_ALPHA + (1 - SRC_ALPHA) * DEST_ALPHA |
+     * | 18 | ALPHA_MIN | Defines that alpha blending is COLOR=MIN(SRC, DEST), ALPHA=MIN(SRC_ALPHA, DEST_ALPHA) |
+     * | 19 | ALPHA_MAX | Defines that alpha blending is COLOR=MAX(SRC, DEST), ALPHA=MAX(SRC_ALPHA, DEST_ALPHA) |
+     * | 20 | ALPHA_DUAL_SRC0_ADD_SRC1xDST | Defines that alpha blending uses dual source blending and is COLOR=SRC + SRC1 * DEST, ALPHA=DST_ALPHA |
      *
      */
     set alphaMode(value) {
-        if (this._alphaMode === value) {
+        if (this._alphaMode[0] === value) {
             return;
         }
-        this._alphaMode = value;
+        this._alphaMode[0] = value;
         this.markAsDirty(Material.TextureDirtyFlag);
     }
     /**
      * Gets the value of the alpha mode
      */
     get alphaMode() {
+        return this._alphaMode[0];
+    }
+    /**
+     * Gets the list of alpha modes (length greater than 1 for multi-targets)
+     */
+    get alphaModes() {
         return this._alphaMode;
     }
+    /**
+     * Sets the value of the alpha mode for a specific target index.
+     * @param value The alpha mode value to set.
+     * @param targetIndex The index of the target to set the alpha mode for. Defaults to 0.
+     */
+    setAlphaMode(value, targetIndex = 0) {
+        if (this._alphaMode[targetIndex] === value) {
+            return;
+        }
+        this._alphaMode[targetIndex] = value;
+        this.markAsDirty(Material.TextureDirtyFlag);
+    }
     /**
      * Sets the need depth pre-pass value
      */
@@ -418,7 +446,7 @@ export class Material {
         /**
          * Stores the value of the alpha mode
          */
-        this._alphaMode = 2;
+        this._alphaMode = [2];
         /**
          * Stores the state of the need depth pre-pass value
          */
@@ -1354,6 +1382,7 @@ 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);
@@ -1390,6 +1419,12 @@ 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;
+        }
         return material;
     }
     static _ParsePlugins(serializationObject, material, scene, rootUrl) {
@@ -1571,9 +1606,6 @@ __decorate([
 __decorate([
     serialize()
 ], Material.prototype, "sideOrientation", void 0);
-__decorate([
-    serialize("alphaMode")
-], Material.prototype, "_alphaMode", void 0);
 __decorate([
     serialize()
 ], Material.prototype, "_needDepthPrePass", void 0);