Функция CheckColors определяет, лежат ли цвета в массиве в пределах выводимой гаммы цвета (gamut) заданного преобразования.
Синтаксис
BOOL WINAPI CheckColors( HTRANSFORM hColorTransform, PCOLOR paInputColors, DWORD nColors, COLORTYPE ctInput, PBYTE paResult ); |
hColorTransform
Дескриптор используемого преобразования цвета.
paInputColors
Указатель на преобразуемый массив nColors структур COLOR.
nColors
Содержит число элементов в массивах, на которые указывают параметры paInputColors и paResult.
ctInput
Определяет тип вводимых данных о цвете.
paResult
Указатель на массив nColors байтов, который получает результаты проверки.
Если эта функция завершается успешно, возвращаемое значение - ИСТИНА (TRUE).
Если эта функция завершается ошибкой, возвращаемое значение - ЛОЖЬ (FALSE). Для дополнительной информации об ошибке, вызовите GetLastError.
Если тип вводимых данных о цвете не совместим с преобразованием цвета, CheckColors завершается ошибкой.
Результаты проверки функция помещает в массиве указанном параметром paResult. Каждый байт в массиве соответствует элементу COLOR в массиве, указанном параметром paInputColors и имеет значение без знака между 0 и 255. Значение 0 обозначает, что цвет находится в гамме, в то время как значение отличное от нуля обозначает, что он - вне гаммы (невоспроизводимый цвет). Для любого целого числа n такого как 0 <n <255, значение результата n+1 указывает, что соответствующий цвет по крайней мере столь же далек от гаммы, как если бы был обозначен значением результата n.
Смотри также
Обзор Основные концепции управления цветом, Функции, используемые ICM, COLOR
|
Размещение и совместимость CheckColors |
||
| К | Windows XP | Да |
| л | Windows 2000 Professional | Да |
| и | Windows NT Workstation | Нет |
| е | Windows Me | Да |
| н | Windows 98 | Да |
| т | Windows 95 | Нет |
| С | Windows Server 2003 | Да |
| е | Windows 2000 Server | Да |
| р | Windows NT Server | Нет |
| в | ||
| е | ||
| р | ||
| Используемая библиотека | Mscms.lib | |
| Используемая DLL | - | |
| Заголовочный файл | ||
| - объявлено в | Icm.h | |
| - включено в | - | |
| Unicode | Нет | |
| Замечания по платформе | Не имеется | |