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

Функция CheckColorsInGamut (wingdi.h)

  • Статья

Функция CheckColorsInGamut определяет, находится ли указанный набор rgb triples в выходной гамме указанного устройства. Триплы RGB интерпретируются во входном логическом цветовом пространстве.

Синтаксис

BOOL CheckColorsInGamut(
  HDC         hdc,
  LPRGBTRIPLE lpRGBTriple,
  LPVOID      dlpBuffer,
  DWORD       nCount
);

Параметры

hdc

Дескриптор контекста устройства, чей выходной гаммы необходимо проверить.

lpRGBTriple

Указатель на массив rgb тройных значений проверка.

dlpBuffer

Указатель на буфер, в который должны быть помещены результаты. Размер этого буфера должен быть не меньше nCount байт.

nCount

Количество элементов в массиве тройных значений.

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

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

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

Комментарии

Функция помещает результаты теста в буфер, на который указывает lpBuffer. Каждый байт в буфере соответствует rgb-тройке и имеет неподписанное значение в диапазоне от CM_IN_GAMUT (= 0) до CM_OUT_OF_GAMUT (= 255). Значение 0 означает, что цвет находится в гамме, а ненулевое значение указывает на то, что цвет выходит за пределы гаммы. Для любого целого числа n , такого как 0 <n< 255, результируемое значение n + 1 указывает, что соответствующий цвет по крайней мере настолько далеко от гаммы, как это было бы указано результирующим значением n, как указано в спецификации формата профиля ICC. Дополнительные сведения о спецификации формата профиля ICC см. в источниках, перечисленных в разделе Дополнительные сведения .

Обратите внимание, что для успешного выполнения этой функции необходимо включить WCS для дескриптора контекста устройства, который передается через параметр hDC . WCS можно включить для дескриптора контекста устройства, вызвав функцию SetICMMode .

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header wingdi.h
Библиотека Gdi32.lib
DLL Gdi32.dll

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