Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

Inside Macintosh: Advanced Color Imaging Reference /

Chapter 2 - Color Picker Manager Reference /

Color Picker Manager Functions / Setting and Getting Color-Matching Profiles for a Color Picker

GetPickerProfile
Determines the destination color-matching profile currently used by a color picker.
pascal OSErr GetPickerProfile (
picker thePicker, 
CMProfileHandle *profile);
thePicker
A color picker.
profile
A pointer to a handle to a ColorSync 1.0 profile for the final output device.

DISCUSSION
In the color-matching profile pointed to in the profile parameter, the GetPickerProfile function returns the destination profile currently used by the color picker specified in the parameter thePicker.

SPECIAL CONSIDERATIONS
This version of the Color Picker Manager uses ColorSync 1.0 profiles only. The ColorSync 1.0 profile is a handle-based profile. The profile format is defined by Apple Computer. You cannot use version 2.x profiles, which are identified by profile references, with this version of the Color Picker Manager. ColorSync 1.0 profiles typically reside in the ColorSyncTM Profiles folder (within the Preferences folder of the System Folder). They may also be embedded with the images to which they pertain in graphics files. The appendix "ColorSync Manager Backward Compatibility" in Advanced Color Imaging on the Mac OS provides information about the relationship between the ColorSync Manager version 2.x and ColorSync 1.0 profiles, which you may find useful.

SEE ALSO
Listing 2-13 (page 2-26) in Advanced Color Imaging on the Mac OS illustrates how to use the GetPickerProfile function. To change the destination color-matching profile for a color picker, use the SetPickerProfile function (page 2-50).