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

Статья
03/09/2024

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

Синтаксис

typedef struct tagBITMAPCOREINFO {
  BITMAPCOREHEADER bmciHeader;
  RGBTRIPLE        bmciColors[1];
} BITMAPCOREINFO, *LPBITMAPCOREINFO, *PBITMAPCOREINFO;

Члены

bmciHeader

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

bmciColors[1]

Задает массив структур RGBTRIPLE , определяющих цвета в растровом рисунке.

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

Элемент bcBitCount структуры BITMAPCOREHEADER определяет количество битов, определяющих каждый пиксель, и максимальное количество цветов в растровом рисунке. Этот элемент может иметь одно из следующих значений.

Значение	Значение
1	Растровое изображение является монохромным, а элемент bmciColors содержит две записи. Каждый бит в массиве растровых изображений представляет пиксель. Если бит является ясным, пиксель отображается с цветом первой записи в таблице bmciColors ; Если бит задан, пиксель имеет цвет второй записи в таблице.
4	Растровое изображение имеет не более 16 цветов, а член bmciColors содержит до 16 записей. Каждый пиксель на растровом рисунке представлен 4-разрядным индексом в таблице цветов. Например, если первый байт в растровом изображении является 0x1F, то байт представляет два пикселя. Первый пиксель содержит цвет во второй записи таблицы, а второй пиксель содержит цвет в шестнадцатой записи таблицы.
8	Растровое изображение имеет не более 256 цветов, а член bmciColors содержит до 256 записей. В этом случае каждый байт в массиве представляет один пиксель.
24	Растровое изображение имеет не более 2 (24) цветов, а член bmciColors имеет значение NULL. Каждый трехбайтовый триплет в массиве растровых изображений представляет относительную интенсивность синего, зеленого и красного соответственно для пикселя.

Цвета в таблице bmciColors должны отображаться в порядке важности.

Кроме того, для функций, использующих DIB, элемент bmciColors может быть массивом 16-разрядных целых чисел без знака, указывающих индексы в реализованной в настоящее время логической палитре, а не явные значения RGB. В этом случае приложение, использующее точечный рисунок, должно вызывать функции DIB ( CreateDIBitmap, CreateDIBPatternBrush и CreateDIBSection ) с параметром iUsage , равным DIB_PAL_COLORS.

Примечание

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

Требования

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