Gray Value Adjustment Damping#
Using the Feature#
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.
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:
- Set the Exposure Auto or the Gain Auto auto function or both to
- Set the
GrayValueAdjustmentDampingAbsparameter to the desired 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.
// 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 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);
/* 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.