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

Статья
02/26/2024

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

Синтаксис

void DrawImage(
  [in]                ID2D1Image              *image,
  [in, optional]      D2D1_POINT_2F           targetOffset,
  [in, ref, optional] const D2D1_RECT_F &     imageRectangle,
                      D2D1_INTERPOLATION_MODE interpolationMode,
                      D2D1_COMPOSITE_MODE     compositeMode
);

Параметры

[in] image

Тип: ID2D1Image*

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

[in, optional] targetOffset

Тип: const D2D1_POINT_2F*

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

[in, ref, optional] imageRectangle

Тип: const D2D1_RECT_F

Соответствующий прямоугольник в пространстве изображения будет сопоставлен с заданными источниками при обработке изображения. Значение по умолчанию — 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