Структура BITMAPINFO (wingdi.h)

Статья
03/13/2024

Структура BITMAPINFO определяет размеры и сведения о цвете для DIB.

Синтаксис

typedef struct tagBITMAPINFO {
  BITMAPINFOHEADER bmiHeader;
  RGBQUAD          bmiColors[1];
} BITMAPINFO, *LPBITMAPINFO, *PBITMAPINFO;

Члены

bmiHeader

Структура BITMAPINFOHEADER , содержащая сведения о измерениях цветового формата.

bmiColors[1]

Член bmiColors содержит один из следующих элементов:

Массив RGBQUAD. Элементы массива, составляющие таблицу цветов.
Массив 16-разрядных целых чисел без знака, указывающий индексы в реализованной в настоящее время логической палитре. Такое использование bmiColors разрешено для функций, использующих DIB. Если элементы bmiColors содержат индексы для реализованной логической палитры, они также должны вызывать следующие функции растрового изображения:
CreateDIBitmap

CreateDIBPatternBrush

CreateDIBSection

Параметру iUsageэлемента CreateDIBSection необходимо задать значение DIB_PAL_COLORS.

Количество записей в массиве зависит от значений элементов biBitCount и biClrUsed структуры BITMAPINFOHEADER .

Цвета в таблице bmiColors отображаются в порядке важности. Дополнительные сведения см. в разделе «Примечания».

DIB состоит из двух отдельных частей: структуры BITMAPINFO , описывающей размеры и цвета растрового изображения, и массив байтов, определяющих пиксели растрового изображения. Биты в массиве упаковываются вместе, но каждая строка сканирования должна быть заполнена нулями, чтобы завершить границу типа данных LONG . Если высота растрового рисунка является положительной, то растровое изображение является diB снизу вверх, а его источником является левый нижний угол. Если высота отрицательная, то растровое изображение представляет собой dib сверху вниз, а его источником является левый верхний угол.

Растровое изображение упаковывается, когда массив растровых рисунков сразу же следует за заголовком BITMAPINFO . На упакованные растровые изображения ссылается один указатель. Для упакованных растровых изображений элементу biClrUsed необходимо задать четное число при использовании режима DIB_PAL_COLORS, чтобы массив битовых карт DIB запускался на границе DWORD .

Примечание

Член bmiColors не должен содержать индексы палитры, если растровое изображение должно храниться в файле или передаваться другому приложению.

Если приложение не имеет монопольного использования растрового изображения и управления ими, таблица цветов растрового изображения должна содержать явные значения RGB.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Верхняя часть	wingdi.h (включая Windows.h)