[libcamera-devel,v2,1/6] libcamera: Add SensorOutputSize property
diff mbox series

Message ID 20200925085127.17214-2-david.plowman@raspberrypi.com
State Superseded
Headers show
Series
  • Digital zoom
Related show

Commit Message

David Plowman Sept. 25, 2020, 8:51 a.m. UTC 
The SensorOutputSize camera property reports the image size that the
next step in processing after the sensor and CSI-2 receiver - usually
the ISP - will see. It will normally change when a new camera mode is
selected, and can be used to implement digital zoom.

Signed-off-by: David Plowman <david.plowman@raspberrypi.com>
Reviewed-by: Jacopo Mondi <jacopo@jmondi.org>
---
 src/libcamera/property_ids.yaml | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

Patch
diff mbox series 

diff --git a/src/libcamera/property_ids.yaml b/src/libcamera/property_ids.yaml
index 74ad019..8011b88 100644
--- a/src/libcamera/property_ids.yaml
+++ b/src/libcamera/property_ids.yaml
@@ -640,4 +640,23 @@  controls:
         \todo Rename this property to ActiveAreas once we will have property
               categories (i.e. Properties::PixelArray::ActiveAreas)
 
+  - SensorOutputSize:
+      type: Size
+      description: |
+        The size, in pixels, of the image being used to produce the
+        desired output streams. The image size might correspond to the
+        size of the frames produced by the image sensor but would also
+        take into account additional cropping (or even re-scaling)
+        performed by the CSI-2 receiver to adjust the sensor frame
+        size to conform to the output image sizes and aspect ratios.
+        The property is meaningful only after the Camera has been
+        successfully configured and its value changes whenever a new
+        configuration is applied. It can be used to implement digital
+        zoom.
+
+        \sa controls::ISPCrop
+
+        \todo Move this property to CameraConfiguration once the
+        feature is made available
+
 ...