Менеджер ColorSync ссылка

Обсуждение

Если CMOpenProfile функция выполняется успешно, ссылка профиля относится к открытому профилю. Ваше приложение использует эту ссылку, например, когда это вызывает функции для окраски соответствия, скопируйте, и обновите профиль и проверьте его содержание.

Менеджер ColorSync поддерживает частное хранение для каждого запроса для открытия профиля, позволяя больше чем одному приложению использовать профиль одновременно.

Когда Вы создаете новый профиль или изменяете элементы существующего профиля, менеджер ColorSync хранит новые или измененные элементы в частном хранении, которое это поддерживает для Вашего приложения. Любые новые или измененные элементы профиля не включены в сам профиль, если Ваше приложение не вызывает функцию CMUpdateProfile обновлять профиль. Если Вы вызываете функцию CMCopyProfile для создания копии существующего профиля под новым именем любые изменения, которые Вы внесли, включены в копию профиля, но исходный профиль остается неизменным.

Перед вызовом CMOpenProfile функция, необходимо установить CMProfileLocation структура данных для идентификации расположения профиля для открытия. Обычно, профиль сохранен в дисковом файле. Если профиль находится в дисковом файле, используйте тип данных расположения профиля для обеспечения его спецификации файла. Если профиль находится в памяти, используйте тип данных расположения профиля для указания дескриптора или указателя на профиль. Если к профилю получают доступ через процедуру, предоставленную Вашим приложением, используйте тип данных расположения профиля для предоставления универсального указателя процедуры на процедуру.

Ваше приложение должно получить ссылку профиля, прежде чем Вы скопируете или проверите профиль, и перед выравниванием профиля для встраивания его.

Например, Ваше приложение может:

• откройте профиль

• вызовите CMGetProfileHeader функция для получения заголовка профиля для изменения его значений

• установите новые значения

• вызовите CMSetProfileHeader функционируйте для замены измененного заголовка

• передайте ссылку профиля на функцию такой как NCWNewColorWorld как источник или целевой профиль в цветном мире для сеанса согласования цветов

• Когда Вы закрываете свою ссылку на профиль путем вызывания функции CMCloseProfile, Ваши изменения отбрасываются (если Вы не вызвали CMUpdateProfile функция).

Обсуждение

Когда Ваше приложение вызывает CMValidateProfile функция, менеджер ColorSync диспетчеризирует функцию CMM, указанному CMMType поле заголовка профиля, ссылку которого Вы указываете. Предпочтительный CMM может поддерживать эту функцию или нет.

Если предпочтительный CMM поддерживает эту функцию, она определяет, содержит ли профиль базовые элементы для класса профиля, которого CMM требует для выполнения проверки палитры или согласования цветов. Для каждого класса профиля, такого как профиль устройства, существует определенный набор требуемых маркированных элементов, определенных ICC, который должен включать профиль. ICC также определяет дополнительные теги, которые могут быть включены в профиль. CMM мог бы использовать эти дополнительные элементы, чтобы оптимизировать или улучшить его обработку. Кроме того, профиль мог бы включать теги скрытия, определенные для обеспечения CMM обработкой возможности, определенной к потребностям того CMM. Разработчик профиля может определить эти теги скрытия, зарегистрировать подписи тега в ICC и включать теги в профиль. CMM проверяет только на существование элементов профиля, оно не проверяет содержание и размер элемента.

Если предпочтительный CMM не поддерживает CMValidateProfile функционируйте запрос, Вызовы диспетчера ColorSync CMM по умолчанию для обрабатывания запроса проверки.

Обсуждение

Менеджер ColorSync сохраняет счет внутренней ссылки для каждой ссылки профиля возвращенным от вызова до CMOpenProfile, CMNewProfile, CMCopyProfile, или CWNewLinkProfile функции. Вызывание функции CMCloneProfileRef постепенно увеличивает количество; вызов CMCloseProfile функционируйте постепенно уменьшает его. Профиль остается открытым, пока подсчет ссылок больше, чем 0, указывая, что существует по крайней мере одна остающаяся ссылка на профиль. Когда количество достигает 0, менеджер ColorSync выпускает всю частную память, файлы или ресурсы, выделенные в сотрудничестве с тем профилем.

Когда менеджер ColorSync выпускает всю частную память и ресурсы, связанные с профилем, любые временные изменения, Ваша заявка, поданная в профиль, не сохраняется, если Вы сначала не вызываете CMUpdateProfile функция для обновления профиля.

Когда Ваше приложение передает копию ссылки профиля на независимую задачу, или синхронный или асинхронный, оно должно вызвать функцию CMCloneProfileRef постепенно увеличить подсчет ссылок. И вызванная задача и вызывающая сторона должны вызвать CMCloseProfile по окончании со ссылкой профиля.

Вы вызываете CMCloneProfileRef после копирования ссылки профиля, но не после дублирования всего профиля (как с CMCopyProfile функция).

Когда Ваше приложение передает копию ссылки профиля внутренне, оно, возможно, не должно вызывать CMCloneProfileRef, пока вызовы приложения CMCloseProfile один раз для профиля.

В Вашем приложении удостоверьтесь это CMCloseProfile вызывается один раз в течение каждого раза, когда ссылка профиля создана или клонирована. Иначе, частная память и ресурсы, связанные со ссылкой профиля, не могут быть должным образом освобождены, или приложение может попытаться использовать ссылку профиля, которая больше не действительна.

Если Вы создаете новый профиль путем вызова CMNewProfile когда Вы вызываете, функция, профиль сохраняется на диск CMCloseProfile функционируйте, если Вы не указали NULL как расположение профиля, когда Вы создали профиль.

Для сохранения изменений в профиле прежде, чем закрыть его используйте функцию CMUpdateProfile.

Обсуждение

CMUpdateProfile функция делает постоянным любые изменения или дополнения, которые Ваше приложение сделало к профилю идентифицированный ссылкой профиля, если не существуют никакие другие ссылки на тот профиль.

Менеджер ColorSync поддерживает измененный флаг, чтобы отследить, был ли изменен профиль. После обновления профиля, CMUpdateProfile функционируйте устанавливает значение измененного флага для того профиля к false.

Каждый раз приложение вызывает функцию CMOpenProfile, функция создает уникальную ссылку на профиль. Приложение может также копировать ссылку профиля путем передачи копии другой задаче. Вы не можете использовать CMUpdateProfile функция для обновления профиля, если больше чем одна ссылка на профиль существует — пытающийся сделать так, приведет к ошибочному возврату. Можно вызвать функцию CMGetProfileRefCount определить подсчет ссылок для ссылки профиля.

Вы не можете использовать CMUpdateProfile функция для обновления профиля ColorSync 1.0.

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

При изменении открытого профиля необходимо вызвать CMUpdateProfile сохранить изменения в файле профиля, прежде чем Вы вызовете функцию CMCloseProfile. Иначе, изменения отбрасываются.

Для изменения заголовка профиля Вы используете функцию CMGetProfileHeader и функция CMSetProfileHeader.

Для установки элементов профиля вне заголовка Вы используете функцию CMSetProfileElement, функция CMSetProfileElementSize, и функция CMSetPartialProfileElement.

