Функция CMCheckRGBs

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

Синтаксис

Параметры

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 должна возвратить нуль, чтобы указать сбой; буфер результатов может быть частично заполнен.

Смотри также 

Назад в оглавление

На главную страницу

На оглавление справки