CreateMultiProfileTransform

[This is preliminary documentation and subject to change.]

The CreateMultiProfileTransform function accepts an array of profiles or a single device link profile and creates a color transform that applications can use to perform color mapping.

HTRANSFORM WINAPI CreateMultiProfileTransform(
  PHPROFILE pahProfiles,
  DWORD nProfiles,
  PDWORD padwIntent,
  DWORD nIntents,
  DWORD dwFlags,
  DWORD indexPreferredCMM 
);
 

Parameters

pahProfiles

Pointer to an array of handles to the profiles to be used.

nProfiles

Specifies the number of profiles in the array.

padwIntent

Pointer to an array of intents to use. Each intent is one of the following values:

INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC
 

For more information, see Rendering Intents.

nIntents

Specifies the number of elements in the intents array: can either be 1 or the same value as nProfiles.

dwFlags

The high-order WORD of dwFlags should be set to ENABLE_GAMUT_CHECKING if this transform will be used for gamut checking.

The low-order WORD can have one of the following constant values: PROOF_MODE, NORMAL_MODE, BEST_MODE. Moving from PROOF_MODE to BEST_MODE, output quality generally improves and transform speed declines.

indexPreferredCMM

One-based index of the profile that specifies the color management module (CMM) to use. If indexPreferredCMM is set to INDEX_DONT_CARE, the CMM will be selected automatically.

Return Values

If this function succeeds, the return value is a handle to the color transform.

If this function fails, the return value is NULL. For extended error information, call GetLastError.

Remarks

If a device link profile is being used, the function will fail if nProfiles is not set to 1.

The array of intents specifies how profiles should be combined. The nth intent is used for combining the nth profile in the array. If only one intent is specified, it is used for the first profile, and all other profiles are combined using Absolute Colorimetric intent.

The values in dwFlags are intended as hints only. The color management module must determine the best way to use them.

The CreateMultiProfileTransform function is used outside of a DC. Colors may shift when transforming from a color profile to the same color profile. This is due to precision errors. Therefore, a color transform should not be performed under these circumstances.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Requires Windows 98.
  Windows CE: Unsupported.
  Header: Declared in icm.h.
  Import Library: Use mscms.lib.

See Also

Color Management Overview, ICM 2.0 Functions, The COLOR Structure, DeleteColorTransform