Обсуждение

CMCopyProfile функционируйте копирует весь открытый профиль, ссылку которого Вы указываете. При внесении временных изменений в профиль который Вы не сохранили путем вызова CMUpdateProfile, те изменения включены в дублированный профиль. Они не сохраняются к исходному профилю, если Вы не вызываете CMUpdateProfile для того профиля.

Менеджер ColorSync поддерживает измененный флаг, чтобы отследить, был ли изменен профиль. После копирования профиля, CMCopyProfile функционируйте устанавливает значение измененного флага для того профиля к false.

Если Вы не копируете профиль, который Вы создали, Вы не должны посягать на защиту авторских прав, указанную создателем профиля. Для получения информации об авторском праве Вы вызываете функцию CMGetProfileElement, указание cmCopyrightTag подпись тега для элемента авторского права (определенный в CMICCProfile.h заголовочный файл).

Необходимо также проверить flags поле структуры заголовка профиля CM2Header для получения информации об авторском праве. Можно протестировать cmEmbeddedUseMask бит поля флагов, чтобы определить, может ли профиль использоваться независимо. Если бит установлен, необходимо использовать этот профиль в качестве встроенного профиля только и не скопировать профиль в собственных целях. cmEmbeddedUseMask маска описана в Определениях Маски Флага для Профилей Версии 2.x. Следующий фрагмент кода показывает, как Вы могли бы выполнить тест с помощью cmEmbeddedUseMask маска:

Калибровочная программа, например, могла бы использовать CMCopyProfile функционируйте, чтобы скопировать исходный профиль устройства, затем изменить копию для отражения текущего состояния устройства. Или приложение могло бы хотеть скопировать профиль после невыравнивания его.

Для копирования профиля необходимо получить ссылку на тот профиль или открытием профиля или созданием его. Для открытия профиля используйте функцию CMOpenProfile. Для создания нового профиля используйте функцию CMNewProfile. Как альтернатива использованию CMCopyProfile функционируйте для дублирования всего профиля, можно использовать ту же ссылку профиля несколько раз. Для этого Вы вызываете функцию CMCloneProfileRef для постепенного увеличения подсчета ссылок для ссылки каждый раз, Вы снова используете его. Вызов CMCloneProfileRef функционируйте постепенно увеличивает количество; вызывание функции CMCloseProfile декременты это. Профиль остается открытым, пока подсчет ссылок больше, чем 0, указывая, что по крайней мере одна подпрограмма сохраняет ссылку на профиль.

Обсуждение

Когда профиль сначала открыт, его измененный флаг установлен в false. На вызовах, добавляющих к, удалите из или установите заголовок профиля или теги, измененный флаг установлен в true. После вызывания функции CMUpdateProfile, измененный флаг сбрасывается к false.

Обсуждение

Можно вызвать эту функцию, чтобы определить, идентичны ли два профиля, или если профиль изменялся в течение долгого времени. Можно получить доступ к этой новой контрольной сумме MD5 непосредственно в заголовке профиля или использовать функцию CMGetProfileMD5. Эта функция имеет преимущество, что это работает и с профилями ICC 4 и с более ранними профилями.

Обсуждение

CMGetProfileHeader функционируйте возвращает заголовок для профиля ColorSync 1.0 или ColorSync 2.x. Для возврата заголовка функция использует объединение типа CMAppleProfileHeader, с вариантами для заголовков версии 1.0 и 2.x.

32-разрядное значение версии расположено при том же смещении в любом заголовке. Для профилей ColorSync 2.x это profileVersion поле. Для профилей ColorSync 1.0 это applProfileVersion поле. Можно проверить значение при этом смещении, чтобы определить версию профиля и интерпретировать остающиеся поля заголовка соответственно.

Для копирования заголовка профиля в профиль после изменения содержания заголовка используйте функцию CMSetProfileHeader.

Обсуждение

Можно использовать CMSetProfileHeader функционируйте для установки заголовка для версии 1.0 или профиля версии 2.x. Прежде чем Вы вызовете эту функцию, необходимо установить значения для заголовка, в зависимости от версии профиля. Для профиля версии 2.x Вы используете структуру данных типа CM2Header. Для профиля версии 1.0 Вы используете структуру данных типа CMHeader. Вы передаете заголовок, который Вы предоставляете в CMAppleProfileHeader объединение, описанное в CMAppleProfileHeader.

Обсуждение

Когда Ваше приложение вызывает CMValidateProfile функция, менеджер ColorSync диспетчеризирует функцию CMM, указанному CMMType поле заголовка профиля, ссылку которого Вы указываете. Предпочтительный CMM может поддерживать эту функцию или нет.

Чтобы открыть профиль и получить ссылку на него, используйте функцию CMOpenProfile.

Обсуждение

NCMGetProfileLocation функция доступна начиная с версии 2.5 ColorSync. Это отличается от своего предшественника, CMGetProfileLocation, в этом более новая версия имеет параметр для размера структуры расположения для указанного профиля.

Необходимо использовать NCMGetProfileLocation вместо CMGetProfileLocation по следующим причинам:

• Код с помощью более старой версии (CMGetProfileLocation) может не быть как легко портирован на другие платформы.

• Указание размера структуры расположения профиля гарантирует, что может расти, при необходимости, в будущем.

Лучший способ использовать NCMGetProfileLocation должен вызвать его дважды:

1. Передайте ссылку на профиль для определения местоположения в prof параметр и NULL для profLoc параметр. NCMGetProfileLocation возвращает размер структуры расположения в locationSize параметр.

2. Выделите достаточно площади для структуры возвращенного размера, затем вызовите функцию снова, передав указатель в profLoc параметр; по возврату структура указывает расположение профиля.

Возможно вызвать NCMGetProfileLocation только один раз, с помощью константы cmCurrentProfileLocationSize для размера выделенной структуры расположения профиля и передачи той же константы для locationSize параметр. Константа cmCurrentProfileLocationSize может измениться в будущем, но будет непротиворечивым в наборе заголовков, с которыми Вы создаете свое приложение. Однако, если размер CMProfileLocation структура изменяется в будущей версии ColorSync (и значение cmCurrentProfileLocationSize также), и Вы не восстанавливаете свое приложение, NCMGetProfileLocation может возвратить ошибку.

Обсуждение

Менеджер ColorSync сохраняет счет внутренней ссылки для каждой ссылки профиля возвращенным от вызова до CMOpenProfile, CMNewProfile, или CMCopyProfile функции. Вызов CMCloneProfileRef функционируйте постепенно увеличивает количество; вызывание функции CMCloseProfile декременты это. Профиль остается открытым, пока подсчет ссылок больше, чем 0, указывая, что по крайней мере одна подпрограмма сохраняет ссылку на профиль. Когда количество достигает 0, менеджер ColorSync выпускает всю частную память, файлы или ресурсы, выделенные в сотрудничестве с тем профилем.

Когда Ваше приложение создает копию всего профиля с CMCopyProfile, копия имеет свой собственный подсчет ссылок. CMCloseProfile подпрограмму нужно вызвать для скопированного профиля, так же, как для оригинала. Когда подсчет ссылок достигает 0, частные ресурсы, связанные со скопированным профилем, освобождены.

