D3D12_RENDER_TARGET_BLEND_DESC structure (d3d12.h)
Describes the blend state for a render target.
Syntax
typedef struct D3D12_RENDER_TARGET_BLEND_DESC {
BOOL BlendEnable;
BOOL LogicOpEnable;
D3D12_BLEND SrcBlend;
D3D12_BLEND DestBlend;
D3D12_BLEND_OP BlendOp;
D3D12_BLEND SrcBlendAlpha;
D3D12_BLEND DestBlendAlpha;
D3D12_BLEND_OP BlendOpAlpha;
D3D12_LOGIC_OP LogicOp;
UINT8 RenderTargetWriteMask;
} D3D12_RENDER_TARGET_BLEND_DESC;
Members
BlendEnable
Specifies whether to enable (or disable) blending. Set to TRUE to enable blending.
Note
It's not valid for LogicOpEnable and BlendEnable to both be TRUE.
LogicOpEnable
Specifies whether to enable (or disable) a logical operation. Set to TRUE to enable a logical operation.
Note
It's not valid for LogicOpEnable and BlendEnable to both be TRUE.
SrcBlend
A D3D12_BLEND-typed value that specifies the operation to perform on the RGB value that the pixel shader outputs. The BlendOp member defines how to combine the SrcBlend and DestBlend operations.
DestBlend
A D3D12_BLEND-typed value that specifies the operation to perform on the current RGB value in the render target. The BlendOp member defines how to combine the SrcBlend and DestBlend operations.
BlendOp
A D3D12_BLEND_OP-typed value that defines how to combine the SrcBlend and DestBlend operations.
SrcBlendAlpha
A D3D12_BLEND-typed value that specifies the operation to perform on the alpha value that the pixel shader outputs. Blend options that end in _COLOR are not allowed. The BlendOpAlpha member defines how to combine the SrcBlendAlpha and DestBlendAlpha operations.
DestBlendAlpha
A D3D12_BLEND-typed value that specifies the operation to perform on the current alpha value in the render target. Blend options that end in _COLOR are not allowed. The BlendOpAlpha member defines how to combine the SrcBlendAlpha and DestBlendAlpha operations.
BlendOpAlpha
A D3D12_BLEND_OP-typed value that defines how to combine the SrcBlendAlpha and DestBlendAlpha operations.
LogicOp
A D3D12_LOGIC_OP-typed value that specifies the logical operation to configure for the render target.
RenderTargetWriteMask
A combination of D3D12_COLOR_WRITE_ENABLE-typed values that are combined by using a bitwise OR operation. The resulting value specifies a write mask.
Remarks
Note
It's not valid for LogicOpEnable and BlendEnable to both be TRUE.
You specify an array of D3D12_RENDER_TARGET_BLEND_DESC structures in the RenderTarget member of the D3D12_BLEND_DESC structure to describe the blend states for render targets; you can bind up to eight render targets to the output-merger stage at one time.
For info about how blending is done, see the output-merger stage.
Here are the default values for blend state.
| State | Default Value |
|---|---|
| BlendEnable | FALSE |
| LogicOpEnable | FALSE |
| SrcBlend | D3D12_BLEND_ONE |
| DestBlend | D3D12_BLEND_ZERO |
| BlendOp | D3D12_BLEND_OP_ADD |
| SrcBlendAlpha | D3D12_BLEND_ONE |
| DestBlendAlpha | D3D12_BLEND_ZERO |
| BlendOpAlpha | D3D12_BLEND_OP_ADD |
| LogicOp | D3D12_LOGIC_OP_NOOP |
| RenderTargetWriteMask | D3D12_COLOR_WRITE_ENABLE_ALL |
Requirements
| Requirement | Value |
|---|---|
| Header | d3d12.h |