Manager: ColorSync Manager



Carbon will support the majority of the ColorSync Manager programming interface. However, ColorSync 1.0 compatibility calls such as CWNewColorWorld, GetProfile, and SetProfile will not be supported.

Some applications use the Component Manager to determine what color management modules (CMMs) are available. You will not be able to use the Component Manager for this purpose in Mac OS X, but Apple will provide a new API to query for available CMMs. We are investigating the runtime model for CMMs; it is possible that CMM developers will have to rewrite their code to replace the Component Manager interface layer.

Unsupported  BeginMatching

BeginMatching is defined only if OLDROUTINENAMES is defined during compile time. Additionally, it uses 1.0 profiles, which are no longer supported. Use NCMBeginMatching (along with 2.0 profiles) instead.

Supported  CalibrateEventProcPtr

Supported  CalibrateProcPtr

Supported  CallCalibrateEventProc

Supported  CallCalibrateProc

Supported  CallCanCalibrateProc

Supported  CallCMBitmapCallBackProc

Supported  CallCMFlattenProc

Supported  CallCMMIterateProc

Supported  CallCMProfileAccessProc

Supported  CallCMProfileFilterProc

Supported  CallCMProfileIterateProc

Unsupported  CallOldCalibrateProc

Unsupported  CallOldCanCalibrateProc

Supported  CanCalibrateProcPtr

Unsupported  CMAccelerationCalculateData

This function was used only by CMMs wishing to support hardware acceleration. With the advent of PowerPC chips, it no longer provides performance benefits over software implementations.

Unsupported  CMAccelerationLoadTables

This function was used only by CMMs wishing to support hardware acceleration. With the advent of PowerPC chips, it no longer provides performance benefits over software implementations.

Unsupported  CMBeginMatching

CMBeginMatching uses 1.0 profiles to establish onscreen matching. These profiles will not be supported. Use NCMBeginMatching instead.

Supported  CMBitmapCallBackProcPtr

Modified  CMCheckBitmap

CMCheckBitmap is an API to CMMs. Use CWCheckBitmap instead. Application developers should avoid calling CMMs directly, since they may or may not support a given API.

Modified  CMCheckColors

CMCheckColors is an API to CMMs. Use CWCheckColors instead. Application developers should avoid calling CMMs directly, since they may or may not support a given API.

Modified  CMCheckPixMap

CMCheckPixMap is an API to CMMs. Use CWCheckPixMap instead. Application developers should avoid calling CMMs directly, since they may or may not support a given API.

Supported  CMCloneProfileRef

Supported  CMCloseProfile

Supported  CMConcatCallBackProcPtr

Supported  CMConcatCallBackProcPtr

Unsupported  CMConcatenateProfiles

CMConcatenateProfiles is an API for CMMs, and it uses 1.0 profiles. It will no longer be supported.

Modified  CMConcatInit

CMConcatInit is an API to CMMs. Application developers should avoid calling CMMs directly, since they may or may not support a given API. To establish a color world using a set of profiles, use CWConcatColorWorld.

Supported  CMConvertFixedXYZToXYZ

Supported  CMConvertHLSToRGB

Supported  CMConvertHSVToRGB

Supported  CMConvertLabToXYZ

Supported  CMConvertLuvToXYZ

Unsupported  CMConvertProfile2to1

ColorSync 1.0 profiles will no longer be supported, so CMConvertProfile2to1 has no utility.

Supported  CMConvertRGBToGray

Supported  CMConvertRGBToHLS

Supported  CMConvertRGBToHSV

Supported  CMConvertXYZToFixedXYZ

Supported  CMConvertXYZToLab

Supported  CMConvertXYZToLuv

Supported  CMConvertXYZToYxy

Supported  CMConvertYxyToXYZ

Supported  CMCopyProfile

Supported  CMCountImageProfiles

Supported  CMCountProfileElements

Supported  CMCreateProfileIdentifier

Unsupported  CMDeleteDeviceProfile

CMDeleteDeviceProfile is an API to the 1.0 Profile Responder component, which is no longer supported.

