Gray Value Adjustment Damping#
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.