The terms "shutter" and "shutter speed" are used through libcamera to mean "exposure time". This is confusing, both due to "speed" being used as "time" while it should be the inverse (i.e. a maximum speed should correspond to the minimum time), and due to "shutter speed" and "exposure time" being used in different places with the same meaning. To improve clarity of the code base and the documentation, use "exposure time" consistently to replace "shutter speed". This rename highlighted another vocabulary issue in libcamera. The ExposureModeHelper::splitExposure() function used to document that it splits "exposure time into shutter time and gain". It has been reworded to "split exposure into exposure time and gain". That is not entirely satisfactory, as "exposure" has a defined meaning in photography (see https://en.wikipedia.org/wiki/Exposure_(photography)) that is not expressed as a duration. This issue if left to be addressed separately. Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com> Reviewed-by: Naushir Patuck <naush@raspberrypi.com> Acked-by: Kieran Bingham <kieran.bingham@ideasonboard.com>
.. SPDX-License-Identifier: BSD-2-Clause
libcamera for the Raspberry Pi
Raspberry Pi provides a fully featured pipeline handler and control algorithms (IPAs, or "Image Processing Algorithms") to work with libcamera. Support is included for all existing Raspberry Pi camera modules.
libcamera for the Raspberry Pi allows users to:
- Use their existing Raspberry Pi cameras.
- Change the tuning of the image processing for their Raspberry Pi cameras.
- Alter or amend the control algorithms (such as AGC/AEC, AWB or any others) that control the sensor and ISP.
- Implement their own custom control algorithms.
- Supply new tunings and/or algorithms for completely new sensors.
How to install and run libcamera on the Raspberry Pi
Please follow the instructions here.
Documentation
Full documentation for the Raspberry Pi Camera Algorithm and Tuning Guide can be found here.