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