ID3D11DeviceContext1::ClearView-Methode (d3d11_1.h)

Artikel
02/26/2024

Legt alle Elemente in einer Ressourcenansicht auf einen Wert fest.

Syntax

void ClearView(
  [in]           ID3D11View       *pView,
  [in]           const FLOAT [4]  Color,
  [in, optional] const D3D11_RECT *pRect,
                 UINT             NumRects
);

Parameter

[in] pView

Ein Zeiger auf die ID3D11View-Schnittstelle , die die zu löschende Ressourcenansicht darstellt.

[in] Color

Ein Array mit vier Komponenten, das die Farbe darstellt, die zum Löschen der Ressourcenansicht verwendet werden soll.

[in, optional] pRect

Ein Array von D3D11_RECT Strukturen für die Zu löschenden Rechtecke in der Ressourcenansicht. Wenn NULL, löscht ClearView die gesamte Oberfläche.

NumRects

Anzahl der Rechtecke im Array, das der pRect-Parameter angibt.

Rückgabewert

Keine

Bemerkungen

ClearView funktioniert nur für Renderzielansichten (RTVs), Tiefen-/Schablonenansichten (DSVs) für Nur-Tiefen-Ressourcen (Ressourcen ohne Schablonenkomponente), UAVs (Ungeordnete Zugriffsansichten) oder jede Videoansicht einer Textur2D-Oberfläche . Die Laufzeit löscht ungültige Aufrufe. Leere Rechtecke im pRect-Array sind no-op. Ein Rechteck ist leer, wenn der obere Wert dem unteren Wert entspricht oder der linke Wert dem rechten Wert entspricht.

ClearView unterstützt keine 3D-Texturen.

ClearView wendet den gleichen Farbwert auf alle Arrayslices in einer Ansicht an. Alle Rechtecke im pRect-Array entsprechen jedem Arrayslice. Das pRect-Array von Rechtecke besteht aus einer Reihe von Bereichen, die auf einer einzelnen Oberfläche gelöscht werden sollen. Wenn die Ansicht ein Array ist, löscht ClearView alle Rechtecke in jedem Arrayslice einzeln.

Wenn Sie Rechtecke auf Puffer anwenden, legen Sie den obersten Wert auf 0 und den unteren Wert auf 1 fest, und legen Sie den linken wert und den rechten Wert fest, um den Umfang innerhalb des Puffers zu beschreiben. Wenn der obere Wert dem unteren Wert oder dem linken Wert gleich dem rechten Wert ist, ist das Rechteck leer, und ein No-Op-Wert wird erreicht.

Der Treiber konvertiert und klemmt Farbwerte entsprechend den Direct3D-Konvertierungsregeln in das Zielformat. Wenn das Format der Ansicht beispielsweise DXGI_FORMAT_R8G8B8A8_UNORM ist, klemmt der Treiber eingaben auf 0,0f bis 1,0f (+INF -> 1,0f (0XFF)/NaN -> 0,0f).

Wenn das Format ganzzahlig ist, z. B. DXGI_FORMAT_R8G8B8A8_UINT, interpretiert die Laufzeit Eingaben als integrale Floats. Daher wird 235.0f 235 zugeordnet (rundet sich auf Null, außerhalb des Bereichs/INF-Werte auf den Zielbereich und NaN auf 0).

Hier sind die Farbzuordnungen:

Farbe[0]: R (oder Y für Video)
Farbe[1]: G (oder U/Cb für Video)
Farbe[2]: B (oder V/Cr für Video)
Farbe[3]: A

Für Videoansichten im YUV- oder YCbBr-Format konvertiert ClearView keine Farbwerte. In Situationen, in denen der Formatname nicht auf _UNORM, _UINT usw. hinweist, geht ClearView von _UINT aus. Daher wird 235.0f 235 zugeordnet (rundet sich auf Null, außerhalb des Bereichs/INF-Werte auf den Zielbereich und NaN auf 0).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	d3d11_1.h
Bibliothek	D3D11.lib

Weitere Informationen

ID3D11DeviceContext1

Freigeben über