Graphics::D rawImage(Image,constPointF,INT,REAL,REAL,REAL,UNIT,constImageAttributes,DrawImageAbort,VOID)-Methode (gdiplusgraphics.h)

2024-02-29

Die Graphics::D rawImage-Methode zeichnet ein Bild.

Syntax

Status DrawImage(
  [in] Image                 *image,
  [in] const PointF          *destPoints,
  [in] INT                   count,
  [in] REAL                  srcx,
  [in] REAL                  srcy,
  [in] REAL                  srcwidth,
  [in] REAL                  srcheight,
  [in] Unit                  srcUnit,
  [in] const ImageAttributes *imageAttributes,
  [in] DrawImageAbort        callback,
  [in] VOID                  *callbackData
);

Parameter

[in] image

Typ: Bild*

Zeiger auf ein Image-Objekt , das das Quellimage angibt.

[in] destPoints

Typ: const PointF*

Zeiger auf ein Array von PointF-Objekten , die den Bereich in einem Parallelogramm angeben, in dem das Bild gezeichnet werden soll.

[in] count

Typ: INT

Ganzzahl, die die Anzahl der Elemente im DestPoints-Array angibt.

[in] srcx

Typ: REAL

Reelle Zahl, die die x-Koordinate der oberen linken Ecke des zu zeichnenden Teils des Quellbilds angibt.

[in] srcy

Typ: REAL

Reelle Zahl, die die y-Koordinate der oberen linken Ecke des zu zeichnenden Teils des Quellbilds angibt.

[in] srcwidth

Typ: REAL

Reelle Zahl, die die Breite des zu zeichnenden Teils des Quellbilds angibt.

[in] srcheight

Typ: REAL

Reelle Zahl, die die Höhe des zu zeichnenden Teils des Quellbilds angibt.

[in] srcUnit

Typ: Einheit

Element der Unit-Enumeration , die die Maßeinheit für das Bild angibt. Der Standardwert ist UnitPixel.

[in] imageAttributes

Typ: ImageAttributes*

Zeiger auf ein ImageAttributes-Objekt , das die Farb- und Größenattribute des zu zeichnenden Bilds angibt. Der Standardwert ist NULL.

[in] callback

Typ: DrawImageAbort

Rückrufmethode, die verwendet wird, um die laufende Zeichnung abzubrechen. Der Standardwert ist NULL.

[in] callbackData

Typ: VOID*

Zeiger auf zusätzliche Daten, die von der vom Rückrufparameter angegebenen Methode verwendet werden. Der Standardwert ist NULL.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Hinweise

Der Wert des Count-Parameters muss gleich 3 sein, um die Koordinaten der oberen linken Ecke, der oberen rechten Ecke und der unteren linken Ecke des Parallelogramms anzugeben. Die Koordinate der unteren rechten Ecke wird anhand der drei angegebenen Koordinaten, der Breite und der Höhe des Bilds berechnet. Der zu zeichnende Teil des Quellbilds wird skaliert, um dem Parallelogramm zu entsprechen.

Beispiele

Das folgende Beispiel zeichnet das ursprüngliche Quellbild und zeichnet dann einen Teil des Bilds in einem angegebenen Parallelogramm.

VOID Example_DrawImage4(HDC hdc)

{

   Graphics graphics(hdc);

   // Create an Image object.
   Image image(L"pattern.png");

   // Draw the original source image.
   graphics.DrawImage(&image, 10, 10);

   // Define the portion of the image to draw.
   REAL srcX = 70.0f;
   REAL srcY = 20.0f;
   REAL srcWidth = 100.0f;
   REAL srcHeight = 100.0f;

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

   Point* pdestPoints = destPoints; 

   // Create an ImageAttributes object that specifies a recoloring from red to blue.
   ImageAttributes remapAttributes;
   ColorMap redToBlue;
   redToBlue.oldColor = Color(255, 255, 0, 0);
   redToBlue.newColor = Color(255, 0, 0, 255);
   remapAttributes.SetRemapTable(1, &redToBlue);

   // Draw the cropped image.
   graphics.DrawImage(
   &image,
   pdestPoints,
   3,
   srcX,
   srcY,
   srcWidth,
   srcHeight,
   UnitPixel,
   &remapAttributes,
   NULL,
   NULL);
}

Die folgende Abbildung zeigt die Ausgabe des vorherigen Codes.

Abbildung eines mehrfarbigen Schachbrettmusters, dann einer vergrößerten, zweifarbigen Teilmenge dieses Musters, die zu einem Parallelogramm geschert wurde

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusgraphics.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll