ID3D12GraphicsCommandList1

レンダリング用のグラフィックスコマンドのリストをカプセル化します。インターフェイスを拡張し、プログラマブルなサンプル位置、レイトラッチ技法を実装するためのアトミックコピー、およびオプションの深度境界テストをサポートします。

UINT 型のプライマリデータ要素を、オプションの依存リソースとともに、あるリソースから別のリソースへアトミックにコピーします。

このメソッドは通常、通常のレンダリングパイプラインのレイテンシーがユーザー体験を損なう可能性のあるリソースを更新するために使用します。たとえばアプリケーションは、最新のユーザー入力 (ヘッドマウントディスプレイのセンサーなど) からビュー行列を計算し、この関数を使用して、すでに GPU にディスパッチ済みのコマンドリスト内でその行列を更新・反映させることで、入力からレンダリングまでの体感レイテンシーを削減できます。

UINT64 型のプライマリデータ要素を、オプションの依存リソースとともに、あるリソースから別のリソースへアトミックにコピーします。

このメソッドは通常、通常のレンダリングパイプラインのレイテンシーがユーザー体験を損なう可能性のあるリソースを更新するために使用します。たとえばアプリケーションは、最新のユーザー入力 (ヘッドマウントディスプレイのセンサーなど) からビュー行列を計算し、この関数を使用して、すでに GPU にディスパッチ済みのコマンドリスト内でその行列を更新・反映させることで、入力からレンダリングまでの体感レイテンシーを削減できます。

このメソッドを使用すると、深度境界 (depth bounds) を動的に変更できます。

深度境界テストでは、現在格納されている深度値が Min と Max で指定された範囲 (両端を含む) の外にある場合に、ピクセルやサンプルを破棄できます。ピクセルまたはサンプルの現在格納されている深度値がこの範囲内にある場合は深度境界テストに合格し、レンダリングされます。そうでない場合は深度境界テストに失敗し、ピクセルまたはサンプルは破棄されます。なお、深度境界テストが参照するのは現在格納されている深度値であり、実行中のピクセルシェーダーが生成する深度値ではありません。

深度境界テストを使用するには、アプリケーションは新しい CreatePipelineState メソッドを使用して PSO 上で深度境界テストを有効にする必要があります。その後、このコマンドリストのメソッドを使用して深度境界を動的に変更できます。

OMSetDepthBounds はオプション機能です。この機能がユーザーモードドライバーでサポートされているかどうかを判定するには、CheckFeatureSupport メソッドを使用します。この機能のサポート状況は D3D12_FEATURE_D3D12_OPTIONS2 構造体を通じて報告されます。

このメソッドは、後続の描画、コピー、リゾルブなどの操作で使用されるサンプル位置を構成します。

サンプル位置の動作上の意味は、発生しうる各種の描画、コピー、リゾルブなどの操作によって決まります。

CommandList: CommandList 内で SetSamplePositions が一度も呼び出されていない場合、サンプルはパイプラインステートオブジェクト (PSO) に基づく既定の位置になります。既定の位置は、PSO の SAMPLE_DESC 部分が存在すればそれによって決まり、PSO の RASTERIZER_DESC 部分の ForcedSampleCount が 0 より大きい値に設定されている場合は標準サンプル位置によって決まります。

SetSamplePosition を呼び出した後の描画呼び出しでは、PSO の SAMPLE_DESC 部分または RASTERIZER_DESC 部分の ForcedSampleCount のいずれかによって、一致するサンプル数を指定した PSO を使用する必要があります。

SetSamplePositions はグラフィックス CommandList でのみ呼び出せます。バンドル内では呼び出せません。バンドルはサンプル位置の状態を呼び出し元の CommandList から継承し、それを変更しません。

SetSamplePositions(0, 0, NULL) を呼び出すと、サンプル位置は既定値に戻ります。

Clear RenderTarget: レンダーターゲットをクリアする際、サンプル位置は無視されます。

Clear DepthStencil: 深度ステンシルサーフェスの深度部分またはその任意の領域をクリアする場合、サンプル位置は、クリアしたサーフェスまたは領域に対する今後のレンダリングで使用するものと一致するように設定する必要があります。異なるサンプル位置で生成された未クリア領域の内容は未定義になります。

深度ステンシルサーフェスのステンシル部分またはその任意の領域をクリアする場合、サンプル位置は無視されます。

