#include <peak_icv/pipeline/peak_icv_default_pipeline.hpp>

Inheritance diagram for DefaultPipeline:

[legend]

Collaboration diagram for DefaultPipeline:

[legend]

Public Member Functions
	DefaultPipeline ()
	Creates a DefaultPipeline with default module settings.

	~DefaultPipeline () override

std::string	ExportSettingsToString () const override
	Converts the current pipeline settings into a string format.

void	ImportSettingsFromString (const std::string &settings) override
	Restores pipeline settings from a previously serialized string.

void	ResetToDefault () override
	Resets all modules in the pipeline to their default state.

const char *	GetType () const override
	Returns the type of the module for serialization purposes.

peak::icv::Image	Process (const peak::icv::Image &image) const
	Processes the input image and returns the result as a new image.

peak::icv::Image	Process (const peak::common::IImageView &imageView) const
	Creates an image from an IImageView object, processes the image and returns the result as a new image.

peak::icv::Image	operator<< (const peak::icv::Image &image) const
	Convenience operator for processing input using the pipeline.

peak::icv::Image	operator<< (const peak::common::IImageView &imageView) const
	Convenience operator for processing input using the pipeline.

void	ReleaseBuffers () const
	Frees unused internal buffers.

features::MirrorFeature &	Mirror () const
	Provides access to the mirror feature for image mirroring operations.

features::RotationFeature &	Rotation () const
	Provides access to the rotation feature for image rotation operations.

features::GainFeature &	Gain () const
	Provides access to the gain feature for brightness and white balance adjustments.

features::ColorCorrectionFeature &	ColorCorrection () const
	Provides access to the color correction feature for color space transformations.

features::SaturationFeature &	Saturation () const
	Provides access to the saturation feature for color intensity adjustments.

features::GammaFeature &	Gamma () const
	Provides access to the gamma feature for brightness and contrast adjustments.

features::DigitalBlackFeature &	DigitalBlack () const
	Provides access to the digital black feature for sensor offset correction.

features::SharpeningFeature &	Sharpening () const
	Provides access to the sharpening feature for image detail enhancement.

features::HotpixelCorrectionFeature &	HotpixelCorrection () const
	Provides access to the hot pixel correction feature for defective pixel repair.

features::BinningFeature &	Binning () const
	Provides access to the binning feature for resolution reduction and noise improvement.

features::DecimationFeature &	Decimation () const
	Provides access to the decimation feature for resolution reduction by pixel skipping.

void	SetOutputPixelFormat (peak::common::PixelFormat format)
	Configures the pipeline for output `format`.

peak::common::PixelFormat	GetOutputPixelFormat () const
	Retrieves the output pixel format of the pipeline.

void	SetProcessingPolicy (ProcessingPolicy policy)
	Sets the processing policy for the image processing pipeline.

ProcessingPolicy	GetProcessingPolicy () const
	Retrieves the current processing policy of the image processing pipeline.

void	SetAutoFeatureModule (const std::shared_ptr< modules::IAutoFeature > &autoFeatureModule)
	Sets an auto feature module used in the pipeline.

void	ExportSettingsToFile (const std::string &filePath) const override
	Saves the current settings of the pipeline and its modules to a file.

void	ImportSettingsFromFile (const std::string &filePath) override
	Loads the settings of the pipeline and its modules from a file.

peak::common::Any	operator<< (const peak::common::Any &input) override
	Convenience operator for processing input using the pipeline.

Detailed Description

Image processing pipeline for sequential transformation of raw image frames.

The Pipeline class performs a series of configurable image processing steps on raw or pre-processed image data. It is designed to support a complete transformation workflow, from raw sensor input to final output format, with each stage modular and optionally enabled or configured.

Processing Steps:

