Syntax
typedef enum D3D12_BLEND
{
D3D12_BLEND_ZERO = 1,
D3D12_BLEND_ONE = 2,
D3D12_BLEND_SRC_COLOR = 3,
D3D12_BLEND_INV_SRC_COLOR = 4,
D3D12_BLEND_SRC_ALPHA = 5,
D3D12_BLEND_INV_SRC_ALPHA = 6,
D3D12_BLEND_DEST_ALPHA = 7,
D3D12_BLEND_INV_DEST_ALPHA = 8,
D3D12_BLEND_DEST_COLOR = 9,
D3D12_BLEND_INV_DEST_COLOR = 10,
D3D12_BLEND_SRC_ALPHA_SAT = 11,
D3D12_BLEND_BLEND_FACTOR = 14,
D3D12_BLEND_INV_BLEND_FACTOR = 15,
D3D12_BLEND_SRC1_COLOR = 16,
D3D12_BLEND_INV_SRC1_COLOR = 17,
D3D12_BLEND_SRC1_ALPHA = 18,
D3D12_BLEND_INV_SRC1_ALPHA = 19,
D3D12_BLEND_ALPHA_FACTOR = 20,
D3D12_BLEND_INV_ALPHA_FACTOR = 21
} D3D12_BLEND
Constants
| Constant | Description |
|---|---|
| D3D12_BLEND_ZERO | The blend factor is (0, 0, 0, 0). No pre-blend operation. |
| D3D12_BLEND_ONE | The blend factor is (1, 1, 1, 1). No pre-blend operation. |
| D3D12_BLEND_SRC_COLOR | The blend factor is (Rₛ, Gₛ, Bₛ, Aₛ), that is color data (RGB) from a pixel shader. No pre-blend operation. |
| D3D12_BLEND_INV_SRC_COLOR | The blend factor is (1 - Rₛ, 1 - Gₛ, 1 - Bₛ, 1 - Aₛ), that is color data (RGB) from a pixel shader. The pre-blend operation inverts the data, generating 1 - RGB. |
| D3D12_BLEND_SRC_ALPHA | The blend factor is (Aₛ, Aₛ, Aₛ, Aₛ), that is alpha data (A) from a pixel shader. No pre-blend operation. |
| D3D12_BLEND_INV_SRC_ALPHA | The blend factor is ( 1 - Aₛ, 1 - Aₛ, 1 - Aₛ, 1 - Aₛ), that is alpha data (A) from a pixel shader. The pre-blend operation inverts the data, generating 1 - A. |
| D3D12_BLEND_DEST_ALPHA | The blend factor is (Ad Ad Ad Ad), that is alpha data from a render target. No pre-blend operation. |
| D3D12_BLEND_INV_DEST_ALPHA | The blend factor is (1 - Ad 1 - Ad 1 - Ad 1 - Ad), that is alpha data from a render target. The pre-blend operation inverts the data, generating 1 - A. |
| D3D12_BLEND_DEST_COLOR | The blend factor is (Rd, Gd, Bd, Ad), that is color data from a render target. No pre-blend operation. |
| D3D12_BLEND_INV_DEST_COLOR | The blend factor is (1 - Rd, 1 - Gd, 1 - Bd, 1 - Ad), that is color data from a render target. The pre-blend operation inverts the data, generating 1 - RGB. |
| D3D12_BLEND_SRC_ALPHA_SAT | The blend factor is (f, f, f, 1); where f = min(Aₛ, 1 - Ad). The pre-blend operation clamps the data to 1 or less. |
| D3D12_BLEND_BLEND_FACTOR | The blend factor is the blend factor set with ID3D12GraphicsCommandList::OMSetBlendFactor. No pre-blend operation. |
| D3D12_BLEND_INV_BLEND_FACTOR | The blend factor is the blend factor set with ID3D12GraphicsCommandList::OMSetBlendFactor. The pre-blend operation inverts the blend factor, generating 1 - blend_factor. |
| D3D12_BLEND_SRC1_COLOR | The blend factor is data sources both as color data output by a pixel shader. There is no pre-blend operation. This blend factor supports dual-source color blending. |
| D3D12_BLEND_INV_SRC1_COLOR | The blend factor is data sources both as color data output by a pixel shader. The pre-blend operation inverts the data, generating 1 - RGB. This blend factor supports dual-source color blending. |
| D3D12_BLEND_SRC1_ALPHA | The blend factor is data sources as alpha data output by a pixel shader. There is no pre-blend operation. This blend factor supports dual-source color blending. |
| D3D12_BLEND_INV_SRC1_ALPHA | The blend factor is data sources as alpha data output by a pixel shader. The pre-blend operation inverts the data, generating 1 - A. This blend factor supports dual-source color blending. |
| D3D12_BLEND_ALPHA_FACTOR | The blend factor is (A, A, A, A), where the constant, A, is taken from the blend factor set with OMSetBlendFactor. To successfully use this constant on a target machine, the D3D12_FEATURE_DATA_D3D12_OPTIONS13 returned from capability querying must have its AlphaBlendFactorSupported set to TRUE. |
| D3D12_BLEND_INV_ALPHA_FACTOR | The blend factor is (1 - A, 1 - A, 1 - A, 1 - A), where the constant, A, is taken from the blend factor set with OMSetBlendFactor. To successfully use this constant on a target machine, the D3D12_FEATURE_DATA_D3D12_OPTIONS13 returned from capability querying must have its AlphaBlendFactorSupported set to TRUE. |
Remarks
Source and destination blend operations are specified in a D3D12_RENDER_TARGET_BLEND_DESC structure.Requirements
Header: d3d12_xs.h or d3d12_x.hLibrary: d3d12_xs.lib or d3d12_x.lib
Supported Platforms: XBOX Series consoles and XBOX One family
