Функция CreateMultiProfileTransform

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

Синтаксис

HTRANSFORM WINAPI CreateMultiProfileTransform(
  PHPROFILE pahProfiles,
  DWORD nProfiles,
  PDWORD padwIntent,
  DWORD nIntents,
  DWORD dwFlags,
  DWORD indexPreferredCMM 
);

Параметры

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

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

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

 

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

Hosted by uCoz