Inheritance diagram for GainModule:

[legend]

Data Structures
class	Handle

Public Member Functions
	GainModule ()
	Creates an instance of class GainModule.

void	Dispose ()
	Releases all resources used by this class.

override void	Serialize (IArchive archive)
	Serializes the object's internal state into the provided archive.

override void	Deserialize (IArchive archive)
	Restores the object's state from the provided archive.

override object	Process (object input)
	Applies the gains to the input image in place and returns a reference to the modified image.

override void	ResetToDefault ()
	Resets all parameters to their default values.

override Image	Process (Image input)
	Applies the gains to the input image in place and returns a reference to the modified image.

Properties
IntervalF	Range `[get]`
	Gets the valid range for the master or color gains.

override string	TypeId `[get]`
	The unique type identifier for this module implementation.This should be a unique string identifying the specific implementation of the module.

override bool	IsEnabled `[get, set]`
	Gets or sets whether the module is enabled.

float	Master `[get, set]`
	The current master gain value.

float	Red `[get, set]`
	The current red gain value.

float	Green `[get, set]`
	The current green gain value.

float	Blue `[get, set]`
	The current blue gain value.

int	Version = 1 `[get]`
	The module version.

Detailed Description

Image pipeline module for applying gain to the image.

A gain module consists of a master gain applied to all channels, along with individual gain values for the red, green, and blue channels.

Since: IDSImaging.Peak.ICV 1.3

Definition at line 20 of file GainModule.cs.

Constructor & Destructor Documentation

◆ GainModule()

GainModule ( )

inline

Creates an instance of class GainModule.

Definition at line 38 of file GainModule.cs.

Member Function Documentation

◆ Deserialize()

override void Deserialize ( IArchive archive )

inlinevirtual

Restores the object's state from the provided archive.

This function reads and applies all necessary parameters from the given archive to reconstruct the internal state of the object. It ensures that the object is restored to a valid and consistent state.

Note: This function requires that the archive contains all expected fields as produced by a corresponding Serialize call.

Parameters

archive The source archive containing the serialized parameters.

Exceptions

IcvCorruptedException	The archive is malformed, misses keys or the values are invalid.
IcvNotSupportedException	The `Version` entry indicates an unsupported version.
IcvOutOfRangeException	The values are outside of the valid range.

Reimplemented from ModuleBase.

Definition at line 139 of file GainModule.cs.

◆ Dispose()

void Dispose ( )

inline

Releases all resources used by this class.

Definition at line 71 of file GainModule.cs.

◆ Process() [1/2]

override Image Process ( Image input )

inline

Applies the gains to the input image in place and returns a reference to the modified image.

The correction is performed based on the current configuration of the module. The operation modifies the input image directly and does not create a copy.

Note: Supported pixel formats: BayerRG8, BayerRG10, BayerRG12, BayerGR8, BayerGR10, BayerGR12, BayerBG8, BayerBG10, BayerBG12, BayerGB8, BayerGB10, BayerGB12, Mono8, Mono10, Mono12, Mono16.

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

Parameters

input The input image to be processed and corrected.

Returns: A reference to the input image after in-place gain correction.

Exceptions

IcvNotSupportedException Thrown when input has any other than the supported pixel formats.

Definition at line 329 of file GainModule.cs.

◆ Process() [2/2]

override object Process ( object input )

inlinevirtual

Applies the gains to the input image in place and returns a reference to the modified image.

The correction is performed based on the current configuration of the module. The operation modifies the input image directly and does not create a copy.

Note: Supported pixel formats: BayerRG8, BayerRG10, BayerRG12, BayerGR8, BayerGR10, BayerGR12, BayerBG8, BayerBG10, BayerBG12, BayerGB8, BayerGB10, BayerGB12, Mono8, Mono10, Mono12, Mono16.

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

Parameters

input The input image to be processed and corrected.

Returns: A reference to the input image after in-place gain correction.

Exceptions

IcvNotSupportedException The input is not an Image or has any other than the supported pixel formats.

Reimplemented from ModuleBase.

Definition at line 261 of file GainModule.cs.

◆ ResetToDefault()

override void ResetToDefault ( )

inlinevirtual

Resets all parameters to their default values.

Default values:

Red = 1.0f
Green = 1.0f
Blue = 1.0f
Master = 1.0f

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

Reimplemented from ModuleBase.

Definition at line 292 of file GainModule.cs.

◆ Serialize()

override void Serialize ( IArchive archive )

inlinevirtual

Serializes the object's internal state into the provided archive.

This function populates the given archive with all parameters required to fully represent the current state of the object. It ensures that the object can be reconstructed or transmitted accurately by saving all relevant data members in a consistent and structured format.

Parameters

archive The target archive that will store the serialized parameters.

Reimplemented from ModuleBase.

Definition at line 102 of file GainModule.cs.

Property Documentation

◆ Blue

float Blue

getset

The current blue gain value.

Sets the color gain for the blue channel. The valid range for the gain value can be obtained using the Range function.

Exceptions

IcvOutOfRangeException The value is outside the valid range.

Implements IGain.

Definition at line 222 of file GainModule.cs.

◆ Green

float Green

getset

The current green gain value.

Sets the color gain for the green channel. The valid range for the gain value can be obtained using the Range function.

Exceptions

IcvOutOfRangeException The value is outside the valid range.

Implements IGain.

Definition at line 201 of file GainModule.cs.

◆ IsEnabled

override bool IsEnabled

getset

Gets or sets whether the module is enabled.

Implements IModule.

Definition at line 81 of file GainModule.cs.

◆ Master

float Master

getset

The current master gain value.

Sets the overall master gain. The valid range for the gain value can be obtained using the Range function.

Exceptions

IcvOutOfRangeException The value is outside the valid range.

Implements IGain.

Definition at line 159 of file GainModule.cs.

◆ Range

IntervalF Range

get

Gets the valid range for the master or color gains.

Provides the minimum and maximum values that are accepted by the Master, Red, Green and the Blue functions.

Definition at line 54 of file GainModule.cs.

◆ Red

float Red

getset

The current red gain value.

Sets the color gain for the red channel. The valid range for the gain value can be obtained using the Range function.

Exceptions

IcvOutOfRangeException The value is outside the valid range.

Implements IGain.

Definition at line 180 of file GainModule.cs.

◆ TypeId

override string TypeId

get

The unique type identifier for this module implementation.This should be a unique string identifying the specific implementation of the module.

Implements IModule.

Definition at line 78 of file GainModule.cs.

◆ Version

int Version = 1

getinherited

The module version.

Definition at line 20 of file ModuleBase.cs.

Data Structures

Public Member Functions

Properties

Detailed Description

Constructor & Destructor Documentation

◆ GainModule()

Member Function Documentation

◆ Deserialize()

◆ Dispose()

◆ Process() [1/2]

◆ Process() [2/2]

◆ ResetToDefault()

◆ Serialize()

Property Documentation

◆ Blue

◆ Green

◆ IsEnabled

◆ Master

◆ Range

◆ Red

◆ TypeId

◆ Version