Device.Clear - метод (ClearFlags, Color, Single, Int32)

Статья
11/04/2008

Обновлен: Ноябрь 2007

Очищает окно просмотра или набор прямоугольников заданным цветом 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
)

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

Параметры

flags
Тип: Microsoft.WindowsMobile.DirectX.Direct3D.ClearFlags
Флаги, указывающие, какие поверхности подлежат очистке. Этот параметр может содержать любое сочетание следующих флагов, при этом должен использоваться как минимум один флаг:
- 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.

Private Sub Render()
    If device Is Nothing Then
        Return
    End If
    '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()

End Sub

private void 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();
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

Платформы

Windows CE, Windows Mobile for Smartphone, Windows Mobile для карманных ПК

Среды .NET Framework и .NET Compact Framework поддерживают не все версии каждой платформы. Поддерживаемые версии перечислены в разделе Требования к системе для .NET Framework.