ChromaticAdaptionFeature Class Reference

Inheritance diagram for ChromaticAdaptionFeature:

Public Member Functions
	ChromaticAdaptionFeature (ColorMatrixTransformationModule module)
	Creates a ChromaticAdaptionFeature for an existing color matrix transformation module.
void	ResetToDefault ()
	Resets the chromatic adaption feature to its default configuration.
bool	HasColorTemperature ()
	Returns whether a color temperature has been set.

Properties
ColorSpace	TargetColorSpace [get, set]
	The current target color space.
ChromaticAdaptionAlgorithm	Algorithm [get, set]
	The current algorithm used for chromatic adaption.
uint?	ColorTemperature [get, set]
	The current color temperature of the light source. If no color temperature is explicitly set the chromatic adaption won't be applied.
RangeU	ColorTemperatureRange [get]
	Returns the allowed temperature range in Kelvin for the current combination of color space and algorithm.
bool	IsEnabled [get, set]
	Enables or disables the feature.

Detailed Description

Adjusts to changes in lighting conditions to maintain consistent color perception despite variations in light sources.

In industrial imaging, white balance can fail due to the lack of a neutral reference in the image, such as when the scene contains no gray or white areas, or when the colors are unevenly distributed (as in images dominated by a single color). In these cases, traditional white balance algorithms, like the gray world method, may fail to produce accurate color corrections.

Chromatic adaptation provides an alternative solution by adjusting the image's colors based on the known or estimated correlated color temperature of the light source.

Note

If chromatic adaption is used in combination with white balance, the result is indefinite.

Defaults

• chromatic adaption algorithm = ChromaticAdaptionAlgorithm.Bradford
• color space = ColorSpace.SRGB_D65
• color temperature = undefined (chromatic adaption won't be applied)

See also

Types.ColorSpace, Types.ChromaticAdaptionAlgorithm, ColorCorrectionFeature

Since

IDSImaging.Peak.ICV 1.3

Constructor & Destructor Documentation

ChromaticAdaptionFeature()

ChromaticAdaptionFeature ( ColorMatrixTransformationModule module )

inline

Creates a ChromaticAdaptionFeature for an existing color matrix transformation module.

Parameters

module

Reference to the underlying ColorMatrixTransformationModule.

Member Function Documentation

HasColorTemperature()

bool HasColorTemperature ( )

inline

Returns whether a color temperature has been set.

ResetToDefault()

void ResetToDefault ( )

inline

Resets the chromatic adaption feature to its default configuration.

Note

The enabled state does not change when calling this function.

Implements IFeature.

Property Documentation

Algorithm

ChromaticAdaptionAlgorithm Algorithm

getset

The current algorithm used for chromatic adaption.

The algorithms use a CAT (chromatic adaptation transform) matrix.

ColorTemperature

uint? ColorTemperature

getset

The current color temperature of the light source. If no color temperature is explicitly set the chromatic adaption won't be applied.

The color temperature must be within the allowed ColorTemperatureRange

Exceptions

IcvNotPossibleException

The color temperature has not been set (it has no default value).

ColorTemperatureRange

RangeU ColorTemperatureRange

get

Returns the allowed temperature range in Kelvin for the current combination of color space and algorithm.

IsEnabled

bool IsEnabled

getset

Enables or disables the feature.

Implements IFeature.

TargetColorSpace

ColorSpace TargetColorSpace

getset

The current target color space.

A color space is a specific implementation of a color model, mapping colors to a defined range of values (e.g., standard primaries, white point, and gamma).