Passer au contenu principal
Décrit l’état de profondeur-gabarit.

Syntaxe

Membres

DepthEnable
Type : BOOL
Spécifie s’il faut activer le test de profondeur. Définissez ce membre à TRUE pour activer le test de profondeur. DepthWriteMask
Type : D3D12_DEPTH_WRITE_MASK
Valeur de type D3D12_DEPTH_WRITE_MASK qui identifie une partie du tampon de profondeur-gabarit pouvant être modifiée par les données de profondeur. DepthFunc
Type : D3D12_COMPARISON_FUNC
Valeur de type D3D12_COMPARISON_FUNC qui identifie une fonction qui compare les données de profondeur aux données de profondeur existantes. StencilEnable
Type : BOOL
Spécifie s’il faut activer le test de gabarit. Définissez ce membre à TRUE pour activer le test de gabarit. StencilReadMask
Type : UINT8
Identifie une partie du tampon de profondeur-gabarit pour la lecture des données de gabarit. StencilWriteMask
Type : UINT8
Identifie une partie du tampon de profondeur-gabarit pour l’écriture des données de gabarit. FrontFace
Type : D3D12_DEPTH_STENCILOP_DESC
Structure D3D12_DEPTH_STENCILOP_DESC qui décrit comment utiliser les résultats du test de profondeur et du test de gabarit pour les pixels dont la normale de surface est orientée vers la caméra. BackFace
Type : D3D12_DEPTH_STENCILOP_DESC
Structure D3D12_DEPTH_STENCILOP_DESC qui décrit comment utiliser les résultats du test de profondeur et du test de gabarit pour les pixels dont la normale de surface est orientée dans la direction opposée à la caméra. DepthBoundsTestEnable
Type : BOOL
TRUE pour activer le test des limites de profondeur; sinon, FALSE. La valeur par défaut est FALSE.

Remarques

Un objet D3D12_GRAPHICS_PIPELINE_STATE_DESC contient une structure d’état de profondeur-gabarit qui contrôle la façon dont le test de profondeur-gabarit est effectué par l’étape de fusion de sortie. Ce tableau présente les valeurs par défaut des états de profondeur-gabarit.
ÉtatValeur par défaut
DepthEnableTRUE
DepthWriteMaskD3D12_DEPTH_WRITE_MASK_ALL
DepthFuncD3D12_COMPARISON_LESS
StencilEnableFALSE
StencilReadMaskD3D12_DEFAULT_STENCIL_READ_MASK
StencilWriteMaskD3D12_DEFAULT_STENCIL_WRITE_MASK
FrontFace.StencilFuncetBackFace.StencilFuncD3D12_COMPARISON_ALWAYS
FrontFace.StencilDepthFailOpetBackFace.StencilDepthFailOpD3D12_STENCIL_OP_KEEP
FrontFace.StencilPassOpetBackFace.StencilPassOpD3D12_STENCIL_OP_KEEP
FrontFace.StencilFailOpetBackFace.StencilFailOpD3D12_STENCIL_OP_KEEP
DepthBoundsTestEnableFALSE
Les formats qui prennent en charge le gabarit sont DXGI_FORMAT_D24_UNORM_S8_UINT et DXGI_FORMAT_D32_FLOAT_S8X24_UINT.

Configuration requise

En-tête : d3d12_xs.h ou d3d12_x.h
Bibliothèque : d3d12_xs.lib ou d3d12_x.lib
Plateformes prises en charge : consoles XBOX Series et famille XBOX One

Voir aussi

Structures de base
Dernière modification le 6 octobre 2026