Compartilhar via

estrutura D3DHAL_DP2CLEAR (d3dhal.h)

  • Artigo

D3DHAL_DP2CLEAR contém todas as informações de que o driver precisa para executar a limpeza assistida por hardware no destino de renderização, buffer de profundidade ou buffer de estêncil.

Sintaxe

typedef struct _D3DHAL_DP2CLEAR {
  DWORD    dwFlags;
  DWORD    dwFillColor;
  D3DVALUE dvFillDepth;
  DWORD    dwFillStencil;
  RECT     Rects[1];
} D3DHAL_DP2CLEAR;

Membros

dwFlags

Especifica quais buffers o driver deve limpar. Esse membro pode ser um OR bit a bit dos seguintes valores:

Valor Significado
D3DCLEAR_TARGET O driver deve limpar o destino de renderização do contexto para a cor especificada pelo membro dwFillColor.
D3DCLEAR_STENCIL O driver deve limpar o buffer de estêncil do contexto para o valor especificado pelo membro dwFillStencil.
D3DCLEAR_ZBUFFER O driver deve limpar o buffer de profundidade do contexto para a profundidade especificada pelo membro dwFillDepth.
D3DCLEAR_COMPUTERECTS Somente o DirectX 8.0 e versões posteriores.
Se esse sinalizador estiver definido, os retângulos especificados deverão ser recortados no visor atual. Além disso, é possível que, quando D3DCLEAR_COMPUTERECTS for especificado, o número de retângulos a serem limpos pode ser zero (o número de retângulos a serem limpos pode ser encontrado na união wStateCount/wPrimtiveCount da estrutura D3DHAL_DP2COMMAND para limpar). Nesse caso, todo o visor deve ser limpo.

dwFillColor

Especifica a cor para a qual o driver deve limpar o destino de renderização do contexto.

dvFillDepth

Especifica o valor que o driver deve usar para definir a profundidade no buffer de profundidade do contexto. Esse membro pode ser um valor no intervalo de 0,0 a 1,0. O driver deve converter esse valor em um inteiro usando o membro dwZBitMask da estrutura DDPIXELFORMAT do buffer de profundidade.

dwFillStencil

Especifica o valor para o qual o driver deve limpar o buffer de estêncil do contexto. Esse membro pode ser um inteiro no intervalo de 0 a 2ⁿ-1, em que n é o número de bits no buffer de estêncil.

Rects[1]

Especifica as áreas retangulares do buffer que o driver deve limpar. Os retângulos são especificados nas coordenadas da tela. Esse membro da estrutura contém a primeira área do retângulo a ser cortada. O membro wStateCount do D3DHAL_DP2COMMAND contém o número total de áreas de retângulo a serem cortadas. As outras estruturas RECT (wStateCount-1) necessárias seguem a estrutura D3DHAL_DP2CLEAR sem nenhum preenchimento.

Comentários

Essa estrutura é usada com o token de comando D3DDP2OP_CLEAR para substituir os retornos de chamada D3dClear e D3dClear2 herdados .

É importante observar que quando o número de retângulos é zero, a estrutura de dados D3DHAL_DP2CLEAR ainda inclui espaço para um único RECT. Portanto, o tamanho desse RECT único deve ser incluído ao avançar para a próxima instrução DP2. No entanto, o conteúdo do RECT nesse caso é indefinido e o driver não deve tentar lê-los.

Os drivers de exibição devem converter valores de cor de entrada para as classes ARGB e YUV de formatos de cor. Para operações claras, os valores de cor de entrada são especificados no membro dwFillColor . Para obter mais informações, consulte Manipulando valores de cor para formatos de pixel.

Requisitos

Requisito Valor
Cabeçalho d3dhal.h (inclua D3dhal.h)

Confira também

D3DDP2OP_CLEAR

D3DHAL_DP2COMMAND

DDPIXELFORMAT