Когда Ваше приложение просто копирует ссылку профиля, как оно может сделать для передачи ссылки профиля на синхронное или асинхронную задачу, оно должно вызвать CMCloneProfileRef постепенно увеличить подсчет ссылок. И вызванная задача и вызывающая сторона должны вызвать CMCloseProfile по окончании со ссылкой профиля.

В Вашем приложении необходимо удостовериться это CMCloseProfile вызывается один раз в течение каждого раза, когда ссылка профиля создана или клонирована. Иначе, память и ресурсы, связанные со ссылкой профиля, не могут быть должным образом освобождены, или приложение может попытаться использовать ссылку профиля, которая больше не действительна.

Обсуждение

Менеджер ColorSync сохраняет счет внутренней ссылки для каждой ссылки профиля возвращенным из вызовов такой как CMOpenProfile или CMNewProfile. Вызывание функции CMCloneProfileRef постепенно увеличивает количество; вызывание функции CMCloseProfile декременты это. Профиль остается открытым, пока подсчет ссылок больше, чем 0, указывая, что по крайней мере одна подпрограмма сохраняет ссылку на профиль. Когда количество достигает 0, менеджер ColorSync выпускает всю память, файлы или ресурсы, выделенные в сотрудничестве с тем профилем.

Приложение, управляющее профилями близко, может вызвать CMGetProfileRefCount функция для получения подсчета ссылок для ссылки профиля затем выполните специальную обработку при необходимости, на основе подсчета ссылок.

Скопировать профиль с функцией CMCopyProfile, необходимо получить ссылку на тот профиль или открытием профиля или созданием его. Для открытия профиля используйте функцию CMOpenProfile. Для создания нового профиля используйте функцию CMNewProfile. Как альтернатива использованию CMCopyProfile функционируйте для дублирования всего профиля, можно использовать ту же ссылку профиля несколько раз. Для этого Вы вызываете функцию CMCloneProfileRef для постепенного увеличения подсчета ссылок для ссылки каждый раз, Вы снова используете его. Вызов CMCloneProfileRef функционируйте постепенно увеличивает количество; вызывание функции CMCloseProfile декременты это. Профиль остается открытым, пока подсчет ссылок больше, чем 0, указывая, что по крайней мере одна подпрограмма сохраняет ссылку на профиль.

Обсуждение

Менеджер ColorSync передает CMM указатель на Вашу сглаживающую профиль функцию. CMM вызывает Вашу функцию CMFlattenProcPtr выполнять фактическую передачу данных.

Для несглаживания профиля, встроенного в графический документ файлу независимого диска, используйте функцию, “Получающую доступ к Элементам Профиля”.

Обсуждение

Начиная с версии 2.5 ColorSync, когда для Вашего приложения нужна информация о профилях, в настоящее время доступных в папке ColorSync Profiles, это может вызвать CMIterateColorSyncFolder подпрограмма, поочередно вызывающая Вашу подпрограмму обратного вызова один раз для каждого профиля.

Даже при том, что может быть много доступных профилей, CMIterateColorSyncFolder может использовать в своих интересах кэш профиля ColorSync для возврата информации о профиле быстро, и (если кэш допустим), не имея необходимость открывать любые профили. Для каждого профиля, CMIterateColorSyncFolder предоставляет Вашу подпрограмму заголовок профиля, код сценария, имя и расположение, в структуре типа CMProfileIterateData. В результате Ваша подпрограмма может быть в состоянии выполнить свою функцию, такую как создание списка профилей для отображения во всплывающем меню, без дальнейшего усилия (такого как открытие каждого основанного на файле профиля).

Только 2.x профили включены в результат поиска профиля.

Перед вызовом CMIterateColorSyncFolder впервые, Вы обычно устанавливаете seed к 0. ColorSync выдерживает сравнение 0 с его текущим семенем для кэша профиля. Маловероятно, что они будут соответствовать — разногласия - примерно один в двух миллиардах против него. Если значения не соответствуют, подпрограмма выполняет итерации через все профили в кэше, вызывая Вашу подпрограмму обратного вызова один раз для каждого профиля. CMIterateColorSyncFolder тогда возвращает фактическое значение семени в seed (если Вы не передали NULL для того параметра).

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

Обратите внимание на то, что можно передать a NULL указатель для seed параметр без вреда. Результат совпадает с при передаче указателя на 0 в котором функция выполняет итерации через доступные профили, вызывая подпрограмму обратного вызова один раз для каждого профиля. Однако функция не возвращает значение семени, так как Вы не передали допустимый указатель.

Можно вынудить ColorSync вызвать подпрограмму обратного вызова (если какие-либо профили доступны) путем передачи a NULL указатель или путем передачи 0 для значения семени. Но предположите, что Вы переносите операцию, такую как создание всплывающего меню, которое Вы только хотите выполнить, если изменились доступные профили. В этом случае Вы передаете значение семени от предыдущего вызова до CMIterateColorSyncFolder. Если папка профиля не изменилась, ColorSync не вызовет Вашу подпрограмму обратного вызова.

Обратите внимание на то, что, при отсутствии доступных профилей, ColorSync не вызывает Вашу подпрограмму обратного вызова.

Можно безопасно передать NULL для любых из параметров к CMIterateColorSyncFolder функция. Если Вы передаете NULL для всех параметров, вызывая функцию просто вызывает восстановление кэша профиля, при необходимости.

Обсуждение

Если папка ColorSync Profiles уже не существует, можно использовать эту функцию для создания ее.

Обсуждение

CMNewProfile функция создает новый профиль и поддерживающий копию в расположении, которое Вы указываете. После создания профиля необходимо заполнить поля заголовка профиля и заполнить профиль с тегами и их данными элемента, и затем вызвать функцию CMUpdateProfile сохранять данные элемента к файлу профиля. Содержание профиля ColorSync по умолчанию включает заголовок профиля типа CM2Header и таблица элемента.

Для установки элементов профиля вне заголовка Вы используете функцию CMSetProfileElement, функция CMSetProfileElementSize, и функция CMSetPartialProfileElement. Вы устанавливаете эти элементы индивидуально, идентифицируя их их именами тега.

Когда Вы создаете новый профиль, все поля CM2Header заголовок профиля установлен в 0 кроме size и profileVersion поля. Для установки элементов заголовка Вы вызываете функцию CMGetProfileHeader для получения копии заголовка присвойте значения полям заголовка, затем вызовите функцию CMSetProfileHeader записать новый заголовок в профиль.

Для каждого класса профиля, такого как профиль устройства, существует определенный набор элементов и связанных тегов, определенных ICC, что профиль должен содержать для соответствия базовым требованиям. ICC также определяет дополнительные теги, которые определенный CMM мог бы использовать, чтобы оптимизировать или улучшить его обработку. Можно также определить теги скрытия, подписи тега которых Вы регистрируете в ICC, для обеспечения CMM большей возможностью совершенствовать ее обработку.

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

Эта функция обычно используется разработчиками профиля, создающими профили для производителей устройств и калибровочными приложениями. В большинстве случаев разработчики приложений используют существующие профили.

