> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# D3D12_RENDER_TARGET_BLEND_DESC

> 描述轉譯目標的混合狀態。(D3D12_RENDER_TARGET_BLEND_DESC)

描述轉譯目標的混合狀態。

## 語法

```cpp theme={null}
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
```

### 成員

*BlendEnable*\
類型：BOOL

指定是否啟用 (或停用) 混合。設定為 **TRUE** 可啟用混合。

<Note>
  *LogicOpEnable* 和 *BlendEnable* 不能同時為 **TRUE**。
</Note>

*LogicOpEnable*\
類型：BOOL

指定是否啟用 (或停用) 邏輯運算。設定為 **TRUE** 可啟用邏輯運算。

<Note>
  *LogicOpEnable* 和 *BlendEnable* 不能同時為 **TRUE**。
</Note>

*SrcBlend*\
類型：D3D12\_BLEND

[D3D12\_BLEND](/zh-TW/reference/graphics/d3d12/enums/d3d12_blend_public) 類型的值，指定要對像素著色器輸出的 RGB 值執行的運算。**BlendOp** 成員定義如何結合 **SrcBlend** 和 **DestBlend** 運算。

*DestBlend*\
類型：D3D12\_BLEND

[D3D12\_BLEND](/zh-TW/reference/graphics/d3d12/enums/d3d12_blend_public) 類型的值，指定要對轉譯目標中目前 RGB 值執行的運算。**BlendOp** 成員定義如何結合 **SrcBlend** 和 **DestBlend** 運算。

*BlendOp*\
類型：D3D12\_BLEND\_OP

[D3D12\_BLEND\_OP](/zh-TW/reference/graphics/d3d12/enums/d3d12_blend_op_public) 類型的值，定義如何結合 **SrcBlend** 和 **DestBlend** 運算。

*SrcBlendAlpha*\
類型：D3D12\_BLEND

[D3D12\_BLEND](/zh-TW/reference/graphics/d3d12/enums/d3d12_blend_public) 類型的值，指定要對像素著色器輸出的 Alpha 值執行的運算。不允許使用以 \_COLOR 結尾的混合選項。**BlendOpAlpha** 成員定義如何結合 **SrcBlendAlpha** 和 **DestBlendAlpha** 運算。

*DestBlendAlpha*\
類型：D3D12\_BLEND

[D3D12\_BLEND](/zh-TW/reference/graphics/d3d12/enums/d3d12_blend_public) 類型的值，指定要對轉譯目標中目前 Alpha 值執行的運算。不允許使用以 \_COLOR 結尾的混合選項。**BlendOpAlpha** 成員定義如何結合 **SrcBlendAlpha** 和 **DestBlendAlpha** 運算。

*BlendOpAlpha*\
類型：D3D12\_BLEND\_OP

[D3D12\_BLEND\_OP](/zh-TW/reference/graphics/d3d12/enums/d3d12_blend_op_public) 類型的值，定義如何結合 **SrcBlendAlpha** 和 **DestBlendAlpha** 運算。

*LogicOp*\
類型：D3D12\_LOGIC\_OP

[D3D12\_LOGIC\_OP](/zh-TW/reference/graphics/d3d12/enums/d3d12_logic_op_public) 類型的值，指定要為轉譯目標設定的邏輯運算。

*RenderTargetWriteMask*\
類型：UINT8

[D3D12\_COLOR\_WRITE\_ENABLE](/zh-TW/reference/graphics/d3d12/enums/d3d12_color_write_enable_public) 類型值的組合，使用位元 OR 運算加以結合。所產生的值會指定寫入遮罩。

## 備註

<Note>
  *LogicOpEnable* 和 *BlendEnable* 不能同時為 **TRUE**。
</Note>

您可以在 [D3D12\_BLEND\_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_blend_desc_public) 結構的 **RenderTarget** 成員中指定 **D3D12\_RENDER\_TARGET\_BLEND\_DESC** 結構的陣列，以描述轉譯目標的混合狀態；一次最多可以將八個轉譯目標繫結至[輸出合併階段](https://learn.microsoft.com/en-us/windows/desktop/direct3d11/d3d10-graphics-programming-guide-output-merger-stage)。

如需混合運作方式的相關資訊，請參閱[輸出合併階段](https://learn.microsoft.com/en-us/windows/desktop/direct3d11/d3d10-graphics-programming-guide-output-merger-stage)。

以下是混合狀態的預設值。

<table>
  <tr>
    <th>狀態</th>
    <th>預設值</th>
  </tr>

  <tr>
    <td>BlendEnable</td>
    <td>FALSE</td>
  </tr>

  <tr>
    <td>LogicOpEnable</td>
    <td>FALSE</td>
  </tr>

  <tr>
    <td>SrcBlend</td>
    <td>D3D12\_BLEND\_ONE</td>
  </tr>

  <tr>
    <td>DestBlend</td>
    <td>D3D12\_BLEND\_ZERO</td>
  </tr>

  <tr>
    <td>BlendOp</td>
    <td>D3D12\_BLEND\_OP\_ADD</td>
  </tr>

  <tr>
    <td>SrcBlendAlpha</td>
    <td>D3D12\_BLEND\_ONE</td>
  </tr>

  <tr>
    <td>DestBlendAlpha</td>
    <td>D3D12\_BLEND\_ZERO</td>
  </tr>

  <tr>
    <td>BlendOpAlpha</td>
    <td>D3D12\_BLEND\_OP\_ADD</td>
  </tr>

  <tr>
    <td>LogicOp</td>
    <td>D3D12\_LOGIC\_OP\_NOOP</td>
  </tr>

  <tr>
    <td>RenderTargetWriteMask</td>
    <td>D3D12\_COLOR\_WRITE\_ENABLE\_ALL</td>
  </tr>
</table>

## 需求

**標頭:** d3d12\_xs.h 或 d3d12\_x.h\
**程式庫:** d3d12\_xs.lib 或 d3d12\_x.lib\
**支援的平台**: XBOX Series 主機和 XBOX One 系列

## 另請參閱

[核心結構](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-structures)


## Related topics

- [D3D12_BLEND_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_blend_desc_public.md)
- [D3D12_BLEND](/zh-TW/reference/graphics/d3d12/enums/d3d12_blend_public.md)
- [D3D12_LOGIC_OP](/zh-TW/reference/graphics/d3d12/enums/d3d12_logic_op_public.md)
- [D3D12_COLOR_WRITE_ENABLE](/zh-TW/reference/graphics/d3d12/enums/d3d12_color_write_enable_public.md)
- [D3D12_BLEND_OP](/zh-TW/reference/graphics/d3d12/enums/d3d12_blend_op_public.md)