Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

Chapter 3 - ColorSync Manager Reference for Applications and Device Drivers / Constants and Data Types

Concatenated Profile Set Structure

You call the NCWNewColorWorld function (page 3-108) to create a color world for operations such as color matching and color conversion. A color world is usually based on two profiles--source and destination. But it can include a series of profiles that describe the processing for a work-flow sequence, such as scanning, printing, and previewing an image.

You use an array to hold the set of profile references used in your operations. You provide this array in the profileSet field of the CMConcatProfileSet structure. You specify the profiles of the array in processing order--from source through destination.

The array identifies a concatenated profile set your application can use to establish a color world in which the sequential relationship among the profiles exists until your application disposes of the color world. Alternatively, you can create a device-linked profile composed of a series of linked profiles that remains intact and available for use again after your application disposes of the concatenated color world. In either case, you use a data structure of type CMConcatProfileSet to define the profile set.

A device-linked profile accommodates users who use a specific configuration requiring a combination of device profiles and possibly nondevice profiles repeatedly over time.

To set up a color world that includes a concatenated set of profiles, your application uses the CWConcatColorWorld function (page 3-110), passing it a structure of type CMConcatProfileSet. The array you pass may contain a set of profile references or it may contain only the profile reference of a device-linked profile. To create a device-linked profile, your application calls the CWNewLinkProfile function (page 3-112), passing a structure of type CMConcatProfileSet.

struct CMConcatProfileSet {
   unsigned short keyIndex;   /* 0-based index into array of profiles,
                                 specifying profile to use CMM for */
   unsigned short count;      /* 1-based count of profiles in array;
                                 minimum is one profile */
   CMProfileRef   profileSet[1];/* array of profile references */
};          

Field Description

keyIndex

A zero-based index into the array of profile references identifying the profile whose CMM is used for the entire session. The profile's CMMType field identifies the CMM.

count

The one-based count of profiles in the profile array. A minimum of one profile is required.

profileSet

A variable-length array of profile references. The references must be in processing order from source to destination. The rules governing the types of profiles you can specify in a profile array differ depending on whether you are creating a profile set for the CWConcatColorWorld function (page 3-110) or for the CWNewLinkProfile function (page 3-112). See the functions for details.