Balance White Adjustment Damping#

The Balance White Adjustment Damping camera feature controls the speed with which the camera adjusts colors when Balance White Auto is enabled.

Using the Feature#

Prerequisites#

The Balance White Auto auto function must be set to Once or Continuous.

How It Works#

If a balance white adjustment damping factor has been specified, colors are not adjusted immediately, but after a certain delay. This can be useful, for example, to avoid the automatic control mechanism of the auto functions being disrupted by objects moving in and out of the camera's area of view.

Specifying a Damping Factor#

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

You can set the parameter in a range from 0.0 to 0.9766. Higher parameter values result in a faster adaptation, i.e., the colors are adjusted more quickly.

By default, the factor is set to the maximum value.

Sample Code#

// Set balance white adjustment damping to 0.5859
camera.BalanceWhiteAdjustmentDampingAbs.SetValue(0.5859);
INodeMap& nodemap = camera.GetNodeMap();
// Set balance white adjustment damping to 0.5859
CFloatPtr(nodemap.GetNode("BalanceWhiteAdjustmentDampingAbs"))->SetValue(0.5859);
INodeMap& nodemap = camera.GetNodeMap();
// Set balance white adjustment damping to 0.5859
CFloatParameter(nodemap, "BalanceWhiteAdjustmentDampingAbs").SetValue(0.5859);
// Set balance white adjustment damping to 0.5859
camera.Parameters[PLCamera.BalanceWhiteAdjustmentDampingAbs].SetValue(0.5859);
// Set balance white adjustment damping to 0.5859
Pylon.DeviceSetFloatFeature(hdev, "BalanceWhiteAdjustmentDampingAbs", 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 */
/* Set balance white adjustment damping to 0.5859 */
errRes = PylonDeviceSetFloatFeature(hdev, "BalanceWhiteAdjustmentDampingAbs", 0.5859);
CHECK(errRes);

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