WBO_Mode

Operating mode of the white balance operator

Applicable product(s): 1624 Grablink Base, 1623 Grablink DualBase, 1622 Grablink Full, 1626 Grablink Full XR.

Parameter Info

Class Category Level Type Access
Channel White Balance Operator ADJUST Enumerated Set and Get
Num ID String Identifier C, C++ identifier
4715 << 14 WBO_Mode MC_WBO_Mode

Parameter Description

This enumerated parameter determines the operating mode of the White Balance Operator within a MultiCam acquisition sequence.

Parameter Usage

Relevance condition(s):
  • Condition: The camera is a color camera (Spectrum=COLOR).
  • Condition: The acquisition channel delivers Y and/or RGB pixel data (ColorFormat ≠ BAYER*)

Parameter Values

Enumeration: NONE, ONCE, CONTINUOUS, MANUAL

Table 1. NONE
MC_WBO_Mode_NONE

Applicable product(s): 1624 Grablink Base, 1623 Grablink DualBase, 1622 Grablink Full, 1626 Grablink Full XR.

Description

When WBO_Mode is set to NONE, the White Balance Operator is disabled; the gain corrections are not applied.

Default value.

Table 2. ONCE
MC_WBO_Mode_ONCE

Applicable product(s): 1624 Grablink Base, 1623 Grablink DualBase, 1622 Grablink Full, 1626 Grablink Full XR.

Description

When WBO_Mode is set to ONCE, the image color balancing gains are automatically computed during the initial acquisition phase of every MultiCam acquisition sequence within the AWB_AREA defined by parameters WBO_OrgX, WBO_OrgY, WBO_Width, and WBO_Height.

The parameters WBO_GainR, WBO_GainG, and WBO_GainR are automatically set to the respective computed gain values.

Description for 1624 Grablink Base, 1623 Grablink DualBase, 1622 Grablink Full, 1626 Grablink Full XR

The White Balance Operator is disabled at the begin of the sequence and remains disabled until the occurrence of the first MC_SIG_SURFACE_PROCESSING signal. The first delivered image is never color balanced; subsequent images remain partially or entirely unbalance until the White Balance Operator is configured.
Table 3. MANUAL
MC_WBO_Mode_MANUAL

Applicable product(s): 1624 Grablink Base, 1623 Grablink DualBase, 1622 Grablink Full, 1626 Grablink Full XR.

Description

When WBO_Mode is set to MANUAL, the image color balance is performed with gains specified by parameters WBO_GainR, WBO_GainG and WBO_GainB.