Функция 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 | Нет | |
| Замечания по платформе | Не имеется | |