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

Artigo
03/05/2024

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