Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

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

Accessing Profiles /

CMValidateProfile

Indicates whether the specified profile contains the minimum set of elements required by the current color management module (CMM) for color matching or color checking.

pascal CMError CMValidateProfile (
CMProfileRef prof, 
Boolean *valid,
Boolean *preferredCMMnotfound);

prof

A profile reference (page 3-63) to the profile to validate.

valid

A pointer to a Boolean value. On output, has the value true if the profile contains the minimum set of elements to be valid and false if it doesn't.

preferredCMMnotfound

A pointer to a flag for whether the preferred CMM was found. On output, has the value true if the CMM specified by the profile was not available to perform validation or does not support this function and the default Apple CMM was used. Has the value false if the profile's preferred CMM is able to perform validation.

function result

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

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.

If the preferred CMM supports this function, it determines if the profile contains the baseline elements for the profile type, which the CMM requires to perform color matching or gamut checking. For each profile type, such as a device profile, there is a specific set of required tagged elements defined by the ICC that the profile must include. The ICC also defines optional tags, which may be included in a profile. A CMM might use these optional elements to optimize or improve its processing. Additionally, a profile might include private tags defined to provide a CMM with processing capability particular to the needs of that CMM. The profile developer can define these private tags, register the tag signatures with the ICC, and include the tags in a profile. The CMM checks only for the existence of profile elements; it does not check the element's content and size.

If the preferred CMM does not support the CMValidateProfile function request, the ColorSync Manager calls the default Apple CMM to handle the validation request.