ID3D11DeviceContext1::ClearView-Methode (d3d11_1.h)
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
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 |