Функция CMCheckColors определяет, находятся ли данные цвета в пределах выводимой гаммы (gamut) заданного преобразования.
Синтаксис
BOOL WINAPI CMCheckColors( HCMTRANSFORM hcmTransform, // дескриптор преобразования LPCOLOR lpaInputColors, // массив COLORs DWORD nColors, // размер массива COLOR 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) обязан экспортировать эту функцию.
Смотри также
Обзор Основные концепции управления цветом, Функции, используемые ICM
|
Размещение и совместимость CMCheckColors |
||
| К | Windows XP | Да |
| л | Windows 2000 Professional | Да |
| и | Windows NT Workstation | Нет |
| е | Windows Me | Да |
| н | Windows 98 | Да |
| т | Windows 95 | Нет |
| С | Windows Server 2003 | Да |
| е | Windows 2000 Server | Да |
| р | Windows NT Server | Нет |
| в | ||
| е | ||
| р | ||
| Используемая библиотека | Gdi32.lib | |
| Используемая DLL | - | |
| Заголовочный файл | ||
| - объявлено в | Wingdi.h | |
| - включено в | - | |
| Unicode | Нет | |
| Замечания по платформе | Не имеется | |