Обсуждение

Это обсуждение точно для версий ColorSync до 2,5. Посмотрите примечания версии ниже для изменений начиная с версии 2.5.

Можно использовать эту функцию, чтобы создать новый единственный профиль, содержащий ряд профилей и передать профиль ссылки устройства функции CWConcatColorWorld вместо того, чтобы указать каждый профиль в массиве. Профиль ссылки устройства обеспечивает средние значения хранения в связанном формате серия профилей устройства и непрофилей устройства, неоднократно использующихся в той же последовательности.

Единственный способ использовать профиль ссылки устройства состоит в том, чтобы передать его CWConcatColorWorld функционируйте, поскольку единственный профиль, указанный массивом, передал в profileSet параметр.

Основанное на нуле keyIndex поле CMConcatProfileSet структура данных указывает индекс профиля в профиле ссылки устройства, предпочтительный CMM которого используется для всего согласования цветов или проверяющего цвет сеанса. Заголовок профиля CMMType поле указывает предпочтительный CMM для указанного профиля. Этот CMM выберет элементы профиля, необходимые для сеанса.

Качественная установка флага — указание нормального режима, чернового режима или лучшего режима — указанный первым профилем преобладает для всего сеанса качественные флаги профилей, следующих в последовательности, проигнорированы. Качественная установка флага сохранена в flag поле заголовка профиля. Посмотрите CM2Header для получения дополнительной информации об использовании флагов.

Намерение рендеринга, указанное первым профилем, используется для окраски соответствия к второму профилю, намерение рендеринга, указанное вторым профилем, используется для окраски соответствия к третьему профилю, и т.д. через серию связанных профилей.

Соблюдающие правила управляют содержанием и использованием профиля ссылки устройства:

• Первые и последние профили, которые Вы указываете в массиве профилей для профиля ссылки устройства, должны быть профилями устройства.

• Вы не можете указать профиль именованного цвета.

• Вы не можете включать другой профиль ссылки устройства в серию профилей, которые Вы указываете в массиве профилей.

• Единственный способ использовать профиль ссылки устройства состоит в том, чтобы передать его CWConcatColorWorld функционируйте, поскольку единственный профиль, указанный массивом, передал в profileSet параметр.

• Вы не можете встроить профиль ссылки устройства в изображение.

• Вы не можете указать NULL указать системный профиль.

Эта функция конфиденциально поддерживает всю требуемую информацию профиля цветным миром для согласования цветов и проверяющих цвет сеансов. Поэтому после выполнения CWNewLinkProfile функция, необходимо вызвать CMCloseProfile функция для каждого профиля, используемого для создания устройства, соединяет профиль (для избавления от каждой ссылки профиля).

Обсуждение

Та же новая гибкость в создании цветных миров расширяется для соединения профилей, которые, как предполагается, не идут от цветового пространства устройства ввода данных до цветового пространства устройства вывода. Возвращенный профиль открыт, и должен быть закрыт, когда Вы закончены с ним.

Обсуждение

Функция CMMakeProfile добавляют надлежащие теги к профилю для создания дисплея или абстрактного профиля на основе словаря спецификации, который Вы предоставляете.

Один ключ в словаре спецификации должен быть "profileType" со значением CFString также "abstractLab", "displayRGB" или "displayID".

Словарь может дополнительно содержать этих пар ключевого значения:

• "description", со связанным значением CFString

• "copyright", со связанным значением CFString

Для a profileType ключ, значение которого "abstractLab", словарь может также содержать пар ключевого значения, перечисленных в Таблице 1.

Для a profileType ключ, значение которого "displayRGB", словарь может также содержать пар ключевого значения, перечисленных в Таблице 2.

Для a profileType ключ, значение которого "displayID", словарь может также содержать пар ключевого значения в Таблице 3

Дополнительно, пары ключевого значения s для a profileType ключ, значение которого "displayRGB" может быть предоставлен для переопределения значений от дисплея.

Обсуждение

Следующие функции позволяют Вам передавать NULL как значение параметра для указания системы профилируют как источник или целевой профиль:

• CMNewProfile

• NCWNewColorWorld

• NCMBeginMatching

• NCMDrawMatchedPicture

Обратите внимание на то, что вместо передачи NULL, можно передать ссылку профиля на определенный профиль, включая системный профиль.

Если Вы хотите указать системный профиль для какой-либо другой функции, требующей ссылки профиля, такой как CWConcatColorWorld и CWNewLinkProfile, необходимо использовать прямую ссылку. Можно получить такую ссылку с CMGetSystemProfile функция.

Существуют другие причины, Вы, возможно, должны были бы получить ссылку на профиль существующей системы. Например, Ваше приложение, возможно, должно было бы вывести на экран имя профиля существующей системы пользователю.

Для идентификации расположения физического файла вызовите функцию CMGetProfileLocation.

Когда Ваше приложение закончило использовать профиль существующей системы, оно должно закрыть ссылку на профиль путем вызывания функции CMCloseProfile.

Обсуждение

По умолчанию стандартный профиль RGB сконфигурирован как системный профиль. Путем вызова CMSetSystemProfile функция, Ваше приложение может указать новый системный профиль. Можно сконфигурировать только профиль дисплея как системный профиль.

Обсуждение

До ColorSync 2.6 функция для установки системного профиля поддерживала только FSSpec спецификация файла вводит как способ указать профиль. Эта функция допускает большую гибкость при указании системного профиля.

Обсуждение

CMGetDefaultProfileBySpace функционируйте в настоящее время поддерживает RGB, CMYK, Лабораторию и цветовые пространства XYZ. Константы подписи для этих цветовых пространств (показанный выше с dataColorSpace описание параметра), описаны в цвете Подписи Пространства. Поддержка дополнительных цветовых пространств может быть предоставлена в будущем. CMGetDefaultProfileBySpace возвращает ошибочное значение paramErr при передаче цветового пространства, постоянного, оно в настоящее время не поддерживает.

CMGetDefaultProfileBySpace функционируйте всегда пытается возвратить основанный на файле профиль для поддерживаемого цветового пространства. Например, если пользователь не указал профиль по умолчанию в панели управления ColorSync для указанного цветового пространства, или если профиль не найден (пользователь, возможно, удалил профили в папке ColorSync Profiles или даже самой папке), CMGetDefaultProfileBySpace создает профиль, хранит его на диске и возвращает ссылку на тот профиль. Однако необходимо всегда проверять на ошибочный возврат — например, пользователь, возможно, загрузился от CD, так, чтобы CMGetDefaultProfileBySpace не может сохранить файл профиля на диск.

Обсуждение

CMSetDefaultProfileBySpace функционируйте в настоящее время поддерживает RGB, CMYK, Лабораторию и цветовые пространства XYZ. Константы подписи для этих цветовых пространств (показанный выше с dataColorSpace описание параметра), описаны в цвете Подписи Пространства. Поддержка дополнительных цветовых пространств может быть предоставлена в будущем. CMSetDefaultProfileBySpace возвращает значение paramErr при передаче цветового пространства, постоянного, оно в настоящее время не поддерживает.

