Difference between AWB_MODE_OFF and AWB_MODE_MANUAL

AWB modes in Libargus include both AWB_MODE_OFF and AWB_MODE_MANUAL. What is the difference between these two modes?

If I set the AWB mode to be AWB_MODE_OFF, what are the impacts of setAwbLock? What are the impacts of those color gains? What will the white balance look like?

If I set the AWB mode to be AWB_MODE_MANUAL, I guess the white balance will change when I change those color gains using setWbGains function. Do I need to lock AWB by calling setAwbLock(true)? If I need to set it, when should I call setAwbLock function, before setting gains or after?

hello suchao,

it’s okay without AWB lock for manual modes.
for instance,
you should have below to set WB gains manually.
iAutoControlSettings->setWbGains(Gains);
iAutoControlSettings->setAwbMode(AWB_MODE_MANUAL);
after that, please also calling Argus::ICaptureSession::repeat() to issue a new request.

please see-also developer guide, Argus::IAutoControlSettings::setAwbMode().

Thank you, Jerry.

I have some follow up questions.

  1. What will happen if I set the mode to be AWB_MODE_OFF?
  2. Is the AWB_MODE_OFF different from setAwbLock(true)? If so, what are the differences?
  3. What if I don’t call setWbGains to set the color gains and directly call setAwbMode(AWB_MODE_MANUAL)? Will the ISP engine just use the color gains right before I call setAwbMode function?

Thank you again for your time!

hello suchao,

it uses external gains only toggle AWB mode to AWB_MODE_MANUAL. otherwise, it’s determine by ISP for WB gains.
there’re default WB gains while camera init. AWB_MODE_OFF it means stop processing the WB gain calculation, it’s same as you toggle setAwbLock(true) in the beginning of camera init.

1 Like

Hi Jerry,

I got other follow-up questions.

  1. If I use MANUAL mode and set the gains to, for example, [1.0, 0.5, 0.5, 1] and then change the mode to OFF, what will the images look like? The same as in MANUAL mode with [1.0, 0.5, 0.5, 1] gains or something else?
  2. After I change the mode to OFF, will changing gains to [2.0, 1.5, 1.5, 3.0] change the images?

Thank you for your help!

hello suchao,

scenario-(1) will be image stay with WB[1.0, 0.5, 0.5, 1] after AWB mode to OFF.
I didn’t ever test the scenario-(2), the expectation of WB gains should not be changed.

1 Like

This topic was automatically closed 14 days after the last reply. New replies are no longer allowed.