Unpack (Always Active) – Automatically unpacks packed sensor data formats. This stage is internal and cannot be configured.
Hot Pixel Correction – Identifies and corrects defective pixels (hot pixels).
Binning – Reduces resolution and improves signal-to-noise ratio by combining adjacent pixels.
Decimation – Downscales the image by skipping pixels in a defined pattern.
Mirror – Optionally mirrors the image left-right and/or up-down.
Rotation – Rotates the image by 90, 180, or 270 degrees.
Gain – Applies digital master gain to control image brightness, or digital color gains to adjust white balance.
Debayer (Configured Internally):
- Converts Bayer pattern raw data to RGB format.
- Expands monochrome images to RGB when a color output format is requested. This behavior is automatically determined based on the input and output pixel formats.
Color Correction – Applies a color correction matrix.
Auto Features – Optionally applies dynamic adjustments:
- Auto Brightness
- Auto White Balance
- Auto Focus (if supported by the device)
  
  To enable Auto Features, an external module must be provided via:
  auto autoFeatureModule = std::make_shared<peak::pipeline::modules::AutoFeatureModule>(remoteDeviceNodeMap);
  
  pipeline.SetAutoFeatureModule(autoFeatureModule);
  
  This module is part of the Auto Feature Library (AFL).
Mono Conversion (Configured Internally) – Converts RGB images to monochrome when a monochrome output format is requested.
Sharpening – Enhances image detail using edge-based sharpening filters.
Gamma – Applies gamma correction to adjust brightness and contrast.
Pixel Format Conversion (Configured Internally) – Converts the processed image to the desired output pixel format.

Smart Pixel Format Configuration Inference:

The pipeline includes built-in logic to automatically configure certain internal stages based on the input and output formats. For example:

If a Bayer image is provided and the output format is RGB, debayering is automatically applied.
If a monochrome image is input and the output format is RGB, the Debayer Module takes over the mono-to-RGB expansion.
If the output format is monochrome, Mono Conversion is enabled.
If a Bayer pixel format is set as output format, the following features or modules are not processing
- Debayer,
- Mono Conversion,
- Sharpening, and
- Gamma.
The Pixel Format Conversion module is responsible for converting to the specified output format. If necessary, the bit depth is reduced during this step.

Use the following method to set the desired final pixel format:

pipeline.SetOutputPixelFormat(PixelFormat::RGB8);

Configuration:

The pipeline can be configured in two ways:

Module Access: Each configurable processing module can be accessed directly, allowing individual configuration:
pipeline.Gain().SetMaster(1.2f);

pipeline.Gamma().SetValue(2.2f);
Settings File: Load or save all configuration settings:
pipeline.ImportSettingsFromFile("config.json");

pipeline.ExportSettingsToFile("config.json");
Reset to Defaults: Restore the pipeline to its default configuration:
pipeline.ResetToDefault();

This modular and extensible design enables flexible integration into a variety of image processing applications, from camera pipelines to offline image editing.

Since: 1.0

Definition at line 261 of file peak_icv_default_pipeline.hpp.

Constructor & Destructor Documentation

◆ DefaultPipeline()

DefaultPipeline ( )

inline

Creates a DefaultPipeline with default module settings.

Initializes all internal modules to their default configuration.

Since: 1.0

Definition at line 629 of file peak_icv_default_pipeline.hpp.

◆ ~DefaultPipeline()

~DefaultPipeline ( )

inlineoverride

Since: 1.0

Definition at line 642 of file peak_icv_default_pipeline.hpp.

Member Function Documentation

◆ Binning()

features::BinningFeature & Binning ( ) const

inline

Provides access to the binning feature for resolution reduction and noise improvement.

The binning feature reduces image resolution by combining adjacent pixels through averaging or summation, improving signal-to-noise ratio at the cost of resolution.

Returns: A reference to the binning feature.

Since: 1.0

Definition at line 814 of file peak_icv_default_pipeline.hpp.

◆ ColorCorrection()

features::ColorCorrectionFeature & ColorCorrection ( ) const

inline

Provides access to the color correction feature for color space transformations.

The color correction feature applies a 3x3 transformation matrix to perform color balancing.

Returns: A reference to the color correction feature.

Since: 1.0

Definition at line 784 of file peak_icv_default_pipeline.hpp.

◆ Decimation()

