ID3D11DeviceContext1::ClearView メソッド (d3d11_1.h)

  • [アーティクル]

リソース ビュー内のすべての要素を 1 つの値に設定します。

構文

void ClearView(
  [in]           ID3D11View       *pView,
  [in]           const FLOAT [4]  Color,
  [in, optional] const D3D11_RECT *pRect,
                 UINT             NumRects
);

パラメーター

[in] pView

クリアするリソース ビューを表す ID3D11View インターフェイスへのポインター。

[in] Color

リソース ビューのクリアに使用する色を表す 4 コンポーネント配列。

[in, optional] pRect

クリアするリソース ビューの四角形の D3D11_RECT 構造体の配列。 NULL の場合、ClearView はサーフェス全体をクリアします。

NumRects

pRect パラメーターが指定する配列内の四角形の数。

戻り値

なし

解説

ClearView は、レンダー ターゲット ビュー (RTV)、深度のみのリソース (ステンシル コンポーネントのないリソース)、順序なしアクセス ビュー (UAV)、または Texture2D サーフェスのビデオ ビューに対してのみ機能します。 ランタイムが無効な呼び出しを削除します。 pRect 配列内の空の四角形は no-op です。 上の値が下の値と等しいか、左の値が右の値と等しい場合、四角形は空です。

ClearView では、3D テクスチャはサポートされていません。

ClearView は、 ビュー内のすべての配列スライスに同じ色の値を適用します。 pRect 配列内のすべての四角形は、各配列スライスに対応します。 四角形の pRect 配列は、1 つのサーフェスでクリアする領域のセットです。 ビューが配列の場合、 ClearView は各配列スライスのすべての四角形を個別にクリアします。

バッファーに四角形を適用する場合は、上の値を 0 に、下の値を 1 に設定し、バッファー内のエクステントを記述する左の値と右の値を設定します。 上の値が下の値と等しいか、左の値が右の値と等しい場合、四角形は空になり、no-op が実現されます。

ドライバーは、Direct3D 変換規則に従って、色の値を変換先の形式に変換およびクランプします。 たとえば、ビューの形式が DXGI_FORMAT_R8G8B8A8_UNORMの場合、ドライバーは入力を 0.0f から 1.0f (+INF -> 1.0f (0XFF)/NaN -> 0.0f) にクランプします。

形式が整数 ( DXGI_FORMAT_R8G8B8A8_UINT など) の場合、ランタイムは入力を整数浮動小数点として解釈します。 したがって、235.0f は 235 にマップされます (0 に丸め、範囲外/INF 値はターゲット範囲にクランプし、NaN は 0 に)。

カラー マッピングを次に示します。

  • Color[0]: R (ビデオの場合は Y)
  • Color[1]: G (ビデオの場合は U/Cb)
  • Color[2]: B (ビデオの場合は V/Cr)
  • Color[3]: A
YUV 形式または YCbBr 形式のビデオ ビューの場合、 ClearView は色の値を変換しません。 形式名が_UNORMや_UINTなどを示していない場合、 ClearView は_UINTと見なします。 したがって、235.0f は 235 にマップされます (0 に丸め、範囲外/INF 値はターゲット範囲にクランプし、NaN は 0 に)。

要件

要件 値
サポートされている最小のクライアント Windows 7 のWindows 8とプラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2 のWindows Server 2012とプラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー d3d11_1.h
Library D3D11.lib

こちらもご覧ください

ID3D11DeviceContext1