Carbon


CMMGetNamedColorInfo

Header: CMMComponent.h Carbon status: Unsupported

Handles the kCMMGetNamedColorInfo request by returning information about a named color space from its profile reference.

CMError CMMGetNamedColorInfo (
    CMMComponentInst cmm, 
    CMProfileRef srcProf, 
    UInt32 *deviceChannels, 
    OSType *deviceColorSpace, 
    OSType *PCSColorSpace, 
    UInt32 *count, 
    StringPtr prefix, 
    StringPtr suffix
);
Parameter descriptions
cmm

A handle to your CMM’s storage for the instance of your component associated with the calling application or device driver.

srcProf

A profile reference to a named color space profile to supply information about.

deviceChannels

A pointer to a count of device channels. 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 maps to CMYK, a 4-channel color space. A value of 0 indicates no device channels were available.

deviceColorSpace

A pointer to a device color space. On output, specifies a device color space, such as CMYK, for the srcProf profile.

PCSColorSpace

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

count

A pointer to a named color count. On output, the number of named colors in the srcProf 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 srcProf profile.

suffix

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

DISCUSSION

A CMM may respond to the kCMMGetNamedColorInfo request code, but it is not required to do so. Most CMMs can rely on the default CMM to handle this request code adequately. The ColorSync Manager sends this request code to your CMM on behalf of an application or device driver that called the CMMGetNamedColorInfo function. The ColorSync Manager dispatches this request to the Component Manager, which calls your CMM to service the request. A CMM that handles the kCMMGetNamedColorInfo request code typically responds by calling a CMM-defined function (for example, CMMGetNamedColorInfo).

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

CARBON NOTES

CMMGetNamedColorInfo is an API to CMMs. Use CMGetNamedColorInfo instead. Application developers should avoid calling CMMs directly, since they may or may not support a given API.


© 2000 Apple Computer, Inc. (Last Updated 7/17/2000)