Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

WcsTranslateColors function

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

Syntax


BOOL WINAPI WcsTranslateColors(
  _In_   HTRANSFORM hColorTransform,
  _In_   DWORD nColors,
  _In_   DWORD nInputChannels,
  _In_   COLORDATATYPE cdtInput,
  _In_   DWORD cbInput,
  _In_   PVOID pInputData,
  _In_   DWORD nOutputChannels,
  _In_   COLORDATATYPE cdtOutput,
  _In_   DWORD cbOutput,
  _Out_  PVOID pOutputData
);

Parameters

hColorTransform [in]

A handle for the WCS color transform.

nColors [in]

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

nInputChannels [in]

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

cdtInput [in]

The input COLORDATATYPE color data type.

cbInput [in]

The buffer size, in bytes, of pInputData.

pInputData [in]

A pointer to an array of input colors. The size of the buffer for this array, in bytes, is the DWORD value of cbInput.

nOutputChannels [in]

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

cdtOutput [in]

The COLORDATATYPE output that specified the color data type.

cbOutput [in]

The buffer size, in bytes, of pOutputData.

pOutputData [out]

A pointer to an array of colors that receives the results of the color translation.The size of the buffer for this array, in bytes, is the DWORD value of cbOutput.

Return value

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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Icm.h

Library

Mscms.lib

DLL

Mscms.dll

See also

Basic Color Management Concepts
Windows Color System Schemas and Algorithms
Functions

 

 

Community Additions

Show:
© 2014 Microsoft