ID3D12GraphicsCommandList1::OMSetDepthBounds-Methode (d3d12.h)

  • Artikel

Mit dieser Methode können Sie die Tiefengrenzen dynamisch ändern.

Syntax

void OMSetDepthBounds(
  [in] FLOAT Min,
  [in] FLOAT Max
);

Parameter

[in] Min

Typ: FLOAT

SAL: In

Gibt die Mindesttiefengrenzen an. Der Standardwert ist 0. NaN-Werte werden automatisch in 0 konvertiert.

[in] Max

Typ: FLOAT

SAL: In

Gibt die maximalen Tiefengrenzen an. Der Standardwert ist 1. NaN-Werte werden automatisch in 0 konvertiert.

Rückgabewert

Keine

Bemerkungen

Tiefengrenzentests ermöglichen das Verwerfen von Pixeln und Beispielen, wenn sich der aktuell gespeicherte Tiefenwert außerhalb des durch Min und Max angegebenen Bereichs (einschließlich Min ) und Max befindet. Wenn sich der aktuell gespeicherte Tiefenwert des Pixels oder Der Stichprobe in diesem Bereich befindet, wird der Test für die Tiefengrenze bestanden und gerendert. Andernfalls schlägt der Tiefengrenzentest fehl, und das Pixel oder Beispiel wird verworfen. Beachten Sie, dass der Tiefengrenzentest den aktuell gespeicherten Tiefenwert berücksichtigt, nicht den tiefen Wert, der vom ausführenden Pixel-Shader generiert wird.

Um tiefengebundene Tests zu verwenden, muss die Anwendung die neue CreatePipelineState-Methode verwenden, um tiefengebundene Tests auf dem PSO zu ermöglichen, und kann dann diese Befehlslistenmethode verwenden, um die Tiefengrenzen dynamisch zu ändern.

OMSetDepthBounds ist ein optionales Feature. Verwenden Sie die CheckFeatureSupport-Methode , um zu bestimmen, ob dieses Feature vom Benutzermodustreiber unterstützt wird. Die Unterstützung für dieses Feature wird über die D3D12_FEATURE_D3D12_OPTIONS2-Struktur gemeldet.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile d3d12.h
Bibliothek D3d12.lib
DLL D3d12.dll

Weitere Informationen

ID3D12GraphicsCommandList1