Функция CMCreateTransform

Функция CMCreateTransform (ANSI) создает преобразование цвета, которое отображает из входной структуры LOGCOLORSPACE в необязательное целевое пространство, а затем на устройство вывода данных.

Синтаксис

HCMTRANSFORM WINAPI CMCreateTransform(
  LPLOGCOLORSPACEA lpColorSpace,       // указатель цветового пространства
  LPDEVCHARACTER lpDevCharacter,       // профиль устройства
  LPDEVCHARACTER lpTargetDevCharacter  // целевой профиль
);

Параметры

lpColorSpace

Указатель на входную структуру логического цветового пространства.

lpDevCharacter

Указатель на отображаемый в памяти файл с информацией для преобразования цвета. Для 16-битовых драйверов устройства, которые являются знающими ICM, параметр lpDevCharacter указывает на имя файла профиля.

lpTargetDevCharacter

Указывает на отображаемый в памяти целевой профиль.

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

Если эта функция завершается успешно, возвращаемое значение - значение преобразованого цвета в диапазоне 256 - 65 535. Так как сохраняется только младшее слово преобразования, допустимые величины преобразования не могут выйти за пределы этого диапазона.

Если эта функция завершается ошибкой, возвращаемое значение - код ошибки, имеющий значение меньше чем 256. Когда возвращаемое значение - меньше чем 256, сообщая об ошибке, Модуль управления цветом (CMM) должен использовать функцию SetLastError, чтобы установить код последней ошибки в правильное значение, как это определено в Winerror.h.

Замечания

Эквивалент Unicode функции CMCreateTransform является функция CMCreateTransformW.

Каждый Модуль управления цветом (CMM) обязан экспортировать эту функцию.

Прямое преобразование должно быть уже вычислено перед вызовом функции CMCreateTransform. Будущие вызовы функций перемещения (CMTranslateColors, CMTranslateRGB, CMTranslateRGBs и CMTranslateRGBsExt), использующих прямое преобразование не должны завершиться ошибкой из-за неспособности создать отображение.

Смотри также 

Обзор Основные концепции управления цветом, Функции, используемые ICM,   CMCreateTransformW, CMTranslateColors, CMTranslateRGB, CMTranslateRGBs, CMTranslateRGBsExt

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

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

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

Hosted by uCoz