[libcamera-devel] [PATCH 3/3] libcamera: controls: Add AE/AWB mode, manual and EV controls.

[Naushir Patuck]

AeMode is a new std::string type control used to set the AE algorithm
mode. The mode may not always be supported by all platforms.

AwbMode is a new std::string type control used to set the AWB algorithm
illuminant mode. The mode may not always be supported by all platforms.

EV is a new double type control used to set the log2 exposure adjustment
for the AE algorithm.

ManualGainR is a new double type control used to set the Red channel
gain in manual AWB mode.

ManualGainB is a new double type control used to set the Blue channel
gain in manual AWB mode.

Signed-off-by: Naushir Patuck <naush at raspberrypi.org>
---
 src/libcamera/control_ids.yaml | 40 ++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/src/libcamera/control_ids.yaml b/src/libcamera/control_ids.yaml
index 33062d6..21d2065 100644
--- a/src/libcamera/control_ids.yaml
+++ b/src/libcamera/control_ids.yaml
@@ -50,4 +50,44 @@ controls:
       type: double
       description: Specify a fixed gain parameter.
 
+  - AeMode:
+      type: std::string
+      description: |
+        Specify an exposure mode for the AE algorithm to use. The exposure modes
+        supported are platform spcific, and not all modes may be supported.
+
+        Examples include "normal", "sport", "low light", etc.
+
+  - AwbMode:
+      type: std::string
+      description: |
+        Specify the range of illuminant to use for the AWB algorihtm. The modes
+        supported are platform specific, and not all modes may be supported.
+
+        Examples include "auto", "incandescent", "daylight", etc.
+
+  - EV:
+      type: double
+      description: |
+        Specify an Exposure Value (EV) parameter.
+
+        By convention, EV adjusts the exposure by a factor of 2^EV. For example
+        EV = [-2, -1, 0.5, 0, 0.5, 1, 2] results in an exposure adjustment
+        of [1/4x, 1/2x, 1/sqrt(2)x, 1x, sqrt(2)x, 2x, 4x].
+
+  - ManualGainR:
+      type: double
+      description: |
+        Specify a fixed gain parameter for the Red colour channel. This must be
+        set together with ManualGainB to be applied.
+
+        \sa ManualGainB
+
+  - ManualGainB:
+      type: double
+      description:  |
+        Specify a fixed gain parameter for the Green colour channel. This must
+        bet together with AwbManualGainR to be applied.
+
+        \sa ManualGainR
 ...
-- 
2.17.1