Metodo Bitmap::GetPixel (gdiplusheaders.h)

Articolo
03/05/2024

Il metodo Bitmap::GetPixel ottiene il colore di un pixel specificato in questa bitmap.

Sintassi

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

Parametri

[in] x

Tipo: INT

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

[in] y

Tipo: INT

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

[out] color

Tipo: Colore*

Puntatore a un oggetto Color che riceve il colore del pixel specificato.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, che è 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 chiami Bitmap::SetPixel su un oggetto Bitmap il cui formato pixel è 32bppPARGB, i componenti RGB del pixel sono premoltiplicati. Una chiamata successiva a Bitmap::GetPixel potrebbe restituire un valore diverso a causa dell'arrotondamento. Inoltre, se chiami Bitmap::SetPixel su un oggetto Bitmap la cui profondità di colore è di 16 bit per pixel, le informazioni potrebbero andare perse durante la 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 chiama il metodo Bitmap::GetPixel per ottenere il colore di un pixel nella bitmap e quindi riempie un rettangolo con il colore recuperato.

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

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