< Previous PageNext Page > Hide TOC

Unsupported Functions

This section lists functions that are unsupported in Mac OS X. Table B-1 provides information on what you should do in place of using these functions.

Table B-1  Porting notes for unsupported ColorSync Manager functions

Unsupported functions

Porting notes

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.

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.

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.

CMBeginMatching

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

CMCheckBitmap

Use CWCheckBitmap instead. CMCheckBitmap is an API to CMMs -- Component Manager structures that Mac OS X does not support. In Carbon, CMMs are replced by opaque structures of type CFBundle.

CMCheckColors

Use CWCheckColors instead. CMCheckColors is an API to CMMs -- Component Manager structures that Mac OS X does not support. In Carbon, CMMs are replced by opaque structures of type CFBundle.

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.

CMConcatenateProfiles

CMConcatenateProfiles is an API for CMMs, and it uses 1.0 profiles.

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.

CMConvertProfile2to1

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

CMDeleteDeviceProfile

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

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.

CMFixedXYZToXYZ

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

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.

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.

CMGetProfileAdditionalDataOffset

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

CMGetProfileName

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

CMHLSToRGB

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

CMHSVToRGB

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

CMInit

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

CMLabToXYZ

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

CMLuvToXYZ

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

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.

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.

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.

CMMCheckBitmap

Use CWCheckBitMap instead. CMMCheckBitmap is an API to CMMs -- Component Manager structures that Mac OS X does not support. In Carbon, CMMs are replced by opaque structures of type CFBundle.

CMMCheckColors

Use CWCheckColors instead. CMMCheckColors is an API to CMMs -- Component Manager structures that Mac OS X does not support. In Carbon, CMMs are replced by opaque structures of type CFBundle.

CMMCheckPixMap

Use CWCheckPixMap instead. CMMCheckPixMap is an API to CMMs -- Component Manager structures that Mac OS X does not support. In Carbon, CMMs are replced by opaque structures of type CFBundle.

CMMClose

This is a Component Manager wrapper function which only applies to ColorSync on Mac OS 8 and 9.

CMMConcatenateProfiles

This is an API to CMMs, which aren\qt supported in Carbon.

CMMConcatInit

This is an API to CMMs, which aren\qt supported in Carbon. To establish a color world using a set of profiles, use CWConcatColorWorld.

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.

CMMGetCMMInfo

This is a Component Manager wrapper function which only applies to ColorSync on Mac OS 8 and 9.

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.

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.

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.

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.

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.

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.

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.

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.

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.

CMMInit

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

CMMMatchBitmap

Use CWMatchBitMap instead. CMMMatchBitmap is an API to CMMs -- Component Manager structures that Mac OS X does not support. In Carbon, CMMs are replced by opaque structures of type CFBundle.

CMMMatchColors

Use CWMatchColors instead. CMMMatchColors is an API to CMMs -- Component Manager structures that Mac OS X does not support. In Carbon, CMMs are replced by opaque structures of type CFBundle.

CMMMatchPixMap

Use CWMatchPixMap instead. CMMMatchPixMap is an API to CMMs -- Component Manager structures that Mac OS X does not support. In Carbon, CMMs are replced by opaque structures of type CFBundle.

CMMNewLinkProfile

Use CWNewLinkProfile instead. CMMNewLinkProfile is an API to CMMs -- Component Manager structures that Mac OS X does not support. In Carbon, CMMs are replced by opaque structures of type CFBundle.

CMMOpen

This is a Component Manager wrapper function which only applies to ColorSync on Mac OS 8 and 9.

CMMUnflattenProfile

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

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.

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.

CMRGBToGray

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

CMRGBToHLS

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

CMRGBToHSV

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

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.

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.

CMUnflattenProfile

Because this function unflattens only those profiles based on FSSpec structures, you should use NCMUnflattenProfile instead.

CMUseProfileComment

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

CMXYZToFixedXYZ

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

CMXYZToLab

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

CMXYZToLuv

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

CMXYZToYxy

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

CMYxyToXYZ

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

ConcatenateProfiles

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

CWNewColorWorld

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

DeleteDeviceProfile

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

DisposeOldCalibrateUPP

This function was intended for use only by the ColorSync Manager itself and not by applications. Applications should have no need to use this function.

DisposeOldCanCalibrateUPP

This function was intended for use only by the ColorSync Manager itself and not by applications. Applications should have no need to use this function.

DrawMatchedPicture

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

EnableMatching

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

EndMatching

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

GetIndexedProfile

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

GetProfile

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

GetProfileAdditionalDataOffset

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

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.

InvokeOldCalibrateUPP

This function was intended for use only by the ColorSync Manager itself and not by applications. Applications should have no need to use this function.

InvokeOldCanCalibrateUPP

This function was intended for use only by the ColorSync Manager itself and not by applications. Applications should have no need to use this function.

NCMInit

This is a Component Manager wrapper function which only applies to ColorSync on Mac OS 8 and 9.

NCMMConcatInit

This is an API to CMMs, which aren’t supported in Carbon. To establish a color world using a set of profiles, use CWConcatColorWorld.

NCMMInit

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

NCMMNewLinkProfile

Use CWNewLinkProfile instead. NCMMNewLinkProfile is an API to CMMs -- Component Manager structures that Mac OS X does not support. In Carbon, CMMs are replced by opaque structures of type CFBundle.

NewOldCalibrateUPP

This function was intended for use only by the ColorSync Manager itself and not by applications. Applications should have no need to use this function.

NewOldCanCalibrateUPP

This function was intended for use only by the ColorSync Manager itself and not by applications. Applications should have no need to use this function.

SetProfile

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

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.

UseProfile

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



< Previous PageNext Page > Hide TOC


© 1999, 2005 Apple Computer, Inc. All Rights Reserved. (Last updated: 2005-06-04)


Did this document help you?
Yes: Tell us what works for you.
It’s good, but: Report typos, inaccuracies, and so forth.
It wasn’t helpful: Tell us what would have helped.