IDeviceModelPlugIn::ColorimetricToDeviceColors method (wcsplugin.h)

Returns the appropriate XYZ colors in response to the specified number of colors, channels, device colors and the proprietary plug-in algorithms.

Syntax

HRESULT ColorimetricToDeviceColors(
  [in]  UINT            cColors,
  [in]  UINT            cChannels,
  [in]  const XYZColorF *pXYZColors,
  [out] FLOAT           *pDeviceValues
);

Parameters

[in] cColors

The number of colors in the pXYZColors and pDeviceValues arrays.

[in] cChannels

The number of color channels in the pDeviceValues arrays.

[in] pXYZColors

The pointer to the array of incoming XYZColors to convert to device colors.

[out] pDeviceValues

The pointer to an array that contains the resulting outgoing device color values.

Return value

If this function succeeds, the return value is S_OK.

If this function fails, the return value is E_FAIL.

Remarks

If cColors or cChannels is zero, the return value is E_FAIL. If there are invalid or out of gamut colors (which may occur if there has been prior processing of the gamut map model), then the return value is E_FAIL.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header wcsplugin.h

See also