Функция TranslateBitmapBits (icm.h)
Преобразует цвета растрового рисунка в определенном формате, чтобы создать другое растровое изображение в запрошенном формате.
Синтаксис
BOOL TranslateBitmapBits(
HTRANSFORM hColorTransform,
PVOID pSrcBits,
BMFORMAT bmInput,
DWORD dwWidth,
DWORD dwHeight,
DWORD dwInputStride,
PVOID pDestBits,
BMFORMAT bmOutput,
DWORD dwOutputStride,
PBMCALLBACKFN pfnCallBack,
LPARAM ulCallbackData
);
Параметры
hColorTransform
Определяет используемое преобразование цвета.
pSrcBits
Указатель на точечный рисунок для преобразования.
bmInput
Задает формат входного растрового изображения. Необходимо задать одно из значений перечислимого типа BMFORMAT .
Примечание
Эта функция не поддерживает BM_XYZTRIPLETS или BM_YxyTRIPLETS в качестве входных данных.
dwWidth
Указывает количество пикселей на одну строку сканирования во входном растровом рисунке.
dwHeight
Указывает количество строк сканирования во входном растровом рисунке.
dwInputStride
Указывает количество байтов от начала одной строки сканирования до начала следующего во входном растровом рисунке; Если задано значение 0, функция предполагает, что линии сканирования заполнены так, чтобы они были выровнены по DWORD.
pDestBits
Указатель на буфер, в который будет помещено преобразованное растровое изображение.
bmOutput
Задает формат выходного растрового изображения. Необходимо задать одно из значений перечислимого типа BMFORMAT .
dwOutputStride
Указывает количество байтов от начала одной строки сканирования до начала следующей в выходном растровом рисунке; Если задано нулевое значение, функция предполагает, что линии сканирования должны быть заполнены для выравнивания по DWORD.
pfnCallBack
Указатель на функцию обратного вызова, периодически вызываемую translateBitmapBits , чтобы сообщить о ходе выполнения и позволить вызывающей процедуре отменить перевод. (См . раздел ICMProgressProcCallback )
ulCallbackData
Данные, передаваемые обратно в функцию обратного вызова, например, для идентификации перевода, сообщающего о ходе выполнения.
Возвращаемое значение
Если эта функция завершается успешно, возвращается значение TRUE.
Если эта функция завершается сбоем, возвращается значение FALSE. Для получения дополнительных сведений об ошибке вызовите Метод GetLastError.
Комментарии
Если форматы входных и выходных данных несовместимы с преобразованием цвета, эта функция завершается ошибкой.
При использовании любого из BMFORMAT с плавающей запятой, BM_32b_scARGB или BM_32b_scRGB, преобразуемые данные цвета не должны содержать NaN или бесконечность. NaN и infinity не считаются допустимыми значениями компонентов цвета, а результат преобразования пикселей, содержащих NaN или бесконечность, не имеет смысла в цветовом выражении. Значения NaN или бесконечности в обрабатываемых цветовых данных обрабатываются автоматически, и ошибка не будет возвращена.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Верхняя часть | icm.h |
| Библиотека | Mscms.lib |
| DLL | Mscms.dll |