Device.Clear - метод (ClearFlags, Color, Single, Int32, array<Rectangle[])

Статья
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, _
    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
)

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

Параметры

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 — битовая глубина буфера шаблона.

rectangles
Тип: array<System.Drawing.Rectangle[]
Массив структур Rectangle, описывающих очищаемые прямоугольники. Чтобы очистить всю поверхность, задайте для прямоугольника размерности целевого буфера рендеринга. Каждый прямоугольник использует экранные координаты, соответствующие точкам на поверхности целевого буфера визуализации. Координаты отсекаются по границам прямоугольника окна просмотра.

Исключения

Исключение	Условие
InvalidCallException	Вызов метода недопустим. Например, параметр может содержать недопустимое значение.

Заметки

Вызов этого метода завершается неудачей, если заданы флаги ZBuffer или Stencil, а с целевым буфером визуализации не связан буфер глубины. Подобным же образом вызов метода завершается неудачей, если задан флаг Stencil, а формат буфера глубины не содержит информации о буфере шаблона.

Разрешения

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

Платформы

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

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