estrutura D3D12_DEPTH_STENCIL_DESC1 (d3d12.h)

Descreve o estado do estêncil de profundidade.

Sintaxe

typedef struct D3D12_DEPTH_STENCIL_DESC1 {
  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;
  BOOL                       DepthBoundsTestEnable;
} D3D12_DEPTH_STENCIL_DESC1;

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.

DepthBoundsTestEnable

TRUE para habilitar o teste de limites de profundidade; caso contrário, FALSE. O valor padrão é FALSE.

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_LESS
EstêncilEnable	FALSE
StencilReadMask	D3D12_DEFAULT_STENCIL_READ_MASK
StencilWriteMask	D3D12_DEFAULT_STENCIL_WRITE_MASK
FrontFace.StencilFunc e BackFace.StencilFunc	D3D12_COMPARISON_ALWAYS
FrontFace.StencilDepthFailOp e BackFace.StencilDepthFailOp	D3D12_STENCIL_OP_KEEP
FrontFace.StencilPassOp e BackFace.StencilPassOp	D3D12_STENCIL_OP_KEEP
FrontFace.StencilFailOp e BackFace.StencilFailOp	D3D12_STENCIL_OP_KEEP
DepthBoundsTestEnable	FALSE

 

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	d3d12.h

Confira também

Estruturas principais