Inheritance diagram for UnpackModule:

[legend]

Public Member Functions
None	__init__ (self)
	Creates an instance of class UnpackModule.

None	__del__ (self)

int	target_bit_depth (self)
	Get the target bit depth used during image processing.

None	target_bit_depth (self, int bit_depth)
	Set the target bit depth for image processing.

ProcessingPolicy	processing_policy (self)
	Get the currently configured processing policy.

None	processing_policy (self, ProcessingPolicy policy)
	Set the processing policy.

bool	enabled (self)
	Indicates whether the unpack module is enabled.

None	enabled (self, bool enabled)
	This property cannot be changed.

str	type (self)
	Returns the type of the module for serialization purposes.

Image	process (self, Image input_image)
	Converts a packed pixel format image into an unpacked Bayer or monochrome format.

None	reset_to_default (self)
	Resets all settings to their defaults.

None	release_buffers (self)
	Frees unused internal buffers.

None	serialize (self, IArchive archive)
	This function has no effect on the Unpack module.

None	deserialize (self, IArchive archive)
	This function has no effect on the Unpack module.

Static Public Attributes
	DEFAULT_POLICY = ProcessingPolicy.FAST

int	DEFAULT_TARGET_BIT_DEPTH = 8

Protected Member Functions
int	_get_output_bit_depth (self, int input_bit_depth)

PixelFormat	_get_output_pixel_format (self, PixelFormat input_pixel_format, int output_bit_depth)

Static Protected Member Functions
PixelFormat	_bayer_bg_format (int bit_depth)

PixelFormat	_bayer_gb_format (int bit_depth)

PixelFormat	_bayer_gr_format (int bit_depth)

PixelFormat	_bayer_rg_format (int bit_depth)

PixelFormat	_mono_format (int bit_depth)

Protected Attributes
	_handle = image_converter_handle

int	_target_bit_depth = self.DEFAULT_TARGET_BIT_DEPTH

ProcessingPolicy	_policy = self.DEFAULT_POLICY

Detailed Description

Unpack is an image pipeline module that converts packed pixel formats into corresponding unpacked Bayer or mono formats.

The unpack module is always enabled and cannot be disabled. It converts input images with packed pixel formats into their corresponding unpacked Bayer or monochrome formats. The output bit depth depends on the applied processing policy and the specified target bit depth.

Default configuration:

Target bit depth: 8
Processing policy: ProcessingPolicy.FAST

Since: ids_peak_icv 1.0

Definition at line 13 of file unpack_module.py.

Constructor & Destructor Documentation

◆ init()

None __init__ ( self )

Creates an instance of class UnpackModule.

Since: ids_peak_icv 1.0

Reimplemented from ModuleBase.

Definition at line 33 of file unpack_module.py.

◆ del()

None __del__ ( self )

Definition at line 49 of file unpack_module.py.

Member Function Documentation

◆ _bayer_bg_format()

PixelFormat _bayer_bg_format ( int bit_depth )

staticprotected

Definition at line 315 of file unpack_module.py.

◆ _bayer_gb_format()

PixelFormat _bayer_gb_format ( int bit_depth )

staticprotected

Definition at line 323 of file unpack_module.py.

◆ _bayer_gr_format()

PixelFormat _bayer_gr_format ( int bit_depth )

staticprotected

Definition at line 331 of file unpack_module.py.

◆ _bayer_rg_format()

PixelFormat _bayer_rg_format ( int bit_depth )

staticprotected

Definition at line 339 of file unpack_module.py.

◆ _get_output_bit_depth()

int _get_output_bit_depth	(		self,
		int	input_bit_depth )

protected

Definition at line 244 of file unpack_module.py.

◆ _get_output_pixel_format()

PixelFormat _get_output_pixel_format	(		self,
		PixelFormat	input_pixel_format,
		int	output_bit_depth )

protected

Definition at line 251 of file unpack_module.py.

◆ _mono_format()

PixelFormat _mono_format ( int bit_depth )

staticprotected

Definition at line 347 of file unpack_module.py.

◆ deserialize()

None deserialize	(		self,
		IArchive	archive )

This function has no effect on the Unpack module.

Since: ids_peak_icv 1.0

Reimplemented from ModuleBase.

Definition at line 232 of file unpack_module.py.

◆ enabled() [1/2]

bool enabled ( self )

Indicates whether the unpack module is enabled.

This property always returns True. Setting this property has no effect.

Returns: True

Since: ids_peak_icv 1.0

Reimplemented from ModuleBase.

Definition at line 118 of file unpack_module.py.

◆ enabled() [2/2]

None enabled	(		self,
		bool	enabled )

This property cannot be changed.

The module remains enabled to guarantee correct operation of following modules.

Since: ids_peak_icv 1.0

Reimplemented from ModuleBase.