Draw to RenderTarget: レンダーターゲットに描画する場合、以前の描画呼び出しと重なる領域に描画する場合であっても、描画呼び出しごとにサンプル位置を変更できます。現在のサンプル位置が各描画呼び出しの動作上の意味を決定し、サンプルはレンダーターゲットに格納された内容から取得されます。これはその内容が異なるサンプル位置で生成されていた場合でも同様です。

Draw using DepthStencil: 深度ステンシルサーフェスまたはその任意の領域に対して描画 (読み取りまたは書き込み) する場合、サンプル位置は、対象領域を以前クリアした際に使用したものと一致するように設定する必要があります。異なるサンプル位置を使用するには、まず対象領域をクリアする必要があります。クリア領域外のピクセルは影響を受けません。

ハードウェアは深度ステンシルサーフェスの深度部分を平面方程式として格納し、アプリケーションが読み取りを発行した際にそれを評価して深度値を生成する場合があります。プログラマブルなサンプル位置を深度ステンシルサーフェスの深度部分に対してサポートする必要があるのは、ラスタライザーと出力マージャーのみです。サンプル位置を設定してレンダリングされた深度部分に対するそれ以外の読み取りや書き込みは、それらを無視して標準の位置でサンプリングする場合があります。

Resolve RenderTarget: レンダーターゲットまたはその任意の領域をリゾルブする場合、サンプル位置は無視されます。これらの API は格納済みのカラー値に対してのみ動作します。

Resolve DepthStencil: 深度ステンシルサーフェスの深度部分またはその任意の領域をリゾルブする場合、サンプル位置は、リゾルブ対象のサーフェスまたは領域に対する過去のレンダリングで使用したものと一致するように設定する必要があります。異なるサンプル位置を使用するには、まず対象領域をクリアする必要があります。

深度ステンシルサーフェスのステンシル部分またはその任意の領域をリゾルブする場合、サンプル位置は無視されます。ステンシルのリゾルブは格納済みのステンシル値に対してのみ動作します。

Copy RenderTarget: レンダーターゲットからコピーする場合、全体コピーか部分コピーかにかかわらずサンプル位置は無視されます。

Copy DepthStencil (Full Subresource): 深度ステンシルサーフェスからサブリソース全体をコピーする場合、サンプル位置は、コピー元サーフェスを生成する際に使用したサンプル位置と一致するように設定する必要があります。異なるサンプル位置を使用するには、まず対象領域をクリアする必要があります。

一部のハードウェアでは、コピー元サーフェスのプロパティ (深度値の平面方程式の格納など) がコピー先に転送されます。そのため、コピー先サーフェスに後から描画する場合は、コピー元の内容を生成する際に使用したサンプル位置をコピー先サーフェスでも使用する必要があります。API は一貫性のため、一部のハードウェアにしか当てはまらない場合であっても、すべてのハードウェアでこれを要求します。

Copy DepthStencil (Partial Subresource): 深度ステンシルサーフェスからサブリソースの一部をコピーする場合も、サブリソース全体のコピーと同様に、サンプル位置は、コピー元サーフェスを生成する際に使用したサンプル位置と一致するように設定する必要があります。ただし、影響を受けるコピー先サブリソースの内容がコピーによって部分的にしかカバーされない場合、それらのサブリソース内のカバーされない部分の内容は、そのすべてがコピー元と同じサンプル位置で生成されていない限り未定義になります。異なるサンプル位置を使用するには、まず対象領域をクリアする必要があります。

深度ステンシルサーフェスのステンシル部分からサブリソースの一部をコピーする場合、サンプル位置は無視されます。コピーでカバーされないコピー先バッファーの他の領域の内容を生成する際にどのサンプル位置が使用されたかは問題になりません。それらの内容は有効なまま保たれます。

Shader SamplePos: HLSL の SamplePos 組み込み関数はプログラマブルなサンプル位置を認識しません。プログラマブルな位置でレンダリングされたサーフェスに対してこれを呼び出したシェーダーに返される結果は未定義です。必要な場合、アプリケーションは座標を手動でシェーダーに渡す必要があります。同様に、サンプルインデックスによる属性の評価もプログラマブルなサンプル位置では未定義です。

