D3D12_DEPTH_STENCIL_DESC1構造体 (d3d12.h)

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

構文

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;

メンバー

DepthEnable

深度テストを有効にするかどうかを指定します。 深度テストを有効にするには、このメンバーを TRUE に 設定します。

DepthWriteMask

深度データによって変更できる深度ステンシル バッファーの一部を識別する、 D3D12_DEPTH_WRITE_MASK型指定された値。

DepthFunc

深さデータと既存の深度データを比較する関数を識別するD3D12_COMPARISON_FUNC型指定の値。

StencilEnable

ステンシル テストを有効にするかどうかを指定します。 ステンシル テストを有効にするには、このメンバーを TRUE に 設定します。

StencilReadMask

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

StencilWriteMask

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

FrontFace

サーフェス法線がカメラに向いているピクセルに対して深度テストとステンシル テストの結果を使用する方法を説明する D3D12_DEPTH_STENCILOP_DESC 構造。

BackFace

サーフェス法線がカメラから離れているピクセルに対して深度テストとステンシル テストの結果を使用する方法を説明する D3D12_DEPTH_STENCILOP_DESC 構造。

DepthBoundsTestEnable

深度境界テストを有効にする場合は TRUE。それ以外の場合は FALSE。 既定値は FALSE です。

注釈

D3D12_GRAPHICS_PIPELINE_STATE_DESC オブジェクトには、出力合併ステージによる深度ステンシル テストの実行方法を制御する深度ステンシル状態構造体が含まれています。

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

状態 既定値
DepthEnable TRUE
DepthWriteMask D3D12_DEPTH_WRITE_MASK_ALL
DepthFunc D3D12_COMPARISON_LESS
StencilEnable FALSE
StencilReadMask D3D12_DEFAULT_STENCIL_READ_MASK
StencilWriteMask D3D12_DEFAULT_STENCIL_WRITE_MASK
FrontFace.StencilFunc

および

BackFace.StencilFunc

D3D12_COMPARISON_ALWAYS
FrontFace.StencilDepthFailOp

および

BackFace.StencilDepthFailOp

D3D12_STENCIL_OP_KEEP
FrontFace.StencilPassOp

および

BackFace.StencilPassOp

D3D12_STENCIL_OP_KEEP
FrontFace.StencilFailOp

および

BackFace.StencilFailOp

D3D12_STENCIL_OP_KEEP
DepthBoundsTestEnable FALSE
 

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

要件

要件
Header d3d12.h

こちらもご覧ください

コア構造