Carbon


CWMatchColors

Header: CMApplication.h Carbon status: Supported

Matches colors in a color list, using the specified color world.

CMError CWMatchColors (
    CMWorldRef cw, 
    CMColor *myColors, 
    UInt32 count
);
Parameter descriptions
cw

A reference to the color world of type CMWorldRef that describes how matching is to occur in the color-matching session.

The functions NCWNewColorWorld and CWConcatColorWorld both allocate color world references of type CMWorldRef.

myColors

A pointer to an array containing a list of colors of type CMColor. On input, contains the list of colors to match. On return, contains the list of matched colors specified in the color data space of the color world’s destination profile.

count

A one-based count of the number of colors in the color list of the myColors array.

DISCUSSION

The CWMatchColors function matches colors according to the profiles corresponding to the specified color world. On input, the color values in the myColors array are assumed to be specified in the data color space of the source profile. On return, the color values in the myColors array are transformed to the data color space of the destination profile.

All color management modules (CMM)s must support this function.

This function supports color-matching sessions set up with one of the multichannel color data types.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when ColorSync 1.0 or later is present.


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