estrutura D3DHAL_DP2CLEAR (d3dhal.h)
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:
| Value | 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 dwZBitMask membro da estrutura de 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 em coordenadas de tela. Esse membro da estrutura contém a primeira área do retângulo a ser cortada. O wStateCount membro da 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.
Observações
Essa estrutura é usada com o token de comando D3DDP2OP_CLEAR para substituir o D3dClear herdado e retornos de chamada D3dClear2.
É 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 deste único RECT 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 cores. 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 cores para formatos de pixel.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | d3dhal.h (inclua D3dhal.h) |
Consulte também
D3DDP2OP_CLEAR