Contents

CWMatchColors

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

Declaration

CMError CWMatchColors (
   CMWorldRef cw,
   CMColor *myColors,
   size_t count
);

Parameters

  • cw:

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

    The functions 1805079 Ncwnewcolorworld and 1805087 Cwconcatcolorworld both allocate color world references of type Cmworldref.

  • myColors:

    A pointer to an array containing a list of colors of type 1560453 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.

Return Value

A CMError value. See Result Codes.

Overview

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.

See Also

Working With ColorWorlds