Device.Clear メソッド (ClearFlags, Color, Single, Int32)

[アーティクル]
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 _
)
'使用
Dim instance As Device
Dim flags As ClearFlags
Dim color As Color
Dim zdepth As Single
Dim stencil As Integer

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

public void Clear(
    ClearFlags flags,
    Color color,
    float zdepth,
    int stencil
)

public:
void Clear(
    ClearFlags flags, 
    Color color, 
    float zdepth, 
    int stencil
)

member Clear : 
        flags:ClearFlags * 
        color:Color * 
        zdepth:float32 * 
        stencil:int -> 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 は、ステンシルバッファーのビット深度です。

例外

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

解説

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

例

Clear プロパティの使用方法を次の例に示します。

PrivateSub Render()
    If device IsNothingThenReturnEndIf    'Clear the backbuffer to a blue color. 
    device.Clear(ClearFlags.Target, System.Drawing.Color.Blue, 1.0F, 0)
    'Begin the scene.
    device.BeginScene()

    'Render scene objects, if desired.    'End the scene.
    device.EndScene()
    device.Present()

EndSub

privatevoid Render()
{
    if (device == null)
        return;

    //Clear the backbuffer to a blue color. 
    device.Clear(ClearFlags.Target, System.Drawing.Color.Blue, 1.0f, 0);
    //Begin the scene.
    device.BeginScene();

    // Rendering scene objects, if desired.//End the scene.
    device.EndScene();
    device.Present();
}

.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 名前空間

次の方法で共有