Método Bitmap::SetPixel (gdiplusheaders.h)

Artículo
02/26/2024

El método Bitmap::SetPixel establece el color de un píxel especificado en este mapa de bits.

Sintaxis

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

Parámetros

[in] x

Tipo: INT

int que especifica la coordenada x (columna) del píxel.

[in] y

Tipo: INT

int que especifica la coordenada y (fila) del píxel.

[in, ref] color

Tipo: color const

Referencia a un objeto Color que especifica el color que se va a establecer.

Valor devuelto

Tipo: Estado

Si el método se ejecuta correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

Según el formato del mapa de bits, Bitmap::GetPixel podría no devolver el mismo valor que el establecido por Bitmap::SetPixel. Por ejemplo, si llamas a Bitmap::SetPixel en un objeto Bitmap cuyo formato de píxel es 32bppPARGB, los componentes RGB están premultiplicados. Una llamada posterior a Bitmap::GetPixel podría devolver un valor diferente debido al redondeo. Además, si llamas a Bitmap::SetPixel en un mapa de bits cuya profundidad de color es de 16 bits por píxel, la información podría perderse en la conversión de 32 a 16 bits y una llamada posterior a Bitmap::GetPixel podría devolver un valor diferente.

Ejemplos

En el ejemplo siguiente se crea un objeto Bitmap basado en un archivo JPEG. El código dibuja el mapa de bits una vez sin modificar. A continuación, el código llama al método Bitmap::SetPixel para crear un patrón comprobado de píxeles negros en el mapa de bits y dibuja el mapa de bits modificado.

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusheaders.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll