Device.Clear-Methode (ClearFlags, Color, Single, Int32)

Artikel
11/08/2009

Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]

Löscht den Viewport oder eine Reihe von Rechtecken im Viewport auf eine angegebene RGBA-Farbe, löscht den Tiefenpuffer und löscht den Stencilpuffer.

Namespace: Microsoft.WindowsMobile.DirectX.Direct3D
Assembly: Microsoft.WindowsMobile.DirectX (in Microsoft.WindowsMobile.DirectX.dll)

Syntax

'Declaration
Public Sub Clear ( _
    flags As ClearFlags, _
    color As Color, _
    zdepth As Single, _
    stencil As Integer _
)
'Usage
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

Parameter

flags
Typ: Microsoft.WindowsMobile.DirectX.Direct3D.ClearFlags
Die Flags, die die Oberflächen deaktivieren angeben.Dieser Parameter kann eine beliebige Kombination folgender Flags, aber mindestens ein Flag muss verwendet werden:
- Stencil: Löscht den Stencilpuffer auf den Wert der stencil Parameter.
- Target: Löscht das Renderingziel auf die Farbe der color Parameter.
- ZBuffer: Löscht den Tiefenpuffer auf den Wert der zdepth Parameter.

color
Typ: System.Drawing.Color
Ein Color Objekt, das die Farbe darstellt, die Renderingzieloberfläche deaktiviert ist.

zdepth
Typ: System.Single
Ein neues zdepth-Wert, der diese Methode im Tiefenpuffer speichert.Dieser Parameter kann im Bereich von 0,0 und 1,0 (für Z-basierte oder w-basierte Tiefenpuffer) sein.Der Wert 0,0 stellt den nächstgelegenen Abstand und den Viewer;ein Wert von 1,0 stellt den am weitesten entfernten Abstand dar.

stencil
Typ: System.Int32
Ein ganzzahliger Wert in jedem Stencilpuffereintrag gespeichert.Dieser Parameter kann im Bereich von 0 bis 2 n1, sein, wobei n die Bittiefe für den Stencilpuffer ist.

Ausnahmen

Ausnahme	Bedingung
InvalidCallException	Der Methodenaufruf ist ungültig.Beispielsweise kann ein Parameter einen ungültigen Wert enthalten.

Hinweise

Diese Methode schlägt fehl Wenn die ZBuffer oder Stencil Flags angegeben werden, wenn das Renderingziel nicht mit einer angefügten Tiefenpuffer verfügt.Schlägt die Methode entsprechend fehl, wenn das Flag Stencil angegeben Tiefenpuffer Format keine Schablone Puffer Informationen enthält.

Beispiele

Das folgende Beispiel veranschaulicht die Clear-Eigenschaft verwenden.

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-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Plattformen

Windows CE, Windows Mobile für Smartphone, Windows Mobile für Pocket PC

Die .NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET framework.