Supported  CMDisposeProfileSearch

Unsupported  CMDrawMatchedPicture

CMDrawMatchedPicture uses 1.0 profiles to match the PICT data, and these profiles will no longer be supported. Use NCMDrawMatchedPicture, which uses 2.0 profiles.

Supported  CMEmbedImage

Supported  CMEnableMatchingComment

Supported  CMEndMatching

Unsupported  CMFixedXYZToXYZ

This function is simply glue to the old CMConversion Component. The preferred access method to this function is CMConvertFixedXYZToXYZ.

Supported  CMFlattenProcPtr

Supported  CMFlattenProfile

Supported  CMGetColorSyncFolderSpec

Supported  CMGetColorSyncVersion

Supported  CMGetCWInfo

Supported  CMGetDefaultProfileBySpace

Supported  CMGetImageSpace

Unsupported  CMGetIndexedProfile

CMGetIndexedProfile is an API to the 1.0 Profile Responder component, which is no longer supported. Services for searching and indexing 2.0 profiles are supported via CMNewProfileSearch, CMSearchGetIndProfile, and other search routines.

Supported  CMGetIndImageProfile

Supported  CMGetIndNamedColorValue

Supported  CMGetIndProfileElement

Supported  CMGetIndProfileElementInfo

Supported  CMGetNamedColorIndex

Supported  CMGetNamedColorInfo

Supported  CMGetNamedColorName

Supported  CMGetNamedColorValue

Supported  CMGetPartialProfileElement

Supported  CMGetPreferredCMM

Unsupported  CMGetProfile

CMGetProfile is an API (for 1.0 profiles) to the Profile Responder component, which is no longer supported. Access to 2.0 profiles is supported via CMGetSystemProfile, CMOpenProfile, and the search routines.

Unsupported  CMGetProfileAdditionalDataOffset

CMGetProfileAdditionalDataOffset provides access to data within 1.0 profiles, and these profiles will no longer be supported.

Supported  CMGetProfileByAVID

Supported  CMGetProfileDescriptions

Supported  CMGetProfileElement

Supported  CMGetProfileHeader

Supported  CMGetProfileLocation

Unsupported  CMGetProfileName

CMGetProfileName gets the name of 1.0 profiles, which will no longer be supported.

Supported  CMGetProfileRefCount

Supported  CMGetPS2ColorRendering

Supported  CMGetPS2ColorRenderingIntent

Supported  CMGetPS2ColorRenderingVMSize

Supported  CMGetPS2ColorSpace

Supported  CMGetScriptProfileDescription

Supported  CMGetSystemProfile

Supported  CMGetUnicodeProfileDescription

Unsupported  CMHLSToRGB

This function is simply glue to the old CMConversion Component. The preferred access method to this function is CMConvertHLSToRGB.

Unsupported  CMHSVToRGB

This function is simply glue to the old CMConversion Component. The preferred access method to this function is CMConvertHSVToRGB.

Unsupported  CMInit

This was the initialization routine for old style color worlds. Use NCMInit to create color worlds.

Supported  CMIterateCMMInfo

Supported  CMIterateColorSyncFolder

Unsupported  CMLabToXYZ

This function is simply glue to the old CMConversion Component. The preferred access method to this function is CMConvertLabToXYZ.

Supported  CMLinkImage

Unsupported  CMLuvToXYZ

This function is simply glue to the old CMConversion Component. The preferred access method to this function is CMConvertLuvToXYZ.

Modified  CMMatchBitmap

CMMatchBitmap is an API to CMMs. Use CWMatchBitMap instead. Application developers should avoid calling CMMs directly, since they may or may not support a given API.

Modified  CMMatchColors

CMMatchColors is an API to CMMs. Use CWMatchColors instead. Application developers should avoid calling CMMs directly, since they may or may not support a given API.

Supported  CMMatchImage

Modified  CMMatchPixMap

CMMatchPixMap is an API to CMMs. Use CWMatchPixMap instead. Application developers should avoid calling CMMs directly, since they may or may not support a given API.

Unsupported  CMMCheckBitmap