Обратите внимание на то, что пользователь может также использовать панель управления ColorSync для указания профиля по умолчанию для цветовых пространств CMYK и RGB.

Обсуждение

Если менеджер по оформлению поддерживает ColorSync, CMGetProfileByAVID вызовы функции на менеджере по оформлению получить профиль для указанного дисплея. Дело обстоит так, если версия менеджера по оформлению 2.2.5 или выше (если gestaltDisplayMgrAttr имеет gestaltDisplayMgrColorSyncAware набор битов).

Обсуждение

Если Вы указываете профиль, содержащий дополнительный тег профиля для гаммы видеокарты, CMSetProfileByAVID извлекает тег и устанавливает видеокарту на основе данных тега. Это - единственная функция ColorSync, устанавливающая гамму видеокарты. Постоянный тег cmVideoCardGammaTag описан в Гамма Тегах Видеокарты.

Когда пользователь устанавливает профиль дисплея с помощью Мониторов и Звуковой панели управления, системный профиль установлен в тот же профиль. Когда Вы вызываете CMSetProfileByAVID для установки профиля для монитора можно также хотеть сделать тот профиль системным профилем. Если так, необходимо вызвать CMSetSystemProfile явно — вызов CMSetProfileByAVID один не имеет никакого влияния на системном профиле.

Обратите внимание на то, что, если менеджер по оформлению поддерживает ColorSync, CMSetProfileByAVID вызовы функции на менеджере по оформлению установить профиль для указанного дисплея. Дело обстоит так, если версия менеджера по оформлению 2.2.5 или выше (если gestaltDisplayMgrAttr имеет gestaltDisplayMgrColorSyncAware набор битов).

Обсуждение

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

Обсуждение

Вы не можете использовать эту функцию, чтобы протестировать ли определенные данные в CM2Header заголовок профиля существует. Вместо этого необходимо вызвать функцию CMGetProfileHeader скопировать весь заголовок профиля и считать его содержание.

Обсуждение

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

CMGetProfileElement функция служит двум целям: получить размер элемента и получить данные элемента. В обоих экземплярах Вы обеспечиваете ссылку на профиль, содержащий элемент в prof параметр и подпись тега элемента в tag параметр.

Для получения размера данных элемента вызовите CMGetProfileElement функция, указывающая указатель на долгий тип данных без знака в elementSize поле и a NULL значение в elementData поле.

После получения размера элемента необходимо выделить буфер, достаточно большой, чтобы содержать возвращенные данные элемента, затем вызвать CMGetProfileElement функционируйте снова, указывая NULL в elementSize параметр для копирования всех данных элемента и указателя на буфер данных в elementData параметр.

Для копирования только части данных элемента, начинающихся с первого байта, выделите буфер размер числа байтов данных элемента, которые Вы хотите получить и указать число байтов для копирования в elementSize параметр. В этом случае, По возврату elementSize параметр содержит размер в байтах данных элемента, фактически возвратился.

Вы не можете использовать CMGetProfileElement функционируйте для копирования части данных элемента, начинающихся со смещения в данные. Для копирования части данных элемента, начинающихся с любого смещения, используйте функцию CMGetPartialProfileElement.

Вы не можете использовать эту функцию для получения части CM2Header заголовок профиля. Вместо этого необходимо вызвать функцию CMGetProfileHeader скопировать весь заголовок профиля и считать его содержание.

Обсуждение

CMSetProfileElement функционируйте заменяет существующие данные элемента, если элемент с указанным тегом уже присутствует в профиле. Иначе, это устанавливает данные элемента для нового тега. Ваше приложение ответственно за выделение памяти для буфера для содержания данных для передачи.

Обсуждение

Ваше приложение может использовать CMSetProfileElementSize функционируйте для резервирования размера данных элемента для определенного тега, прежде чем Вы вызовете функцию CMGetPartialProfileElement установить данные элемента. Самый эффективный способ установить большую сумму данных элемента, когда Вы знаете размер данных, состоит в том, чтобы сначала установить размер, затем вызвать CMSetPartialProfileElement функционируйте для установки каждого из сегментов данных. Вызов CMSetProfileElementSize функция сначала избавляет от необходимости менеджера ColorSync неоднократно увеличивать размер для данных каждый раз, когда Вы вызываете CMSetPartialProfileElement функция.

В дополнение к резервированию размера данных элемента, CMSetProfileElementSize функционируйте устанавливает тег элементов, если он уже не существует.

Обсуждение

CMGetPartialProfileElement функция позволяет Вам копировать любую часть данных элемента, начинающихся с любого смещения в данные. Для CMGetPartialProfileElement функционируйте, чтобы скопировать данные элемента и возвратить их Вам, Ваше приложение должно выделить буфер в памяти для содержания данных.

Вы не можете использовать эту функцию для получения части CM2Header заголовок профиля. Вместо этого необходимо вызвать функцию CMGetProfileHeader получить весь заголовок профиля и считать его содержание.

Обсуждение

Можно использовать CMSetPartialProfileElement функционируйте для установки данных для элемента, когда объем данных является большим, и необходимо скопировать его в профиль в сегментах.

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

Если Вы знаете размер данных элемента, необходимо вызвать функцию CMSetProfileElementSize зарезервировать его перед вызовом CMSetPartialProfileElement к данным элемента набора в сегментах. Установка размера сначала избегает обширных издержек, требуемых увеличить размер для данных элемента с каждым вызовом для добавления другого сегмента данных.

Для копирования всех данных для элемента как, единственная работа, когда объем данных является достаточно небольшим для разрешения этого, вызывает функцию CMSetProfileElement.

Обсуждение

Индексный порядок элементов определяется внутренне менеджером ColorSync и публично не определяется.

Прежде, чем вызвать CMGetIndProfileElementInfo функция, необходимо вызвать функцию CMCountProfileElements, который возвращает общее количество элементов в профиле в elementCount параметр. Число Вы указываете для index параметр при вызове CMGetIndProfileElementInfo должен быть в диапазоне 1 к elementCount; иначе функция возвратит код результата cmIndexRangeErr.

Вы могли бы хотеть вызвать эту функцию, например, распечатать содержание профиля.

Обсуждение

Перед вызовом CMGetIndProfileElement функция для получения данных элемента для элемента в определенном индексе Вы сначала определяете размер в байтах данных элемента. Для определения размера данных Вы можете

• вызовите функцию CMGetIndProfileElementInfo, передача индекса элемента

• вызовите CMGetIndProfileElement функционируйте самостоятельно, указывая указатель на долгий тип данных без знака в elementSize поле и a NULL значение в elementData поле

Как только Вы определили размер данных элемента, Вы выделяете буфер для содержания такого количества данных, как Вам нужно. Если Вы хотите все данные элемента, Вы указываете NULL в elementSize параметр. Если Вы хотите только часть данных элемента, Вы указываете число байтов, которые Вы хотите в elementSize параметр. Вы предоставляете указатель на буфер данных в elementData параметр. После вызова CMGetIndProfileElement, elementSize параметр содержит размер в байтах данных элемента, фактически скопированных.

Прежде, чем вызвать эту функцию, необходимо вызвать функцию CMCountProfileElements. Это возвращается, общий элемент профиля включают elementCount параметр.

