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

Confira também

Estruturas principais