Unsupported  CMMCheckColors

Unsupported  CMMCheckPixMap

Unsupported  CMMConcatenateProfiles

Unsupported  CMMConcatInit

Modified  CMMFlattenProfile

CMMFlattenProfile is an API to CMMs. Use CMFlattenProfile instead. Application developers should avoid calling CMMs directly, since they may or may not support a given API.

Modified  CMMGetIndNamedColorValue

CMMGetIndNamedColorValue is an API to CMMs. Use CMGetIndNamedColorValue instead. Application developers should avoid calling CMMs directly, since they may or may not support a given API.

Modified  CMMGetNamedColorIndex

CMMGetNamedColorIndex is an API to CMMs. Use CMGetNamedColorIndex instead. Application developers should avoid calling CMMs directly, since they may or may not support a given API.

Modified  CMMGetNamedColorInfo

CMMGetNamedColorInfo is an API to CMMs. Use CMGetNamedColorInfo instead. Application developers should avoid calling CMMs directly, since they may or may not support a given API.

Modified  CMMGetNamedColorName

CMMGetNamedColorName is an API to CMMs. Use CMGetNamedColorName instead. Application developers should avoid calling CMMs directly, since they may or may not support a given API.

Modified  CMMGetNamedColorValue

CMMGetNamedColorValue is an API to CMMs. Use CMGetNamedColorValue instead. Application developers should avoid calling CMMs directly, since they may or may not support a given API.

Modified  CMMGetPS2ColorRendering

CMMGetPS2ColorRendering is an API to CMMs; use CMGetPS2ColorRendering instead. Application developers should avoid calling CMMs directly, since they may or may not support a given API.

Modified  CMMGetPS2ColorRenderingIntent

CMMGetPS2ColorRenderingIntent is an API to CMMs. Use CMGetPS2ColorRenderingIntent instead. Application developers should avoid calling CMMs directly, since they may or may not support a given API.

Modified  CMMGetPS2ColorRenderingVMSize

CMMGetPS2ColorRenderingVMSize is an API to CMMs; use CMGetPS2ColorRenderingVMSize instead. Application developers should avoid calling CMMs directly, since they may or may not support a given API.

Modified  CMMGetPS2ColorSpace

CMMGetPS2ColorSpace is an API to CMMs. Use CMGetPS2ColorSpace instead. Application developers should avoid calling CMMs directly, since they may or may not support a given API.

Unsupported  CMMInit

Supported  CMMIterateProcPtr

Unsupported  CMMMatchBitmap

Unsupported  CMMMatchColors

Unsupported  CMMMatchPixMap

Unsupported  CMMNewLinkProfile

Modified  CMMUnflattenProfile

CMMUnflattenProfile is an API to CMMs. Application developers should avoid calling CMMs directly, since they may or may not support a given API.

Modified  CMMValidateProfile

CMMValidateProfile is an API to CMMs. Use CMValidateProfile instead. Application developers should avoid calling CMMs directly, since they may or may not support a given API.

Modified  CMNewLinkProfile

CMNewLinkProfile is an API to CMMs. Use CWNewLinkProfile instead. Application developers should avoid calling CMMs directly, since they may or may not support a given API.

Supported  CMNewProfile

Supported  CMNewProfileSearch

Supported  CMOpenProfile

Supported  CMProfileAccessProcPtr

Supported  CMProfileElementExists

Supported  CMProfileFilterProcPtr

Supported  CMProfileIdentifierFolderSearch

Supported  CMProfileIdentifierListSearch

Supported  CMProfileIterateProcPtr

Supported  CMProfileModified

Supported  CMProofImage

Supported  CMRemoveProfileElement

Unsupported  CMRGBToGray

This function is simply glue to the old CMConversion Component. The preferred access method to this function is CMConvertRGBToGray.

Unsupported  CMRGBToHLS

This function is simply glue to the old CMConversion Component. The preferred access method to this function is CMConvertRGBToHLS.

Unsupported  CMRGBToHSV

This function is simply glue to the old CMConversion Component. The preferred access method to this function is CMConvertRGBToHSV.

