saturation_feature.py

Go to the documentation of this file.

from __future__ import annotations
 
from ids_peak_common.datatypes.interval import Interval
from ids_peak_icv.pipeline._internal.color_matrix_transformation_module import ColorMatrixTransformationModule
from ids_peak_icv.pipeline.features.ifeature import IFeature
 
 
class SaturationFeature(IFeature):
    """!
    @brief
    Adjusts the saturation of an image by modifying a 3x3 color correction matrix.
 
    @supportedPixelformats{ColorMatrixTransformation}
 
    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.
 
    The default value for saturation is 1.0.
 
    @since ids_peak_icv 1.0
    @ingroup ids_peak_icv_python_pipeline_features
    """
 
    def __init__(self, module: ColorMatrixTransformationModule) -> None:
        """!
        @brief
        Creates a SaturationFeature for an existing color matrix transformation module.
 
        @param module: Reference to the underlying module
 
        @since ids_peak_icv 1.0
        """
        self._module = module
 
    @property
    def enabled(self) -> bool:
        """!
        @brief
        Gets whether this feature is currently enabled.
 
        @return True if enabled; otherwise False.
 
        @since ids_peak_icv 1.0
        """
        return self._module.saturation_enabled
 
    @enabled.setter
    def enabled(self, enabled: bool) -> None:
        """!
        @brief
        Enables or disables the feature.
 
        @param enabled: True to enable, False to disable.
 
        @since ids_peak_icv 1.0
        """
        self._module.saturation_enabled = enabled
 
    def reset_to_default(self) -> None:
        """!
        @brief
        Resets the saturation to its default value (1.0).
 
        @note The enabled state does not change when calling this function.
 
        @since ids_peak_icv 1.0
        """
        self._module.reset_to_default()
 
    @property
    def value(self) -> float:
        """!
        @brief
        Gets the current saturation value.
 
        @return The current saturation value.
 
        @since ids_peak_icv 1.0
        """
        return self._module.saturation
 
    @value.setter
    def value(self, saturation: float) -> None:
        """!
        @brief
        Sets the saturation value.
 
        @param saturation: 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 returned by range property.
 
        :raise OutOfRangeException: If saturation is outside the valid range.
 
        @since ids_peak_icv 1.0
        """
        self._module.saturation = saturation
 
    @property
    def range(self) -> Interval:
        """!
        @brief
        Gets the valid range for the saturation.
 
        The returned interval specifies the minimum and maximum values that can be passed to value property.
 
        @return An Interval representing the valid saturation range.
 
        @since ids_peak_icv 1.0
        """
        return self._module.saturation_range