Функция CMCreateMultiProfileTransform (icm.h)

Принимает массив профилей или отдельный профиль связи устройства и создает преобразование цвета. Это преобразование — это сопоставление из цветового пространства, указанного первым профилем, с тем, что второй профиль и т. д.

Синтаксис

HCMTRANSFORM CMCreateMultiProfileTransform(
  PHPROFILE pahProfiles,
  DWORD     nProfiles,
  PDWORD    padwIntents,
  DWORD     nIntents,
  DWORD     dwFlags
);

Параметры

pahProfiles

Указывает на массив дескрипторов профиля.

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.

Массив намерений указывает, как следует объединять профили. Намерение nth используется для объединения профиля nth в массиве. Если указано только одно намерение, он используется для первого профиля, а все остальные профили объединяются с намерением Match.

Маркеры профиля, используемые для создания преобразования цвета, можно закрыть после завершения вызова CMCreateMultiProfileTransform .

Требования

См. также

• Основные понятия управления цветами
• Функции