Bitmap::GetPixel-Methode (gdiplusheaders.h)

Artikel
02/28/2024

Die Bitmap::GetPixel-Methode ruft die Farbe eines angegebenen Pixels in dieser Bitmap ab.

Syntax

Status GetPixel(
  [in]  INT   x,
  [in]  INT   y,
  [out] Color *color
);

Parameter

[in] x

Typ: INT

Ganzzahl, die die x-Koordinate (Spalte) des Pixels angibt.

[in] y

Typ: INT

Ganze Zahl, die die y-Koordinate (Zeile) des Pixels angibt.

[out] color

Typ: Farbe*

Zeiger auf ein Color-Objekt , das die Farbe des angegebenen Pixels empfängt.

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

Abhängig vom Format der Bitmap gibt Bitmap::GetPixel möglicherweise nicht denselben Wert zurück, der von Bitmap::SetPixel festgelegt wurde. Wenn Sie beispielsweise Bitmap::SetPixel für ein Bitmap-Objekt aufrufen, dessen Pixelformat 32bppPARGB ist, werden die RGB-Komponenten des Pixels vormultipliziert. Ein nachfolgender Aufruf von Bitmap::GetPixel kann aufgrund der Rundung einen anderen Wert zurückgeben. Wenn Sie Bitmap::SetPixel für ein Bitmap-Objekt aufrufen, dessen Farbtiefe 16 Bit pro Pixel beträgt, können informationen während der Konvertierung von 32 zu 16 Bit verloren gehen, und ein späterer Aufruf von Bitmap::GetPixel gibt möglicherweise einen anderen Wert zurück.

Beispiele

Im folgenden Beispiel wird ein Bitmap-Objekt basierend auf einer JPEG-Datei erstellt. Der Code ruft die Bitmap::GetPixel-Methode auf, um die Farbe eines Pixels in der Bitmap abzurufen, und füllt dann ein Rechteck mit der abgerufenen Farbe.

VOID Example_GetPixel(HDC hdc)

{

   Graphics graphics(hdc);

   // Create a Bitmap object from a JPEG file.
   Bitmap myBitmap(L"Climber.jpg");

   // Get the value of a pixel from myBitmap.
   Color pixelColor;
   myBitmap.GetPixel(25, 25, &pixelColor);

   // Fill a rectangle with the pixel color.
   SolidBrush brush(pixelColor);
   graphics.FillRectangle(&brush, Rect(0, 0, 100, 100));
}

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	gdiplusheaders.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll