D3DHAL_DP2CLEAR struttura (d3dhal.h)
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