Spectral Interpolator object.
More...
#include <cvb/spectral/interpolator.hpp>
Spectral Interpolator object.
◆ Create()
Creates an Interpolator object.
The interpolator is used to fit the wavelengths of the standard observer and the standard illuminant to the wavelengths in the Cube. As reference wavelengths the values of CVSFI_Wavelength in the cube metadata are used.
Internally the color matching functions are defined in the range:
- 2006 2deg: [390 nm, 830 nm] in 0.1 nm steps
- 2006 10deg: [390 nm, 830 nm] in 0.1 nm steps
- 1964 10deg: [360 nm, 380 nm] in 5 nm steps
- 1931 2deg: [380 nm, 825 nm] in 5 nm steps
The standard illuminant are defined in the range:
- Standard A: [300 nm, 830 nm] in 1 nm steps
- Standard D50: [300 nm, 780 nm] in 5 nm steps
- Standard D65: [300 nm, 830 nm] in 1 nm steps
- Standard E: [300 nm, 830 nm] in a 530 nm step (this spectrum is even for the whole spectrum)
- Parameters
-
[in] | cube | Metadata needs to contain wavelength info |
[in] | stdObserver | Standard observer used to access predefined Color Matching functions for the Lab and XYZ Conversion |
[in] | stdIlluminant | Standard illuminant used to access the predefined relative spectral power distribution for the Lab and XYZ Conversion |
[in] | interpolationMethod | Interpolation method used for the color matching function and illuminant spectrum |
- Returns
- Object contains the interpolated values of the relative spectral power distribution from color matching functions and standard illuminant.
- Exceptions
-
- See also
- Wavelengths StdIlluminant StdObserver
- Examples
- Spectral/ColorConvert.
◆ FromHandle()
Creates Interpolator from a classic API Interpolator handle.
The Interpolator takes ownership of the handle, so you must share it before using this function.
- Parameters
-
[in] | guard | Life time guard for C-API handle. |
- Returns
- The Cube created from the classic API handle.
- Exceptions
-
- See also
- Handle Create
◆ Handle()
◆ StdIlluminant()
Retrieves the standard illuminant from the interpolator object.
- Returns
- Standard illuminant used to access the predefined relative spectral power distribution for the Lab and XYZ Conversion.
- Exceptions
-
- See also
- Wavelengths StdObserver
◆ StdObserver()
Retrieves the standard observer from the interpolator object.
- Returns
- Standard observer used to access predefined Color Matching functions for the Lab and XYZ Conversion.
- Exceptions
-
- See also
- Wavelengths StdIlluminant
◆ Wavelengths()
Retrieves the wavelengths of the illuminant spectrum.
- Returns
- Wavelengths of the illuminant spectrum.
- Exceptions
-
- See also
- StdIlluminant StdObserver