Обсуждение

После CMSetProfileElementReference функция выполняется успешно, указанный профиль будет содержать больше чем один тег, соответствующий единственной части данных. Все эти теги имеют равное значение. Ваше приложение может установить ссылку на элемент, который был первоначально самой ссылкой без зацикливания.

Если Вы вызываете функцию CMSetProfileElement впоследствии для одного из тегов, действующих как ссылка на данные другого тега, тогда, данные элемента, которые Вы предоставляете, установлены для тега, и тег больше не считают ссылкой. Вместо этого тег соответствует своим собственным данным элемента и не тому из другого тега.

Обсуждение

CMRemoveProfileElement функция удаляет тег, а также данные элемента от профиля.

Обсуждение

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

Обсуждение

Например, Вы передаете в дополнительном теге 'dscm' плюс «enUS» для reqLocale параметр, к для английской строки США. Если английская строка США не найдена, ColorSync отступает к разумному значению по умолчанию:

Обсуждение

Эта функция позволяет Вам получать CFDictionary, содержащий локаль языка и строку для многократных локализаций от данного тега.

Обсуждение

Данные элемента текстового тега описания (который имеет подпись 'desc' или постоянный cmSigProfileDescriptionType, определенный в CMICCProfile.h заголовочный файл), указывает имя профиля и код сценария. name параметр возвращает имя профиля как строку Паскаля. Используйте эту функцию так, чтобы Ваше приложение не должно было получить и проанализировать данные элемента, содержащие другую информацию.

Обсуждение

