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

See also

Core Structures