Brightness Adjustment Damping#

The Brightness Adjustment Damping 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.

Using the Feature#

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.

Specifying a Damping Factor#

To specify a damping factor:

1. Set the Exposure Auto or the Gain Auto auto function or both to Once or Continuous.
2. Set the AutoTargetBrightnessDamping parameter to the desired 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#

Show all camera models

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
CEnumParameter(nodemap, "GainAuto").SetValue("Continuous");
// Set brightness adjustment damping to 0.7
CFloatParameter(nodemap, "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);

/* 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);

# Enable Gain Auto by setting the operating mode to Continuous
camera.GainAuto.Value = "Continuous"
# Set brightness adjustment damping to 0.7
camera.AutoTargetBrightnessDamping.Value = 0.7

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