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

Artículo
02/28/2024

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

Sintaxis

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

Parámetros

[in] x

Tipo: INT

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

[in] y

Tipo: INT

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

[out] color

Tipo: Color*

Puntero a un objeto Color que recibe el color del píxel especificado.

Valor devuelto

Tipo: Estado

Si el método se realiza 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 llama a Bitmap::SetPixel en un objeto Bitmap cuyo formato de píxel es 32bppPARGB, los componentes RGB del píxel se premultiplican. Una llamada posterior a Bitmap::GetPixel podría devolver un valor diferente debido al redondeo. Además, si llama a Bitmap::SetPixel en un objeto Bitmap cuya profundidad de color es de 16 bits por píxel, la información podría perderse durante 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 llama al método Bitmap::GetPixel para obtener el color de un píxel en el mapa de bits y, a continuación, rellena un rectángulo con el color recuperado.

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

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