Bitmap::Metode SetPixel (gdiplusheaders.h)

Metode Bitmap::SetPixel mengatur warna piksel tertentu dalam bitmap ini.

Sintaks

Status SetPixel(
  [in]      INT           x,
  [in]      INT           y,
  [in, ref] const Color & color
);

Parameter

[in] x

Jenis: INT

int yang menentukan koordinat x (kolom) piksel.

[in] y

Jenis: INT

int yang menentukan koordinat y (baris) piksel.

[in, ref] color

Jenis: const Color

Referensi ke objek Warna yang menentukan warna yang akan diatur.

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 telah ditentukan sebelumnya. Panggilan berikutnya ke Bitmap::GetPixel mungkin mengembalikan nilai yang berbeda karena pembulatan. Selain itu, jika Anda memanggil Bitmap::SetPixel pada Bitmap yang kedalaman warnanya adalah 16 bit per piksel, informasi dapat hilang dalam 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 menggambar bitmap setelah tidak diubah. Kemudian kode memanggil metode Bitmap::SetPixel untuk membuat pola pemeriksa piksel hitam di bitmap dan menggambar bitmap yang diubah.

VOID Example_SetPixel(HDC hdc)

{
   Graphics graphics(hdc);

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

   // Draw the bitmap.
   graphics.DrawImage(&myBitmap, 0, 0);

   // Create a checkered pattern with black pixels.
   for (UINT row = 0; row < myBitmap.GetWidth(); row += 2)
   {
      for (UINT col = 0; col < myBitmap.GetHeight(); col += 2)
      {
         myBitmap.SetPixel(row, col, Color(255, 0, 0, 0));
      }
   }

   // Draw the altered bitmap.
   graphics.DrawImage(&myBitmap, 200, 0);
}

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

Lihat juga

Bitmap

Bitmap::GetPixel

Warna

Gambar

Gambar, bitmap, dan metafile

Menggunakan Gambar, Bitmap, dan Metafiles