Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

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

Accessing Profile Elements /

CMGetIndProfileElementInfo

Obtains the element tag and data size of an element by index from the specified profile.

pascal CMError CMGetIndProfileElementInfo (
CMProfileRef prof,
unsigned long index, 
OSType *tag,
unsigned long *elementSize,
Boolean *refs);

prof

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

index

A one-based element index within the range returned by the elementCount parameter of the CMCountProfileElements function.

tag

A pointer to an element signature. On output, the tag signature of the element corresponding to the index.

elementSize

A pointer to an element size. On output, the size in bytes of the element data corresponding to the tag.

refs

A pointer to a Boolean value. On output, set to true if more than one tag in the profile refers to element data associated with the tag corresponding to the index.

function result

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

DISCUSSION

Before calling this function, you must call the CMCountProfileElements function (page 3-86), which returns the total number of elements in the profile in the elementCount parameter. The number you specify for the CMGetIndProfileElementInfo function's index parameter must be in the range of 1 to elementCount. The index order of elements is determined internally by the ColorSync Manager and is not publicly defined.

You might want to call this function, for example, to print out the contents of a profile.