struttura D3D11_DEPTH_STENCIL_DESC (d3d11.h)

Articolo
08/22/2023

Descrive lo stato depth-stencil.

Sintassi

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;

Members

DepthEnable

Tipo: BOOL

Abilitare il test di profondità.

DepthWriteMask

Tipo: D3D11_DEPTH_WRITE_MASK

Identificare una parte del buffer depth-stencil che può essere modificato dai dati di profondità (vedere D3D11_DEPTH_WRITE_MASK).

DepthFunc

Tipo: D3D11_COMPARISON_FUNC

Funzione che confronta i dati di profondità con i dati di profondità esistenti. Le opzioni della funzione sono elencate in D3D11_COMPARISON_FUNC.

StencilEnable

Tipo: BOOL

Abilitare il test degli stencil.

StencilReadMask

Tipo: UINT8

Identificare una parte del buffer depth-stencil per la lettura dei dati degli stencil.

StencilWriteMask

Tipo: UINT8

Identificare una parte del buffer depth-stencil per la scrittura dei dati degli stencil.

FrontFace

Tipo: D3D11_DEPTH_STENCILOP_DESC

Identificare come usare i risultati del test di profondità e il test degli stencil per i pixel la cui normale superficie è rivolta verso la fotocamera (vedere D3D11_DEPTH_STENCILOP_DESC).

BackFace

Tipo: D3D11_DEPTH_STENCILOP_DESC

Identificare come usare i risultati del test di profondità e il test degli stencil per i pixel la cui normale superficie è rivolta lontano dalla fotocamera (vedere D3D11_DEPTH_STENCILOP_DESC).

Commenti

Passare un puntatore a D3D11_DEPTH_STENCIL_DESC al metodo ID3D11Device::CreateDepthStencilState per creare l'oggetto stato depth-stencil.

Lo stato depth-stencil controlla il modo in cui il test depth-stencil viene eseguito dalla fase di fusione dell'output.

La tabella seguente mostra i valori predefiniti degli stati depth-stencil.

State	Valore predefinito
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 e BackFace.StencilFunc	D3D11_COMPARISON_ALWAYS
FrontFace.StencilDepthFailOp e BackFace.StencilDepthFailOp	D3D11_STENCIL_OP_KEEP
FrontFace.StencilPassOp e BackFace.StencilPassOp	D3D11_STENCIL_OP_KEEP
FrontFace.StencilFailOp e BackFace.StencilFailOp	D3D11_STENCIL_OP_KEEP

I formati che supportano lo stenciling sono DXGI_FORMAT_D24_UNORM_S8_UINT e DXGI_FORMAT_D32_FLOAT_S8X24_UINT.

Requisiti

Requisito	Valore
Intestazione	d3d11.h

Vedi anche

Strutture principali