Bitmap::Metode GetPixel (gdiplusheaders.h)

Artikel
03/04/2024

Metode Bitmap::GetPixel mendapatkan warna piksel tertentu dalam bitmap ini.

Sintaks

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

Parameter

[in] x

Jenis: INT

Bilangan bulat yang menentukan koordinat x (kolom) piksel.

[in] y

Jenis: INT

Bilangan bulat yang menentukan koordinat y (baris) piksel.

[out] color

Jenis: Warna*

Penunjuk ke objek Warna yang menerima warna piksel yang ditentukan.

Nilai kembali

Jenis: Status

Jika metode berhasil, metode mengembalikan Ok, yang merupakan elemen dari enumerasi Status .

Jika metode gagal, metode mengembalikan salah satu elemen lain dari enumerasi Status .

Keterangan

Bergantung pada format bitmap, Bitmap::GetPixel mungkin tidak mengembalikan nilai yang sama seperti yang ditetapkan oleh Bitmap::SetPixel. Misalnya, jika Anda memanggil Bitmap::SetPixel pada objek Bitmap yang format pikselnya adalah 32bppPARGB, komponen RGB piksel telah ditentukan sebelumnya. Panggilan berikutnya ke Bitmap::GetPixel mungkin mengembalikan nilai yang berbeda karena pembulatan. Selain itu, jika Anda memanggil Bitmap::SetPixel pada objek Bitmap yang kedalaman warnanya adalah 16 bit per piksel, informasi dapat hilang selama konversi dari 32 menjadi 16 bit, dan panggilan berikutnya ke Bitmap::GetPixel mungkin mengembalikan nilai yang berbeda.

Contoh

Contoh berikut membuat objek Bitmap berdasarkan file JPEG. Kode memanggil metode Bitmap::GetPixel untuk mendapatkan warna piksel dalam bitmap lalu mengisi persegi panjang dengan warna yang diambil.

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP, Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	gdiplusheaders.h (termasuk Gdiplus.h)
Pustaka	Gdiplus.lib
DLL	Gdiplus.dll