Definition at line 131 of file unpack_module.py.

◆ process()

Image process	(		self,
		Image	input_image )

Converts a packed pixel format image into an unpacked Bayer or monochrome format.

This function unpacks the input image from a packed format to its corresponding unpacked Bayer or monochrome format.

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

Parameters

input_image The packed input image to unpack.

Returns: The unpacked output image with the downsampled bit depth.

Since: ids_peak_icv 1.0

Definition at line 154 of file unpack_module.py.

◆ processing_policy() [1/2]

ProcessingPolicy processing_policy ( self )

Get the currently configured processing policy.

Returns: The active processing policy.

Since: ids_peak_icv 1.0

Definition at line 96 of file unpack_module.py.

◆ processing_policy() [2/2]

None processing_policy	(		self,
		ProcessingPolicy	policy )

Set the processing policy.

Parameters

policy The desired processing policy.

Since: ids_peak_icv 1.0

Definition at line 107 of file unpack_module.py.

◆ release_buffers()

None release_buffers ( self )

Frees unused internal buffers.

This module uses 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.

Note: Avoid calling this function too frequently (e.g., after every resize or format change), as it introduces some overhead.

Since: ids_peak_icv 1.0

Definition at line 202 of file unpack_module.py.

◆ reset_to_default()

None reset_to_default ( self )

Resets all settings to their defaults.

Default configuration:

target_bit_depth = 8
processing_policy = ProcessingPolicy.FAST

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

Since: ids_peak_icv 1.0

Definition at line 186 of file unpack_module.py.

◆ serialize()

None serialize	(		self,
		IArchive	archive )

This function has no effect on the Unpack module.

Since: ids_peak_icv 1.0

Reimplemented from ModuleBase.

Definition at line 221 of file unpack_module.py.

◆ target_bit_depth() [1/2]

int target_bit_depth ( self )

Get the target bit depth used during image processing.

This value specifies the bit depth the module will aim for when unpacking packed pixel formats. The actual output bit depth depends on the selected :class:ProcessingPolicy.

Returns: The currently configured target bit depth.

Since: ids_peak_icv 1.0

Definition at line 54 of file unpack_module.py.

◆ target_bit_depth() [2/2]

None target_bit_depth	(		self,
		int	bit_depth )

Set the target bit depth for image processing.

The target bit depth acts as a reference when deciding how to unpack packed pixel formats. The actual resulting bit depth depends on the selected :class:ProcessingPolicy:

Fast: The output bit depth is the minimum of the input image bit depth and the target bit depth.
Balanced: The output bit depth is the same as the input image bit depth (the target value is ignored).
Enhanced: The output bit depth is the maximum of the input image bit depth and the target bit depth.

This allows you to downsample, preserve, or enhance bit depth depending on your use case.

Parameters

bit_depth The desired target bit depth (e.g., 8, 10, 12).

Since: ids_peak_icv 1.0

Definition at line 70 of file unpack_module.py.

◆ type()

str type ( self )

Returns the type of the module for serialization purposes.

Returns: Module type

Since: ids_peak_icv 1.0

Definition at line 143 of file unpack_module.py.

Field Documentation

◆ _handle

_handle = image_converter_handle

protected

Definition at line 45 of file unpack_module.py.

◆ _policy

ProcessingPolicy _policy = self.DEFAULT_POLICY

protected

Definition at line 47 of file unpack_module.py.

◆ _target_bit_depth

_target_bit_depth = self.DEFAULT_TARGET_BIT_DEPTH

protected

Definition at line 46 of file unpack_module.py.

◆ DEFAULT_POLICY

DEFAULT_POLICY = ProcessingPolicy.FAST

static

Definition at line 30 of file unpack_module.py.

◆ DEFAULT_TARGET_BIT_DEPTH

int DEFAULT_TARGET_BIT_DEPTH = 8

static

Definition at line 31 of file unpack_module.py.

Public Member Functions

Static Public Attributes

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __init__()

◆ __del__()

Member Function Documentation

◆ _bayer_bg_format()

◆ _bayer_gb_format()

◆ _bayer_gr_format()

◆ _bayer_rg_format()

◆ _get_output_bit_depth()

◆ _get_output_pixel_format()

◆ _mono_format()

◆ deserialize()

◆ enabled() [1/2]

◆ enabled() [2/2]

◆ process()

◆ processing_policy() [1/2]

◆ processing_policy() [2/2]

◆ release_buffers()

◆ reset_to_default()

◆ serialize()

◆ target_bit_depth() [1/2]

◆ target_bit_depth() [2/2]

◆ type()

Field Documentation

◆ _handle

◆ _policy

◆ _target_bit_depth

◆ DEFAULT_POLICY

◆ DEFAULT_TARGET_BIT_DEPTH

◆ init()

◆ del()