Метод ID2D1DeviceContext::D rawImage(ID2D1Image*,D2D1_POINT_2F,D2D1_INTERPOLATION_MODE,D2D1_COMPOSITE_MODE) (d2d1_1.h)

Статья
08/22/2023

Рисует изображение в контексте устройства.

Синтаксис

void DrawImage(
  [in]           ID2D1Image              *image,
  [in, optional] D2D1_POINT_2F           targetOffset,
                 D2D1_INTERPOLATION_MODE interpolationMode,
                 D2D1_COMPOSITE_MODE     compositeMode
);

Параметры

[in] image

Тип: ID2D1Image*

Изображение, отрисовывающееся в контексте устройства.

[in, optional] targetOffset

Тип: const D2D1_POINT_2F*

Смещение в пространстве назначения, в которое будет отображаться изображение. Весь логический экстент изображения будет преобразован в соответствующее назначение. Если значение не указано, конечным источником будет (0, 0). Левый верхний угол изображения будет сопоставлен с целевым смещением. Это не обязательно будет источником. Это значение по умолчанию — NULL.

interpolationMode

Тип: D2D1_INTERPOLATION_MODE

Режим интерполяции, который будет использоваться для масштабирования изображения при необходимости.

compositeMode

Тип: D2D1_COMPOSITE_MODE

Составной режим, который будет применяться к ограничениям выбранного в данный момент клипа. Значение по умолчанию — D2D1_COMPOSITE_MODE_SOURCE_OVER

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

None

Remarks

Если параметр interpolationModeD2D1_INTERPOLATION_MODE_HIGH_QUALITY, будут использоваться различные масштабировщики в зависимости от коэффициента масштабирования, подразумеваемого преобразованием мира.

Все недопустимые прямоугольники, накопленные для любого эффекта, нарисованного этим вызовом, будут удалены независимо от того, какая часть прямоугольника изображения нарисована.

Если compositeModeD2D1_COMPOSITE_MODE_SOURCE_OVER,DrawImage будет использовать выбранную в данный момент примитивную смесь, заданную id2D1DeviceContext::SetPrimitiveBlend. Если compositeMode не D2D1_COMPOSITE_MODE_SOURCE_OVER, изображение будет расширено до прозрачности до текущей обрезки, выровненной по оси.

Если есть прямоугольник изображения и преобразование мира, это эквивалентно вставке эффекта клипа для представления прямоугольника изображения и двухd-аффинного преобразования для учета преобразования мира.

Требования

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