D3D12_DEPTH_STENCIL_DESC1-Struktur (d3d12.h)

  • Artikel

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

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 von der Kamera abgewandt ist.

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