D3D12_DEPTH_STENCIL_DESC1-Struktur (d3d12.h)

Artikel
08/23/2023

Beschreibt den Tiefenschablonenzustand.

Syntax

typedef struct D3D12_DEPTH_STENCIL_DESC1 {
  BOOL                       DepthEnable;
  D3D12_DEPTH_WRITE_MASK     DepthWriteMask;
  D3D12_COMPARISON_FUNC      DepthFunc;
  BOOL                       StencilEnable;
  UINT8                      StencilReadMask;
  UINT8                      StencilWriteMask;
  D3D12_DEPTH_STENCILOP_DESC FrontFace;
  D3D12_DEPTH_STENCILOP_DESC BackFace;
  BOOL                       DepthBoundsTestEnable;
} D3D12_DEPTH_STENCIL_DESC1;

Member

DepthEnable

Gibt an, ob Tiefentests aktiviert werden sollen. Legen Sie dieses Element auf TRUE fest, um Tiefentests zu aktivieren.

DepthWriteMask

Ein D3D12_DEPTH_WRITE_MASK typisierter Wert, der einen Teil des Tiefenschablonenpuffers identifiziert, der durch Tiefendaten geändert werden kann.

DepthFunc

Ein D3D12_COMPARISON_FUNC typisierter Wert, der eine Funktion identifiziert, die Tiefendaten mit vorhandenen Tiefendaten vergleicht.

StencilEnable

Gibt an, ob Schablonentests aktiviert werden sollen. Legen Sie diesen Member auf TRUE fest, um Schablonentests zu aktivieren.

StencilReadMask

Identifizieren Sie einen Teil des Tiefenschablonenpuffers zum Lesen von Schablonendaten.

StencilWriteMask

Identifizieren Sie einen Teil des Tiefenschablonenpuffers zum Schreiben von Schablonendaten.

FrontFace

Eine D3D12_DEPTH_STENCILOP_DESC Struktur, die beschreibt, wie die Ergebnisse des Tiefentests und des Schablonentests für Pixel verwendet werden, deren normale Oberfläche zur Kamera ausgerichtet ist.

BackFace

DepthBoundsTestEnable

TRUE, um tiefengebundene Tests zu ermöglichen; andernfalls FALSE. Der Standardwert ist FALSE.

Hinweise

Ein D3D12_GRAPHICS_PIPELINE_STATE_DESC-Objekt enthält eine Tiefenschablonenzustandsstruktur, die steuert, wie tiefenschablonentests von der Ausgabefusionsstufe ausgeführt werden.

Diese Tabelle zeigt die Standardwerte der Tiefenschablonenzustände.

State	Standardwert
DepthEnable	true
DepthWriteMask	D3D12_DEPTH_WRITE_MASK_ALL
DepthFunc	D3D12_COMPARISON_LESS
StencilEnable	false
StencilReadMask	D3D12_DEFAULT_STENCIL_READ_MASK
StencilWriteMask	D3D12_DEFAULT_STENCIL_WRITE_MASK
FrontFace.StencilFunc und BackFace.StencilFunc	D3D12_COMPARISON_ALWAYS
FrontFace.StencilDepthFailOp und BackFace.StencilDepthFailOp	D3D12_STENCIL_OP_KEEP
FrontFace.StencilPassOp und BackFace.StencilPassOp	D3D12_STENCIL_OP_KEEP
FrontFace.StencilFailOp und BackFace.StencilFailOp	D3D12_STENCIL_OP_KEEP
DepthBoundsTestEnable	false

Die Formate, die schablonen unterstützen, sind DXGI_FORMAT_D24_UNORM_S8_UINT und DXGI_FORMAT_D32_FLOAT_S8X24_UINT.

Anforderungen

Anforderung	Wert
Header	d3d12.h

Weitere Informationen

Kernstrukturen

Freigeben über