Metodo Bitmap::SetPixel (gdiplusheaders.h)

Articolo
02/26/2024

Il metodo Bitmap::SetPixel imposta il colore di un pixel specificato in questa bitmap.

Sintassi

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

Parametri

[in] x

Tipo: INT

int che specifica la coordinata x (colonna) del pixel.

[in] y

Tipo: INT

int che specifica la coordinata y (riga) del pixel.

[in, ref] color

Tipo: colore const

Riferimento a un oggetto Color che specifica il colore da impostare.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, ovvero un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

A seconda del formato della bitmap, Bitmap::GetPixel potrebbe non restituire lo stesso valore impostato da Bitmap:: SetPixel. Ad esempio, se si chiama Bitmap::SetPixel in un oggetto Bitmap il cui formato pixel è 32bppPARGB, i componenti RGB sono premultiplied. Una chiamata successiva a Bitmap::GetPixel potrebbe restituire un valore diverso a causa dell'arrotondamento. Inoltre, se si chiama Bitmap::SetPixel in una Bitmap la cui profondità di colore è 16 bit per pixel, le informazioni potrebbero essere perse nella conversione da 32 a 16 bit e una chiamata successiva a Bitmap::GetPixel potrebbe restituire un valore diverso.

Esempio

Nell'esempio seguente viene creato un oggetto Bitmap basato su un file JPEG. Il codice disegna la bitmap una volta invariata. Il codice chiama quindi il metodo Bitmap::SetPixel per creare un modello checkered di pixel neri nella bitmap e disegna la bitmap modificata.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusheaders.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll