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

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

Синтаксис

BOOL CMCheckColors(
  HCMTRANSFORM hcmTransform,
  LPCOLOR      lpaInputColors,
  DWORD        nColors,
  COLORTYPE    ctInput,
  LPBYTE       lpaResult
);

Параметры

hcmTransform

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

lpaInputColors

Указатель на массив структур COLOR для проверки гаммы выходных данных.

nColors

Указывает количество элементов в массиве.

ctInput

Задает тип цвета ввода.

lpaResult

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

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

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

Если эта функция завершается ошибкой, возвращаемое значение равно FALSE. Если функция не выполнена успешно, CMM должен вызвать SetLastError , чтобы задать для последней ошибки допустимое значение ошибки, определенное в Winerror.h.

Замечания

Для экспорта этой функции требуется каждый CMM.

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

Требования

См. также

• Основные понятия управления цветами
• Функции