D3D11_RENDER_TARGET_BLEND_DESC1 structure (d3d11_1.h)
Describes the blend state for a render target.
Note
This structure is supported by the Direct3D 11.1 runtime, which is available on Windows 8 and later operating systems.
Syntax
typedef struct D3D11_RENDER_TARGET_BLEND_DESC1 {
BOOL BlendEnable;
BOOL LogicOpEnable;
D3D11_BLEND SrcBlend;
D3D11_BLEND DestBlend;
D3D11_BLEND_OP BlendOp;
D3D11_BLEND SrcBlendAlpha;
D3D11_BLEND DestBlendAlpha;
D3D11_BLEND_OP BlendOpAlpha;
D3D11_LOGIC_OP LogicOp;
UINT8 RenderTargetWriteMask;
} D3D11_RENDER_TARGET_BLEND_DESC1;
Members
BlendEnable
Type: BOOL
Enable (or disable) blending.
Note
It's not valid for LogicOpEnable and BlendEnable to both be TRUE.
LogicOpEnable
Type: BOOL
Enable (or disable) a logical operation.
Note
If you set LogicOpEnable to TRUE, then BlendEnable must be FALSE, and the system's D3D11_FEATURE_DATA_D3D11_OPTIONS::OutputMergerLogicOp option must be TRUE.
SrcBlend
Type: D3D11_BLEND
This blend option 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
Type: D3D11_BLEND
This blend option 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
Type: D3D11_BLEND_OP
This blend operation defines how to combine the SrcBlend and DestBlend operations.
SrcBlendAlpha
Type: D3D11_BLEND
This blend option 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
Type: D3D11_BLEND
This blend option 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
Type: D3D11_BLEND_OP
This blend operation defines how to combine the SrcBlendAlpha and DestBlendAlpha operations.
LogicOp
Type: D3D11_LOGIC_OP
A D3D11_LOGIC_OP-typed value that specifies the logical operation to configure for the render target.
RenderTargetWriteMask
Type: UINT8
A write mask.
Remarks
Note
It's not valid for LogicOpEnable and BlendEnable to both be TRUE.
You specify an array of D3D11_RENDER_TARGET_BLEND_DESC1 structures in the RenderTarget member of the D3D11_BLEND_DESC1 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 | D3D11_BLEND_ONE |
| DestBlend | D3D11_BLEND_ZERO |
| BlendOp | D3D11_BLEND_OP_ADD |
| SrcBlendAlpha | D3D11_BLEND_ONE |
| DestBlendAlpha | D3D11_BLEND_ZERO |
| BlendOpAlpha | D3D11_BLEND_OP_ADD |
| LogicOp | D3D11_LOGIC_OP_NOOP |
| RenderTargetWriteMask | D3D11_COLOR_WRITE_ENABLE_ALL |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8 and Platform Update for Windows 7 [desktop apps | UWP apps] |
| Minimum supported server | Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | UWP apps] |
| Header | d3d11_1.h |