Método ID3D11DeviceContext::ClearRenderTargetView (d3d11.h)

  • Artigo

Defina todos os elementos em um destino de renderização como um valor.

Sintaxe

void ClearRenderTargetView(
  [in] ID3D11RenderTargetView *pRenderTargetView,
  [in] const FLOAT [4]        ColorRGBA
);

Parâmetros

[in] pRenderTargetView

Tipo: ID3D11RenderTargetView*

Ponteiro para o destino de renderização.

[in] ColorRGBA

Tipo: const FLOAT[4]

Uma matriz de quatro componentes que representa a cor com a qual preencher o destino de renderização.

Retornar valor

Nenhum

Comentários

Os aplicativos que desejam limpar um destino de renderização para um padrão de bit de valor inteiro específico devem renderizar um quad alinhado à tela em vez de usar esse método. O motivo disso é porque esse método aceita como entrada um valor de ponto flutuante, que pode não ter o mesmo padrão de bit que o inteiro original.

Diferenças entre o Direct3D 9 e o Direct3D 11/10:

Ao contrário do Direct3D 9, a extensão completa da exibição de recursos é sempre desmarcada. As configurações de visor e tesoura não são aplicadas.
 

Ao usar D3D_FEATURE_LEVEL_9_x, ClearRenderTargetView limpa apenas a primeira fatia de matriz na exibição de destino de renderização. Isso pode afetar (por exemplo) cenários de renderização de mapa de cubo. Os aplicativos devem criar uma exibição de destino de renderização para cada face ou fatia de matriz e limpar cada exibição individualmente.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho d3d11.h
Biblioteca D3D11.lib

Confira também

ID3D11DeviceContext