D3DHAL_DP2CLEAR struttura (d3dhal.h)

  • Articolo

D3DHAL_DP2CLEAR contiene tutte le informazioni necessarie al driver per eseguire la cancellazione assistita dall'hardware nella destinazione di rendering, nel buffer di profondità o nel buffer stencil.

Sintassi

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

Members

dwFlags

Specifica i buffer che il driver deve cancellare. Questo membro può essere un OR bit per bit dei valori seguenti:

Valore Significato
D3DCLEAR_TARGET Il driver deve cancellare la destinazione di rendering del contesto al colore specificato dal membro dwFillColor.
D3DCLEAR_STENCIL Il driver deve cancellare il buffer stencil del contesto al valore specificato dal membro dwFillStencil.
D3DCLEAR_ZBUFFER Il driver deve cancellare il buffer di profondità del contesto alla profondità specificata dal membro dwFillDepth.
D3DCLEAR_COMPUTERECTS DirectX 8.0 e versioni successive solo.
Se questo flag è impostato, i rettangoli specificati devono essere ritagliati sul riquadro di visualizzazione corrente. Inoltre, è possibile che quando D3DCLEAR_COMPUTERECTS è specificato il numero di rettangoli da cancellare può essere zero (il numero di rettangoli da cancellare può essere trovato nell'unione wStateCount/wPrimtiveCount della struttura D3DHAL_DP2COMMAND per la cancellazione). In questo caso, l'intero riquadro di visualizzazione deve essere cancellato.

dwFillColor

Specifica il colore a cui il driver deve cancellare la destinazione di rendering del contesto.

dvFillDepth

Specifica il valore che il driver deve usare per impostare la profondità nel buffer di profondità del contesto. Questo membro può essere un valore nell'intervallo da 0,0 a 1,0. Il driver deve convertire questo valore in un intero usando il membro dwZBitMask della struttura DDPIXELFORMAT del buffer di profondità.

dwFillStencil

Specifica il valore a cui il driver deve cancellare il buffer stencil del contesto. Questo membro può essere un intero nell'intervallo da 0 a 2ⁿ-1, dove n è il numero di bit nel buffer stencil.

Rects[1]

Specifica le aree rettangolari del buffer che il driver deve cancellare. I rettangoli vengono specificati nelle coordinate dello schermo. Questo membro della struttura contiene la prima area rettangolo da blittare. Il membro wStateCount della D3DHAL_DP2COMMAND contiene il numero totale di aree rettangole da blittare. Le altre strutture RECT (wStateCount-1) necessarie seguono la struttura D3DHAL_DP2CLEAR senza spaziatura interna.

Commenti

Questa struttura viene usata con il token di comando D3DDP2OP_CLEAR per sostituire i callback D3dClear legacy e D3dClear2.

È importante notare che quando il numero di rettangoli è zero, la struttura dati D3DHAL_DP2CLEAR include ancora spazio per un singolo RECT. Pertanto, le dimensioni di questo singolo RECT devono essere incluse durante l'avanzamento all'istruzione DP2 successiva. Tuttavia, il contenuto del RECT in questo caso non è definito e il driver non deve tentare di leggerli.

I driver di visualizzazione devono convertire i valori di colore di input per le classi ARGB e YUV dei formati di colore. Per operazioni chiare, i valori di colore di input vengono specificati nel membro dwFillColor . Per altre informazioni, vedere Gestione dei valori dei colori per i formati pixel.

Requisiti

Requisito Valore
Intestazione d3dhal.h (include D3dhal.h)

Vedi anche

D3DDP2OP_CLEAR

D3DHAL_DP2COMMAND

DDPIXELFORMAT