Método ID3D11DeviceContext1::ClearView (d3d11_1.h)

  • Artigo

Define todos os elementos em uma exibição de recurso como um valor.

Sintaxe

void ClearView(
  [in]           ID3D11View       *pView,
  [in]           const FLOAT [4]  Color,
  [in, optional] const D3D11_RECT *pRect,
                 UINT             NumRects
);

Parâmetros

[in] pView

Um ponteiro para a interface ID3D11View que representa a exibição de recurso a ser limpa.

[in] Color

Uma matriz de quatro componentes que representa a cor a ser usada para limpar a exibição de recursos.

[in, optional] pRect

Uma matriz de estruturas D3D11_RECT para os retângulos na exibição de recursos a serem limpos. Se FOR NULL, ClearView limpará toda a superfície.

NumRects

Número de retângulos na matriz especificada pelo parâmetro pRect .

Retornar valor

Nenhum

Comentários

ClearView funciona apenas em RTVs (exibições de destino de renderização), DSVs (exibições de profundidade/estêncil) em recursos somente de profundidade (recursos sem componente de estêncil), exibições de acesso não ordenado (UAVs) ou qualquer exibição de vídeo de uma superfície Texture2D . O runtime descarta chamadas inválidas. Retângulos vazios na matriz pRect são não op. Um retângulo estará vazio se o valor superior for igual ao valor inferior ou se o valor esquerdo for igual ao valor à direita.

ClearView não dá suporte a texturas 3D.

ClearView aplica o mesmo valor de cor a todas as fatias de matriz em um modo de exibição; todos os retângulos na matriz pRect correspondem a cada fatia de matriz. A matriz pRect de retângulos é um conjunto de áreas a serem limpas em uma única superfície. Se a exibição for uma matriz, ClearView limpará todos os retângulos em cada fatia de matriz individualmente.

Ao aplicar retângulos a buffers, defina o valor superior como 0 e o valor inferior como 1 e defina o valor esquerdo e o valor direito para descrever a extensão dentro do buffer. Quando o valor superior é igual ao valor inferior ou o valor esquerdo é igual ao valor direito, o retângulo fica vazio e uma não operação é obtida.

O driver converte e fixa valores de cor no formato de destino, conforme apropriado, de acordo com as regras de conversão do Direct3D. Por exemplo, se o formato da exibição for DXGI_FORMAT_R8G8B8A8_UNORM, o driver fixa as entradas de 0,0f a 1,0f (+INF -> 1,0f (0XFF)/NaN -> 0,0f).

Se o formato for inteiro, como DXGI_FORMAT_R8G8B8A8_UINT, o runtime interpretará as entradas como floats integrais. Portanto, 235,0f é mapeado para 235 (arredonda para zero, valores fora do intervalo/INF fixados para o intervalo de destino e NaN a 0).

Aqui estão os mapeamentos de cores:

  • Color[0]: R (ou Y para vídeo)
  • Color[1]: G (ou U/Cb para vídeo)
  • Color[2]: B (ou V/Cr para vídeo)
  • Cor[3]: A
Para exibições de vídeo com formatos YUV ou YCbBr, ClearView não converte valores de cor. Em situações em que o nome do formato não indica _UNORM, _UINT e assim por diante, ClearView pressupõe _UINT. Portanto, 235,0f é mapeado para 235 (arredonda para zero, valores fora do intervalo/INF fixados para o intervalo de destino e NaN a 0).

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 e Atualização de Plataforma para Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 e Atualização de Plataforma para Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho d3d11_1.h
Biblioteca D3D11.lib

Confira também

ID3D11DeviceContext1