[libcamera-devel] [RFC 6/7] libcamera: properties: Define 'lens' properties

[Jacopo Mondi]

Define properties that describe the optical characteristics of the image
sensor.

Signed-off-by: Jacopo Mondi <jacopo at jmondi.org>
---
 src/libcamera/property_ids.yaml | 34 +++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/src/libcamera/property_ids.yaml b/src/libcamera/property_ids.yaml
index 9e2333cb7206..fdadfb8b1da4 100644
--- a/src/libcamera/property_ids.yaml
+++ b/src/libcamera/property_ids.yaml
@@ -208,4 +208,38 @@ controls:
         The range of supported ISO sensitivities, as documented by the
         ISO 12232:2006 standard
 
+  - LensApertures:
+      type: float
+      compound: true
+      description: |
+        The available lens apertures, expressed as f numbers (the ratio between
+        the lens focal distance and the diameter of the pupil aperture).
+
+        If the sensor has a fixed aperture, the property transports a single
+        value.
+
+  - LensFocalDistance:
+      type: float
+      compound: true
+      description: |
+        The available focal length distances, expressed in millimeters.
+
+        If the sensor is featured with a movable lens mechanism this property
+        reports the focal lengths associated with each discrete step. For
+        sensor with fixed-focus lenses, a single focal length should be instead
+        reported.
+
+  - LensHyperfocalDistance:
+      type: float
+      compound: true
+      description: |
+        The hyperfocal distance of the sensor. The property is particularly
+        meaningful for fixed-focus devices.
+
+  - LensMinimumFocalDistance:
+      type: float
+      description: |
+        The shortest distance in millimeters from the lens surface in which an
+        object could be brought into sharp focus.
+
 ...
-- 
2.24.0