Carbon


CMGetProfileLocation

Header: CMApplication.h Carbon status: Supported

Obtains the location of a profile based on the specified profile reference.

CMError CMGetProfileLocation (
    CMProfileRef prof, 
    CMProfileLocation *theProfile
);
Parameter descriptions
prof

A profile reference of type CMProfileRef. Before calling CMGetProfileLocation, you set the reference to specify the profile you wish to obtain the location for.

theProfile

A pointer to a profile location structure of type CMProfileLocation. On return, specifies the location of the profile. Commonly, a profile is disk-file based, but it may instead be temporary, handle-based, pointer-based, or accessed through a procedure supplied by your application.

DISCUSSION

When your application calls the CMValidateProfile function, the ColorSync Manager dispatches the function to the CMM specified by the CMMType header field of the profile whose reference you specify. The preferred CMM can support this function or not.

To open a profile and obtain a reference to it, use the function CMOpenProfile.

VERSION NOTES

This function is not recommended for use in ColorSync 2.5.

Starting with ColorSync version 2.5, you should use the function NCMGetProfileLocation instead of CMGetProfileLocation.

As of version 2.5, if you call CMGetProfileLocation, it will just call NCMGetProfileLocation in turn, passing the profile specified by prof, the profile location specified by theProfile, and a location size value of cmOriginalProfileLocationSize.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when ColorSync 2.0 or later is present.


© 2000 Apple Computer, Inc. (Last Updated 7/17/2000)