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