Метод Bitmap::GetPixel (gdiplusheaders.h)

Статья
03/05/2024

Метод Bitmap::GetPixel получает цвет указанного пикселя в этом растровом рисунке.

Синтаксис

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

Параметры

[in] x

Тип: INT

Целое число, указывающее координату X (столбец) пикселя.

[in] y

Тип: INT

Целое число, указывающее координату Y (строку) пикселя.

[out] color

Тип: Цвет*

Указатель на объект Color , который получает цвет указанного пикселя.

Возвращаемое значение

Тип: Состояние

В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .

Если метод завершается сбоем, он возвращает один из других элементов перечисления Status .

В зависимости от формата растрового рисунка bitmap::GetPixel может не возвращать то же значение, которое было задано Bitmap::SetPixel. Например, при вызове Bitmap::SetPixel для объекта Bitmap с форматом пикселей 32bppPARGB компоненты RGB пикселя будут предварительно преобразованы. Последующий вызов Bitmap::GetPixel может возвращать другое значение из-за округления. Кроме того, при вызове Bitmap::SetPixel для объекта Bitmap с глубиной цвета 16 бит на пиксель данные могут быть потеряны во время преобразования с 32 до 16 бит, а последующий вызов Bitmap::GetPixel может вернуть другое значение.

Примеры

В следующем примере создается объект Bitmap на основе JPEG-файла. Код вызывает метод Bitmap::GetPixel для получения цвета пикселя на растровом рисунке, а затем заполняет прямоугольник извлеченным цветом.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows XP, Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	gdiplusheaders.h (включая Gdiplus.h)
Библиотека	Gdiplus.lib
DLL	Gdiplus.dll