Функция CheckColorsInGamut

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