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 |