<!--
{
  "availability" : [
    "iOS: 17.0.0 -",
    "iPadOS: 17.0.0 -",
    "macCatalyst: 17.0.0 -",
    "macOS: 14.0.0 -",
    "tvOS: 26.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "ShaderGraph-Docs",
  "identifier" : "/documentation/ShaderGraph/Compositing/Matte",
  "metadataVersion" : "0.1.0",
  "role" : "ShaderGraph Node",
  "symbol" : {
    "kind" : "ShaderGraph Node",
    "modules" : [
      "ShaderGraph"
    ],
    "preciseIdentifier" : "Shader_ND_matte_color4"
  },
  "title" : "Matte"
}
-->

# Matte

A merge operation that layers premultiplied foreground over background.

## Parameter Types

|Input       |Type         |
        |------------|-------------|
        |`Foreground`|Color4<Float>|
        |`Background`|Color4<Float>|
        |`Mix`       |Float        |

|Output|Type         |
        |------|-------------|
        |`Out` |Color4<Float>|

## Parameter descriptions

- `Foreground`: The `color4` foreground input. `F` represents the RGB component of this parameter. `f` represents the alpha component of this parameter.
- `Background`: The `color4` background input. `B` represents the RGB component of this parameter. `b`represents the alpha component of this parameter.
- `Mix`: The weight of the blend operation. The higher the value of `Mix`, the more apparent the effect of the blend operation. The default value is `1`. Values outside of the range `0-1` produce an undefined effect outside of the node’s intended function.

## Discussion

The Matte node determines its output using the alpha channels of the foreground and background inputs. The RGB component of the output is `Ff+B(1-f)` and the alpha component of the output is `f+b(1-f)`.
Below is a simple node graph that uses the In node to blend a wood and rock texture.

![](images/ShaderGraph-Docs/MatteGraph~dark.png)

Below are the two original images, the image representation of the alpha of the foreground, and the resulting blended texture applied to a cube.



![](images/ShaderGraph-Docs/MaskMaterial1.png)



![](images/ShaderGraph-Docs/MaskMaterialAlpha.png)



![](images/ShaderGraph-Docs/DisjointOverMaterial2~dark.png)

![](images/ShaderGraph-Docs/MatteMaterial~dark.png)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)