Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

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

Accessing Profile Elements /

CMProfileElementExists

Tests whether the specified profile contains a specific element based on the element's tag signature.

pascal CMError CMProfileElementExists (
CMProfileRef prof, 
OSType tag, 
Boolean *found);

prof

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

tag

The tag signature for the element in question. For a complete list of the tag signatures a profile may contain, including a description of each tag, refer to the International Color Consortium Profile Format Specification. For information on how to obtain this document, see "Profiles" in Advanced Color Imaging on the Mac OS. The signatures for profile tags are defined in the CMICCProfile.h header file.

found

A pointer to a Boolean value that indicates whether the element was found. On output, has the value true if the profile contains the element or false if it doesn't.

function result

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

DISCUSSION

You cannot use this function to test whether a profile element in the profile CM2Header profile header exists. Instead, you must call the CMGetProfileHeader function (page 3-88) to copy the profile header and read its contents.