Функция CreateMultiProfileTransform

Функция CreateMultiProfileTransform принимает массив профилей или единичный профиль, связанный с устройством (device link profile), и создает преобразование цвета, которое приложения могут использовать, чтобы выполнить подбор цвета.

Синтаксис

Параметры

pahProfiles

Указатель на массив дескрипторов используемых профилей.

nProfiles

Определяет число профилей в массиве.

padwIntent

Указатель на массив используемых преобразований цвета. Каждое преобразование - одно из нижеследующие значений:

INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC

Дополнительную информацию смотри в статье Методы преобразования цвета.

nIntents

Определяет число элементов в массиве преобразований: может быть или 1, или тем же самым значением, что и nProfiles.

dwFlags

Определяет флажки, которые используются для управления созданием преобразования. Подробности смотри в статье Создающие преобразование флажки Модуля управления цветом (CMM).

indexPreferredCMM

Определяет однобазисный индекс профиля цвета, который указывает какой модуль управления цветом (CMM) использовать. Разработчик прикладной программы может дать возможность Windows выбирать Модуль управления цветом (CMM), устанавливая этот параметр в INDEX_DONT_CARE. См. Использование Модулей управления цветом (CMM).

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

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

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

Замечания

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

Массив преобразований определяет, как профили должны комбинироваться. N-ое преобразование используется чтобы комбинировать n-ый профиль в массиве. Если определяется только одно преобразование, оно используется для первого профиля, а все другие профили комбинируются, используя направленность подбора (match intent).

Значения в dwFlags предназначаются только как подсказки. Модуль управления цветом (CMM) должен установить лучший способ их использования.

Функция CreateMultiProfileTransform используется вне контекста устройства (DC). Цвета могут сдвинуться, когда происходит преобразование профиля цвета в тот же самый профиль цвета. Это происходит из-за случайных ошибок. Поэтому при этих условиях преобразование цвета не должно выполняться.

Смотри также

Обзор Основные понятия управления цветом, Функции, используемые ICM, COLOR, DeleteColorTransform