Bitmap ::GetPixel, méthode (gdiplusheaders.h)

La méthode Bitmap ::GetPixel obtient la couleur d’un pixel spécifié dans cette bitmap.

Syntaxe

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

Paramètres

[in] x

Type : INT

Entier qui spécifie la coordonnée x (colonne) du pixel.

[in] y

Type : INT

Entier qui spécifie la coordonnée y (ligne) du pixel.

[out] color

Type : Couleur*

Pointeur vers un objet Color qui reçoit la couleur du pixel spécifié.

Valeur retournée

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Remarques

Selon le format de la bitmap, Bitmap ::GetPixel peut ne pas retourner la même valeur que celle définie par Bitmap ::SetPixel. Par exemple, si vous appelez Bitmap ::SetPixel sur un objet Bitmap dont le format de pixel est 32bppPARGB, les composants RVB du pixel sont prémultipliés. Un appel suivant à Bitmap ::GetPixel peut retourner une valeur différente en raison de l’arrondi. En outre, si vous appelez Bitmap ::SetPixel sur un objet Bitmap dont la profondeur de couleur est de 16 bits par pixel, des informations peuvent être perdues lors de la conversion de 32 à 16 bits, et un appel ultérieur à Bitmap ::GetPixel peut retourner une valeur différente.

Exemples

L’exemple suivant crée un objet Bitmap basé sur un fichier JPEG. Le code appelle la méthode Bitmap ::GetPixel pour obtenir la couleur d’un pixel dans la bitmap, puis remplit un rectangle avec la couleur récupérée.

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

Configuration requise

Voir aussi

Bitmap

Bitmap ::LockBits

Bitmap ::SetPixel

Color

Image

Images, bitmaps et métafichiers

Utilisation d’images, de bitmaps et de métafichiers