Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

Chapter 3 - ColorSync Manager Reference for Applications and Device Drivers / ColorSync Manager Functions

Assigning and Accessing the System Profile File /

CMGetSystemProfile

Obtains a reference to the current system profile.

pascal CMError CMGetSystemProfile (CMProfileRef *prof);

prof

A pointer to a profile reference (page 3-63). On output, a reference to the current system profile.

function result

A result code of type CMError. See "Result Codes" (page 3-174) for a list of ColorSync-specific result codes.

DISCUSSION

To give the system profile as a function parameter for any of several functions including NCMBeginMatching, NCMDrawMatchedPicture, and NCWNewColorWorld, you can specify the profile reference or you can specify NULL.

For all other functions, you must specify an explicit reference to the system profile. You can use this function to obtain a reference to the system profile.

There are other purposes for which your application might obtain a reference to the current system profile. For example, your application might need to get the name of the current system profile to display the application user.

To identify the location of the physical file, call the CMGetProfileLocation function (page 3-80).

SEE ALSO

When your application has finished using the current system profile, it must close the reference to the profile by calling the CMCloseProfile function (page 3-71).