Skip to content

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#

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:

  1. Set the Balance White Auto auto function to Once or Continuous.
  2. 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
CFloatParameter(nodemap, "BalanceWhiteAdjustmentDampingAbs").SetValue(0.5859);

// Set balance white adjustment damping to 0.5859
camera.Parameters[PLCamera.BalanceWhiteAdjustmentDampingAbs].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 */
/* Set balance white adjustment damping to 0.5859 */
errRes = PylonDeviceSetFloatFeature(hdev, "BalanceWhiteAdjustmentDampingAbs", 0.5859);
CHECK(errRes);

# Set balance white adjustment damping to 0.5859
camera.BalanceWhiteAdjustmentDampingAbs.Value = 0.5859

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