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

Definition at line 39 of file ChromaticAdaptionFeature.cs.

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.

Definition at line 49 of file ChromaticAdaptionFeature.cs.

Member Function Documentation

HasColorTemperature()

bool HasColorTemperature ( )

inline

Returns whether a color temperature has been set.

Definition at line 123 of file ChromaticAdaptionFeature.cs.

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.

Definition at line 115 of file ChromaticAdaptionFeature.cs.

Property Documentation

Algorithm

ChromaticAdaptionAlgorithm Algorithm

getset

The current algorithm used for chromatic adaption.

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

Definition at line 73 of file ChromaticAdaptionFeature.cs.

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).

Definition at line 89 of file ChromaticAdaptionFeature.cs.

ColorTemperatureRange

RangeU ColorTemperatureRange

get

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

Definition at line 98 of file ChromaticAdaptionFeature.cs.

IsEnabled

bool IsEnabled

getset

Enables or disables the feature.

Implements IFeature.

Definition at line 101 of file ChromaticAdaptionFeature.cs.

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).

Definition at line 61 of file ChromaticAdaptionFeature.cs.