From patchwork Thu Mar 26 14:59:23 2020
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
X-Patchwork-Submitter: Jacopo Mondi <jacopo@jmondi.org>
X-Patchwork-Id: 3330
X-Patchwork-Delegate: jacopo@jmondi.org
Return-Path: <jacopo@jmondi.org>
Received: from relay7-d.mail.gandi.net (relay7-d.mail.gandi.net
	[217.70.183.200])
	by lancelot.ideasonboard.com (Postfix) with ESMTPS id E426060410
	for <libcamera-devel@lists.libcamera.org>;
	Thu, 26 Mar 2020 15:56:33 +0100 (CET)
X-Originating-IP: 2.224.242.101
Received: from localhost.localdomain (2-224-242-101.ip172.fastwebnet.it
	[2.224.242.101]) (Authenticated sender: jacopo@jmondi.org)
	by relay7-d.mail.gandi.net (Postfix) with ESMTPSA id A6D8F20008
	for <libcamera-devel@lists.libcamera.org>;
	Thu, 26 Mar 2020 14:56:33 +0000 (UTC)
From: Jacopo Mondi <jacopo@jmondi.org>
To: libcamera-devel@lists.libcamera.org
Date: Thu, 26 Mar 2020 15:59:23 +0100
Message-Id: <20200326145927.324919-3-jacopo@jmondi.org>
X-Mailer: git-send-email 2.25.1
In-Reply-To: <20200326145927.324919-1-jacopo@jmondi.org>
References: <20200326145927.324919-1-jacopo@jmondi.org>
MIME-Version: 1.0
Subject: [libcamera-devel] [PATCH v4 2/6] libcamera: properties: Define
	'lens' properties
X-BeenThere: libcamera-devel@lists.libcamera.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: <libcamera-devel.lists.libcamera.org>
List-Unsubscribe: <https://lists.libcamera.org/options/libcamera-devel>,
	<mailto:libcamera-devel-request@lists.libcamera.org?subject=unsubscribe>
List-Archive: <https://lists.libcamera.org/pipermail/libcamera-devel/>
List-Post: <mailto:libcamera-devel@lists.libcamera.org>
List-Help: <mailto:libcamera-devel-request@lists.libcamera.org?subject=help>
List-Subscribe: <https://lists.libcamera.org/listinfo/libcamera-devel>,
	<mailto:libcamera-devel-request@lists.libcamera.org?subject=subscribe>
X-List-Received-Date: Thu, 26 Mar 2020 14:56:34 -0000

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

Signed-off-by: Jacopo Mondi <jacopo@jmondi.org>
Reviewed-by: Niklas Söderlund <niklas.soderlund@ragnatech.se>
---
 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 ea9d363fdef8..a7897bc8e5dc 100644
--- a/src/libcamera/property_ids.yaml
+++ b/src/libcamera/property_ids.yaml
@@ -541,4 +541,38 @@ controls:
         The range of supported ISO sensitivities, as documented by the
         ISO 12232:2006 (or later) standard.
 
+  - LensApertures:
+      type: float
+      size: [n]
+      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 camera module has a fixed aperture, the property transports a
+        single value.
+
+  - LensFocalLengths:
+      type: float
+      size: [n]
+      description: |
+        The available lens focal lengths, expressed in millimeters.
+
+        If the camera module supports multiple focal lengths this property
+        reports the focal lengths associated with each discrete step. For
+        camera modules with a single focal length, a single value should be
+        instead reported.
+
+  - LensHyperfocalDistances:
+      type: float
+      size: [n]
+      description: |
+        The hyperfocal distance of the camera module. The property is
+        particularly meaningful for modules with a single focal length.
+
+  - LensMinimumFocusDistance:
+      type: float
+      description: |
+        The shortest distance in millimeters at which an object could be brought
+        into sharp focus.
+
 ...