Graphics::D rawImage(Image,constPoint,INT) (gdiplusgraphics.h)

Artículo
02/29/2024

El método Graphics::D rawImage dibuja una imagen.

Sintaxis

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

Parámetros

[in] image

Tipo: Imagen*

Puntero a un objeto Image que especifica la imagen de origen.

[in] destPoints

Tipo: const Point*

Puntero a una matriz de objetos Point que especifican el área, en un paralegrama, en el que se va a dibujar la imagen.

[in] count

Tipo: INT

Entero que especifica el número de elementos de la matriz destPoints .

Valor devuelto

Tipo: Estado

Si el método se ejecuta correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve InvalidParameter.

Comentarios

El valor del parámetro count debe ser igual a 3 para especificar las tres esquinas del paralelismo. La cuarta esquina del paralelgrama se calcula utilizando los vectores de las coordenadas primera y segunda y la primera y tercera coordenadas. La imagen se escala para ajustarse al paralelismo.

Ejemplos

En el ejemplo siguiente se dibuja una imagen.

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);
}

En la ilustración siguiente se muestra la salida del código anterior.

Ilustración en la que se muestra una imagen rectangular previamente que ahora se ha desarizado en un paralelismo

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusgraphics.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll