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.
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. |
© 1999, 2005 Apple Computer, Inc. All Rights Reserved. (Last updated: 2005-06-04)