libcamera/include/libcamera
Laurent Pinchart d0478c41f4 libcamera: Rename "shutter speed" to "exposure time"
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>
2024-11-26 19:05:17 +02:00
..
base libcamera: utils: Add ScopeExitActions class 2024-09-05 16:12:35 +03:00
internal libcamera: add DmaBufAllocator::exportBuffers() 2024-11-20 10:47:27 +00:00
ipa libcamera: Rename "shutter speed" to "exposure time" 2024-11-26 19:05:17 +02:00
camera.h libcamera: Drop file name from header comment blocks 2024-05-08 22:39:50 +03:00
camera_manager.h libcamera: Drop file name from header comment blocks 2024-05-08 22:39:50 +03:00
color_space.h libcamera: Drop file name from header comment blocks 2024-05-08 22:39:50 +03:00
control_ids.h.in libcamera: Add debug control space 2024-11-13 11:47:06 +01:00
controls.h libcamera: controls: Add vendor information to ControlId 2024-10-21 00:22:56 +03:00
fence.h libcamera: Drop remaining file name from header comment blocks 2024-05-09 23:31:15 +03:00
formats.h.in libcamera: Drop file name from header comment blocks in templates 2024-05-09 23:31:14 +03:00
framebuffer.h libcamera: includes: Remove unused includes 2024-09-02 22:44:38 +03:00
framebuffer_allocator.h libcamera: Drop file name from header comment blocks 2024-05-08 22:39:50 +03:00
geometry.h libcamera: geometry: Add two-point Rectangle constructor 2024-10-01 21:01:25 +02:00
logging.h libcamera: includes: Add missing includes 2024-09-02 22:37:55 +03:00
meson.build libcamera: Add debug control space 2024-11-13 11:47:06 +01:00
orientation.h libcamera: Drop file name from header comment blocks 2024-05-08 22:39:50 +03:00
pixel_format.h libcamera: includes: Remove unused includes 2024-09-02 22:44:38 +03:00
request.h libcamera: includes: Remove unused includes 2024-09-02 22:44:38 +03:00
stream.h libcamera: includes: Remove unused includes 2024-09-02 22:44:38 +03:00
transform.h libcamera: includes: Remove unused includes 2024-09-02 22:44:38 +03:00
version.h.in libcamera: Drop file name from header comment blocks in templates 2024-05-09 23:31:14 +03:00