Метод ID3D11DeviceContext::ClearRenderTargetView (d3d11.h)

Статья
02/24/2024

Задайте для всех элементов в целевом объекте отрисовки одно значение.

Синтаксис

void ClearRenderTargetView(
  [in] ID3D11RenderTargetView *pRenderTargetView,
  [in] const FLOAT [4]        ColorRGBA
);

Параметры

[in] pRenderTargetView

Тип: ID3D11RenderTargetView*

Указатель на целевой объект отрисовки.

[in] ColorRGBA

Тип: const FLOAT[4]

4-компонентный массив, представляющий цвет для заполнения целевого объекта отрисовки.

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

None

Remarks

Приложения, которые хотят очистить целевой объект отрисовки для определенного битового шаблона целочисленного значения, должны отрисовывать выровненный по экрану четырехугольник, а не использовать этот метод. Причина этого заключается в том, что этот метод принимает в качестве входных данных значение с плавающей запятой, которое может иметь не тот же битовый шаблон, что и исходное целое число.

Различия между Direct3D 9 и Direct3D 11/10:

В отличие от Direct3D 9, полный экстент представления ресурсов всегда очищается. Параметры окна просмотра и ножницы не применяются.

При использовании D3D_FEATURE_LEVEL_9_x ClearRenderTargetView очищает только первый срез массива в целевом представлении отрисовки. Это может повлиять (например, на сценарии отрисовки кубической карты). Приложения должны создать целевое представление отрисовки для каждого среза лица или массива, а затем очистить каждое представление по отдельности.

Требования

Требование	Значение
Целевая платформа	Windows
Header	d3d11.h
Библиотека	D3D11.lib

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

ID3D11DeviceContext