Метод ID3D11DeviceContext1::ClearView (d3d11_1.h)

Статья
08/22/2023

Присваивает всем элементам в представлении ресурсов одно значение.

Синтаксис

void ClearView(
  [in]           ID3D11View       *pView,
  [in]           const FLOAT [4]  Color,
  [in, optional] const D3D11_RECT *pRect,
                 UINT             NumRects
);

Параметры

[in] pView

Указатель на интерфейс ID3D11View , представляющий представление ресурсов для очистки.

[in] Color

Массив из 4 компонентов, представляющий цвет, используемый для очистки представления ресурсов.

[in, optional] pRect

Массив D3D11_RECT структур для очистки прямоугольников в представлении ресурсов. Если значение NULL, ClearView очищает всю поверхность.

NumRects

Число прямоугольников в массиве, указанное параметром pRect .

Возвращаемое значение

None

Remarks

ClearView работает только с целевыми представлениями (RTV), представлениями глубины и трафарета (DSV) только для ресурсов глубины (ресурсы без компонента набора элементов), представлениями без упорядоченного доступа (БПЛА) или любым видеопросмотром поверхности Texture2D . Среда выполнения удаляет недопустимые вызовы. Пустые прямоугольники в массиве pRect не являются оповещенными. Прямоугольник пустой, если верхнее значение равно нижнему или левое значение равно правильному значению.

ClearView не поддерживает трехмерные текстуры.

ClearView применяет одно и то же значение цвета ко всем срезам массива в представлении; все прямоугольники в массиве pRect соответствуют каждому срезу массива. Массив прямоугольников pRect — это набор областей для очистки на одной поверхности. Если представление является массивом, ClearView очищает все прямоугольники на каждом срезе массива по отдельности.

При применении прямоугольников к буферам присвойте верхнему значению значение 0, а нижнему — 1, а левое и правое значение для описания экстента в буфере. Если верхнее значение равно нижнему или левое значение равно правому значению, прямоугольник пуст и достигается отсутствие операции.

Драйвер преобразует и зажимает значения цвета в целевой формат в соответствии с правилами преобразования Direct3D. Например, если формат представления DXGI_FORMAT_R8G8B8A8_UNORM, драйвер зажимает входные данные с 0,0f до 1,0f (+INF -> 1.0f (0XFF)/NaN -> 0,0f).

Если формат имеет целочисленное значение, например DXGI_FORMAT_R8G8B8A8_UINT, среда выполнения интерпретирует входные данные как целочисленные числа с плавающей точкой. Таким образом, 235.0f сопоставляется с 235 (округляется до нуля, значения вне диапазона/INF заклинываются в целевом диапазоне, а NaN — до 0).

Ниже приведены сопоставления цветов.

Color[0]: R (или Y для видео)
Color[1]: G (или U/Cb для видео)
Color[2]: B (или V/Cr для видео)
Цвет[3]: A

Для представлений видео в форматах YUV или YCbBr ClearView не преобразует значения цвета. В ситуациях, когда имя формата не указывает на _UNORM, _UINT и т. д., ClearView предполагает, что _UINT. Таким образом, 235.0f сопоставляется с 235 (округляется до нуля, значения вне диапазона/INF заклинываются в целевом диапазоне, а NaN — до 0).

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 и обновление платформы для Windows 7 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	d3d11_1.h
Библиотека	D3D11.lib

См. также раздел

ID3D11DeviceContext1