ID3D11DeviceContext::ClearRenderTargetView-Methode (d3d11.h)

  • Artikel

Legen Sie alle Elemente in einem Renderziel auf einen Wert fest.

Syntax

void ClearRenderTargetView(
  [in] ID3D11RenderTargetView *pRenderTargetView,
  [in] const FLOAT [4]        ColorRGBA
);

Parameter

[in] pRenderTargetView

Typ: ID3D11RenderTargetView*

Zeiger auf das Renderziel.

[in] ColorRGBA

Typ: const FLOAT[4]

Ein Array mit vier Komponenten, das die Farbe darstellt, mit der das Renderziel gefüllt werden soll.

Rückgabewert

Keine

Bemerkungen

Anwendungen, die ein Renderziel auf ein bestimmtes Ganzzahlwertbitmuster löschen möchten, sollten anstelle dieser Methode ein bildschirmbündiges Quad rendern. Der Grund dafür ist, dass diese Methode als Eingabe einen Gleitkommawert akzeptiert, der möglicherweise nicht das gleiche Bitmuster wie die ursprüngliche ganze Zahl aufweist.

Unterschiede zwischen Direct3D 9 und Direct3D 11/10:

Im Gegensatz zu Direct3D 9 wird der gesamte Umfang der Ressourcenansicht immer gelöscht. Viewport- und Schereneinstellungen werden nicht angewendet.
 

Bei Verwendung D3D_FEATURE_LEVEL_9_x löscht ClearRenderTargetView nur den ersten Arrayslice in der Renderzielansicht. Dies kann sich z. B. auf Das Rendern von Cubezuordnungen auswirken. Anwendungen sollten eine Renderzielansicht für jeden Gesichts- oder Array-Slice erstellen und dann jede Ansicht einzeln löschen.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile d3d11.h
Bibliothek D3D11.lib

Weitere Informationen

ID3D11DeviceContext