features::DecimationFeature & Decimation ( ) const

inline

Provides access to the decimation feature for resolution reduction by pixel skipping.

The decimation feature reduces image resolution by skipping pixels in a defined pattern, providing a faster alternative to binning for resolution reduction.

Returns: A reference to the decimation feature.

Since: 1.0

Definition at line 819 of file peak_icv_default_pipeline.hpp.

◆ DigitalBlack()

features::DigitalBlackFeature & DigitalBlack ( ) const

inline

Provides access to the digital black feature for sensor offset correction.

The digital black feature compensates for sensor digital black offsets by subtracting a configurable black level and normalizing the result.

Returns: A reference to the digital black feature.

Since: 1.0

Definition at line 799 of file peak_icv_default_pipeline.hpp.

◆ ExportSettingsToFile()

void ExportSettingsToFile ( const std::string & filePath ) const

inlineoverridevirtualinherited

Saves the current settings of the pipeline and its modules to a file.

This base implementation calls ExportSettingsToString() and writes the resulting string to the specified file path.

Parameters

filePath Path to the file where the settings should be saved.

Since: ids_peak_common 1.0

Implements IPipeline.

Definition at line 77 of file peak_common_pipeline_base.hpp.

◆ ExportSettingsToString()

std::string ExportSettingsToString ( ) const

inlineoverridevirtual

Converts the current pipeline settings into a string format.

Serializes all relevant configuration parameters of the pipeline into a single string, which can be stored or transferred for later use.

Returns: A string representation of the pipeline's current configuration state.

Since: 1.0

Implements IPipeline.

Definition at line 650 of file peak_icv_default_pipeline.hpp.

◆ Gain()

features::GainFeature & Gain ( ) const

inline

Provides access to the gain feature for brightness and white balance adjustments.

The gain feature allows adjustment of master gain (overall brightness) and individual color channel gains (red, green, blue) for white balance correction.

Returns: A reference to the gain feature.

Since: 1.0

Definition at line 779 of file peak_icv_default_pipeline.hpp.

◆ Gamma()

features::GammaFeature & Gamma ( ) const

inline

Provides access to the gamma feature for brightness and contrast adjustments.

The gamma feature applies inverse gamma correction to adjust image luminance, preparing images for linear domain processing or display.

Returns: A reference to the gamma feature.

Since: 1.0

Definition at line 794 of file peak_icv_default_pipeline.hpp.

◆ GetOutputPixelFormat()

peak::common::PixelFormat GetOutputPixelFormat ( ) const

inline

Retrieves the output pixel format of the pipeline.

Indicates the pixel format used by the pipeline when producing output images.

Returns: The output pixel format used by the pipeline.

Since: 1.0

Definition at line 897 of file peak_icv_default_pipeline.hpp.

◆ GetProcessingPolicy()

ProcessingPolicy GetProcessingPolicy ( ) const

inline

Retrieves the current processing policy of the image processing pipeline.

Returns: The currently set processing policy.

Since: 1.0

Definition at line 564 of file peak_icv_default_pipeline.hpp.

◆ GetType()

const char * GetType ( ) const

inlineoverridevirtual

Returns the type of the module for serialization purposes.

Returns: A string representing the module's type.

Since: 1.0

Implements IPipeline.

Definition at line 756 of file peak_icv_default_pipeline.hpp.

◆ HotpixelCorrection()

features::HotpixelCorrectionFeature & HotpixelCorrection ( ) const

inline

Provides access to the hot pixel correction feature for defective pixel repair.

The hot pixel correction feature identifies and corrects defective pixels (hot pixels) in camera images by replacing them with interpolated values from neighboring pixels.

Returns: A reference to the hotpixel correction feature.

Since: 1.0

Definition at line 809 of file peak_icv_default_pipeline.hpp.

◆ ImportSettingsFromFile()

void ImportSettingsFromFile ( const std::string & filePath )

inlineoverridevirtualinherited

Loads the settings of the pipeline and its modules from a file.

This base implementation reads the file contents and passes them to ImportSettingsFromString() to restore the pipeline state.