Используйте эту функцию для получения данных тега описания для данного профиля. Спецификация Формата Профиля ICC (доступный в http://www .color.org) включает тег описания ('desc' ), разработанный для предоставления большей информации о профиле, чем может содержаться в имени файла. Это особенно критически важно в файловых системах с 8,3 именами. Данные тега могут состоять максимум из трех отдельных частей (строки) информации для профиля. Эти различные строки разработаны для обеспечения дисплея на различных языках или на различных компьютерных системах. Приложения обычно используют одну из строк для показа профилей в списке или всплывающем меню.

Обсуждение

Используйте эту функцию для установки данных тега описания для данного профиля. Спецификация Формата Профиля ICC (доступный в http://www .color.org) включает тег описания ( 'desc' ), разработанный для предоставления большей информации о профиле, чем может содержаться в имени файла. Это особенно критически важно в файловых системах с 8,3 именами. Данные тега могут состоять максимум из трех отдельных частей (строки) информации для профиля. Эти различные строки разработаны для обеспечения дисплея на различных языках или на различных компьютерных системах. Приложения обычно используют одну из строк для показа профилей в списке или всплывающем меню.

Обсуждение

CMGetNamedColorInfo функционируйте информация о возвратах о пространстве именованного цвета, именуемом переданной ссылкой профиля.

Обсуждение

На основе переданного цветного имени, CMGetNamedColorValue если имя найдено в теге, устройстве возвратов и цветных значениях PCS, функция делает поиск в тег именованного цвета и. Иначе, CMGetNamedColorValue возвращает код ошибки.

Обсуждение

На основе переданного индекса именованного цвета, CMGetIndNamedColorValue функция делает поиск в тег именованного цвета и возвращает значения PCS и устройство. Если индекс больше, чем число именованных цветов, CMGetIndNamedColorValue возвращает код ошибки.

Обсуждение

На основе переданного цветного имени, CMGetNamedColorIndex функция делает поиск в тег именованного цвета и, если имя найдено в теге, возвращает индекс. Иначе, CMGetNamedColorIndex возвращает код ошибки.

Обсуждение

На основе переданного цветного индекса имени, CMGetNamedColorName функция делает поиск в тег именованного цвета и возвращает имя. Если индекс больше, чем число именованных цветов, CMGetNamedColorName возвращает код ошибки.

Обсуждение

Необходимо установить цветной мир, прежде чем приложение сможет выполнить согласование цветов общего назначения или проверяющие цвет операции. Для установки цветного мира для этих операций приложение может вызвать NCWNewColorWorld после получения ссылок на профили для использования в качестве источника и места назначения профилирует для цветного мира. Соблюдающие правила управляют типами позволенных профилей:

• Можно указать профиль устройства или профиль преобразования цветового пространства для источника и целевые профили.

• Вы не можете указать профиль ссылки устройства или абстрактный профиль или для исходного профиля или для целевого профиля.

• Только один профиль может быть профилем именованного цвета.

• Можно указать системный профиль явно ссылкой или путем предоставления NULL или для исходного профиля или для целевого профиля.

Необходимо вызвать функцию CMCloseProfile и для источника и для места назначения профилирует для избавления от их ссылок после выполнения NCWNewColorWorld функция.

Качественная установка флага (указание нормального режима, чернового режима или лучшего режима) указанный исходным профилем преобладает для всего сеанса. Качественная установка флага сохранена в flags поле заголовка профиля. Посмотрите CM2Header и Определения Маски Флага для Профилей Версии 2.x для получения дополнительной информации об использовании флагов. Намерение рендеринга, указанное исходным профилем также, преобладает для всего сеанса.

Функция CWConcatColorWorld также выделяет цветную мировую ссылку типа CMWorldRef.

Обсуждение

CWConcatColorWorld функция устанавливает сеанс для цвета, обрабатывающего, который включает ряд профилей. Массив профилей находится в обработке порядка — источник через место назначения. Ваше приложение передает функцию указатель на структуру данных типа CMConcatProfileSet идентифицировать массив профиля.

Качественная установка флага — указание нормального режима, чернового режима или лучшего режима — указанный первым профилем преобладает для всего сеанса, качественные флаги следующих профилей в последовательности проигнорированы. Качественная установка флага сохранена в flags поле заголовка профиля. Посмотрите CM2Header и Определения Маски Флага для Профилей Версии 2.x для получения дополнительной информации об использовании флагов.

Намерение рендеринга, указанное первым профилем, используется для окраски соответствия к второму профилю, намерение рендеринга для второго профиля используется для окраски соответствия к третьему профилю, и т.д. через серию связанных профилей.

Соблюдающие правила управляют профилями, которые можно указать в массиве профиля, на который указывают profileSet параметр для использования с CWConcatColorWorld функция:

• В массиве профиля можно передать в одном или более профилях, но необходимо указать по крайней мере один профиль. При указании только одного профиля это должен быть профиль ссылки устройства. При указании профиля ссылки устройства Вы не можете указать никакие другие профили в массиве профилей; профиль ссылки устройства должен использоваться один.

• В массиве профиля можно указать абстрактный профиль где угодно в последовательности кроме как первый или последний профиль.

• Для первых и последних профилей можно указать профили устройства или профили преобразования цветового пространства. Однако при установке сеанса согласования цветов с профилем пространства именованного цвета и другими профилями профиль именованного цвета должен быть первым или последний профиль в цветном мире — это не может быть в середине.

• Вы не можете указать NULL указать системный профиль. Обратите внимание на то, что начиная с версии 2.5, использование системного профиля изменилось.

• При указании профиля цветового пространства посреди последовательности профиля это проигнорировано CMM по умолчанию.

• При указании профиля именованного цвета это должно быть первым или последний профиль. Иначе, CWConcatColorWorld возвращает значение cmCantConcatenateError.

После выполнения CWConcatColorWorld функция, необходимо вызвать функцию CMCloseProfile для каждого профиля для избавления от его ссылки.

Вместо того, чтобы передать в массиве профилей, можно указать профиль ссылки устройства. Для получения информации о том, как создать профиль ссылки устройства, посмотрите CWNewLinkProfile функция, описанная затем.

Обсуждение

Вызывающая сторона может переопределить модуль управления цветом (CMM), который обычно выбирался бы ColorSync путем обеспечения идентификатора CMM в NCMConcatProfileSet структура или передача 0 для принятия выбора CMM ColorSync (отмечают, что это могло или быть предпочтительным выбором CMM пользователя или CMM, требовавшимся в профиле). flags и k параметры предоставлены для разрешения простой настройки таких атрибутов как качество и проверка палитры при сохранении других настроек. Каждый профиль в наборе может быть настроен путем переопределения намерения и выбора тега преобразования. Вместе с другими профилями, пользовательски представляющая среда может быть установлена для преобразования к или от зависящих от устройств пробелов с минимумом сжатия палитры и/или ненужных трансформаций к и от пробелов соединения. Эта гибкость прибывает в цену специальных знаний содержания профиля и как накладываются палитры устройства.

Обратите внимание на то, что для стандартных профилей устройства ввода и вывода, A2B и теги B2A представляют, преобразовывает от пространства данных до пространства соединения и от пространства соединения до пространства данных, соответственно. При этих обстоятельствах вызывающая сторона обычно не была бы в состоянии использовать то же, преобразовывают теги (например, kUseAtoB ) последовательно, так как пространство соединения не совпало бы с последующим пространством данных. Если пробелы не будут тем же, то вызывающая сторона доберется a cmCantConcatenateError ошибка возвратилась. Для профилей типа cmLinkClass, cmAbstractClass, cmColorSpaceClass , и cmNamedColorClass , эти константы не всегда значимы, и вызывающая сторона призвана думать с точки зрения фактического настоящего тегов в профилях (например, A2B0 или B2A0). При этих условиях может быть надлежащим указать два, преобразовывают теги того же типа последовательно, пока фактические цветовые пространства выравнивают промежуточные теги. Если дело обстоит не так, cmCantConcatenateError ошибка возвращается.

Обратный вызов proc предоставлен как защита от появления остановленной машины во время долгой цветной мировой обработки. Если CMM займет больше чем несколько секунд, чтобы обработать информацию и создать цветной мир, то она вызовет обратный вызов proc, если Вам будут предоставлены, и передайте ее refCon если. Это - также истина для NCWNewLinkProfile.

Обсуждение

Это обсуждение точно для версий ColorSync до 2,5. Посмотрите примечания версии ниже для изменений начиная с версии 2.5.

Для изучения или один или два CMMs используются для согласования цветов и цвета, регистрируясь в данном цветном мире и получить тип CMM и номер версии каждого используемого CMM, приложение должно сначала получить ссылку на цветной мир. Для получения ссылки на ColorSync окрашивают мир, Вы (или некоторый другой процесс), должно быть, создали цветной мир с помощью функции NCWNewColorWorld или функция CWConcatColorWorld.

Источник и целевые профили, которые Вы указываете при создании цветного мира идентифицируют их предпочтительный CMMs, и Вы явно идентифицируете профиль, CMM которого используется для профиля ссылки устройства или связанного цветного мира. Однако Вы не можете быть уверены, будет ли указанный CMM фактически использоваться, пока менеджер ColorSync не определит внутренне, если CMM доступен и в состоянии выполнить запрошенную функцию. Например, когда указанный CMM не доступен, CMM по умолчанию используется.

CMGetCWInfo функция идентифицирует CMM или CMMs для использования. Ваше приложение должно выделить структуру данных типа CMCWInfoRecord и передайте указатель на него в info параметр. CMGetCWInfo функционируйте возвращает цветную мировую информацию в этой структуре. Структура включает a cmmCount поле, идентифицирующее число CMMs, который будет использоваться и массив двух элементов, содержащих структуры типа CMMInfoRecord. CMGetCWInfo функционируйте информация о возвратах в одной или обеих из информационных записей CMM в зависимости от или одного или двух CMMs используется.

Обсуждение

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

• CWMatchColors

• CWCheckColors

• CWMatchBitmap

• CWCheckBitmap

• CWMatchPixMap

• CWCheckPixMap

Обсуждение

CWMatchColors функционируйте цвета соответствий согласно профилям, соответствующим указанному цветному миру. На вводе, значениях цвета в myColors массив, как предполагается, указан в цветовом пространстве данных исходного профиля. По возврату, значениям цвета в myColors массив преобразовывается к цветовому пространству данных целевого профиля.

Все модули управления цветом (CMM) s должны поддерживать эту функцию.

Эта функция поддерживает сеансы согласования цветов, установленные с одним из многоканальных цветных типов данных.

Обсуждение

Цветной тест обеспечивает предварительный просмотр согласования цветов с помощью указанного цветного мира.

Весь CMMs должен поддерживать CWCheckColors функция.

При установке проверяющей палитру маски профиля так, чтобы никакая информация о палитре не была включена — см. Определения Маски Флага для Профилей Версии 2.x — CWCheckColors возвраты cmCantGamutCheckError ошибка.

CWCheckColors функциональные поддержки совпадающие сеансы установлены с одним из многоканальных цветных типов данных. CWCheckColors если цветной мир был инициализирован с профилем пространства именованного цвета, не поддерживается.

Обсуждение

CWMatchBitmap функционируйте соответствует битовый массив с помощью профилей, указанных данным цветным миром.

Необходимо гарантировать что буфер, на который указывают image поле битового массива передало в bitMap параметр обнулен, прежде чем Вы вызовете эту функцию.

Менеджер ColorSync явно не поддерживает цветовое пространство CMY. Однако для принтеров, имеющих цветовое пространство CMY, можно использовать любой из следующих обманов для внесения корректировки:

• Можно использовать профиль CMY, который менеджер ColorSync действительно поддерживает с цветовым пространством CMYK. Если Вы указываете цветовое пространство CMYK в этом случае, менеджер ColorSync обнуляет канал K для моделирования цветового пространства CMY.

• Можно использовать цветовое пространство RGB и передать в битовом массиве вместе с профилем RGB, затем выполнить преобразование от RGB до CMY сами.

Для этой функции для выполнения успешно, исходный профиль dataColorSpace значение поля и space значение поля исходного растрового изображения, на которое указывают bitMap параметр должен указать то же цветовое пространство данных. Кроме того, целевой профиль dataColorSpace значение поля и space значение поля полученного растрового изображения, на которое указывают matchedBitMap параметр должен указать то же цветовое пространство данных, если целевой профиль не является профилем пространства именованного цвета.

Если Вы устанавливаете matchedBitMap к NULL для указания оперативного соответствия необходимо быть уверены, что пространство, требуемое целевым битовым массивом, меньше чем или равно размеру исходного растрового изображения.

Обсуждение

Когда Ваше приложение вызывает CWCheckBitMap функция, менеджер ColorSync диспетчеризирует функцию предпочтительному CMM. Менеджер ColorSync определяет предпочтительный CMM на основе цветной мировой конфигурации. Если цветной мир, в котором Вы передаете, создавался CWConcatColorWorld функция, тогда keyIndex поле CMConcatProfileSet структура данных идентифицирует предпочтительный CMM. Если предпочтительный CMM не доступен, CMM по умолчанию используется для выполнения согласования цветов.

Для CWCheckBitMap функция для выполнения успешно, исходный профиль dataColorSpace значение поля и space значение поля исходного растрового изображения, на которое указывают bitMap параметр должен указать то же цветовое пространство данных. CWCheckBitMap если цветной мир был инициализирован с профилем пространства именованного цвета, не поддерживается.

Обсуждение

Можно использовать получающуюся таблицу в OpenGL для ускорения управления цветом в аппаратных средствах.

Обсуждение

CMConvertXYZToLab функция преобразовывает один или несколько цветов, определенных в цветовом пространстве XYZ к эквивалентным цветам, определенным в L*a*b* цветовое пространство. Оба цветовых пространства независимы от устройств.

Если Ваше приложение не требует, чтобы Вы сохранили список исходного цвета, можно передать указатель на тот же массив списка цветов как src и dst параметры и позволяют CMConvertXYZToLab функционируйте для перезаписи исходных цветов с получающимися преобразованными спецификациями цветов.

Обсуждение

CMConvertLabToXYZ функция преобразовывает один или несколько цветов, определенных в цветовом пространстве L*a*b к эквивалентным цветам, определенным в цветовом пространстве XYZ. Оба цветовых пространства независимы от устройств.

Обсуждение

CMConvertXYZToLuv функция преобразовывает один или несколько цветов, определенных в цветовом пространстве XYZ к эквивалентным цветам, определенным в L*u*v* цветовое пространство. Оба цветовых пространства независимы от устройств.

Если Ваше приложение не требует, чтобы Вы сохранили список исходного цвета, можно передать указатель на тот же массив списка цветов как src и dst параметры и позволяют CMConvertXYZToLuv функционируйте для перезаписи исходных цветов с получающимися преобразованными спецификациями цветов.

Обсуждение

CMConvertLuvToXYZ функция преобразовывает один или несколько цветов, определенных в цветовом пространстве L*u*v к эквивалентным цветам, определенным в цветовом пространстве XYZ. Оба цветовых пространства независимы от устройств.

Обсуждение

CMConvertXYZToYxy функция преобразовывает один или несколько цветов, определенных в цветовом пространстве XYZ к эквивалентным цветам, определенным в цветовом пространстве Yxy. Оба цветовых пространства независимы от устройств.

Если Ваше приложение не требует, чтобы Вы сохранили список исходного цвета, можно передать указатель на тот же массив списка цветов как src и dst параметры и позволяют CMConvertXYZToYxy функционируйте для перезаписи исходных цветов с получающимися преобразованными спецификациями цветов.

Обсуждение

CMConvertYxyToXYZ функция преобразовывает один или несколько цветов, определенных в цветовом пространстве Yxy к эквивалентным цветам, определенным в цветовом пространстве XYZ. Оба цветовых пространства независимы от устройств.

Если Ваше приложение не требует, чтобы Вы сохранили список исходного цвета, можно передать указатель на тот же массив списка цветов как src и dst параметры и позволяют CMConvertYxyToXYZ функционируйте для перезаписи исходных цветов с получающимися преобразованными спецификациями цветов.

Обсуждение

CMConvertRGBToHLS функция преобразовывает один или несколько цветов, определенных в цветовом пространстве RGB к эквивалентным цветам, определенным в цветовом пространстве HLS. Оба цветовых пространства зависимы от устройств.

Если Ваше приложение не требует, чтобы Вы сохранили список исходного цвета, можно передать указатель на тот же массив списка цветов как src и dst параметры и позволяют CMConvertRGBToHLS функционируйте для перезаписи исходных цветов с получающимися преобразованными спецификациями цветов.

Обсуждение

CMConvertHLSToRGB функция преобразовывает один или несколько цветов, определенных в цветовом пространстве HLS к эквивалентным цветам, определенным в цветовом пространстве RGB. Оба цветовых пространства зависимы от устройств.

Если Ваше приложение не требует, чтобы Вы сохранили список исходного цвета, можно передать указатель на тот же массив списка цветов как src и dst параметры и позволяют CMConvertHLSToRGB функционируйте для перезаписи исходных цветов с получающимися преобразованными спецификациями цветов.

Обсуждение

CMConvertRGBToHSV функция преобразовывает один или несколько цветов, определенных в цветовом пространстве RGB к эквивалентным цветам, определенным в цветовом пространстве HSV. Оба цветовых пространства зависимы от устройств.

Если Ваше приложение не требует, чтобы Вы сохранили список исходного цвета, можно передать указатель на тот же массив списка цветов как src и dst параметры и позволяют CMConvertRGBToHSV функционируйте для перезаписи исходных цветов с получающимися преобразованными спецификациями цветов.

Обсуждение

CMConvertHSVToRGB функция преобразовывает один или несколько цветов, определенных в цветовом пространстве HSV к эквивалентным цветам, определенным в цветовом пространстве RGB. Оба цветовых пространства зависимы от устройств.

Если Ваше приложение не требует, чтобы Вы сохранили список исходного цвета, можно передать указатель на тот же массив списка цветов как src и dst параметры и позволяют CMConvertHSVToRGB функционируйте для перезаписи исходных цветов с получающимися преобразованными спецификациями цветов.

Обсуждение

CMConvertRGBToGray функция преобразовывает один или несколько цветов, определенных в цветовом пространстве RGB к эквивалентным цветам, определенным в цветовом пространстве Грэя. Оба цветовых пространства зависимы от устройств.

Если Ваше приложение не требует, чтобы Вы сохранили список исходного цвета, можно передать указатель на тот же массив списка цветов как src и dst параметры и позволяют CMConvertRGBToGray функционируйте для перезаписи исходных цветов с получающимися преобразованными спецификациями цветов.

Обсуждение

CMConvertXYZToFixedXYZ функция преобразовывает один или несколько цветов, компоненты которых определяются как цвета XYZ к эквивалентным цветам, компоненты которых определяются как Фиксированные цвета XYZ. Фиксированные цвета XYZ допускают 32-разрядную точность. Цветовое пространство XYZ независимо от устройств.

Обсуждение

CMConvertFixedXYZToXYZ функция преобразовывает один или несколько цветов, определенных в Фиксированном цветовом пространстве XYZ к эквивалентным цветам, определенным в цветовом пространстве XYZ. Цветовое пространство XYZ независимо от устройств.

Если Ваше приложение не требует, чтобы Вы сохранили список исходного цвета, можно передать указатель на тот же массив списка цветов как src и dst параметры и позволяют CMConvertFixedXYZToXYZ функционируйте для перезаписи исходных цветов с получающимися преобразованными спецификациями цветов.