IDeviceModelPlugIn::GetNeutralAxis method

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


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


cColors [in]

The number of points that are returned.

pXYZColors [out]

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.


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.


Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]



See also

Basic Color Management Concepts