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 |