Skip to Main Content
Centro de soporte de Cognex
Logo

How to Set White Balance of CIC GigE Color Cameras

How to set CIC color camera white balance.

28/01/2026

Details

There are two methods for configuring the white balance on CIC color cameras. Both methods follow the same overall process, with only minor differences in the placement or configuration of certain attribute nodes.

Setting process:

  1. Add CogAcqFifoTool and then Connect Camera;

    How to Set White Balance of CIC GigE Color Cameras_image-1
  2. Place the standard white balance calibration gray card within the camera’s field of view. If a gray card is not available, a sheet of white paper can be used as a temporary substitute; however, note that different types of white paper may lead to variations in calibration accuracy. Adjust the exposure time, aperture, or lighting to ensure the image reaches an appropriate brightness level;
  3. Close camera live display;
  4. Add the BalanceWhiteAuto property to the custom attributes tab. By default, this property is set to Off. Note: Attribute nodes path may vary across different camera models:
    • The first attribute node path

      How to Set White Balance of CIC GigE Color Cameras_image-2
    • The second attribute node path

      How to Set White Balance of CIC GigE Color Cameras_image-3
  5. Additionally, add the properties UserSetSelector, UserSetDefaultSelector (UserSetDefault), and UserSetSave. Note: The names of the attribute node may vary between different camera models;
    • The first set of attribute node

      How to Set White Balance of CIC GigE Color Cameras_image-4
    • The second set of attribute node

      How to Set White Balance of CIC GigE Color Cameras_image-5
  6. Set the BalanceWhiteAuto property value, first set it to Continuous. If it does not work, then set it to Once. After setting, press the Enter key;
    • Set the property value to Continuous

      How to Set White Balance of CIC GigE Color Cameras_image-6
    • Set the property value to Once

      How to Set White Balance of CIC GigE Color Cameras_image-7
  7. Click the Live Display button to open the live display window. Wait until the automatic white balance adjustment is complete, then set BalanceWhiteAuto to Off and press the Enter key. Finally, close the live display;

    How to Set White Balance of CIC GigE Color Cameras_image-8
  8. In the value lists of UserSetSelector and UserSetDefaultSelector (UserSetDefault), select a user set and ensure that both properties have the same value. UserSetSelector specifies which user set the current configuration will be saved to, while UserSetDefaultSelector (UserSetDefault) specifies which user set will be used by default at startup;

    How to Set White Balance of CIC GigE Color Cameras_image-9
  9. Click the blank area in the value field to the right of the UserSetSave property to save the current configuration;

    How to Set White Balance of CIC GigE Color Cameras_image-10

Recursos relacionados