Freigeben über


D3D12_DEPTH_STENCIL_DESC-Struktur (d3d12.h)

Beschreibt den Tiefenschablonenzustand.

Syntax

typedef struct D3D12_DEPTH_STENCIL_DESC {
  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;
} D3D12_DEPTH_STENCIL_DESC;

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.

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_FUNC_LESS
StencilEnable false
StencilReadMask D3D12_DEFAULT_STENCIL_READ_MASK
StencilWriteMask D3D12_DEFAULT_STENCIL_WRITE_MASK
FrontFace.StencilFailOp

und

BackFace.StencilFailOp

D3D12_STENCIL_OP_KEEP
FrontFace.StencilDepthFailOp

und

BackFace.StencilDepthFailOp

D3D12_STENCIL_OP_KEEP
FrontFace.StencilPassOp

und

BackFace.StencilPassOp

D3D12_STENCIL_OP_KEEP
FrontFace.StencilFunc

und

BackFace.StencilFunc

D3D12_COMPARISON_FUNC_ALWAYS
 

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

Anforderungen

   
Kopfzeile d3d12.h

Weitere Informationen

CD3DX12_DEPTH_STENCIL_DESC

Kernstrukturen