summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNaushir Patuck <naush@raspberrypi.com>2020-04-24 11:47:00 +0100
committerLaurent Pinchart <laurent.pinchart@ideasonboard.com>2020-04-27 20:18:17 +0300
commitde30b6127c8b4b6114006f401a77a150166d9d99 (patch)
tree15c8681d0d079179940021d2de4bffe88f5de062
parentaba945a1c2eb7f9aee1f0aec87a1e70198ee2685 (diff)
libcamera: controls: Add AWB related controls
AwbMode is a new enum type to specify operating mode of the AWB algorithm. All modes may not be supported by all platforms. ColourGains is a new float array type used to specify manual red and blue (in that order) colour channel gains when AWB is disabled. ColourTemperature is a new control to return the current estimate of the colour temperature. Signed-off-by: Naushir Patuck <naush@raspberrypi.com> Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com> Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
-rw-r--r--src/libcamera/control_ids.yaml55
1 files changed, 55 insertions, 0 deletions
diff --git a/src/libcamera/control_ids.yaml b/src/libcamera/control_ids.yaml
index 0907167f..b419f8a7 100644
--- a/src/libcamera/control_ids.yaml
+++ b/src/libcamera/control_ids.yaml
@@ -169,6 +169,61 @@ controls:
description: |
Enable or disable the AWB.
+ \sa ColourGains
+
+ # AwbMode needs further attention:
+ # - Auto-generate max enum value.
+ # - Better handling of custom types.
+ - AwbMode:
+ type: int32_t
+ description: |
+ Specify the range of illuminants to use for the AWB algorithm. The modes
+ supported are platform specific, and not all modes may be supported.
+ enum:
+ - name: AwbAuto
+ value: 0
+ description: Search over the whole colour temperature range.
+ - name: AwbIncandescent
+ value: 1
+ description: Incandescent AWB lamp mode.
+ - name: AwbTungsten
+ value: 2
+ description: Tungsten AWB lamp mode.
+ - name: AwbFluorescent
+ value: 3
+ description: Fluorescent AWB lamp mode.
+ - name: AwbIndoor
+ value: 4
+ description: Indoor AWB lighting mode.
+ - name: AwbDaylight
+ value: 5
+ description: Daylight AWB lighting mode.
+ - name: AwbCloudy
+ value: 6
+ description: Cloudy AWB lighting mode.
+ - name: AwbCustom
+ value: 7
+ description: Custom AWB mode.
+ - name: AwbModeMax
+ value: 7
+ description: Maximum allowed value (place any new values above here).
+
+ - ColourGains:
+ type: float
+ description: |
+ Pair of gain values for the Red and Blue colour channels, in that
+ order. ColourGains can only be applied in a Request when the AWB is
+ disabled.
+
+ \sa AwbEnable
+ size: [2]
+
+ - ColourTemperature:
+ type: int32_t
+ description: Report the current estimate of the colour temperature, in
+ kelvin, for this frame. The ColourTemperature control can only be
+ returned in metadata.
+
- Saturation:
type: float
description: |