WcsTranslateColors

Translates an array of colors from the source color space to the destination color space as defined by a color transform.

BOOL WINAPI WcsTranslateColors(
  __in HTRANSFORM hColorTransform,  __in DWORD nColors,  __in DWORD nInputChannels,  __in COLORDATATYPE cdtInput,  __in DWORD cbInput,  __in_bcount(cbInput) PVOID pInputData,  __in DWORDnOutputChannels,
  __in COLORDATATYPEcdtOutput,
  __in DWORDcbOutput,
  __out_bcount(cbOutput) PVOIDpOutputData);

Parameters

• hColorTransform
  A handle for the WCS color transform.

• nColors
  The number of elements in the array to which pInputData and pOutputData point.

• nInputChannels
  The number of channels per element in the array to which pInputData points.

• cdtInput
  The input COLORDATATYPE color data type.

• cbInput
  The buffer size, in bytes, of pInputData.

• pInputData
  A pointer to an array of input colors.

• nOutputChannels
  The number of channels per element in the array to which pOutputData points.

• cdtOutput
  The COLORDATATYPE output that specified the color data type.

• cbOutput
  The buffer size, in bytes, of pOutputData.

• pOutputData
  A pointer to an array of colors that receives the results of the color translation.

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 data types are not compatible with the color transform, this function fails. This function will fail if an ICC transform is used.

Requirements

**  Windows Vista:** Included in Windows Vista and later.
**  Header:** Declared in Icm.h.
**  Library:** Use Mscms.lib.
**  Unicode:** Implemented as Unicode and ANSI versions on Windows Vista.

See Also

Basic Color Management Concepts, Windows Color System Schemas and Algorithms, Functions