На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

GetDIBColorTable



The GetDIBColorTable function retrieves RGB (red, green, blue) color values from a range of entries in the color table of the DIB section bitmap that is currently selected into a specified device context.

UINT GetDIBColorTable(

HDC hdc, // handle of device context whose DIB is of interest
UINT uStartIndex, // color table index of first entry to retrieve
UINT cEntries, // number of color table entries to retrieve
RGBQUAD *pColors // pointer to buffer that receives color table entries
);


Parameters

hdc

Specifies a device context. A DIB section bitmap must be selected into this device context.

uStartIndex

A zero-based color table index that specifies the first color table entry to retrieve.

cEntries

Specifies the number of color table entries to retrieve.

pColors

Points to a buffer that receives an array of RGBQUAD data structures containing color information from the DIB's color table. The buffer must be large enough to contain as many RGBQUAD data structures as the value of cEntries.



Return Values

If the function succeeds, the return value is the number of color table entries that the function retrieves.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The GetDIBColorTable function should be called to retrieve the color table for DIB section bitmaps that use 1, 4, or 8 bits per pixel. The biBitCount member of a bitmap's associated BITMAPINFOHEADER structure specifies the number of bits per pixel. DIB section bitmaps with a biBitCount value greater than 8 do not have a color table, but they do have associated color masks. Call the GetObject function to retrieve those color masks.

See Also

BITMAPINFOHEADER, CreateDIBSection, DIBSECTION, GetObject, RGBQUAD, SetDIBColorTable


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

GetDIBColorTable



Функция GetDIBColorTable извлекает RGB (красный, зеленый, синий) цветные величины из дипазона данных на цветном столе побитового отображения секции DIB, которые к настоящему времени выбраны в определенный контекст устройства.

UINT GetDIBColorTable(

HDC hdc, // РУЧКА контекста устройства чье DIB - интересный UINT uStartIndex, // цветной табличный индекс первого входа, чтобы извлекать UINT cEntries, // номер цветных табличных данных, чтобы извлекать RGBQUAD *указатель pColors //, чтобы буферизовать эти приемники окрашивать табличные данные
);


Параметры

hdc

Определяет контекст устройства. Побитовое отображение секции DIB должно быть выбрано в этот контекст устройства.

uStartIndex

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

cEntries

Определяет номер цветных табличных данных, чтобы извлекаться.

pColors

Точки на буфер, которые получают массив структур данных RGBQUAD, содержащих цветную информацию из цветной таблицы DIB's. Буфер должен быть большой достаточно, чтобы содержать как много структуры данных RGBQUAD как величина cEntries.



Обратные Величины

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

Замечания

Функция GetDIBColorTable должна быть названа, чтобы извлекать цветную таблицу для побитовых отображений секции DIB, которые используют 1, 4, или 8 битов за пиксель. Элемент biBitCount побитового отображения связанной структуры BITMAPINFOHEADER определяет количество битов за пиксель. ПОБИТОВЫЕ отображения секции DIB с biBitCount оценивают больше, чем 8 нет иметь цветную таблицу, но они связали цветные маски. Назовите функцию GetObject, чтобы извлекать те цветные маски.

Смотри Также

BITMAPINFOHEADER, CreateDIBSection, DIBSECTION, GetObject, RGBQUAD, SetDIBColorTable


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz