Image Brightness and Color Balancer

You are currently viewing the documentation for the latest version (2.2.0). To access a different version, click the "Switch version" button located in the upper-right corner of the page.

■ If you are not sure which version of the product you are currently using, please feel free to contact Mech-Mind Technical Support.

Function

This Step uses different algorithms to process images. It is mainly used to adjust the contrast of images and also used to adjust the color balance, which facilitates further processing such as edge detection and identification.

Usage Scenario

This Step is used in scenes with large variations in light intensity. It performs a balancing operation on the image, so that the brightness or color of the image is within an appropriate range to facilitate subsequent processing.

Input and Output

Input

Input port Data type Description

Original Image

Image

Image input to this port will be processed.

Output

Output port Data type Description

Processed Image

Image

Processed image.

Parameters

The following five types of balancers are available, each requires different parameter settings:

AdaptiveColorBalancer

This balancer performs a balancing operation based on the RGB channels’ values of the image, while its effect on grayscale images is not obvious.

There are no parameters for this kind of balancer.

CLAHE

The default balancer is CLAHE.

Parameter Description

Clip Limit

Parameter description: This parameter is used to adjust the color balance. When the value is increased, the balancing effect is more obvious, and the degree of contrast decreases.
Default value: 4

ColorBalancer

Parameter Description

Lightness

Parameter description: This parameter is used to adjust the lightness of the image. When the value is increased, the image will be brighter.
Default value: 0

Green to Red

Parameter description: This parameter is used to adjust the color of the image. When the value is increased, the image will tend to be reddish.
Default value: 0

Blue to Yellow

Parameter description: This parameter is used to adjust the color of the image. When the value is increased, the image will tend to be yellowish.
Default value: 0

GammaCorrection

Parameter Description

Gamma

Parameter description: When the value is increased, the degree of contrast decreases. Only a few pixels will be displayed if this value is set to 0.
Default value: 1.00

Illumination Normalization

Retinex_SSR

Gaussian Kernel Settings

Parameter Description

Kernel Size

Parameter description: This parameter is used to set the Gaussian kernel size, and the value can only be an odd number. When the value is increased, the edge of objects in the image will be more obvious.
Default value: 21
Tuning instructions: Please set based on actual conditions.

General Settings

Parameter Description

Mean Illumination

Parameter description: This parameter is used to adjust the mean value of illumination. When the value is increased, the image will be brighter, and is suitable for processing images acquired under darker lighting conditions.
Default value: 100
Tuning instructions: Please set based on actual conditions.

Retinex_MSR

Gaussian Kernel Settings

Parameter Description

Small/Medium/Large Kernel Size

Parameter description: This parameter is used to set the Gaussian kernel size, and the value can only be an odd number. When the value is increased, the edge of objects in the image will be more obvious.
Default value of small size: 15
Default value of medium size: 81
Default value of large size: 201
Tuning instructions: Please set based on actual conditions.

General Settings

Parameter Description

Mean Illumination

Parameter description: This parameter is used to adjust the mean value of illumination. When the value is increased, the image will be brighter, and is suitable for processing images acquired under darker lighting conditions.
Default value: 100
Tuning recommendation: Please set the value according to the actual situation.

BgAdjust

Background Adjustment Settings

ROI

The coordinate of the upper left corner of the original image is (0, 0).

Parameter Description

X

Parameter description: This parameter refers to the X coordinate of the ROI’s upper left vertex.
Default value: 30

Y

Parameter description: This parameter refers to the Y coordinate of the ROI’s upper left vertex.
Default value: 700

Width

Parameter description: This parameter refers to the width of the ROI.
Default value: 200

Height

Parameter description: This parameter refers to the height of the ROI.
Default value: 200

General Settings

Parameter Description

Mean Illumination

Parameter description: This parameter is used to adjust the mean value of illumination. When the value is increased, the image will be brighter, and is suitable for processing images acquired under darker lighting conditions.
Default value: 100
Tuning instructions: Please set based on actual conditions.

Is this page helpful?

You can give a feedback in any of the following ways:

We Value Your Privacy

We use cookies to provide you with the best possible experience on our website. By continuing to use the site, you acknowledge that you agree to the use of cookies. If you decline, a single cookie will be used to ensure you're not tracked or remembered when you visit this website.