/* SPDX-License-Identifier: BSD-2-Clause */
/*
 * Copyright (C) 2019-2020, Raspberry Pi Ltd
 *
 * camera_mode.h - 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;
};