DEPTH_READ または DEPTH_WRITE 状態からの遷移: DEPTH_READ または DEPTH_WRITE 状態のサブリソースが、COPY_SOURCE や RESOLVE_SOURCE を含む他の任意の状態に遷移する場合、一部のハードウェアではサーフェスの展開 (デコンプレス) が必要になることがあります。そのため、コマンドリスト上のサンプル位置は、コピー元サーフェスの内容を生成する際に使用したものと一致するように設定する必要があります。さらに、同じ深度データがそのサーフェスに残っている間の以降のあらゆる遷移においても、サンプル位置はコマンドリストに設定されたものと一致し続ける必要があります。異なるサンプル位置を使用するには、まず対象領域をクリアする必要があります。

一部だけを使用する場合に展開される領域を最小化したい、あるいは単に圧縮を維持したい場合、アプリケーションは矩形を指定して DECOMPRESS モードで ResolveSubresourceRegion() を呼び出せます。これにより、関連する領域だけが別のリソースに展開され、一部のハードウェアではコピー元はそのまま維持されます (ただし他のハードウェアではコピー元の領域も展開されます)。明示的に展開された別リソースは、その後、目的の状態 (SHADER_RESOURCE など) に遷移させることができます。

RENDER_TARGET 状態からの遷移: RENDER_TARGET 状態のサブリソースが COPY_SOURCE または RESOLVE_SOURCE 以外の状態に遷移する場合、一部の実装ではサーフェスの展開が必要になることがあります。この展開はサンプル位置に依存しません。

一部だけを使用する場合に展開される領域を最小化したい、あるいは単に圧縮を維持したい場合、アプリケーションは矩形を指定して DECOMPRESS モードで ResolveSubresourceRegion() を呼び出せます。これにより、関連する領域だけが別のリソースに展開され、一部のハードウェアではコピー元はそのまま維持されます (ただし他のハードウェアではコピー元の領域も展開されます)。明示的に展開された別リソースは、その後、目的の状態 (SHADER_RESOURCE など) に遷移させることができます。

マルチサンプリングされた、または圧縮されたリソースの領域を、マルチサンプリングされていない、または圧縮されていないリソースにコピーします。

ResolveSubresourceRegion は ResolveSubresource と同様に動作しますが、リソースの一部のみをリゾルブしたり、コピー元サンプルを複数の方法でリゾルブしたりできます。部分的なリゾルブはマルチアダプターのシナリオで有用です。たとえばレンダリング領域を複数のアダプターに分割している場合、各アダプターは自身に割り当てられた区画に対応するサブリソースの部分のみをリゾルブすれば済みます。

後続の描画で有効になるビューインスタンスを制御するマスクを設定します。

ビューインスタンスマスクは、作成時に D3D12_VIEW_INSTANCING_FLAG_ENABLE_VIEW_INSTANCE_MASKING フラグを指定してビューインスタンスマスキングを宣言した PSO にのみ影響します。ビューインスタンシングをサポートしていないアダプターでは、ビューインスタンスマスキングを宣言する PSO の作成は失敗します。

ビューインスタンスマスクの既定値は 0 で、すべてのビューが無効になります。これにより、ビューインスタンスマスキングを宣言するアプリケーションは有効にするビューを明示的に選択せざるを得なくなります。そうしなければ何もレンダリングされません。仮にビューインスタンスマスクが既定ですべてのビューを有効にしていた場合、アプリケーションは未使用のビューを無効にし忘れ、無駄な処理によってパフォーマンスを損なうおそれがあります。

バンドルは呼び出し元からビューインスタンスマスクを継承せず、既定値の 0 になります。これは、実装が描画を記録する方法にマスク設定が影響する場合、バンドルの記録時にその設定が判明している必要があるためです。ただし、バンドルが設定したビューインスタンスマスクは、バンドル完了後も呼び出し元に持続します。この継承のセマンティクスは PSO のものと似ています。

マスクによって無効化されたビューインスタンスについては、SV_ViewID に依存するシェーダーコードパスはどのシェーダーステージでも実行されず、クリッピング、ビューポート処理、ラスタライズも行われません。レンダリング中にマスクを検査する実装では、ビューインスタンスマスキングをまったく宣言しない PSO と比べてわずかなパフォーマンス上のペナルティが生じることがありますが、通常はマスクで無効化されたビューに関連する処理を省略することによるパフォーマンス上の節約でそのペナルティを上回れます。省略される処理の頻度と量によっては、パフォーマンスの向上は大きなものになり得ます。