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