Device.Clear メソッド (ClearFlags, Color, Single, Int32, array<Rectangle[])

[アーティクル]
11/03/2009

[このドキュメントはプレビュー版であり、後のリリースで変更されることがあります。空白のトピックは、プレースホルダーとして挿入されています。]

ビューポートまたはビューポート内の四角形のセットを指定の RGBA 色にクリアし、深度バッファーをクリアし、ステンシルバッファーを消去します。

名前空間: Microsoft.WindowsMobile.DirectX.Direct3D
アセンブリ: Microsoft.WindowsMobile.DirectX (Microsoft.WindowsMobile.DirectX.dll 内)

構文

'宣言
Public Sub Clear ( _
    flags As ClearFlags, _
    color As Color, _
    zdepth As Single, _
    stencil As Integer, _
    rectangles As Rectangle() _
)
'使用
Dim instance As Device
Dim flags As ClearFlags
Dim color As Color
Dim zdepth As Single
Dim stencil As Integer
Dim rectangles As Rectangle()

instance.Clear(flags, color, zdepth, stencil, _
    rectangles)

public void Clear(
    ClearFlags flags,
    Color color,
    float zdepth,
    int stencil,
    Rectangle[] rectangles
)

public:
void Clear(
    ClearFlags flags, 
    Color color, 
    float zdepth, 
    int stencil, 
    array<Rectangle>^ rectangles
)

member Clear : 
        flags:ClearFlags * 
        color:Color * 
        zdepth:float32 * 
        stencil:int * 
        rectangles:Rectangle[] -> unit

パラメーター

flags
型 : Microsoft.WindowsMobile.DirectX.Direct3D.ClearFlags
クリアするサーフェイスを示すフラグ。このパラメーターでは、次のフラグの任意の組み合わせを指定できますが、少なくとも 1 つのフラグを使用する必要があります。
- Stencil。ステンシルバッファーをクリアして、stencil パラメーターの値にします。
- Target。レンダリング先をクリアして、color パラメーターの色にします。
- ZBuffer。深度バッファーをクリアして、zdepth パラメーターの値にします。

color
型 : System.Drawing.Color
レンダリング先のサーフェイスをクリアする色を表す Color オブジェクト。

zdepth
型 : System.Single
このメソッドが深度バッファーに格納する新しい zdepth 値。このパラメーターには、0.0 から 1.0 までの値を指定できます (z ベースまたは w ベースの深度バッファーの場合)。値 0.0 はビューアーに最も近い距離を表し、値 1.0 は最も遠い距離を表します。

stencil
型 : System.Int32
各ステンシルバッファーのエントリに格納する整数値。このパラメーターには、0 から 2n-1 までの値を指定できます。n は、ステンシルバッファーのビット深度です。

rectangles
型 : array<System.Drawing.Rectangle[]
クリアする四角形を記述する Rectangle 構造体の配列。サーフェイス全体をクリアするには、四角形をレンダリング先の大きさに設定します。各四角形は、レンダリング先のサーフェイス上の点に対応する画面座標を使用します。座標は、ビューポート四角形の境界でクリッピングされます。

例外

例外	条件
InvalidCallException	メソッドの呼び出しが無効です。たとえば、パラメーターに無効な値が含まれている場合などです。

解説

レンダリング先に深度バッファーが割り当てられていない場合に ZBuffer フラグまたは Stencil フラグを指定すると、このメソッドは失敗します。同様に、深度バッファーの形式にステンシルバッファー情報が含まれていない場合に Stencil フラグを指定すると、このメソッドは失敗します。

.NET Framework セキュリティ

直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分的に信頼される側のコードからライブラリの使用」を参照してください。

プラットフォーム

Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET フレームワークのシステム要件」を参照してください。

バージョン情報

.NET Compact Framework

サポート対象 : 3.5、2.0

参照

Device クラス

Device メンバー

Clear オーバーロード

Microsoft.WindowsMobile.DirectX.Direct3D 名前空間

次の方法で共有