次の方法で共有


D3D12_DEPTH_STENCIL_DESC構造体 (d3d12.h)

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

構文

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;

メンバー

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 構造。

解説

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

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

State Default value
DepthEnable TRUE
DepthWriteMask D3D12_DEPTH_WRITE_MASK_ALL
DepthFunc D3D12_COMPARISON_FUNC_LESS
StencilEnable FALSE
StencilReadMask D3D12_DEFAULT_STENCIL_READ_MASK
StencilWriteMask D3D12_DEFAULT_STENCIL_WRITE_MASK
FrontFace.StencilFailOp

BackFace.StencilFailOp

D3D12_STENCIL_OP_KEEP
FrontFace.StencilDepthFailOp

BackFace.StencilDepthFailOp

D3D12_STENCIL_OP_KEEP
FrontFace.StencilPassOp

BackFace.StencilPassOp

D3D12_STENCIL_OP_KEEP
FrontFace.StencilFunc

BackFace.StencilFunc

D3D12_COMPARISON_FUNC_ALWAYS
 

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

要件

   
Header d3d12.h

関連項目

CD3DX12_DEPTH_STENCIL_DESC

コア構造