Método Bitmap::GetPixel (gdiplusheaders.h)
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 |