Функции GDI Win-32, страница 3

Если Вы больше не нуждаетесь в побитовом отображении, вызовите функцию DeleteObject, чтобы удалить его.

Функция CreateDIBitmap может быть аппаратно-зависимым побитовым отображением (DDB); независимым побитовым отображением (DIB) и может произвольно устанавливать  отображение .

HBITMAP CreateDIBitmap (

HDC hdc,                                                       // обработка контекста устройства

CONST BITMAPINFOHEADER * lpbmih,         // адрес побитового отображения размера и   

данных формата

DWORD fdwInit,                                                // инициализация флага

CONST VOID   *lpbInit,                                     // адрес инициализации данных

CONST BITMAPINFO * lpbmi,                         // адрес побитового отображения данных в   

цветном формате

UINT fuUsage                                                    // использование с  цветным данными

);       

Параметры

Hdc

Опознает контекст устройства.

Lpbmih

Указатель на структуру BITMAPINFOHEADER.

Функция fdwInit - CBM_INIT  использует структуру BITMAPINFOHEADER для того, чтобы получить желаемую ширину и высоту побитового отображения . Обратите внимание, что положительное значение для высоты указывает на возрастающее значение DIB, в то время как отрицательное значение для высоты указывает на нисходящее значение DIB. Это свойство аналогично с функцией CreateDIBitmap.

FdwInit

Набор флагов, которые определяют как побитовые отображения инициализируют операционную систему.

Следующий флаг может быть определен:

Значение        Значение

CBM_INIT        , если этот флаг установлен, операционная система использует данные, указанные параметрами lpbInit и lpbmi для  инициализации побитовых отображений. Если флаг пуст, данные, указанные этими параметрами не используются.

Если fdwInit нулевой, операционная система не инициализирует побитовые отображения.

LpbInit

Указатель на адрес, содержащий начальные данные побитового отображения. Формат данных зависит от переменной biBitCount структуры BITMAPINFO, на которую указывает параметр lpbmi.

Lpbmi

Указатель на структуру BITMAPINFO, которая описывает измерения и формат цвета множества, указанного lpbInit параметром.

FuUsage

Определяет, была ли переменная bmiColors структуры BITMAPINFO инициализированна и, если да,то содержит ли bmiColors явные красные, зеленые, синие цвета (RGB) или индексы палитры. Параметром FuUsage должно быть одно из следующих значений:

Значение          Значение

DIB_PAL_COLORS        Таблица цветов загружена в логическую палитру контекста устройства, в который должно быть отобрано побитовое отображение.

DIB_RGB_COLORS       Таблица цветов загружена и содержит литерал RGB ценности.

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

Если функция выполнена успешно, возвращаемое значение обрабатывает побитовое отображение

Если функция выполнена неуспешно, возвращаемое значение нулевое

Замечания

CBM_CREATDIB флаг для параметра fdwInit не поддерживается.

Функция CreateDIBSection создает аппаратно-независимые побитовые отображения (DIB). Функция дает Вам указатель на адрес значений побитовых отображений. Вы можете позволять операционной системе размещать память для побитовых отображений.

HBITMAP CreateDIBSection (

HDC hdc,                               // обработка контекста устройства

CONST BITMAPINFO *pbmi,             // адрес структуры, содержащей размер, формат, и цветные  

данные побитового отображения

UINT iUsage,                         // окрашивают индикатор типа данных RGB или оценивает индексы палитры

VOID   ** ppvBits,                    // указатель на переменную, чтобы получить указатель на значение битов побитовоых отображений

HANDLE с hSection,                 // необязательная обработка  цели отображения объекта файла

DWORD dwOffset                  // смещение бита к значению побитового отображения в пределах отображения объекта файла

);