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 3 - ColorSync Manager Reference for Applications and Device Drivers / ColorSync Manager Functions

Accessing Named Color Profile Values /

CMGetNamedColorValue
Obtains device and PCS color values for a specific color name from a named color space profile.
pascal CMError CMGetNamedColorValue (
CMProfileRef prof,
StringPtr name,
CMColor *deviceColor,
CMColor *PCSColor);
prof
A profile reference (page 3-63) to a named color space profile to obtain color values from.
name
A pointer to a Pascal string. You supply a color name string for the color to get information for.
deviceColor
A pointer to a device color. On output, a device color value in CMColor union format. If the profile does not contain device values, deviceColor is undefined.
PCSColor
A pointer to a profile connection space color. On output, an interchange color value in CMColor union format.
function result
A result code of type CMError. See "Result Codes" (page 3-174) for a list of ColorSync-specific result codes.

DISCUSSION
Based on the passed color name, the CMGetNamedColorValue function does a lookup into the named color tag and, if the name is found in the tag, returns device and color PCS values. Otherwise, CMGetNamedColorValue returns an error code.