rotation_feature.py

Go to the documentation of this file.

from ids_peak_icv.pipeline.datatypes.rotation import Rotation
from ids_peak_icv.pipeline._internal.transformation_module import TransformationModule
from ids_peak_icv.pipeline.features.ifeature import IFeature
 
 
class RotationFeature(IFeature):
    """!
    @brief
    Rotation provides fixed-angle rotation functionality.
 
    @supportedPixelformats{ImageTransformation}
 
    This feature rotates images in 90-degree increments, based on the rotation mode set via the angle property.
 
    @warning When processing images with a Bayer pattern, the result may have a different pixel format,
    though the bit depth remains unchanged. Ensure your application can handle potential pixel format changes
    after rotation.
 
    The default rotation is Rotation.NO_ROTATION.
 
    @ingroup ids_peak_icv_python_pipeline_features
 
    @since ids_peak_icv 1.0
    """
 
    @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._rotation_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._rotation_enabled = enabled
 
    @property
    def angle(self) -> Rotation:
        """!
        @brief
        Gets the current rotation angle.
 
        @return The currently configured rotation angle.
 
        @since ids_peak_icv 1.0
        """
        return self._module.rotation_angle
 
    @angle.setter
    def angle(self, angle: Rotation) -> None:
        """!
        @brief
        Sets the desired rotation angle.
 
        @param angle: The rotation angle to apply (see RotationAngle enum).
 
        @since ids_peak_icv 1.0
        """
        self._module.rotation_angle = angle
 
    def reset_to_default(self) -> None:
        """!
        @brief
        Resets the rotation to its default value (Rotation.NO_ROTATION).
 
        @note The enabled state does not change when calling this function.
 
        @since ids_peak_icv 1.0
        """
        self._module.reset_to_default()
 
    def __init__(self, module: TransformationModule) -> None:
        """!
        @brief
        Creates a RotationFeature for an existing transformation module.
 
        @param module: Reference to the underlying TransformationModule.
 
        @since ids_peak_icv 1.0
        """
        self._module = module