estructura de D3D12_DEPTH_STENCIL_DESC1 (d3d12.h)

  • Artículo

Describe el estado de la galería de símbolos de profundidad.

Sintaxis

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;

Miembros

DepthEnable

Especifica si se van a habilitar las pruebas de profundidad. Establezca este miembro en TRUE para habilitar las pruebas de profundidad.

DepthWriteMask

Valor D3D12_DEPTH_WRITE_MASK con tipo que identifica una parte del búfer de galería de símbolos de profundidad que se puede modificar mediante datos de profundidad.

DepthFunc

Valor D3D12_COMPARISON_FUNC con tipo que identifica una función que compara los datos de profundidad con los datos de profundidad existentes.

StencilEnable

Especifica si se van a habilitar las pruebas de galería de símbolos. Establezca este miembro en TRUE para habilitar las pruebas de galería de símbolos.

StencilReadMask

Identifique una parte del búfer de galería de símbolos de profundidad para leer los datos de la galería de símbolos.

StencilWriteMask

Identifique una parte del búfer de galería de símbolos de profundidad para escribir datos de galería de símbolos.

FrontFace

Estructura D3D12_DEPTH_STENCILOP_DESC que describe cómo usar los resultados de la prueba de profundidad y la prueba de galería de símbolos para píxeles cuya superficie normal está orientada hacia la cámara.

BackFace

Estructura D3D12_DEPTH_STENCILOP_DESC que describe cómo usar los resultados de la prueba de profundidad y la prueba de galería de símbolos para píxeles cuya superficie normal está orientada lejos de la cámara.

DepthBoundsTestEnable

TRUE para habilitar las pruebas de límites de profundidad; de lo contrario, FALSE. El valor predeterminado es FALSE.

Comentarios

Un objeto D3D12_GRAPHICS_PIPELINE_STATE_DESC contiene una estructura de estado de galería de símbolos de profundidad que controla cómo la fase de fusión de salida realiza las pruebas de galería de símbolos de profundidad.

En esta tabla se muestran los valores predeterminados de estados de galería de símbolos de profundidad.

State Valor predeterminado
DepthEnable TRUE
DepthWriteMask D3D12_DEPTH_WRITE_MASK_ALL
DepthFunc D3D12_COMPARISON_LESS
Galería de símbolosEnable FALSE
Galería de símbolosReadMask D3D12_DEFAULT_STENCIL_READ_MASK
Galería de símbolosWriteMask D3D12_DEFAULT_STENCIL_WRITE_MASK
FrontFace.StencilFunc

y

BackFace.StencilFunc

 D3D12_COMPARISON_ALWAYS
FrontFace.StencilDepthFailOp

y

BackFace.StencilDepthFailOp

 D3D12_STENCIL_OP_KEEP
FrontFace.StencilPassOp

y

BackFace.StencilPassOp

 D3D12_STENCIL_OP_KEEP
FrontFace.StencilFailOp

y

BackFace.StencilFailOp

 D3D12_STENCIL_OP_KEEP
DepthBoundsTestEnable FALSE
 

Los formatos que admiten la galería de símbolos se DXGI_FORMAT_D24_UNORM_S8_UINT y DXGI_FORMAT_D32_FLOAT_S8X24_UINT.

Requisitos

Requisito Valor
Header d3d12.h

Consulte también

Estructuras principales