estrutura D3D11_DEPTH_STENCIL_DESC (d3d11.h)
Descreve o estado do estêncil de profundidade.
Sintaxe
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;
Membros
DepthEnable
Tipo: BOOL
Habilite o teste de profundidade.
DepthWriteMask
Tipo: D3D11_DEPTH_WRITE_MASK
Identifique uma parte do buffer de estêncil de profundidade que pode ser modificada por dados de profundidade (consulte D3D11_DEPTH_WRITE_MASK).
DepthFunc
Tipo: D3D11_COMPARISON_FUNC
Uma função que compara dados de profundidade com os dados de profundidade existentes. As opções de função são listadas em D3D11_COMPARISON_FUNC.
StencilEnable
Tipo: BOOL
Habilitar o teste de estêncil.
StencilReadMask
Tipo: UINT8
Identifique uma parte do buffer de estêncil de profundidade para ler dados de estêncil.
StencilWriteMask
Tipo: UINT8
Identifique uma parte do buffer de estêncil de profundidade para gravar dados de estêncil.
FrontFace
Tipo: D3D11_DEPTH_STENCILOP_DESC
Identifique como usar os resultados do teste de profundidade e o teste de estêncil para pixels cuja superfície normal esteja voltada para a câmera (consulte D3D11_DEPTH_STENCILOP_DESC).
BackFace
Tipo: D3D11_DEPTH_STENCILOP_DESC
Identifique como usar os resultados do teste de profundidade e o teste de estêncil para pixels cuja superfície normal esteja voltada para longe da câmera (consulte D3D11_DEPTH_STENCILOP_DESC).
Comentários
Passe um ponteiro para D3D11_DEPTH_STENCIL_DESC para o método ID3D11Device::CreateDepthStencilState para criar o objeto de estado de estêncil de profundidade.
O estado de estêncil de profundidade controla como o teste de estêncil de profundidade é executado pelo estágio de fusão de saída.
A tabela a seguir mostra os valores padrão dos estados de estêncil de profundidade.
| Estado | Valor padrão |
|---|---|
| DepthEnable | TRUE |
| DepthWriteMask | D3D11_DEPTH_WRITE_MASK_ALL |
| DepthFunc | D3D11_COMPARISON_LESS |
| EstêncilEnable | 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 |
Os formatos que dão suporte ao estêncil são DXGI_FORMAT_D24_UNORM_S8_UINT e DXGI_FORMAT_D32_FLOAT_S8X24_UINT.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | d3d11.h |