Parameters

filePath Path to the file from which settings should be loaded.

Since: ids_peak_common 1.0

Implements IPipeline.

Definition at line 94 of file peak_common_pipeline_base.hpp.

◆ ImportSettingsFromString()

void ImportSettingsFromString ( const std::string & settings )

inlineoverridevirtual

Restores pipeline settings from a previously serialized string.

Parses the provided string and applies the contained configuration values to update the internal state of the pipeline accordingly.

Parameters

settings A string containing the serialized pipeline configuration.

Since: 1.0

Implements IPipeline.

Definition at line 684 of file peak_icv_default_pipeline.hpp.

◆ Mirror()

features::MirrorFeature & Mirror ( ) const

inline

Provides access to the mirror feature for image mirroring operations.

The mirror feature allows horizontal (left-right) and vertical (up-down) mirroring of images during pipeline processing.

Returns: A reference to the mirror feature.

Since: 1.0

Definition at line 769 of file peak_icv_default_pipeline.hpp.

◆ operator<<() [1/3]

peak::icv::Image operator<< ( const peak::common::IImageView & imageView ) const

inline

Convenience operator for processing input using the pipeline.

Equivalent to calling Process.

Parameters

imageView The image view object to be processed as image.

Returns: A new image containing the processed result or a deep copy of the input.

Since: 1.0

Definition at line 892 of file peak_icv_default_pipeline.hpp.

◆ operator<<() [2/3]

peak::icv::Image operator<< ( const peak::icv::Image & image ) const

inline

Convenience operator for processing input using the pipeline.

Equivalent to calling Process.

Parameters

image The input image to be processed.

Returns: A new image containing the processed result or a deep copy of the input.

Since: 1.0

Definition at line 887 of file peak_icv_default_pipeline.hpp.

◆ operator<<() [3/3]

peak::common::Any operator<< ( const peak::common::Any & input )

inlineoverridevirtualinherited

Convenience operator for processing input using the pipeline.

This base implementation simply redirects to the Process() method.

Equivalent to calling Process(input).

Parameters

input The input to process.

Returns: The processed output.

Since: ids_peak_common 1.0

Implements IPipeline.

Definition at line 114 of file peak_common_pipeline_base.hpp.

◆ Process() [1/2]

peak::icv::Image Process ( const peak::common::IImageView & imageView ) const

inline

Creates an image from an IImageView object, processes the image and returns the result as a new image.

The returned image is always a new instance. If no processing is applied, it will contain a deep copy of the input buffer.

Note: This operation disregards any specified image regions and processes the entire image.

Parameters

imageView The image view object to be processed as image.

Returns: A new image containing the processed result or a deep copy of the input.

Since: 1.0

Definition at line 882 of file peak_icv_default_pipeline.hpp.

◆ Process() [2/2]

peak::icv::Image Process ( const peak::icv::Image & image ) const

inline

Processes the input image and returns the result as a new image.

The returned image is always a new instance. If no processing is applied, it will be a deep copy of the input.

Note: This operation disregards any specified image regions and processes the entire image.

Parameters

image The input image to be processed.

Returns: A new image containing the processed result or a deep copy of the input.

Since: 1.0

Definition at line 877 of file peak_icv_default_pipeline.hpp.

◆ ReleaseBuffers()

void ReleaseBuffers ( ) const

inline

Frees unused internal buffers.

Conversion modules use pre-allocated internal buffers to accelerate conversions. When the image size or pixel format changes, new buffers are allocated, which may cause the internal buffer pool to grow over time. This function can be used to release unused buffers and reduce memory usage.

Warning: Avoid calling this function too frequently (e.g., after every resize or format change), as it introduces some overhead and may negatively impact performance.

Since: 1.0

Definition at line 761 of file peak_icv_default_pipeline.hpp.

◆ ResetToDefault()

void ResetToDefault ( )

inlineoverridevirtual

Resets all modules in the pipeline to their default state.

Since: 1.0

Implements IPipeline.

