structure D3D12_DEPTH_STENCIL_DESC1 (d3d12.h)

Article
03/01/2024

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

Syntaxe

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;

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.

DepthBoundsTestEnable

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 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_LESS
StencilEnable	FALSE
GabaritReadMask	D3D12_DEFAULT_STENCIL_READ_MASK
StencilWriteMask	D3D12_DEFAULT_STENCIL_WRITE_MASK
FrontFace.StencilFunc et BackFace.StencilFunc	D3D12_COMPARISON_ALWAYS
FrontFace.StencilDepthFailOp et BackFace.StencilDepthFailOp	D3D12_STENCIL_OP_KEEP
FrontFace.StencilPassOp et BackFace.StencilPassOp	D3D12_STENCIL_OP_KEEP
FrontFace.StencilFailOp et BackFace.StencilFailOp	D3D12_STENCIL_OP_KEEP
DepthBoundsTestEnable	FALSE

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

Configuration requise

Condition requise	Valeur
En-tête	d3d12.h

Voir aussi

Structures principales

Partager via