D3D11_DEPTH_STENCIL_DESC-Struktur (d3d11.h)

Artikel
02/24/2024

Beschreibt den Tiefenschablonenzustand.

Syntax

typedef struct D3D11_DEPTH_STENCIL_DESC {
  BOOL                       DepthEnable;
  D3D11_DEPTH_WRITE_MASK     DepthWriteMask;
  D3D11_COMPARISON_FUNC      DepthFunc;
  BOOL                       StencilEnable;
  UINT8                      StencilReadMask;
  UINT8                      StencilWriteMask;
  D3D11_DEPTH_STENCILOP_DESC FrontFace;
  D3D11_DEPTH_STENCILOP_DESC BackFace;
} D3D11_DEPTH_STENCIL_DESC;

Member

DepthEnable

Typ: BOOL

Aktivieren Sie Tiefentests.

DepthWriteMask

Typ: D3D11_DEPTH_WRITE_MASK

Identifizieren Sie einen Teil des Tiefenschablonenpuffers, der durch Tiefendaten geändert werden kann (siehe D3D11_DEPTH_WRITE_MASK).

DepthFunc

Typ: D3D11_COMPARISON_FUNC

Eine Funktion, die Tiefendaten mit vorhandenen Tiefendaten vergleicht. Die Funktionsoptionen sind in D3D11_COMPARISON_FUNC aufgeführt.

StencilEnable

Typ: BOOL

Schablonentests aktivieren.

StencilReadMask

Typ: UINT8

Identifizieren Sie einen Teil des Tiefenschablonenpuffers zum Lesen von Schablonendaten.

StencilWriteMask

Typ: UINT8

Identifizieren Sie einen Teil des Tiefenschablonenpuffers zum Schreiben von Schablonendaten.

FrontFace

Typ: D3D11_DEPTH_STENCILOP_DESC

Identifizieren Sie, wie die Ergebnisse des Tiefentests und des Schablonentests für Pixel verwendet werden, deren Normale Oberfläche der Kamera zugewandt ist (siehe D3D11_DEPTH_STENCILOP_DESC).

BackFace

Typ: D3D11_DEPTH_STENCILOP_DESC

Identifizieren Sie, wie die Ergebnisse des Tiefentests und des Schablonentests für Pixel verwendet werden, deren Normale Oberfläche von der Kamera abgewandt ist (siehe D3D11_DEPTH_STENCILOP_DESC).

Hinweise

Übergeben Sie einen Zeiger auf D3D11_DEPTH_STENCIL_DESC an die ID3D11Device::CreateDepthStencilState-Methode , um das Tiefenschablonenzustandsobjekt zu erstellen.

Der Tiefenschablonenzustand steuert, wie tiefenschablonentests von der Output-Merger-Phase durchgeführt werden.

In der folgenden Tabelle sind die Standardwerte der Tiefenschablonenzustände aufgeführt.

State	Standardwert
DepthEnable	true
DepthWriteMask	D3D11_DEPTH_WRITE_MASK_ALL
DepthFunc	D3D11_COMPARISON_LESS
StencilEnable	FALSE
StencilReadMask	D3D11_DEFAULT_STENCIL_READ_MASK
StencilWriteMask	D3D11_DEFAULT_STENCIL_WRITE_MASK
FrontFace.StencilFunc und BackFace.StencilFunc	D3D11_COMPARISON_ALWAYS
FrontFace.StencilDepthFailOp und BackFace.StencilDepthFailOp	D3D11_STENCIL_OP_KEEP
FrontFace.StencilPassOp und BackFace.StencilPassOp	D3D11_STENCIL_OP_KEEP
FrontFace.StencilFailOp und BackFace.StencilFailOp	D3D11_STENCIL_OP_KEEP

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

Anforderungen

Anforderung	Wert
Header	d3d11.h

Weitere Informationen

Kernstrukturen

Freigeben über