Compartilhar via


estrutura D3D12_DEPTH_STENCIL_DESC (d3d12.h)

Descreve o estado do estêncil de profundidade.

Sintaxe

typedef struct D3D12_DEPTH_STENCIL_DESC {
  BOOL                       DepthEnable;
  D3D12_DEPTH_WRITE_MASK     DepthWriteMask;
  D3D12_COMPARISON_FUNC      DepthFunc;
  BOOL                       StencilEnable;
  UINT8                      StencilReadMask;
  UINT8                      StencilWriteMask;
  D3D12_DEPTH_STENCILOP_DESC FrontFace;
  D3D12_DEPTH_STENCILOP_DESC BackFace;
} D3D12_DEPTH_STENCIL_DESC;

Membros

DepthEnable

Especifica se o teste de profundidade deve ser habilitado. Defina esse membro como TRUE para habilitar o teste de profundidade.

DepthWriteMask

Um valor do tipo D3D12_DEPTH_WRITE_MASK que identifica uma parte do buffer de estêncil de profundidade que pode ser modificada por dados de profundidade.

DepthFunc

Um valor de tipo D3D12_COMPARISON_FUNC que identifica uma função que compara dados de profundidade com os dados de profundidade existentes.

StencilEnable

Especifica se o teste de estêncil deve ser habilitado. Defina esse membro como TRUE para habilitar o teste de estêncil.

StencilReadMask

Identifique uma parte do buffer de estêncil de profundidade para ler dados de estêncil.

StencilWriteMask

Identifique uma parte do buffer de estêncil de profundidade para gravar dados de estêncil.

FrontFace

Uma estrutura D3D12_DEPTH_STENCILOP_DESC que descreve como usar os resultados do teste de profundidade e o teste de estêncil para pixels cuja superfície normal está voltada para a câmera.

BackFace

Uma estrutura D3D12_DEPTH_STENCILOP_DESC que descreve como usar os resultados do teste de profundidade e o teste de estêncil para pixels cuja superfície normal está voltada para longe da câmera.

Comentários

Um objeto D3D12_GRAPHICS_PIPELINE_STATE_DESC contém uma estrutura de estado de estêncil de profundidade que controla como o teste de estêncil de profundidade é executado pelo estágio de fusão de saída.

Esta tabela mostra os valores padrão dos estados de estêncil de profundidade.

Estado Valor padrão
DepthEnable TRUE
DepthWriteMask D3D12_DEPTH_WRITE_MASK_ALL
DepthFunc D3D12_COMPARISON_FUNC_LESS
StencilEnable FALSE
StencilReadMask D3D12_DEFAULT_STENCIL_READ_MASK
StencilWriteMask D3D12_DEFAULT_STENCIL_WRITE_MASK
FrontFace.StencilFailOp

e

BackFace.StencilFailOp

D3D12_STENCIL_OP_KEEP
FrontFace.StencilDepthFailOp

e

BackFace.StencilDepthFailOp

D3D12_STENCIL_OP_KEEP
FrontFace.StencilPassOp

e

BackFace.StencilPassOp

D3D12_STENCIL_OP_KEEP
FrontFace.StencilFunc

e

BackFace.StencilFunc

D3D12_COMPARISON_FUNC_ALWAYS
 

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

   
Cabeçalho d3d12.h

Confira também

CD3DX12_DEPTH_STENCIL_DESC

Estruturas principais