structure D3D12_DEPTH_STENCIL_DESC (d3d12.h)

Décrit l’état du gabarit de profondeur.

Syntaxe

typedef struct D3D12_DEPTH_STENCIL_DESC {
  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;
} D3D12_DEPTH_STENCIL_DESC;

Membres

DepthEnable

Spécifie s’il faut activer le test de profondeur. Définissez ce membre sur TRUE pour activer les tests en profondeur.

DepthWriteMask

Valeur de type D3D12_DEPTH_WRITE_MASK qui identifie une partie de la mémoire tampon de gabarit de profondeur qui peut être modifiée par les données de profondeur.

DepthFunc

Valeur de type D3D12_COMPARISON_FUNC qui identifie une fonction qui compare les données de profondeur aux données de profondeur existantes.

StencilEnable

Spécifie s’il faut activer le test de gabarit. Définissez ce membre sur TRUE pour activer le test du gabarit.

StencilReadMask

Identifiez une partie de la mémoire tampon de gabarit de profondeur pour la lecture des données de gabarit.

StencilWriteMask

Identifiez une partie de la mémoire tampon de gabarit de profondeur pour l’écriture de données de gabarit.

FrontFace

Une 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 surface normale est orientée vers l’appareil photo.

BackFace

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 surface normale est orientée loin de l’appareil photo.

Notes

Un objet D3D12_GRAPHICS_PIPELINE_STATE_DESC contient une structure profondeur-gabarit-état qui contrôle la façon dont le test de gabarit de profondeur est effectué par l’étape sortie-fusion.

Ce tableau affiche les valeurs par défaut des états de gabarit de profondeur.

State Valeur par défaut
DepthEnable TRUE
DepthWriteMask D3D12_DEPTH_WRITE_MASK_ALL
DepthFunc D3D12_COMPARISON_FUNC_LESS
StencilEnable FALSE
GabaritReadMask D3D12_DEFAULT_STENCIL_READ_MASK
StencilWriteMask D3D12_DEFAULT_STENCIL_WRITE_MASK
FrontFace.StencilFailOp

et

BackFace.StencilFailOp

D3D12_STENCIL_OP_KEEP
FrontFace.StencilDepthFailOp

et

BackFace.StencilDepthFailOp

D3D12_STENCIL_OP_KEEP
FrontFace.StencilPassOp

et

BackFace.StencilPassOp

D3D12_STENCIL_OP_KEEP
FrontFace.StencilFunc

et

BackFace.StencilFunc

D3D12_COMPARISON_FUNC_ALWAYS
 

Les formats qui prennent en charge le pochoir sont DXGI_FORMAT_D24_UNORM_S8_UINT et DXGI_FORMAT_D32_FLOAT_S8X24_UINT.

Spécifications

   
En-tête d3d12.h

Voir aussi

CD3DX12_DEPTH_STENCIL_DESC

Structures principales