Структура BITMAPINFO

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

Синтаксис

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

Члены структуры

bmiHeader

Определяет структуру BITMAPINFOHEADER, которая содержит информацию о размерах и формате цвета.

bmiColors

Член структуры bmiColors, содержащий одно из перечисленного ниже:

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

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

Цвета в таблицу bmiColors включаются в соответствии с значимостью. Дополнительную информацию смотри в разделе Замечания.

Замечания

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

Точечный рисунок упаковывается тогда, когда растровый массив следует непосредственно за заголовком структуры BITMAPINFO. Сжатые точечные рисунки сосланы представляются одиночным указателем. Для упакованных точечных рисунков, член структуры biClrUsed должен быть приведен к четному числу при использовании режима DIB_PAL_COLORS так, чтобы массив точечного рисунка аппаратно-независимого растрового формата (DIB) начинался с границы двойного слова (DWORD).

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

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

Смотри также

Обзор Точечные рисунки, Структуры, используемые точечными рисунками, BITMAPCOREHEADER, CreateDIBitmap, CreateDIBPatternBrush, CreateDIBSection, RGBQUAD

Размещение и совместимость BITMAPINFO
Windows. NET Server	Да
Windows XP	Да
Windows 2000	Да
Windows NT	Да версии 3.1 и выше
Windows Me	Да
Windows 98	Да
Windows 95	Да
Используемая библиотека	Нет
Заголовочный файл
- объявлено в	Wingdi.h
- включено в	Windows.h
Unicode	Нет
Замечания по платформе	Не имеется

Назад в оглавление

На главную страницу

На оглавление справки