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.

Using the Feature#

Prerequisites#

The Exposure Autoor the Gain Autoauto 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.

Info

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#

Show all camera models

Camera Model Default Damping Factor
a2A1920-51gcBAS Brightness Adjustment Damping feature not supported
a2A1920-51gmBAS Brightness Adjustment Damping feature not supported
a2A1920-160ucBAS Brightness Adjustment Damping feature not supported
a2A1920-160umBAS Brightness Adjustment Damping feature not supported
a2A3840-13gcBAS tbd
a2A3840-13gmBAS tbd
a2A3840-45ucBAS tbd
a2A3840-45umBAS tbd
acA640-90gc Brightness Adjustment Damping feature not supported
acA640-90gm Brightness Adjustment Damping feature not supported
acA640-90uc Brightness Adjustment Damping feature not supported
acA640-90um Brightness Adjustment Damping feature not supported
acA640-120gc Brightness Adjustment Damping feature not supported
acA640-120gm Brightness Adjustment Damping feature not supported
acA640-120uc Brightness Adjustment Damping feature not supported
acA640-120um Brightness Adjustment Damping feature not supported
acA640-121gm Brightness Adjustment Damping feature not supported
acA640-300gc Brightness Adjustment Damping feature not supported
acA640-300gm Brightness Adjustment Damping feature not supported
acA640-750uc Brightness Adjustment Damping feature not supported
acA640-750um Brightness Adjustment Damping feature not supported
acA720-290gc Brightness Adjustment Damping feature not supported
acA720-290gm Brightness Adjustment Damping feature not supported
acA720-520uc Brightness Adjustment Damping feature not supported
acA720-520um Brightness Adjustment Damping feature not supported
acA780-75gc Brightness Adjustment Damping feature not supported
acA780-75gm Brightness Adjustment Damping feature not supported
acA800-200gc Brightness Adjustment Damping feature not supported
acA800-200gm Brightness Adjustment Damping feature not supported
acA800-510uc Brightness Adjustment Damping feature not supported
acA800-510um Brightness Adjustment Damping feature not supported
acA1280-60gc Brightness Adjustment Damping feature not supported
acA1280-60gm Brightness Adjustment Damping feature not supported
acA1300-22gc Brightness Adjustment Damping feature not supported
acA1300-22gm Brightness Adjustment Damping feature not supported
acA1300-30gc Brightness Adjustment Damping feature not supported
acA1300-30gm Brightness Adjustment Damping feature not supported
acA1300-30uc Brightness Adjustment Damping feature not supported
acA1300-30um Brightness Adjustment Damping feature not supported
acA1300-60gc Brightness Adjustment Damping feature not supported
acA1300-60gm Brightness Adjustment Damping feature not supported
acA1300-60gmNIR Brightness Adjustment Damping feature not supported
acA1300-75gc Brightness Adjustment Damping feature not supported
acA1300-75gm Brightness Adjustment Damping feature not supported
acA1300-200uc Brightness Adjustment Damping feature not supported
acA1300-200um Brightness Adjustment Damping feature not supported
acA1440-73gc Brightness Adjustment Damping feature not supported
acA1440-73gm Brightness Adjustment Damping feature not supported
acA1440-220uc Brightness Adjustment Damping feature not supported
acA1440-220um Brightness Adjustment Damping feature not supported
acA1600-20gc Brightness Adjustment Damping feature not supported
acA1600-20gm Brightness Adjustment Damping feature not supported
acA1600-20uc Brightness Adjustment Damping feature not supported
acA1600-20um Brightness Adjustment Damping feature not supported
acA1600-60gc Brightness Adjustment Damping feature not supported
acA1600-60gm Brightness Adjustment Damping feature not supported
acA1920-25gc Brightness Adjustment Damping feature not supported
acA1920-25gm Brightness Adjustment Damping feature not supported
acA1920-25uc Brightness Adjustment Damping feature not supported
acA1920-25um Brightness Adjustment Damping feature not supported
acA1920-40gc Brightness Adjustment Damping feature not supported
acA1920-40gm Brightness Adjustment Damping feature not supported
acA1920-40uc Brightness Adjustment Damping feature not supported
acA1920-40ucMED Brightness Adjustment Damping feature not supported
acA1920-40um Brightness Adjustment Damping feature not supported
acA1920-40umMED Brightness Adjustment Damping feature not supported
acA1920-48gc Brightness Adjustment Damping feature not supported
acA1920-48gm Brightness Adjustment Damping feature not supported
acA1920-50gc Brightness Adjustment Damping feature not supported
acA1920-50gm Brightness Adjustment Damping feature not supported
acA1920-150uc Brightness Adjustment Damping feature not supported
acA1920-150um Brightness Adjustment Damping feature not supported
acA1920-155uc Brightness Adjustment Damping feature not supported
acA1920-155ucMED Brightness Adjustment Damping feature not supported
acA1920-155um Brightness Adjustment Damping feature not supported
acA1920-155umMED Brightness Adjustment Damping feature not supported
acA2000-50gc Brightness Adjustment Damping feature not supported
acA2000-50gm Brightness Adjustment Damping feature not supported
acA2000-50gmNIR Brightness Adjustment Damping feature not supported
acA2000-165uc Brightness Adjustment Damping feature not supported
acA2000-165um Brightness Adjustment Damping feature not supported
acA2000-165umNIR Brightness Adjustment Damping feature not supported
acA2040-25gc Brightness Adjustment Damping feature not supported
acA2040-25gm Brightness Adjustment Damping feature not supported
acA2040-25gmNIR Brightness Adjustment Damping feature not supported
acA2040-35gc Brightness Adjustment Damping feature not supported
acA2040-35gm Brightness Adjustment Damping feature not supported
acA2040-55uc Brightness Adjustment Damping feature not supported
acA2040-55um Brightness Adjustment Damping feature not supported
acA2040-90uc Brightness Adjustment Damping feature not supported
acA2040-90um Brightness Adjustment Damping feature not supported
acA2040-90umNIR Brightness Adjustment Damping feature not supported
acA2040-120uc Brightness Adjustment Damping feature not supported
acA2040-120um Brightness Adjustment Damping feature not supported
acA2440-20gc Brightness Adjustment Damping feature not supported
acA2440-20gm Brightness Adjustment Damping feature not supported
acA2440-35uc Brightness Adjustment Damping feature not supported
acA2440-35ucMED Brightness Adjustment Damping feature not supported
acA2440-35um Brightness Adjustment Damping feature not supported
acA2440-35umMED Brightness Adjustment Damping feature not supported
acA2440-75uc Brightness Adjustment Damping feature not supported
acA2440-75ucMED Brightness Adjustment Damping feature not supported
acA2440-75um Brightness Adjustment Damping feature not supported
acA2440-75umMED Brightness Adjustment Damping feature not supported
acA2500-14gc Brightness Adjustment Damping feature not supported
acA2500-14gm Brightness Adjustment Damping feature not supported
acA2500-14uc Brightness Adjustment Damping feature not supported
acA2500-14um Brightness Adjustment Damping feature not supported
acA2500-20gc Brightness Adjustment Damping feature not supported
acA2500-20gcMED Brightness Adjustment Damping feature not supported
acA2500-20gm Brightness Adjustment Damping feature not supported
acA2500-20gmMED Brightness Adjustment Damping feature not supported
acA2500-60uc Brightness Adjustment Damping feature not supported
acA2500-60um Brightness Adjustment Damping feature not supported
acA3088-16gc Brightness Adjustment Damping feature not supported
acA3088-16gm Brightness Adjustment Damping feature not supported
acA3088-57uc Brightness Adjustment Damping feature not supported
acA3088-57um Brightness Adjustment Damping feature not supported
acA3800-10gc Brightness Adjustment Damping feature not supported
acA3800-10gm Brightness Adjustment Damping feature not supported
acA3800-14uc Brightness Adjustment Damping feature not supported
acA3800-14um Brightness Adjustment Damping feature not supported
acA4024-8gc Brightness Adjustment Damping feature not supported
acA4024-8gm Brightness Adjustment Damping feature not supported
acA4024-29uc Brightness Adjustment Damping feature not supported
acA4024-29um Brightness Adjustment Damping feature not supported
acA4096-11gc Brightness Adjustment Damping feature not supported
acA4096-11gm Brightness Adjustment Damping feature not supported
acA4096-30uc Brightness Adjustment Damping feature not supported
acA4096-30ucMED Brightness Adjustment Damping feature not supported
acA4096-30um Brightness Adjustment Damping feature not supported
acA4096-30umMED Brightness Adjustment Damping feature not supported
acA4096-40uc Brightness Adjustment Damping feature not supported
acA4096-40ucMED Brightness Adjustment Damping feature not supported
acA4096-40um Brightness Adjustment Damping feature not supported
acA4096-40umMED Brightness Adjustment Damping feature not supported
acA4112-8gc Brightness Adjustment Damping feature not supported
acA4112-8gm Brightness Adjustment Damping feature not supported
acA4112-20uc Brightness Adjustment Damping feature not supported
acA4112-20ucMED Brightness Adjustment Damping feature not supported
acA4112-20um Brightness Adjustment Damping feature not supported
acA4112-20umMED Brightness Adjustment Damping feature not supported
acA4112-30uc Brightness Adjustment Damping feature not supported
acA4112-30ucMED Brightness Adjustment Damping feature not supported
acA4112-30um Brightness Adjustment Damping feature not supported
acA4112-30umMED Brightness Adjustment Damping feature not supported
acA4600-7gc Brightness Adjustment Damping feature not supported
acA4600-10uc Brightness Adjustment Damping feature not supported
acA5472-5gc Brightness Adjustment Damping feature not supported
acA5472-5gm Brightness Adjustment Damping feature not supported
acA5472-17uc Brightness Adjustment Damping feature not supported
acA5472-17um Brightness Adjustment Damping feature not supported
boA4096-93cc Brightness Adjustment Damping feature not supported
boA4096-93cm Brightness Adjustment Damping feature not supported
boA4112-68cc Brightness Adjustment Damping feature not supported
boA4112-68cm Brightness Adjustment Damping feature not supported
daA1280-54lc Brightness Adjustment Damping feature not supported
daA1280-54lm Brightness Adjustment Damping feature not supported
daA1280-54uc 0.5
daA1280-54um 0.5
daA1600-60lc Brightness Adjustment Damping feature not supported
daA1600-60lm Brightness Adjustment Damping feature not supported
daA1600-60uc 0.2
daA1600-60um 0.2
daA1920-15um 0.3
daA1920-30uc 0.3
daA1920-30um 0.3
daA2500-14lc Brightness Adjustment Damping feature not supported
daA2500-14lm Brightness Adjustment Damping feature not supported
daA2500-14uc 0.3
daA2500-14um 0.3
daA2500-60mc Brightness Adjustment Damping feature not supported
puA1280-54uc 0.5
puA1280-54um 0.5
puA1600-60uc 0.2
puA1600-60um 0.2
puA1920-30uc 0.3
puA1920-30um 0.3
puA2500-14uc 0.3
puA2500-14um 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);
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);
// 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.