estructura de D3D12_DEPTH_STENCIL_DESC1 (d3d12.h)
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 |