Функция CMCheckRGBs

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

Синтаксис

BOOL WINAPI CMCheckRGBs(
  HCMTRANSFORM hcmTransform,
  LPVOID lpSrcBits,
  BMFORMAT bmInput, 
  DWORD dwWidth,
  DWORD dwHeight,
  DWORD dwStride, 
  LPBYTE lpaResult, 
  PBMCALLBACKFN pfnCallback,
  ULONG ulCallbackData 
);

Параметры

hcmTransform

Задает используемое преобразование цвета.

lpSrcBits

Указывает на точечный рисунок, который проверяется на соответствие выводимой гаммы.

bmInput

Определяет входной формат точечного рисунка.

dwWidth

Задает число пикселей на строку развертки во входном точечном рисунке.

dwHeight

Задает число строк развертки во входном точечном рисунке.

dwStride

Задает число байтов с начала одной строки развертки до начала следующей во входном точечном рисунке. Если параметр dwStride установлен в нуль, модуль управления цветом (CMM) должен допускать, что строки развертки дополнены, чтобы быть выровненными по границе СЛОВА (DWORD).

lpaResult

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

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

pfnCallback

Указатель на поставляемую приложением функцию обратного вызова, вызываемую периодически функцией CMCheckRGBs, чтобы сообщать о ходе процесса и давать возможность вызывающему процессу отменить преобразование. (См. описание функции ICMProgressProcCallback.)

ulCallbackData

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

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

Если эта функция завершает успешно, возвращаемое значение - ИСТИНА (TRUE).

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

Замечания

Каждый модуль управления цветом (CMM) обязан экспортировать эту функцию.

Если входной формат не совместим с преобразованием цвета, функция CMCheckRGBs завершается ошибкой.

Если функцией обратного вызова возвращен 0, обработка данных должна быть отменена, а функция CMCheckRGBs должна возвратить нуль, чтобы указать сбой; буфер результатов может быть частично заполнен.

Смотри также

Обзор Основные концепции управления цветом, Функции, используемые ICM, ICMProgressProcCallback

Размещение и совместимость CMCheckRGBs
К	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		Нет
Замечания по платформе		Не имеется