Поделиться через

Метод ID2D1RenderTarget::CreateCompatibleRenderTarget(D2D1_SIZE_F;D2D1_SIZE_U;ID2D1BitmapRenderTarget**) (d2d1.h)

  • Статья

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

Синтаксис

HRESULT CreateCompatibleRenderTarget(
  D2D1_SIZE_F             desiredSize,
  D2D1_SIZE_U             desiredPixelSize,
  ID2D1BitmapRenderTarget **bitmapRenderTarget
);

Параметры

desiredSize

Тип: [in] D2D1_SIZE_F

Требуемый размер нового целевого объекта отрисовки (в независимых от устройства пикселях), если он должен отличаться от исходного целевого объекта отрисовки. Дополнительные сведения см. в разделе Примечания.

desiredPixelSize

Тип: [in] D2D1_SIZE_U

Требуемый размер нового целевого объекта отрисовки в пикселях, если он должен отличаться от исходного целевого объекта отрисовки. Дополнительные сведения см. в разделе «Примечания».

bitmapRenderTarget

Тип: [out] ID2D1BitmapRenderTarget**

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

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Размер пикселей и DPI нового целевого объекта отрисовки можно изменить, указав значения для desiredSize или desiredPixelSize.

  • Если параметр desiredSize указан, а desiredPixelSize — нет, размер пикселя вычисляется на основе требуемого размера с использованием родительского целевого DPI. Если значение desiredSize сопоставляется с целочисленным размером пикселей, то значение DPI совместимого целевого объекта отрисовки совпадает с DPI родительского целевого объекта. Если значение desiredSize сопоставляется с размером в дробном пикселе, размер пикселя округляется до ближайшего целого числа, а значение DPI для совместимого целевого объекта отрисовки немного выше, чем значение DPI родительского целевого объекта отрисовки. Во всех случаях координата (desiredSize.width, desiredSize.height) сопоставляется с правым нижним углом совместимого целевого объекта отрисовки.
  • Если параметр desiredPixelSize указан, а параметр desiredSize — нет, то значение DPI нового целевого объекта отрисовки совпадает с исходным целевым объектом отрисовки.
  • Если указаны значения desiredSize и desiredPixelSize , то dPI нового целевого объекта отрисовки вычисляется с учетом разницы в масштабе.
  • Если не указано ни desiredSize, ни desiredPixelSize , новый размер и DPI отрисовки соответствуют исходному целевому объекту отрисовки.

Целевой объект отрисовки растрового рисунка, созданный этим методом, несовместим с GDI.

Требования

Требование Значение
Минимальная версия клиента Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header d2d1.h
Библиотека D2d1.lib
DLL D2d1.dll

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

ID2D1RenderTarget