Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

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

Accessing Profile Elements /

CMSetProfileHeader

Sets the header for the specified profile.

pascal CMError CMSetProfileHeader (
CMProfileRef prof,
const CMAppleProfileHeader *header);

prof

A profile reference (page 3-63) to the profile whose header is set.

header

A pointer to the new header to set for the profile.

function result

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

DISCUSSION

You can use the CMSetProfileHeader function to set a header for a version 1.0 or a version 2.x profile. Before you call this function, you must set the values for the header, depending on the version of the profile. For a version 2.x profile, you use the CM2Header data structure (page 3-43). For a version 1.0 profile, you use the CMHeader data structure (page 3-46). You pass the header you supply in the CMAppleProfileHeader union, described in "Apple Profile Header" (page 3-42).