D3DHAL_DP2CLEAR Struktur (d3dhal.h)

Artikel
02/23/2024

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

D3DHAL_DP2COMMAND

DDPIXELFORMAT

Freigeben über