![]() |
PATH![]() |
![]() ![]() |
This section describes the functions you use to retrieve information from a named color profile.
CMGetNamedColorInfo
obtains information about a named color space from its profile reference.CMGetNamedColorValue
obtains device and PCS color values for a specific color name from a named color space profile.CMGetIndNamedColorValue
obtains device and PCS color values for a specific named color index from a named color space profile.CMGetNamedColorIndex
obtains a named color index for a specific color name from a named color space profile.CMGetNamedColorName
obtains a named color name for a specific named color index from a named color space profile.Obtains information about a named color space from its profile reference.
pascal CMError CMGetNamedColorInfo (
CMProfileRef prof,
unsigned long *deviceChannels,
OSType *deviceColorSpace,
OSType *PCSColorSpace,
unsigned long *count,
StringPtr prefix,
StringPtr suffix);
CMProfileRef
to a named color space profile to obtain named color information from.The CMGetNamedColorInfo function returns information about the named color space referred to by the passed profile reference.
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);
CMProfileRef
to a named color space profile to obtain color values from.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.
Obtains device and PCS color values for a specific named color index from a named color space profile.
pascal CMError CMGetIndNamedColorValue (
CMProfileRef prof,
unsigned long index,
CMColor *deviceColor,
CMColor *PCSColor);
CMProfileRef
to a named color space profile to obtain color values from.Based on the passed named color index, the CMGetIndNamedColorValue function does a lookup into the named color tag and returns device and PCS values. If the index is greater than the number of named colors, CMGetIndNamedColorValue returns an error code.
Obtains a named color index for a specific color name from a named color space profile.
pascal CMError CMGetNamedColorIndex (
CMProfileRef prof,
StringPtr name,
unsigned long *index);
CMProfileRef
to a named color space profile to obtain a named color index from.Based on the passed color name, the CMGetNamedColorIndex function does a lookup into the named color tag and, if the name is found in the tag, returns the index. Otherwise, CMGetNamedColorIndex returns an error code.
Obtains a named color name for a specific named color index from a named color space profile.
pascal CMError CMGetNamedColorName (
CMProfileRef prof,
unsigned long index,
StringPtr name)
CMProfileRef
to a named color space profile to obtain a named color name from.Based on the passed color name index, the CMGetNamedColorName function does a lookup into the named color tag and returns the name. If the index is greater than the number of named colors, CMGetNamedColorName returns an error code.