Supported  CMSearchGetIndProfile

Supported  CMSearchGetIndProfileFileSpec

Supported  CMSetDefaultProfileBySpace

Supported  CMSetIndImageProfile

Supported  CMSetPartialProfileElement

Unsupported  CMSetProfile

CMSetProfile is an API (for 1.0 profiles) to the Profile Responder component, which is no longer supported. Access to 2.0 profiles is supported via CMSetSystemProfile, CMNewProfile, and other routines.

Supported  CMSetProfileByAVID

Unsupported  CMSetProfileDescription

CMSetProfileDescription is an API to the Profile Responder component, which is no longer supported. It also operated on 1.0 profiles, which are no longer supported. Access to internal profile data for 2.0 profiles is supported via CMSetProfileElement.

Supported  CMSetProfileDescriptions

Supported  CMSetProfileElement

Supported  CMSetProfileElementReference

Supported  CMSetProfileElementSize

Supported  CMSetProfileHeader

Supported  CMSetSystemProfile

Supported  CMUnembedImage

Supported  CMUnflattenProfile

Supported  CMUpdateProfile

Supported  CMUpdateProfileSearch

Unsupported  CMUseProfileComment

CMUseProfileComment embeds 1.0 profiles in the PICT data. These profiles will no longer be supported. Use NCMUseProfileComment instead.

Supported  CMValidateProfile

Supported  CMValidImage

Unsupported  CMXYZToFixedXYZ

This function is simply glue to the old CMConversion Component. The preferred access method to this function is CMConvertXYZToFixedXYZ.

Unsupported  CMXYZToLab

This function is simply glue to the old CMConversion Component. The preferred access method to this function is CMConvertXYZToLab.

Unsupported  CMXYZToLuv

This function is simply glue to the old CMConversion Component. The preferred access method to this function is CMConvertXYZToLuv.

Unsupported  CMXYZToYxy

This function is simply glue to the old CMConversion Component. The preferred access method to this function is CMConvertXYZToYxy.

Unsupported  CMYxyToXYZ

This function is simply glue to the old CMConversion Component. The preferred access method to this function is CMConvertYxyToXYZ.

Unsupported  ConcatenateProfiles

ConcatenateProfiles operates on 1.0 profiles, which are no longer supported. Concatenation is supported for 2.0 profiles via CWNewLinkProfile and other APIs.

Supported  CountImageProfilesProcPtr

Supported  CWCheckBitmap

Supported  CWCheckColors

Supported  CWCheckPixMap

Supported  CWConcatColorWorld

Supported  CWDisposeColorWorld

Supported  CWMatchBitmap

Supported  CWMatchColors

Supported  CWMatchPixMap

Unsupported  CWNewColorWorld

CWNewColorWorld takes as parameters 1.0 profiles, which will no longer be supported. Use NCWNewColorWorld instead.

Supported  CWNewLinkProfile

Unsupported  DeleteDeviceProfile

DeleteDeviceProfile deletes 1.0 profiles, which will no longer be supported.

Supported  DisposeCalibrateEventUPP

Supported  DisposeCalibrateUPP

Supported  DisposeCanCalibrateUPP

Supported  DisposeCMBitmapCallBackUPP

Supported  DisposeCMConcatCallBackUPP

Supported  DisposeCMFlattenUPP

Supported  DisposeCMMIterateUPP

Supported  DisposeCMProfileAccessUPP

Supported  DisposeCMProfileFilterUPP

Supported  DisposeCMProfileIterateUPP

Unsupported  DisposeOldCalibrateUPP

Unsupported  DisposeOldCanCalibrateUPP

Unsupported  DrawMatchedPicture

DrawMatchedPicture uses 1.0 profiles, which are obsolete. Use NCMDrawMatchedPicture (which supports 2.0 profiles) instead.

Supported  EmbedImageProcPtr

Unsupported  EnableMatching

EnableMatching is a valid API only if OLDROUTINENAMES is defined for a given compile. Use CMEnableMatchingComment for full compatibility.

Unsupported  EndMatching

