Функция CheckColorsInGamut устанавливает, располагается ли заданный набор триплетов RGB в выводимой гамме цвета (gamut) заданного устройства. Триплеты RGB интерпретируются во входном логическом цветовом пространстве.
Синтаксис
BOOL WINAPI CheckColorsInGamut( HDC hDC, // дескриптор контекста устройства LPVOID lpRGBTriples, // массив триплетов RGB LPVOID lpBuffer, // буфер для результатов UINT nCount // число триплетов ); |
hDC
Дескриптор контекста устройства, выводимая гамма цвета которого будет проверена.
lpRGBTriples
Указатель на проверяемый массив триплетов RGB.
lpBuffer
Указатель на буфер, в который будут помещены результаты. Этот буфер должен быть по крайней мере такого же размера, сколько байтов в параметре nCount.
nCount
Число элементов в массиве триплетов.
Если эта функция завершается успешно, возвращаемое значение - значение отличное от нуля.
Если эта функция завершается ошибкой, возвращаемое значение - нуль.
Функция помещает результаты проверки в буфере, указанном при помощи параметра lpBuffer. Каждый байт в буфере соответствует триплету RGB (RGB triple), и имеет значение без знака между CM_IN_GAMUT (= 0) и CM_OUT_OF_GAMUT (= 255). Значение 0 обозначает, что цвет находится в гамме, в то время как значение отличное от нуля обозначает, что он - вне гаммы (невоспроизводимый цвет). Для любого целого числа n такого как 0 <n <255, значение результата n + 1 указывает, что соответствующий цвет по крайней мере столь же далек от гаммы, как если бы был обозначен значением результата n, как это определено Спецификацией формата профиля Международного консорциума по средствам обработки цветных изображений (ICC). Для получения дополнительной информации о ICC Спецификации формата профиля, см. источники, перечисленные в статье Дополнительная информация.
| Обратите внимание! на то, что этой функции, чтобы завершиться успешно, ICM должен разрешить дескриптор контекста устройства, который передается в через параметр hDC. ICM можно разрешить для дескриптора контекста устройства вызов при помощи функции SetICMMode. |
Смотри также
Обзор Основные концепции управления цветом, Функции, используемые ICM, SetICMMode
|
Размещение и совместимость CheckColorsInGamut |
||
| К | 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 | Нет | |
| Замечания по платформе | Не имеется | |