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

Статья
08/24/2023

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

Синтаксис

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

Параметры

[in] image

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

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

[in] destPoints

Тип: const Point*

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

[in] count

Тип: INT

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

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

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

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

Если метод завершается сбоем, он возвращает InvalidParameter.

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

Примеры

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

VOID Example_DrawImage(HDC hdc)

{

   Graphics graphics(hdc);

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

   // Create an array of Point objects that specify the destination of the image.
   Point destPoints[3] = {
   Point(30, 30),
   Point(250, 50),
   Point(175, 120)};

   Point* 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