summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNaushir Patuck <naush@raspberrypi.com>2023-06-05 10:14:04 +0100
committerLaurent Pinchart <laurent.pinchart@ideasonboard.com>2023-06-06 18:19:51 +0300
commitbdba31cc0258dbfc71cb0fe68a9350189ef985e4 (patch)
tree10883d90b3b0076a38418387be984cd560cf5d21
parentea93e7899fbfbc34dec3cdb08aca8ac9a51d414b (diff)
libcamera: controls: Define a default lens position behaviour
Update the AfMode control description to explicitly define a startup/default behaviour. On startup, the camera will move the lens to the position given by the default value of the LensPosition control if operating in manual focus mode. Typically this would be the hyperfocal position of the lens. Signed-off-by: Naushir Patuck <naush@raspberrypi.com> Reviewed-by: Jacopo Mondi <jacopo.mondi@ideasonboard.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.yaml7
1 files changed, 7 insertions, 0 deletions
diff --git a/src/libcamera/control_ids.yaml b/src/libcamera/control_ids.yaml
index a0fbb772..056886e6 100644
--- a/src/libcamera/control_ids.yaml
+++ b/src/libcamera/control_ids.yaml
@@ -408,6 +408,13 @@ controls:
LensPosition control.
In this mode the AfState will always report AfStateIdle.
+
+ If the camera is started in AfModeManual, it will move the focus
+ lens to the position specified by the LensPosition control.
+
+ This mode is the recommended default value for the AfMode control.
+ External cameras (as reported by the Location property set to
+ CameraLocationExternal) may use a different default value.
- name: AfModeAuto
value: 1
description: |