struttura D3D11_DEPTH_STENCIL_DESC (d3d11.h)
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 |