Функция RenderTargetProperties (d2d1helper.h)

  • Статья

Создает структуру D2D1_RENDER_TARGET_PROPERTIES .

Синтаксис

D2D1_RENDER_TARGET_PROPERTIES RenderTargetProperties(
       D2D1_RENDER_TARGET_TYPE   type,
  [in] const D2D1_PIXEL_FORMAT & pixelFormat,
       FLOAT                     dpiX,
       FLOAT                     dpiY,
       D2D1_RENDER_TARGET_USAGE  usage,
       D2D1_FEATURE_LEVEL        minLevel
);

Параметры

type

Тип: D2D1_RENDER_TARGET_TYPE

Значение типа , указывающее, должен ли целевой объект отрисовки использовать аппаратную или программную отрисовку. Значение по умолчанию , D2D1_RENDER_TARGET_TYPE_DEFAULT, указывает, что будет использоваться аппаратная отрисовка; Если отрисовка оборудования недоступна, целевой объект отрисовки использует программную отрисовку. Обратите внимание, что целевые объекты отрисовки точечного изображения WIC не поддерживают аппаратную отрисовку.

[in] pixelFormat

Тип: const D2D1_PIXEL_FORMAT

Формат пикселей и альфа-режим целевого объекта отрисовки. Формат пикселей по умолчанию — D2D1::P ixelFormat, который предписывает Direct2D выбрать формат пикселей, поддерживаемый целевым объектом отрисовки. Список форматов пикселей и альфа-режимов, поддерживаемых каждым целевым объектом отрисовки, см. в разделе Поддерживаемые форматы пикселей и альфа-режимы.

dpiX

Тип: FLOAT

Горизонтальное разрешение целевого объекта отрисовки. Значение по умолчанию — 0,0. Если и dpiX , и dpiY имеют значение 0,0, целевой объект отрисовки использует значение по умолчанию. Дополнительные сведения см. в разделе D2D1_RENDER_TARGET_PROPERTIES.

dpiY

Тип: FLOAT

Вертикальное разрешение целевого объекта отрисовки. Значение по умолчанию — 0,0. Если и dpiX , и dpiY имеют значение 0,0, целевой объект отрисовки использует значение по умолчанию. Дополнительные сведения см. в разделе D2D1_RENDER_TARGET_PROPERTIES.

usage

Тип: D2D1_RENDER_TARGET_USAGE

Указывает, как выполняется удаленная отрисовка целевого объекта отрисовки и должна ли она быть совместима с GDI. Значение по умолчанию , D2D1_RENDER_TARGET_USAGE_NONE, создает целевой объект отрисовки, несовместимый с GDI и использующий удаленную отрисовку потока команд Direct3D, если он доступен.

minLevel

Тип: D2D1_FEATURE_LEVEL

Минимальный уровень компонентов Direct3D, необходимый для аппаратной отрисовки. Значение по умолчанию , D2D1_FEATURE_LEVEL_DEFAULT, указывает, что Direct2D должен определить, является ли уровень функций Direct3D устройства адекватным. Это поле используется только при создании объектов ID2D1HwndRenderTarget и ID2D1DCRenderTarget . Дополнительные сведения см. в разделе D2D1_RENDER_TARGET_PROPERTIES.

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

Тип: D2D1_RENDER_TARGET_PROPERTIES

D2D1_RENDER_TARGET_PROPERTIES, содержащий указанные параметры.

Требования

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

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

Структура D2D1_RENDER_TARGET_PROPERTIES

Поддерживаемые форматы пикселей и режимы альфа-канала