ID3D12GraphicsCommandList1::OMSetDepthBounds-Methode (d3d12.h)
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 |