> ## 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

> Descreve o estado de mesclagem de um destino de renderização. (D3D12_RENDER_TARGET_BLEND_DESC)

Descreve o estado de mesclagem de um destino de renderização.

## Sintaxe

```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
```

### Membros

*BlendEnable*\
Tipo: BOOL

Especifica se a mesclagem deve ser habilitada (ou desabilitada). Defina como **TRUE** para habilitar a mesclagem.

<Note>
  Não é válido que *LogicOpEnable* e *BlendEnable* sejam ambos **TRUE**.
</Note>

*LogicOpEnable*\
Tipo: BOOL

Especifica se uma operação lógica deve ser habilitada (ou desabilitada). Defina como **TRUE** para habilitar uma operação lógica.

<Note>
  Não é válido que *LogicOpEnable* e *BlendEnable* sejam ambos **TRUE**.
</Note>

*SrcBlend*\
Tipo: D3D12\_BLEND

Um valor do tipo [D3D12\_BLEND](/pt-BR/reference/graphics/d3d12/enums/d3d12_blend_public) que especifica a operação a ser executada no valor RGB gerado pelo sombreador de pixel. O membro **BlendOp** define como combinar as operações **SrcBlend** e **DestBlend**.

*DestBlend*\
Tipo: D3D12\_BLEND

Um valor do tipo [D3D12\_BLEND](/pt-BR/reference/graphics/d3d12/enums/d3d12_blend_public) que especifica a operação a ser executada no valor RGB atual no destino de renderização. O membro **BlendOp** define como combinar as operações **SrcBlend** e **DestBlend**.

*BlendOp*\
Tipo: D3D12\_BLEND\_OP

Um valor do tipo [D3D12\_BLEND\_OP](/pt-BR/reference/graphics/d3d12/enums/d3d12_blend_op_public) que define como combinar as operações **SrcBlend** e **DestBlend**.

*SrcBlendAlpha*\
Tipo: D3D12\_BLEND

Um valor do tipo [D3D12\_BLEND](/pt-BR/reference/graphics/d3d12/enums/d3d12_blend_public) que especifica a operação a ser executada no valor alfa gerado pelo sombreador de pixel. Opções de mesclagem que terminam em \_COLOR não são permitidas. O membro **BlendOpAlpha** define como combinar as operações **SrcBlendAlpha** e **DestBlendAlpha**.

*DestBlendAlpha*\
Tipo: D3D12\_BLEND

Um valor do tipo [D3D12\_BLEND](/pt-BR/reference/graphics/d3d12/enums/d3d12_blend_public) que especifica a operação a ser executada no valor alfa atual no destino de renderização. Opções de mesclagem que terminam em \_COLOR não são permitidas. O membro **BlendOpAlpha** define como combinar as operações **SrcBlendAlpha** e **DestBlendAlpha**.

*BlendOpAlpha*\
Tipo: D3D12\_BLEND\_OP

Um valor do tipo [D3D12\_BLEND\_OP](/pt-BR/reference/graphics/d3d12/enums/d3d12_blend_op_public) que define como combinar as operações **SrcBlendAlpha** e **DestBlendAlpha**.

*LogicOp*\
Tipo: D3D12\_LOGIC\_OP

Um valor do tipo [D3D12\_LOGIC\_OP](/pt-BR/reference/graphics/d3d12/enums/d3d12_logic_op_public) que especifica a operação lógica a ser configurada para o destino de renderização.

*RenderTargetWriteMask*\
Tipo: UINT8

Uma combinação de valores do tipo [D3D12\_COLOR\_WRITE\_ENABLE](/pt-BR/reference/graphics/d3d12/enums/d3d12_color_write_enable_public) combinados por meio de uma operação OR bit a bit. O valor resultante especifica uma máscara de gravação.

## Comentários

<Note>
  Não é válido que *LogicOpEnable* e *BlendEnable* sejam ambos **TRUE**.
</Note>

Você especifica uma matriz de estruturas **D3D12\_RENDER\_TARGET\_BLEND\_DESC** no membro **RenderTarget** da estrutura [D3D12\_BLEND\_DESC](/pt-BR/reference/graphics/d3d12/structs/d3d12_blend_desc_public) para descrever os estados de mesclagem dos destinos de renderização; você pode associar até oito destinos de renderização ao [estágio de fusão de saída](https://learn.microsoft.com/en-us/windows/desktop/direct3d11/d3d10-graphics-programming-guide-output-merger-stage) ao mesmo tempo.

Para obter informações sobre como a mesclagem é feita, consulte o [estágio de fusão de saída](https://learn.microsoft.com/en-us/windows/desktop/direct3d11/d3d10-graphics-programming-guide-output-merger-stage).

Estes são os valores padrão do estado de mesclagem.

<table>
  <tr>
    <th>Estado</th>
    <th>Valor padrão</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>

## Requisitos

**Cabeçalho:** d3d12\_xs.h ou d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib ou d3d12\_x.lib\
**Plataformas com suporte**: consoles XBOX Series e família XBOX One

## Confira também

[Estruturas principais](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-structures)


## Related topics

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