シェーダー指定ステンシル参照値 (Direct3D 12 グラフィックス)

  • [アーティクル]

API 指定の値を使用するのではなく、ピクセル シェーダーからステンシル参照値を出力できるようにすると、ステンシル操作をきめ細かく制御できます。

ステンシル参照値は通常、 ID3D12GraphicsCommandList::OMSetStencilRef メソッドによって指定されます。 このメソッドは、描画ごとの細分性にステンシル参照値を設定します。 ただし、この値はピクセル シェーダーで上書きできます。

この D3D12 (および D3D11.3) 機能を使用すると、開発者はピクセル シェーダーから出力されるステンシル参照値 (SV_StencilRef) を読み取って使用し、ピクセル単位またはサンプル単位の細分性を実現できます。

シェーダー指定の値は、その呼び出しの API で指定された参照値を置き換えます。つまり、変更はステンシル テストの両方に影響し、ステンシル操作D3D12_STENCIL_OP_REPLACE ( D3D12_STENCIL_OP の 1 つのメンバー) を使用してステンシル バッファーに参照値を書き込みます。

この機能は、D3D12 と D3D11.3 の両方で省略可能です。 そのサポートをテストするには、CheckFeatureSupport を使用して、D3D12_FEATURE_DATA_D3D12_OPTIONSの PSSpecifiedStencilRefSupported ブール値フィールドをチェックします。

ピクセル シェーダーでの SV_StencilRef の使用例を次に示します。

uint main2(float4 c : COORD) : SV_StencilRef
{
    return uint(c.x);
}

レンダリング

HLSL でのリソース バインド

シェーダー モデル 5.1

HLSL でのルート署名の指定