IDS peak ICV v1.5.0
Loading...
Searching...
No Matches
SaturationFeature Class Reference
Inheritance diagram for SaturationFeature:

Public Member Functions

 SaturationFeature (ColorMatrixTransformationModule module)
 Creates a SaturationFeature using an existing color matrix transformation module.
 
void ResetToDefault ()
 Resets the saturation value to its default.
 

Properties

float Value [get, set]
 The current saturation value.
 
IntervalF Range [get]
 Gets the valid range for the saturation value.
 
bool IsEnabled [get, set]
 Enables or disables the feature.
 

Detailed Description

Adjusts the saturation of an image by modifying a 3x3 Types.ColorCorrectionMatrix.

This feature modifies the image's color saturation by scaling the chrominance components of the color correction matrix. A higher saturation makes colors more vivid, while a lower value results in more muted tones.

Defaults
  • saturation = 1.0
See also
ColorCorrectionFeature, Types.ColorCorrectionMatrix
Since
IDSImaging.Peak.ICV 1.3

Constructor & Destructor Documentation

◆ SaturationFeature()

Creates a SaturationFeature using an existing color matrix transformation module.

Parameters
moduleReference to the underlying ColorMatrixTransformationModule.

Member Function Documentation

◆ ResetToDefault()

void ResetToDefault ( )
inline

Resets the saturation value to its default.

Note
The enabled state does not change when calling this function.

Implements IFeature.

Property Documentation

◆ IsEnabled

bool IsEnabled
getset

Enables or disables the feature.

Implements IFeature.

◆ Range

Gets the valid range for the saturation value.

The returned interval specifies the minimum and maximum values that can be passed to Value.

◆ Value

float Value
getset

The current saturation value.

A floating-point value representing the saturation value. A value of 1.0 means no change, values greater than 1.0 increase saturation, and values less than 1.0 decrease saturation. Valid values are within the Range

Warning
Extreme saturation values may cause color clipping or unnatural color appearance. Values significantly above 2.0 or below 0.0 should be used with caution.
See also
ColorCorrectionFeature, Range