Поделиться через

Функция CheckColors (icm.h)

  • Статья

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

Синтаксис

BOOL CheckColors(
  HTRANSFORM hColorTransform,
  PCOLOR     paInputColors,
  DWORD      nColors,
  COLORTYPE  ctInput,
  PBYTE      paResult
);

Параметры

hColorTransform

Дескриптор используемого преобразования цвета.

paInputColors

Указатель на массив структур nColorsCOLOR для преобразования.

nColors

Содержит количество элементов в массивах, на которые указывают paInputColors и paResult.

ctInput

Указывает тип входного цвета.

paResult

Указатель на массив байтов nColors , который получает результаты теста.

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

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

Если эта функция завершается сбоем, возвращается значение FALSE. Чтобы получить дополнительные сведения об ошибке, вызовите Метод GetLastError.

Комментарии

Если входной тип цвета несовместим с преобразованием цвета, CheckColors завершается ошибкой .

Функция помещает результаты тестов в массив, на который указывает paResult. Каждый байт в массиве соответствует элементу COLOR в массиве, на который указывает paInputColors , и имеет значение без знака от 0 до 255. Значение 0 означает, что цвет находится в гамме, а ненулевое значение означает, что цвет выходит за пределы гаммы. Для любого целого числа n , такого как 0 <n< 255, результирующий значение n +1 указывает на то, что соответствующий цвет находится по крайней мере настолько далеко за пределы гаммы, как было бы указано результирующим значением n.

Сведения вне гаммы в тегах гаммы, созданных в WCS, используют расстояние между цветами восприятия в CIECAM02, что является средним квадратным корнем в пространстве CIECAM02 Jab. Расстояние в устаревших тегах гаммы профиля ICC — это средний квадратный корень в пространстве CIELAB. Мы рекомендуем использовать пространство CIECAM02, когда оно доступно, так как оно предоставляет более точные метрики расстояния.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть icm.h
Библиотека Mscms.lib
DLL Mscms.dll

См. также раздел