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
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.
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.
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.
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 |
// 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.