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.

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:

Set the Exposure Auto or the Gain Auto auto function or both to Once or Continuous.
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

Camera Model	Default Damping Factor
a2A640-240gmSWIR	Brightness Adjustment Damping feature not supported
a2A640-240umSWIR	Brightness Adjustment Damping feature not supported
a2A1280-80gmSWIR	Brightness Adjustment Damping feature not supported
a2A1280-125umSWIR	Brightness Adjustment Damping feature not supported
a2A1920-51gcBAS	Brightness Adjustment Damping feature not supported
a2A1920-51gcPRO	Brightness Adjustment Damping feature not supported
a2A1920-51gmBAS	Brightness Adjustment Damping feature not supported
a2A1920-51gmPRO	Brightness Adjustment Damping feature not supported
a2A1920-160ucBAS	Brightness Adjustment Damping feature not supported
a2A1920-160ucPRO	Brightness Adjustment Damping feature not supported
a2A1920-160umBAS	Brightness Adjustment Damping feature not supported
a2A1920-160umPRO	Brightness Adjustment Damping feature not supported
a2A1920-165g5cBAS	Brightness Adjustment Damping feature not supported
a2A1920-165g5mBAS	Brightness Adjustment Damping feature not supported
a2A2440-98g5cBAS	Brightness Adjustment Damping feature not supported
a2A2440-98g5mBAS	Brightness Adjustment Damping feature not supported
a2A2448-23gcBAS	Brightness Adjustment Damping feature not supported
a2A2448-23gcPRO	Brightness Adjustment Damping feature not supported
a2A2448-23gmBAS	Brightness Adjustment Damping feature not supported
a2A2448-23gmPRO	Brightness Adjustment Damping feature not supported
a2A2448-75ucBAS	Brightness Adjustment Damping feature not supported
a2A2448-75ucPRO	Brightness Adjustment Damping feature not supported
a2A2448-75umBAS	Brightness Adjustment Damping feature not supported
a2A2448-75umPRO	Brightness Adjustment Damping feature not supported
a2A2448-105g5cBAS	Brightness Adjustment Damping feature not supported
a2A2448-105g5mBAS	Brightness Adjustment Damping feature not supported
a2A2448-120cc	Brightness Adjustment Damping feature not supported
a2A2448-120cm	Brightness Adjustment Damping feature not supported
a2A2448-210cc	Brightness Adjustment Damping feature not supported
a2A2448-210cm	Brightness Adjustment Damping feature not supported
a2A2590-22gcBAS	Brightness Adjustment Damping feature not supported
a2A2590-22gcPRO	Brightness Adjustment Damping feature not supported
a2A2590-22gmBAS	Brightness Adjustment Damping feature not supported
a2A2590-22gmPRO	Brightness Adjustment Damping feature not supported
a2A2590-60ucBAS	Brightness Adjustment Damping feature not supported
a2A2590-60ucPRO	Brightness Adjustment Damping feature not supported
a2A2590-60umBAS	Brightness Adjustment Damping feature not supported
a2A2590-60umPRO	Brightness Adjustment Damping feature not supported
a2A2600-20gcBAS	Brightness Adjustment Damping feature not supported
a2A2600-20gcPRO	Brightness Adjustment Damping feature not supported
a2A2600-20gmBAS	Brightness Adjustment Damping feature not supported
a2A2600-20gmPRO	Brightness Adjustment Damping feature not supported
a2A2600-64ucBAS	Brightness Adjustment Damping feature not supported
a2A2600-64ucPRO	Brightness Adjustment Damping feature not supported
a2A2600-64umBAS	Brightness Adjustment Damping feature not supported
a2A2600-64umPRO	Brightness Adjustment Damping feature not supported
a2A2840-14gcBAS	Brightness Adjustment Damping feature not supported
a2A2840-14gcPRO	Brightness Adjustment Damping feature not supported
a2A2840-14gmBAS	Brightness Adjustment Damping feature not supported
a2A2840-14gmPRO	Brightness Adjustment Damping feature not supported
a2A2840-14gmUV	Brightness Adjustment Damping feature not supported
a2A2840-48ucBAS	Brightness Adjustment Damping feature not supported
a2A2840-48ucPRO	Brightness Adjustment Damping feature not supported
a2A2840-48umBAS	Brightness Adjustment Damping feature not supported
a2A2840-48umPRO	Brightness Adjustment Damping feature not supported
a2A2840-48umUV	Brightness Adjustment Damping feature not supported
a2A2840-67g5cBAS	Brightness Adjustment Damping feature not supported
a2A2840-67g5mBAS	Brightness Adjustment Damping feature not supported
a2A2840-67g5mUV	Brightness Adjustment Damping feature not supported
a2A2840-86cc	Brightness Adjustment Damping feature not supported
a2A2840-86cm	Brightness Adjustment Damping feature not supported
a2A3840-13gcBAS	Brightness Adjustment Damping feature not supported
a2A3840-13gcPRO	Brightness Adjustment Damping feature not supported
a2A3840-13gmBAS	Brightness Adjustment Damping feature not supported
a2A3840-13gmPRO	Brightness Adjustment Damping feature not supported
a2A3840-45ucBAS	Brightness Adjustment Damping feature not supported
a2A3840-45ucPRO	Brightness Adjustment Damping feature not supported
a2A3840-45umBAS	Brightness Adjustment Damping feature not supported
a2A3840-45umPRO	Brightness Adjustment Damping feature not supported
a2A4096-9gcBAS	Brightness Adjustment Damping feature not supported
a2A4096-9gcPRO	Brightness Adjustment Damping feature not supported
a2A4096-9gmBAS	Brightness Adjustment Damping feature not supported
a2A4096-9gmPRO	Brightness Adjustment Damping feature not supported
a2A4096-30ucBAS	Brightness Adjustment Damping feature not supported
a2A4096-30ucPRO	Brightness Adjustment Damping feature not supported
a2A4096-30umBAS	Brightness Adjustment Damping feature not supported
a2A4096-30umPRO	Brightness Adjustment Damping feature not supported
a2A4096-44g5cBAS	Brightness Adjustment Damping feature not supported
a2A4096-44g5mBAS	Brightness Adjustment Damping feature not supported
a2A4096-67cc	Brightness Adjustment Damping feature not supported
a2A4096-67cm	Brightness Adjustment Damping feature not supported
a2A4200-12gcBAS	Brightness Adjustment Damping feature not supported
a2A4200-12gcPRO	Brightness Adjustment Damping feature not supported
a2A4200-12gmBAS	Brightness Adjustment Damping feature not supported
a2A4200-12gmPRO	Brightness Adjustment Damping feature not supported
a2A4200-40ucBAS	Brightness Adjustment Damping feature not supported
a2A4200-40ucPRO	Brightness Adjustment Damping feature not supported
a2A4200-40umBAS	Brightness Adjustment Damping feature not supported
a2A4200-40umPRO	Brightness Adjustment Damping feature not supported
a2A4504-5gcBAS	Brightness Adjustment Damping feature not supported
a2A4504-5gcPRO	Brightness Adjustment Damping feature not supported
a2A4504-5gmBAS	Brightness Adjustment Damping feature not supported
a2A4504-5gmPRO	Brightness Adjustment Damping feature not supported
a2A4504-18ucBAS	Brightness Adjustment Damping feature not supported
a2A4504-18ucPRO	Brightness Adjustment Damping feature not supported
a2A4504-18umBAS	Brightness Adjustment Damping feature not supported
a2A4504-18umPRO	Brightness Adjustment Damping feature not supported
a2A4504-27g5cBAS	Brightness Adjustment Damping feature not supported
a2A4504-27g5mBAS	Brightness Adjustment Damping feature not supported
a2A4504-42cc	Brightness Adjustment Damping feature not supported
a2A4504-42cm	Brightness Adjustment Damping feature not supported
a2A4508-6gcBAS	Brightness Adjustment Damping feature not supported
a2A4508-6gcPRO	Brightness Adjustment Damping feature not supported
a2A4508-6gmBAS	Brightness Adjustment Damping feature not supported
a2A4508-6gmPRO	Brightness Adjustment Damping feature not supported
a2A4508-20ucBAS	Brightness Adjustment Damping feature not supported
a2A4508-20ucPRO	Brightness Adjustment Damping feature not supported
a2A4508-20umBAS	Brightness Adjustment Damping feature not supported
a2A4508-20umPRO	Brightness Adjustment Damping feature not supported
a2A5320-7gcBAS	Brightness Adjustment Damping feature not supported
a2A5320-7gcPRO	Brightness Adjustment Damping feature not supported
a2A5320-7gmBAS	Brightness Adjustment Damping feature not supported
a2A5320-7gmPRO	Brightness Adjustment Damping feature not supported
a2A5320-23ucBAS	Brightness Adjustment Damping feature not supported
a2A5320-23ucPRO	Brightness Adjustment Damping feature not supported
a2A5320-23umBAS	Brightness Adjustment Damping feature not supported
a2A5320-23umPRO	Brightness Adjustment Damping feature not supported
a2A5320-34g5cBAS	Brightness Adjustment Damping feature not supported
a2A5320-34g5mBAS	Brightness Adjustment Damping feature not supported
a2A5320-52cc	Brightness Adjustment Damping feature not supported
a2A5320-52cm	Brightness Adjustment Damping feature not supported
a2A5328-4gcBAS	Brightness Adjustment Damping feature not supported
a2A5328-4gcPRO	Brightness Adjustment Damping feature not supported
a2A5328-4gmBAS	Brightness Adjustment Damping feature not supported
a2A5328-4gmPRO	Brightness Adjustment Damping feature not supported
a2A5328-15ucBAS	Brightness Adjustment Damping feature not supported
a2A5328-15ucPRO	Brightness Adjustment Damping feature not supported
a2A5328-15umBAS	Brightness Adjustment Damping feature not supported
a2A5328-15umPRO	Brightness Adjustment Damping feature not supported
a2A5328-22g5cBAS	Brightness Adjustment Damping feature not supported
a2A5328-22g5mBAS	Brightness Adjustment Damping feature not supported
a2A5328-35cc	Brightness Adjustment Damping feature not supported
a2A5328-35cm	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
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-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-20uc	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-165uc	Brightness Adjustment Damping feature not supported
acA2000-165um	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-57ucMED	Brightness Adjustment Damping feature not supported
acA3088-57um	Brightness Adjustment Damping feature not supported
acA3088-57umMED	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
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-17ucMED	Brightness Adjustment Damping feature not supported
acA5472-17um	Brightness Adjustment Damping feature not supported
acA5472-17umMED	Brightness Adjustment Damping feature not supported
boA1936-400cc	Brightness Adjustment Damping feature not supported
boA1936-400cm	Brightness Adjustment Damping feature not supported
boA2448-250cc	Brightness Adjustment Damping feature not supported
boA2448-250cm	Brightness Adjustment Damping feature not supported
boA2832-190cc	Brightness Adjustment Damping feature not supported
boA2832-190cm	Brightness Adjustment Damping feature not supported
boA4096-93cc	Brightness Adjustment Damping feature not supported
boA4096-93cm	Brightness Adjustment Damping feature not supported
boA4096-180cc	Brightness Adjustment Damping feature not supported
boA4096-180cm	Brightness Adjustment Damping feature not supported
boA4112-68cc	Brightness Adjustment Damping feature not supported
boA4112-68cm	Brightness Adjustment Damping feature not supported
boA4500-45cc	Brightness Adjustment Damping feature not supported
boA4500-45cm	Brightness Adjustment Damping feature not supported
boA4504-100cc	Brightness Adjustment Damping feature not supported
boA4504-100cm	Brightness Adjustment Damping feature not supported
boA5120-150cc	Brightness Adjustment Damping feature not supported
boA5120-150cm	Brightness Adjustment Damping feature not supported
boA5120-230cc	Brightness Adjustment Damping feature not supported
boA5120-230cm	Brightness Adjustment Damping feature not supported
boA5320-150cc	Brightness Adjustment Damping feature not supported
boA5320-150cm	Brightness Adjustment Damping feature not supported
boA5328-100cc	Brightness Adjustment Damping feature not supported
boA5328-100cm	Brightness Adjustment Damping feature not supported
boA6500-36cc	Brightness Adjustment Damping feature not supported
boA6500-36cm	Brightness Adjustment Damping feature not supported
boA8100-16cc	Brightness Adjustment Damping feature not supported
boA8100-16cm	Brightness Adjustment Damping feature not supported
boA9344-30cc	Brightness Adjustment Damping feature not supported
boA9344-30cm	Brightness Adjustment Damping feature not supported
boA9344-70cc	Brightness Adjustment Damping feature not supported
boA9344-70cm	Brightness Adjustment Damping feature not supported
boA13440-17cm	Brightness Adjustment Damping feature not supported
daA720-520uc	Brightness Adjustment Damping feature not supported
daA720-520um	Brightness Adjustment Damping feature not supported
daA1280-54uc	0.5
daA1280-54um	0.5
daA1440-220uc	Brightness Adjustment Damping feature not supported
daA1440-220um	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
daA1920-160uc	Brightness Adjustment Damping feature not supported
daA1920-160um	Brightness Adjustment Damping feature not supported
daA2448-70uc	Brightness Adjustment Damping feature not supported
daA2448-70um	Brightness Adjustment Damping feature not supported
daA2500-14uc	0.3
daA2500-14um	0.3
daA3840-45uc	Brightness Adjustment Damping feature not supported
daA3840-45um	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#

C++ (Native)C++ (Generic)C#C (Generic)Python

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