D3DHAL_DP2CLEAR Struktur (d3dhal.h)
D3DHAL_DP2CLEAR enthält alle Informationen, die der Treiber benötigt, um hardwaregestütztes Löschen für das Renderingziel, den Tiefenpuffer oder den Schablonenpuffer durchzuführen.
Syntax
typedef struct _D3DHAL_DP2CLEAR {
DWORD dwFlags;
DWORD dwFillColor;
D3DVALUE dvFillDepth;
DWORD dwFillStencil;
RECT Rects[1];
} D3DHAL_DP2CLEAR;
Member
dwFlags
Gibt an, welche Puffer der Treiber löschen soll. Dieser Member kann ein bitweiser OR der folgenden Werte sein:
| Wert | Bedeutung |
|---|---|
| D3DCLEAR_TARGET | Der Treiber sollte das Renderziel des Kontexts auf die vom dwFillColor-Element angegebene Farbe löschen. |
| D3DCLEAR_STENCIL | Der Treiber sollte den Schablonenpuffer des Kontexts auf den vom dwFillStencil-Member angegebenen Wert löschen. |
| D3DCLEAR_ZBUFFER | Der Treiber sollte den Tiefenpuffer des Kontexts auf die vom dwFillDepth-Element angegebene Tiefe löschen. |
| D3DCLEAR_COMPUTERECTS | Nur DirectX 8.0 und höhere Versionen. Wenn dieses Flag festgelegt ist, sollten die angegebenen Rechtecke für den aktuellen Viewport abgeschnitten werden. Darüber hinaus ist es möglich, dass beim Angeben von D3DCLEAR_COMPUTERECTS die Anzahl der zu löschenden Rechtecke 0 sein kann (die Anzahl der zu löschenden Rechtecke befindet sich in der wStateCount/wPrimtiveCount-Union der D3DHAL_DP2COMMAND Struktur für clear). In diesem Fall sollte der gesamte Viewport gelöscht werden. |
dwFillColor
Gibt die Farbe an, für die der Treiber das Renderziel des Kontexts löschen soll.
dvFillDepth
Gibt den Wert an, den der Treiber verwenden soll, um die Tiefe im Tiefenpuffer des Kontexts festzulegen. Dieser Member kann ein Wert im Intervall 0,0 bis 1,0 sein. Der Treiber sollte diesen Wert mithilfe des dwZBitMask-Elements der DDPIXELFORMAT-Struktur des Tiefenpuffers in eine ganze Zahl konvertieren.
dwFillStencil
Gibt den Wert an, in den der Treiber den Schablonenpuffer des Kontexts löschen soll. Dieses Element kann eine ganze Zahl im Intervall 0 bis 2ⁿ-1 sein, wobei n die Anzahl der Bits im Schablonenpuffer ist.
Rects[1]
Gibt die rechteckigen Bereiche des Puffers an, die der Treiber löschen soll. Die Rechtecke werden in Bildschirmkoordinaten angegeben. Dieses Element der Struktur enthält den ersten rechteckigen Bereich, der eingeteilt werden soll. Das wStateCount-Element des D3DHAL_DP2COMMAND enthält die Gesamtanzahl der zu durchschneidenden Rechteckbereiche. Die anderen erforderlichen (wStateCount-1) RECT-Strukturen folgen der D3DHAL_DP2CLEAR-Struktur ohne Auffüllung.
Hinweise
Diese Struktur wird mit dem D3DDP2OP_CLEAR-Befehlstoken verwendet, um die Legacy-Rückrufe D3dClear und D3dClear2 zu ersetzen.
Es ist wichtig zu beachten, dass die D3DHAL_DP2CLEAR Datenstruktur weiterhin Platz für ein einzelnes RECT enthält, wenn die Anzahl der Rechtecke 0 ist. Daher sollte die Größe dieses einzelnen RECT beim Wechseln zur nächsten DP2-Anweisung einbezogen werden. Der Inhalt des RECT ist in diesem Fall jedoch nicht definiert, und der Treiber sollte nicht versuchen, sie zu lesen.
Anzeigetreiber müssen Eingabefarbwerte für die KLASSEN ARGB und YUV von Farbformaten konvertieren. Für klare Vorgänge werden eingabefarbene Werte im dwFillColor-Element angegeben. Weitere Informationen finden Sie unter Behandeln von Farbwerten für Pixelformate.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | d3dhal.h (einschließlich D3dhal.h) |
Weitere Informationen
D3DDP2OP_CLEAR