TranslateColors

[This is preliminary documentation and subject to change.]

The TranslateColors function translates an array of colors from the source color space to the destination color space as defined by a color transform.

BOOL WINAPI TranslateColors(
  HTRANSFORM hColorTransform,
  PCOLOR paInputColors,
  DWORD nColors, 
  COLORTYPE ctInput,
  PCOLOR paOutputColors,
  COLORTYPE ctOutput
);
 

Parameters

hColorTransform
Identifies the color transform to use.
paInputColors
Pointer to an array of nColors COLOR structures to translate.
nColors
Contains the number of elements in the arrays pointed to by paInputColors and paOutputColors.
ctInput
Specifies the input color type.
paOutputColors
Pointer to an array of nColors COLOR structures that receive the translated colors.
ctOutput
Specifies the output color type.

Return Values

If this function succeeds, the return value is TRUE.

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

Remarks

If the input and the output color types are not compatible with the color transform, this function fails.

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