Метод Graphics::D rawImage(Image,constPointF,INT) (gdiplusgraphics.h)

Статья
08/24/2023

Метод Graphics::D rawImage рисует изображение.

Синтаксис

Status DrawImage(
  [in] Image        *image,
  [in] const PointF *destPoints,
  [in] INT          count
);

Параметры

[in] image

Тип: Изображение*

Указатель на объект Image , указывающий исходное изображение.

[in] destPoints

Тип: const PointF*

Указатель на массив объектов PointF , задающий область в параллелограмме, в которой нужно нарисовать изображение.

[in] count

Тип: INT

Целое число, указывающее количество элементов в массиве destPoints .

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

Тип: Состояние

В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .

Если метод завершается сбоем, он возвращает один из других элементов перечисления Status .

Значение параметра count должно быть равно 3, чтобы указать координаты левого верхнего, верхнего и левого нижнего угла параллелограмма. Координата нижнего правого угла вычисляется с использованием трех заданных координат, ширины и высоты изображения. Изображение масштабируется в соответствии с параллелограммом.

Примеры

В следующем примере рисуется изображение.

VOID Example_DrawImage3(HDC hdc)

{
   Graphics graphics(hdc);

   // Create an Image object.
   Image image(L"climber.jpg");

   // Create an array of PointF objects that specify the destination of the image.
   PointF destPoints[3] = {
   PointF(30.0f, 30.0f),
   PointF(250.0f, 50.0f),
   PointF(175.0f, 120.0f)};

   PointF* pdestPoints = destPoints;

   // Draw the image.
   graphics.DrawImage(&image, pdestPoints, 3);
}

На следующем рисунке показаны выходные данные предыдущего кода.

Иллюстрация, показывающая ранее прямоугольное изображение, которое было смещено на параллелограмм

Требования


Минимальная версия клиента	Windows XP, Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	gdiplusgraphics.h (включая Gdiplus.h)
Библиотека	Gdiplus.lib
DLL	Gdiplus.dll