Gray Value Adjustment Damping#

The Gray Value 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 Brightness Adjustment Damping feature, which is only available on Basler dart and pulse camera models.

Using the Feature#

Prerequisites#

The Exposure Auto or Gain Auto auto function or both must be set to Once or Continuous.

How It Works#

The lower the gray value adjustment damping factor, the slower the target brightness value is reached. This 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.

Info

The Brightness Adjustment Damping feature, which is only available on Basler dart and pulse camera models, works vice versa: The lower the brightness adjustment damping factor, the faster the target brightness value is reached.

Specifying a Damping Factor#

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

You can set the parameter in a range from 0.0 to 0.78125. Using higher parameter values means that the target value is reached sooner.

By default, the factor is set to 0.6836. This is a setting where the damping control is as stable and quick as possible.

Sample Code#

// Enable Gain Auto by setting the operating mode to Continuous
camera.GainAuto.SetValue(GainAuto_Continuous);
// Set gray value adjustment damping to 0.5859
camera.GrayValueAdjustmentDampingAbs.SetValue(0.5859);
INodeMap& nodemap = camera.GetNodeMap();
// Enable Gain Auto by setting the operating mode to Continuous
CEnumerationPtr(nodemap.GetNode("GainAuto"))->FromString("Continuous");
// Set gray value adjustment damping to 0.5859
CFloatPtr(nodemap.GetNode("GrayValueAdjustmentDampingAbs"))->SetValue(0.5859);
INodeMap& nodemap = camera.GetNodeMap();
// Enable Gain Auto by setting the operating mode to Continuous
CEnumParameter(nodemap, "GainAuto").SetValue("Continuous");
// Set gray value adjustment damping to 0.5859
CFloatParameter(nodemap, "GrayValueAdjustmentDampingAbs").SetValue(0.5859);
// Enable Gain Auto by setting the operating mode to Continuous
camera.Parameters[PLCamera.GainAuto].SetValue(PLCamera.GainAuto.Continuous);
// Set gray value adjustment damping to 0.5859
camera.Parameters[PLCamera.GrayValueAdjustmentDampingAbs].SetValue(0.5859);
// Enable Gain Auto by setting the operating mode to Continuous
Pylon.DeviceFeatureFromString(hdev, "GainAuto", "Continuous");
// Set gray value adjustment damping to 0.5859
Pylon.DeviceSetFloatFeature(hdev, "GrayValueAdjustmentDampingAbs", 0.5859);
/* 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 gray value adjustment damping to 0.5859 */
errRes = PylonDeviceSetFloatFeature(hdev, "GrayValueAdjustmentDampingAbs", 0.5859);
CHECK(errRes);

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