BinningFeature Class Reference

#include <peak_icv/pipeline/features/peak_icv_binning_feature.hpp>

Inheritance diagram for BinningFeature:

Collaboration diagram for BinningFeature:

Public Member Functions
	BinningFeature (detail::DownsamplingModule &module)
	Creates a BinningFeature for an existing downsampling module.
void	SetEnabled (bool enabled) override
	Enables or disables the feature.
bool	IsEnabled () const override
	Indicates whether the feature is currently enabled.
void	ResetToDefault () override
	Resets all settings to the default values.
void	SetX (uint32_t x)
	Sets the number of columns used for binning.
void	SetY (uint32_t y)
	Sets the number of rows used for binning.
uint32_t	GetX () const
	Retrieves the current number of columns used for binning.
uint32_t	GetY () const
	Retrieves the current number of rows used for binning.
peak::common::IntervalU	GetRange () const
	Retrieves the valid range for the binning factors x and y.
void	SetMode (const BinningMode &mode)
	Sets the BinningMode.
BinningMode	GetMode () const
	Retrieves the current BinningMode.

Detailed Description

Binning is used to decrease the image size.

This method reduces resolution by summarizing or averaging groups of pixels in the horizontal (x) and/or vertical (y) directions. It helps preserve image quality by minimizing aliasing artifacts.

Warning

Binning permanently reduces image resolution. The original resolution cannot be recovered after binning is applied.

Defaults

• x = 1
• y = 1
• peak::pipeline::detail::DownsamplingMode::BinningAverage

See also

features::DecimationFeature, BinningMode

Since

1.0

Definition at line 47 of file peak_icv_binning_feature.hpp.

Constructor & Destructor Documentation

BinningFeature()

BinningFeature ( detail::DownsamplingModule & module )

inlineexplicit

Creates a BinningFeature for an existing downsampling module.

Parameters

module

Reference to the underlying detail::DownsamplingModule.

Since

1.0

Definition at line 155 of file peak_icv_binning_feature.hpp.

Member Function Documentation

GetMode()

BinningMode GetMode ( ) const

inline

Retrieves the current BinningMode.

Returns

The current BinningMode.

Since

1.0

Definition at line 235 of file peak_icv_binning_feature.hpp.

GetRange()

peak::common::IntervalU GetRange ( ) const

inline

Retrieves the valid range for the binning factors x and y.

The returned interval specifies the minimum and maximum values that can be passed to SetX or SetY.

Returns

An IntervalU representing the valid binning factor range.

Since

1.0

Definition at line 214 of file peak_icv_binning_feature.hpp.

GetX()

uint32_t GetX ( ) const

inline

Retrieves the current number of columns used for binning.

Returns

The current number of columns summarized/averaged during binning.

Since

1.0

Definition at line 204 of file peak_icv_binning_feature.hpp.

GetY()

uint32_t GetY ( ) const

inline

Retrieves the current number of rows used for binning.

Returns

The current number of rows summarized/averaged during binning.

Since

1.0

Definition at line 209 of file peak_icv_binning_feature.hpp.

IsEnabled()

bool IsEnabled ( ) const

inlineoverridevirtual

Indicates whether the feature is currently enabled.

Returns

true if enabled; otherwise, false.

Since

1.0

Implements IFeature.

Definition at line 164 of file peak_icv_binning_feature.hpp.

ResetToDefault()

void ResetToDefault ( )

inlineoverridevirtual

Resets all settings to the default values.

Note

The enabled state does not change when calling this function.

Since

1.0

Implements IFeature.

Definition at line 169 of file peak_icv_binning_feature.hpp.

SetEnabled()

void SetEnabled ( bool enabled )

inlineoverridevirtual

Enables or disables the feature.

Parameters

enabled

Set to true to enable the feature, or false to disable it.

Since

1.0

Implements IFeature.

Definition at line 159 of file peak_icv_binning_feature.hpp.

SetMode()

void SetMode ( const BinningMode & mode )

inline

Sets the BinningMode.

Parameters

mode	The BinningMode to set.

Exceptions

NotSupportedException

If the mode is an unsupported BinningMode.

Since

1.0

Definition at line 219 of file peak_icv_binning_feature.hpp.

SetX()

void SetX ( uint32_t x )

inline

Sets the number of columns used for binning.

Parameters

x	An integer value representing the number of columns summarized/averaged during binning. Valid values are within the range returned by GetRange.

Exceptions

OutOfRangeException

If x is outside the valid range.

Since

1.0

Definition at line 174 of file peak_icv_binning_feature.hpp.

SetY()

void SetY ( uint32_t y )

inline

Sets the number of rows used for binning.

Parameters

y	An integer value representing the number of rows summarized/averaged during binning. Valid values are within the range returned by GetRange.

Exceptions

OutOfRangeException

If y is outside the valid range.

Since

1.0

Definition at line 189 of file peak_icv_binning_feature.hpp.