Метод ID2D1DeviceContext::D rawImage(ID2D1Effect,constD2D1_POINT_2F,constD2D1_RECT_F*,D2D1_INTERPOLATION_MODE,D2D1_COMPOSITE_MODE) (d2d1_1.h)

Статья
08/22/2023

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

Синтаксис

void DrawImage(
  [in]           ID2D1Effect             *effect,
  [in, optional] const D2D1_POINT_2F     *targetOffset,
  [in, optional] const D2D1_RECT_F       *imageRectangle,
                 D2D1_INTERPOLATION_MODE interpolationMode,
                 D2D1_COMPOSITE_MODE     compositeMode
);

Параметры

[in] effect

Тип: ID2D1Effect*

Эффект, который необходимо отрисовать в контексте устройства.

[in, optional] targetOffset

Тип: const D2D1_POINT_2F*

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

[in, 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