EndMatching is defined if OLDROUTINENAMES is used during compilation. Use CMEndMatching for full compatibility.

Modified  GetColorSyncFolderSpec

This function will continue to be supported on the MacOS. Future APIs will support universal access to the ³ColorSync Folder² across platforms.

Supported  GetImageSpaceProcPtr

Unsupported  GetIndexedProfile

GetIndexedProfile provides access to 1.0 profiles, which will no longer be supported. CMNewProfileSearch and CMSearchGetIndProfile provide enhanced access to 2.0 profiles.

Supported  GetIndImageProfileProcPtr

Unsupported  GetProfile

GetProfile provides access to 1.0 profiles, which will no longer be supported.

Unsupported  GetProfileAdditionalDataOffset

GetProfileAdditionalDataOffset is a data accessor for 1.0 profiles, which will no longer be supported.

Unsupported  GetProfileName

GetProfileName is an accessor for 1.0 profiles, which will no longer be supported. Access to 2.0 profile data is supported by CMGetScriptProfileDescription and CMGetProfileElement.

Supported  InvokeCalibrateEventUPP

Supported  InvokeCalibrateUPP

Supported  InvokeCanCalibrateUPP

Supported  InvokeCMBitmapCallBackUPP

Supported  InvokeCMConcatCallBackUPP

Supported  InvokeCMFlattenUPP

Supported  InvokeCMMIterateUPP

Supported  InvokeCMProfileAccessUPP

Supported  InvokeCMProfileFilterUPP

Supported  InvokeCMProfileIterateUPP

Unsupported  InvokeOldCalibrateUPP

Unsupported  InvokeOldCanCalibrateUPP

Supported  MatchImageProcPtr

Supported  NCMBeginMatching

Supported  NCMDrawMatchedPicture

Supported  NCMGetProfileLocation

Supported  NCMInit

Unsupported  NCMMConcatInit

Unsupported  NCMMInit

Unsupported  NCMMNewLinkProfile

Supported  NCMSetSystemProfile

Supported  NCMUnflattenProfile

Supported  NCMUseProfileComment

Supported  NCWConcatColorWorld

Supported  NCWNewColorWorld

Supported  NCWNewLinkProfile

Supported  NewCalibrateEventProc

Supported  NewCalibrateEventUPP

Supported  NewCalibrateProc

Supported  NewCalibrateUPP

Supported  NewCanCalibrateProc

Supported  NewCanCalibrateUPP

Supported  NewCMBitmapCallBackProc

Supported  NewCMBitmapCallBackUPP

Supported  NewCMConcatCallBackUPP

Supported  NewCMFlattenProc

Supported  NewCMFlattenUPP

Supported  NewCMMIterateProc

Supported  NewCMMIterateUPP

Supported  NewCMProfileAccessProc

Supported  NewCMProfileAccessUPP

Supported  NewCMProfileFilterProc

Supported  NewCMProfileFilterUPP

Supported  NewCMProfileIterateProc

Supported  NewCMProfileIterateUPP

Unsupported  NewOldCalibrateProc

Unsupported  NewOldCalibrateUPP

Unsupported  NewOldCanCalibrateProc

Unsupported  NewOldCanCalibrateUPP

Unsupported  OldCalibrateProcPtr

Unsupported  OldCanCalibrateProcPtr

Supported  SetIndImageProfileProcPtr

Unsupported  SetProfile

SetProfile uses 1.0 profiles, which will no longer be supported. To set the System profile, use NCMSetSystemProfile.

Unsupported  SetProfileDescription

SetProfileDescription provides access to 1.0 profiles, which will no longer be supported. To set the description of a 2.0 profile, use CMSetProfileElement.

Supported  UnembedImageProcPtr

Unsupported  UseProfile

UseProfile allows 1.0 profiles to be used within PICT data streams. These profiles will no longer be supported.

Supported  ValidateImageProcPtr

Supported  ValidateSpaceProcPtr

[Table of Contents] [Manager Index] [Function Index]

Generated on: 7/7/99. Copyright 1999 Apple Computer, Inc. All rights reserved.