CMCreateTransformExt

[This is preliminary documentation and subject to change.]

The CMCreateTransformExt ANSI function creates a color transform that maps from an input LOGCOLORSPACE to an optional target space and then to an output device, using a set of flags that define how the transform should be created.

HCMTRANSFORM WINAPI CMCreateTransformExt(
  LPLOGCOLORSPACEA lpColorSpace,        // color space pointer
  LPDEVCHARACTER lpDevCharacter,        // profile file name
  LPDEVCHARACTER lpTargetDevCharacter,  // target profile file name
  DWORD dwFlags                         // creation flags
);
 

Parameters

lpColorSpace

Pointer to an input logical color space structure.

lpDevCharacter

Pointer to a memory-mapped device profile.

lpTargetDevCharacter

Pointer to a memory-mapped target profile.

dwFlags

Specifies flags to control creation of the transform. It is up to the CMM to determine how best to use these flags.

Set the high-order WORD to ENABLE_GAMUT_CHECKING if the 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.

Return Values

If this function succeeds, the return value is a color transform in the range 256 to 65,535. Since only the low WORD of the transform is retained, valid transforms cannot exceed this range.

If this function fails, the return value is an error code having a value less than 256. When the return value is less than 256, signaling an error, the CMM should use SetLastError to set the last error to a valid error value as defined in Winerror.h.

Remarks

The Unicode equivalent of CMCreateTransformExt is CMCreateTransformExtW.

Every CMM is required to export this function.

QuickInfo

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

See Also

Color Management Overview, ICM 2.0 Functions, CMCreateTransformExtW