Definition at line 741 of file peak_icv_default_pipeline.hpp.

◆ Rotation()

features::RotationFeature & Rotation ( ) const

inline

Provides access to the rotation feature for image rotation operations.

The rotation feature allows rotating images in 90-degree increments (0°, 90°, 180°, 270°) during pipeline processing.

Returns: A reference to the rotation feature.

Since: 1.0

Definition at line 774 of file peak_icv_default_pipeline.hpp.

◆ Saturation()

features::SaturationFeature & Saturation ( ) const

inline

Provides access to the saturation feature for color intensity adjustments.

The saturation feature allows adjustment of color saturation levels, making colors more vivid (higher saturation) or more muted (lower saturation).

Returns: A reference to the saturation feature.

Since: 1.0

Definition at line 789 of file peak_icv_default_pipeline.hpp.

◆ SetAutoFeatureModule()

void SetAutoFeatureModule ( const std::shared_ptr< modules::IAutoFeature > & autoFeatureModule )

inline

Sets an auto feature module used in the pipeline.

Sets an auto feature module for automatic image adjustments. These adjustments can include features such as image brightness, white balance, and focus, depending on the capabilities of the provided module.

Note: If there is no auto feature module specified, this step will be skipped during processing.

Parameters

autoFeatureModule The auto feature module.

Since: 1.0

Definition at line 977 of file peak_icv_default_pipeline.hpp.

◆ SetOutputPixelFormat()

void SetOutputPixelFormat ( peak::common::PixelFormat format )

inline

Configures the pipeline for output format.

Sets the output format to format

Warning: When set to a Bayer format, the ColorCorrection, Gamma and Sharpening features will not process the image because they do not support Bayer formats. This may result in unexpected image quality if these features are enabled.

Parameters

format The output pixel format.

See also: GetOutputPixelFormat(), features::ColorCorrectionFeature, features::GammaFeature, features::SharpeningFeature

Since: 1.0

Definition at line 902 of file peak_icv_default_pipeline.hpp.

◆ SetProcessingPolicy()

void SetProcessingPolicy ( ProcessingPolicy policy )

inline

Sets the processing policy for the image processing pipeline.

This policy determines the trade-off between processing speed and image quality throughout the entire pipeline.

Fast: Prioritizes processing speed, which may reduce image quality.
Balanced: Balances processing speed and image quality for typical use cases.
Enhanced: Prioritizes improved image quality at the cost of reduced processing speed.

Parameters

policy The desired processing policy.

Since: 1.0

Definition at line 965 of file peak_icv_default_pipeline.hpp.

◆ Sharpening()

features::SharpeningFeature & Sharpening ( ) const

inline

Provides access to the sharpening feature for image detail enhancement.

The sharpening feature applies edge-based sharpening filters to enhance image detail and improve perceived image sharpness.

Returns: A reference to the sharpening feature.

Since: 1.0

Definition at line 804 of file peak_icv_default_pipeline.hpp.

Public Member Functions

Detailed Description

Processing Steps:

Smart Pixel Format Configuration Inference:

Configuration:

Constructor & Destructor Documentation

◆ DefaultPipeline()

◆ ~DefaultPipeline()

Member Function Documentation

◆ Binning()

◆ ColorCorrection()

◆ Decimation()

◆ DigitalBlack()

◆ ExportSettingsToFile()

◆ ExportSettingsToString()

◆ Gain()

◆ Gamma()

◆ GetOutputPixelFormat()

◆ GetProcessingPolicy()

◆ GetType()

◆ HotpixelCorrection()

◆ ImportSettingsFromFile()

◆ ImportSettingsFromString()

◆ Mirror()

◆ operator<<() [1/3]

◆ operator<<() [2/3]

◆ operator<<() [3/3]

◆ Process() [1/2]

◆ Process() [2/2]

◆ ReleaseBuffers()

◆ ResetToDefault()

◆ Rotation()

◆ Saturation()

◆ SetAutoFeatureModule()

◆ SetOutputPixelFormat()

◆ SetProcessingPolicy()

◆ Sharpening()