summaryrefslogtreecommitdiff
path: root/src/ipa/rpi/controller/camera_mode.h
blob: 4fdb5b85b299e3e4b7942b03dc259b36ee9f005a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
/* SPDX-License-Identifier: BSD-2-Clause */
/*
 * Copyright (C) 2019-2020, Raspberry Pi Ltd
 *
 * description of a particular operating mode of a sensor
 */
#pragma once

#include <libcamera/transform.h>

#include <libcamera/base/utils.h>

/*
 * Description of a "camera mode", holding enough information for control
 * algorithms to adapt their behaviour to the different modes of the camera,
 * including binning, scaling, cropping etc.
 */

struct CameraMode {
	/* bit depth of the raw camera output */
	uint32_t bitdepth;
	/* size in pixels of frames in this mode */
	uint16_t width;
	uint16_t height;
	/* size of full resolution uncropped frame ("sensor frame") */
	uint16_t sensorWidth;
	uint16_t sensorHeight;
	/* binning factor (1 = no binning, 2 = 2-pixel binning etc.) */
	uint8_t binX;
	uint8_t binY;
	/* location of top left pixel in the sensor frame */
	uint16_t cropX;
	uint16_t cropY;
	/* scaling factor (so if uncropped, width*scaleX is sensorWidth) */
	double scaleX;
	double scaleY;
	/* scaling of the noise compared to the native sensor mode */
	double noiseFactor;
	/* minimum and maximum line time and frame durations */
	libcamera::utils::Duration minLineLength;
	libcamera::utils::Duration maxLineLength;
	libcamera::utils::Duration minFrameDuration;
	libcamera::utils::Duration maxFrameDuration;
	/* any camera transform *not* reflected already in the camera tuning */
	libcamera::Transform transform;
	/* minimum and maximum frame lengths in units of lines */
	uint32_t minFrameLength;
	uint32_t maxFrameLength;
	/* sensitivity of this mode */
	double sensitivity;
	/* pixel clock rate */
	uint64_t pixelRate;
	/* Mode specific shutter speed limits */
	libcamera::utils::Duration minShutter;
	libcamera::utils::Duration maxShutter;
	/* Mode specific analogue gain limits */
	double minAnalogueGain;
	double maxAnalogueGain;
};