D3D11_DEPTH_STENCIL_DESC structure (d3d11.h)

Article
08/22/2023

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

Syntaxe

typedef struct D3D11_DEPTH_STENCIL_DESC {
  BOOL                       DepthEnable;
  D3D11_DEPTH_WRITE_MASK     DepthWriteMask;
  D3D11_COMPARISON_FUNC      DepthFunc;
  BOOL                       StencilEnable;
  UINT8                      StencilReadMask;
  UINT8                      StencilWriteMask;
  D3D11_DEPTH_STENCILOP_DESC FrontFace;
  D3D11_DEPTH_STENCILOP_DESC BackFace;
} D3D11_DEPTH_STENCIL_DESC;

Membres

DepthEnable

Type : BOOL

Activez les tests de profondeur.

DepthWriteMask

Type : D3D11_DEPTH_WRITE_MASK

Identifiez une partie de la mémoire tampon de gabarit de profondeur qui peut être modifiée par les données de profondeur (voir D3D11_DEPTH_WRITE_MASK).

DepthFunc

Type : D3D11_COMPARISON_FUNC

Fonction qui compare les données de profondeur aux données de profondeur existantes. Les options de fonction sont répertoriées dans D3D11_COMPARISON_FUNC.

StencilEnable

Type : BOOL

Activez le test de gabarit.

StencilReadMask

Type : UINT8

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

StencilWriteMask

Type : UINT8

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

FrontFace

Type : D3D11_DEPTH_STENCILOP_DESC

Identifiez 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 la caméra (voir D3D11_DEPTH_STENCILOP_DESC).

BackFace

Type : D3D11_DEPTH_STENCILOP_DESC

Identifiez comment utiliser les résultats du test de profondeur et du test de gabarit pour les pixels dont la surface normale est exposée loin de la caméra (voir D3D11_DEPTH_STENCILOP_DESC).

Remarques

Passez un pointeur vers D3D11_DEPTH_STENCIL_DESC à la méthode ID3D11Device ::CreateDepthStencilState pour créer l’objet d’état depth-stencil.

L’état profondeur-gabarit contrôle la façon dont le test de profondeur-gabarit est effectué par l’étape de fusion de sortie.

Le tableau suivant montre les valeurs par défaut des états de profondeur-gabarit.

State	Valeur par défaut
DepthEnable	TRUE
DepthWriteMask	D3D11_DEPTH_WRITE_MASK_ALL
DepthFunc	D3D11_COMPARISON_LESS
StencilEnable	FALSE
StencilReadMask	D3D11_DEFAULT_STENCIL_READ_MASK
StencilWriteMask	D3D11_DEFAULT_STENCIL_WRITE_MASK
FrontFace.StencilFunc et BackFace.StencilFunc	D3D11_COMPARISON_ALWAYS
FrontFace.StencilDepthFailOp et BackFace.StencilDepthFailOp	D3D11_STENCIL_OP_KEEP
FrontFace.StencilPassOp et BackFace.StencilPassOp	D3D11_STENCIL_OP_KEEP
FrontFace.StencilFailOp et BackFace.StencilFailOp	D3D11_STENCIL_OP_KEEP

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	d3d11.h

Voir aussi

Structures principales