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

Artigo
02/29/2024

O método Bitmap::SetPixel define a cor de um pixel especificado neste bitmap.

Sintaxe

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

Parâmetros

[in] x

Tipo: INT

int que especifica a coordenada x (coluna) do pixel.

[in] y

Tipo: INT

int que especifica a coordenada y (linha) do pixel.

[in, ref] color

Tipo: const Color

Referência a um objeto Color que especifica a cor a ser definida.

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 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 Bitmap cuja profundidade de cor é de 16 bits por pixel, as informações podem ser perdidas na 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 desenha o bitmap uma vez não alterado. Em seguida, o código chama o método Bitmap::SetPixel para criar um padrão verificado de pixels pretos no bitmap e desenha o bitmap alterado.

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	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