IDeviceModelPlugIn::GetNeutralAxis method (wcsplugin.h)

  • Article

The IDeviceModelPlugIn::GetNeutralAxis return the XYZ colorimetry of sample points along the device's neutral axis.

Syntax

HRESULT GetNeutralAxis(
  [in]  UINT      cColors,
  [out] XYZColorF *pXYZColors
);

Parameters

[in] cColors

The number of points that are returned.

[out] pXYZColors

A pointer to an array of XYZColorF structures.

Return value

If this function succeeds, the return value is S_OK.

If this function fails, the return value is E_FAIL.

Remarks

You should define "neutral axis" in a way that is appropriate for your device. Usually, it is points made by the device's gray values. This might be R=G=B, or C=M=Y=0 and any value of K. For some devices, the most pleasing gray may be one that uses a different combination of colorants, such as M=Y=0 and C=K. The plug-in is responsible for determining the colorimetry of a sampling of the neutral axis values and returning them. The sampling may be as sparse as two points (white and black) or as dense as desired.

There is no requirement that the samples be uniformly spaced in any color space.

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