Функция CheckColors

Функция 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 Нет
 Замечания по платформе Не имеется

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz