Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

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

Accessing Named Color Profile Values /

CMGetNamedColorInfo

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);

prof

A profile reference (page 3-63) to a named color space profile to obtain named color information from.

deviceChannels

A pointer to a count value. On output, the number of device channels in the color space for the profile. It should agree with the "data color space" field in the profile header. For example, Pantone\x90 maps to CMYK, a four-channel color space. A value of 0 indicates no device channels were available.

deviceColorSpace

A pointer to a device color space. On output, a device color space, such as CMYK.

PCSColorSpace

A pointer to a profile connection space color space. On output, an interchange color space, such as Lab.

count

A pointer to a count value. On output, the number of named colors in the profile.

prefix

A pointer to a Pascal string. On output, the string contains a prefix, such as "Pantone", for each color name. The prefix identifies the named color system described by the profile.

suffix

A pointer to a Pascal string. On output, the string contains a suffix for each color name, such as "CVC".

function result

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

DISCUSSION

The CMGetNamedColorInfo function returns information about the named color space referred to by the passed profile reference.