Standard Features AW00097603000186 Basler aviator GigE10.7.9 Balance White AutoBalance White Auto is the "automatic" counterpart to manually setting the white balance. Thebalance white auto function is only available on color models.Automatic white balancing is a two-step process. First, the Balance Ratio Abs parameter values forred, green, and blue are each set to 1.5. Then, assuming a "gray world" model, the Balance RatioAbs parameter values are automatically adjusted such that the average values for the "red" and"blue" pixels match the average value for the "green" pixels.The balance white auto function uses the Auto Function AOI that was related to the Balance WhiteAuto function. The balance white auto function can be operated in the "once" mode of operationand in the "continuous" mode of operation. For information about the "once" mode of operation andthe "continuous" mode of operation, see Section 10.7.2 on page 173.If the related Auto Function AOI does not overlap the Image AOI (see the "Auto Function AOI"section) the pixel data from the Auto Function AOI will not be used to control the white balance ofthe image. However, as soon as the Balance White Auto function is set to "once" operation mode,the Balance Ratio parameter values for red, green, and blue are each set to 1.5. These settings willthen control the white balance of the image.For more information about setting the white balance "manually", see Section 8.3.1 on page 113.Setting the balance white auto functionality using Basler pylon is a several step process: Select the Auto Function AOI to which the Balance White Auto is assigned. Set the value of the Offset X, Offset Y, Width, and Height parameters for the AOI. Set the value of the Exposure Auto parameter for the "once" or the "continuous" mode ofoperation.You can set the white balance auto functionality from within your application software by using thepylon API. The following code snippets illustrate using the API to set the balance auto functionality:// Select Auto Function AOI to which the Balance White Auto function is assigned// For this example, assume that the Balance White Auto function is// assigned to Auto AOI 2Camera.AutoFunctionAOISelector.SetValue( AutoFunctionAOISelector_AOI2 );// Set the position and size of selected auto function AOI. In this example, we set// auto function AOI to cover the entire sensor.Note that on cameras delivered from the factory, all auto functions will becomedisabled whenever you power on or reset the camera.If you load the auto functions factory set as the default configuration set and thedefault configuration set is designated as the "startup" set, by default the exposureauto function is enabled.To change this behavior, you must change the configuration set settings. For moreinformation about configuration sets, see Section 10.19 on page 254.
