Método Bitmap::GetPixel (gdiplusheaders.h)
O método Bitmap::GetPixel obtém a cor de um pixel especificado neste bitmap.
Sintaxe
Status GetPixel(
[in] INT x,
[in] INT y,
[out] Color *color
);
Parâmetros
[in] x
Tipo: INT
Inteiro que especifica a coordenada x (coluna) do pixel.
[in] y
Tipo: INT
Inteiro que especifica a coordenada y (linha) do pixel.
[out] color
Tipo: Cor*
Ponteiro para um objeto Color que recebe a cor do pixel especificado.
Retornar valor
Tipo: Status
Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .
Se o método falhar, ele retornará um dos outros elementos da enumeração Status .
Comentários
Dependendo do formato do bitmap, Bitmap::GetPixel pode não retornar o mesmo valor que foi definido por Bitmap::SetPixel. Por exemplo, se você chamar Bitmap::SetPixel em um objeto Bitmap cujo formato de pixel é 32bppPARGB, os componentes RGB do pixel serão pré-multiplicados. Uma chamada subsequente para Bitmap::GetPixel pode retornar um valor diferente devido ao arredondamento. Além disso, se você chamar Bitmap::SetPixel em um objeto Bitmap cuja profundidade de cor é de 16 bits por pixel, as informações podem ser perdidas durante a conversão de 32 para 16 bits e uma chamada subsequente para Bitmap::GetPixel pode retornar um valor diferente.
Exemplos
O exemplo a seguir cria um objeto Bitmap com base em um arquivo JPEG. O código chama o método Bitmap::GetPixel para obter a cor de um pixel no bitmap e preenche um retângulo com a cor recuperada.
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 | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | gdiplusheaders.h (inclua Gdiplus.h) |
| Biblioteca | Gdiplus.lib |
| DLL | Gdiplus.dll |