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

Article
02/29/2024

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

Syntaxe

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

Paramètres

[in] x

Type : INT

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

[in] y

Type : INT

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

[in, ref] color

Type : couleur const

Référence à un objet Color qui spécifie la couleur à définir.

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 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 bitmap dont la profondeur de couleur est de 16 bits par pixel, des informations peuvent être perdues dans 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 dessine la bitmap une fois inchangée. Ensuite, le code appelle la méthode Bitmap ::SetPixel pour créer un modèle à damer de pixels noirs dans la bitmap et dessiner la bitmap modifiée.

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP, Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	gdiplusheaders.h (inclure Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll