Brightness Adjustment Damping

The Brightness Adjustment Damping camera feature camera feature controls the speed with which pixel gray values are changed when Exposure Auto, Gain Auto, or both are enabled.

This feature is similar to the Gray Value Adjustment Damping feature, which is only available on Basler ace GigE camera models.

In this topic Hide

Using the Feature

Prerequisites

The Exposure Auto or the Gain Auto auto function or both must be set to Once or Continuous. Otherwise, the damping parameter setting has no effect.

How It Works

The lower the brightness adjustment damping factor, the faster the target brightness value is reached.

Specifying a damping factor can be useful, for example, to avoid the auto functions being disrupted by objects moving in and out of the camera’s area of view.

Also, specifying a damping factor can help to keep the brightness of your images stable if the brightness value is oscillating around the target brightness value.

The Gray Value Adjustment Damping feature, which is only available on Basler ace GigE camera models, works the opposite way: The lower the gray value adjustment damping factor, the slower the target brightness value is reached.

Specifying a Damping Factor

To specify a damping factor, adjust the AutoTargetBrightnessDamping parameter value.

You can set the parameter in a range from 0.1 to 1.0. Using lower parameter values means that the target value is reached faster.

The default value depends on your camera model.

Specifics

Camera Model Default Damping Factor
All ace 2 GigE camera models Brightness Adjustment Damping feature not supported
All ace 2 USB 3.0 camera models Brightness Adjustment Damping feature not supported
All ace GigE camera models Brightness Adjustment Damping feature not supported
All ace USB 3.0 camera models Brightness Adjustment Damping feature not supported
All dart BCON for LVDS camera models Brightness Adjustment Damping feature not supported
All dart BCON for MIPI cameras models Brightness Adjustment Damping feature not supported
All boost CXP-12 camera models Brightness Adjustment Damping feature not supported
daA1280-54um 0.5
daA1280-54uc 0.5
daA1600-60um 0.2
daA1600-60uc 0.2
daA1920-15um 0.3
daA1920-30um 0.3
daA1920-30uc 0.3
daA2500-14um 0.3
daA2500-14uc 0.3
puA1280-54um 0.5
puA1280-54uc 0.5
puA1600-60um 0.2
puA1600-60uc 0.2
puA1920-30um 0.3
puA1920-30uc 0.3
puA2500-14um 0.3
puA2500-14uc 0.3

Sample Code

// Enable Gain Auto by setting the operating mode to Continuous
camera.GainAuto.SetValue(GainAuto_Continuous);
// Set brightness adjustment damping to 0.7
camera.AutoTargetBrightnessDamping.SetValue(0.7);
INodeMap& nodemap = camera.GetNodeMap();
// Enable Gain Auto by setting the operating mode to Continuous
CEnumerationPtr(nodemap.GetNode("GainAuto"))->FromString("Continuous");
// Set brightness adjustment damping to 0.7
CFloatPtr(nodemap.GetNode("AutoTargetBrightnessDamping"))->SetValue(0.7);
// Enable Gain Auto by setting the operating mode to Continuous
camera.Parameters[PLCamera.GainAuto].SetValue(PLCamera.GainAuto.Continuous);
// Set brightness adjustment damping to 0.7
camera.Parameters[PLCamera.AutoTargetBrightnessDamping].SetValue(0.7);
// Enable Gain Auto by setting the operating mode to Continuous
Pylon.DeviceFeatureFromString(hdev, "GainAuto", "Continuous");
// Set brightness adjustment damping to 0.7
Pylon.DeviceSetFloatFeature(hdev, "AutoTargetBrightnessDamping", 0.7);
/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK;  /* Return value of pylon methods */
/* Enable Gain Auto by setting the operating mode to Continuous */
errRes = PylonDeviceFeatureFromString(hdev, "GainAuto", "Continuous");
CHECK(errRes);
/* Set brightness adjustment damping to 0.7 */
errRes = PylonDeviceSetFloatFeature(hdev, "AutoTargetBrightnessDamping", 0.7);
CHECK(errRes);

You can also use the pylon Viewer to easily set the parameters.