Функция TranslateBitmapBits

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

Синтаксис

Параметры

hColorTransform

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

pSrcBits

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

bmInput

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

dwWidth

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

dwHeight

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

dwInputStride

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

pDestBits

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

bmOutput

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

dwOutputStride

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

pfnCallback

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

ulCallbackData

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

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

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

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

Замечания

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

Смотри также

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