Функция TranslateBitmapBits

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

Синтаксис

BOOL WINAPI TranslateBitmapBits(
  HTRANSFORM hColorTransform,
  PVOID pSrcBits,
  BMFORMAT bmInput,
  DWORD dwWidth,
  DWORD dwHeight,
  DWORD dwInputStride,
  PVOID pDestBits,
  BMFORMAT bmOutput,
  DWORD dwOutputStride,
  PBMCALLBACKFN pfnCallback,
  ULONG ulCallbackData
);

Параметры

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

Размещение и совместимость TranslateBitmapBits

К Windows XP Да 
л Windows 2000 Professional Да
и Windows NT Workstation Нет
е Windows Me Да
н Windows 98 Да
т Windows 95 Нет
 
С Windows Server 2003 Да
е Windows 2000 Server Да
р Windows NT Server Нет
в    
е    
р    
Используемая библиотека Mscms.lib
Используемая DLL -
 Заголовочный файл  
- объявлено в Icm.h
 - включено в -
 Unicode Нет
 Замечания по платформе Не имеется

 

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz