Функция CMCreateMultiProfileTransform принимает массив профилей или единичного профиля связанного с устройством (device link profile) и создает преобразование цвета. Это преобразование - отображение из цветового пространства, определенного первым профилем, на то которое из второго профиля и так далее до последнего.
Синтаксис
HCMTRANSFORM CMCreateMultiProfileTransform( LPHPROFILE lpahProfiles, // массив дескрипторов профилей DWORD nProfiles, // размер массива дескрипторов профиля PDWORD padwIntents, // массив направленности обработки DWORD nIntents, // размер массива направленности DWORD dwFlags // флажки создания преобразования ); |
lpahProfiles
Указывает на массив дескрипторов профилей.
nProfiles
Определяет число профилей в массиве.
padwIntents
Указывает на массив направленности обработки. Каждое направление обработки представляется одним из нижеследующих значений:
| INTENT_PERCEPTUAL INTENT_SATURATION INTENT_RELATIVE_COLORIMETRIC INTENT_ABSOLUTE_COLORIMETRIC |
Дополнительную информацию, см. в статье Методы преобразования цвета.
nIntents
Определяет число направлений в массиве направленностей. Оно может быть 1, или то же самое значение, что и параметр nProfiles.
dwFlags
Определяет флажки используемые для управления созданием преобразования. Детали смотри в статье Создающие преобразование флажки Модуля управления цветом (CMM).
Если эта функция завершается успешно, возвращаемое значение - преобразование цвета в диапазоне 256 - 65 535. Поскольку сохраняется только младшее СЛОВО (WORD) преобразования, допустимые преобразования не могут выйти за пределы этого диапазона.
Если эта функция завершается ошибкой, возвращаемое значение - код ошибки, имеющий значение меньше чем 256. Когда возвращаемое значение - меньше чем 256, сообщая об ошибке, Модуль управления цветом (CMM) должен использовать функцию SetLastError, чтобы установить последнюю ошибку в правильное значение ошибки как определено в Winerror.h.
Каждый Модуль управления цветом (CMM) обязан экспортировать эту функцию.
Массив методов преобразования определяет, как профили должны комбинироваться. n-ое направление используется чтобы комбинировать n-ый профиль в массиве. Если определяется только один метод, он используется для первого профиля, а все другие профили комбинируются, используя Метод подбора (Match intent).
Дескрипторы профиля, используемые, чтобы создать преобразование цвета могут закрываться после того, как вызов функции CMCreateMultiProfileTransform завершает работу.
Смотри также
Обзор Основные концепции управления цветом, Функции, используемые ICM
|
Размещение и совместимость CMCreateMultiProfileTransform |
||
| К | 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 | Нет | |
| Замечания по платформе | Не имеется | |