D3D11_DEPTH_STENCIL_DESC 構造体 (d3d11.h)

深度ステンシルの状態について説明します。

構文

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;

メンバー

DepthEnable

種類: BOOL

深度テストを有効にします。

DepthWriteMask

種類: D3D11_DEPTH_WRITE_MASK

深度データで変更できる深度ステンシル バッファーの一部を特定します ( 「D3D11_DEPTH_WRITE_MASK」を参照)。

DepthFunc

種類: D3D11_COMPARISON_FUNC

深度データと既存の深度データを比較する関数。 関数のオプションは、 D3D11_COMPARISON_FUNCに一覧表示されます。

StencilEnable

種類: BOOL

ステンシル テストを有効にします。

StencilReadMask

種類: UINT8

ステンシル データを読み取るための深度ステンシル バッファーの一部を特定します。

StencilWriteMask

種類: UINT8

ステンシル データを書き込む深度ステンシル バッファーの一部を特定します。

FrontFace

種類: D3D11_DEPTH_STENCILOP_DESC

深度テストの結果と、サーフェスの法線がカメラに向いているピクセルのステンシル テストの使用方法を特定します ( D3D11_DEPTH_STENCILOP_DESCを参照)。

BackFace

種類: D3D11_DEPTH_STENCILOP_DESC

サーフェス法線がカメラから離れているピクセルに対して深度テストとステンシル テストの結果を使用する方法を特定します ( 「D3D11_DEPTH_STENCILOP_DESC」を参照)。

注釈

D3D11_DEPTH_STENCIL_DESCへのポインターを ID3D11Device::CreateDepthStencilState メソッドに渡して、深度ステンシル状態オブジェクトを作成します。

深度ステンシルの状態は、出力マージャー ステージによって深度ステンシル テストを実行する方法を制御します。

次の表は、深度ステンシルの状態の既定値を示しています。

状態	既定値
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 および BackFace.StencilFunc	D3D11_COMPARISON_ALWAYS
FrontFace.StencilDepthFailOp および BackFace.StencilDepthFailOp	D3D11_STENCIL_OP_KEEP
FrontFace.StencilPassOp および BackFace.StencilPassOp	D3D11_STENCIL_OP_KEEP
FrontFace.StencilFailOp および BackFace.StencilFailOp	D3D11_STENCIL_OP_KEEP

 

ステンシルをサポートする形式は、DXGI_FORMAT_D24_UNORM_S8_UINTとDXGI_FORMAT_D32_FLOAT_S8X24_UINT。

要件

要件	値
Header	d3d11.h

こちらもご覧ください

コア構造