Функция CheckBitmapBits

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

Синтаксис

Параметры

hColorTransform

Дескриптор используемого преобразования цвета.

pSrcBits

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

bmInput

Определяет формат точечного рисунка. Должен быть установлен в одном из значений перечислимого типа BMFORMAT.

dwWidth

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

dwHeight

Определяет число строк развертки точечного рисунка.

dwStride

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

paResult

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

pfnCallback

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

lpCallbackData

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

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

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

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

Замечания

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

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

Смотри также 

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

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

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