libcamera v0.4.0+53-29156679
Supporting cameras in Linux since 2019
agc_mean_luminance.h
Go to the documentation of this file.
1/* SPDX-License-Identifier: LGPL-2.1-or-later */
2/*
3 * Copyright (C) 2024 Ideas on Board Oy
4 *
5 agc_mean_luminance.h - Base class for mean luminance AGC algorithms
6 */
7
8#pragma once
9
10#include <map>
11#include <memory>
12#include <tuple>
13#include <vector>
14
16
17#include <libcamera/controls.h>
18
20
22#include "histogram.h"
23
24namespace libcamera {
25
26namespace ipa {
27
29{
30public:
32 virtual ~AgcMeanLuminance();
33
35 enum class Bound {
36 Lower = 0,
37 Upper = 1
38 };
40 double qLo;
41 double qHi;
42 double yTarget;
43 };
44
45 int parseTuningData(const YamlObject &tuningData);
46
47 void setLimits(utils::Duration minExposureTime, utils::Duration maxExposureTime,
48 double minGain, double maxGain);
49
50 std::map<int32_t, std::vector<AgcConstraint>> constraintModes()
51 {
52 return constraintModes_;
53 }
54
55 std::map<int32_t, std::shared_ptr<ExposureModeHelper>> exposureModeHelpers()
56 {
57 return exposureModeHelpers_;
58 }
59
61 {
62 return controls_;
63 }
64
65 std::tuple<utils::Duration, double, double>
66 calculateNewEv(uint32_t constraintModeIndex, uint32_t exposureModeIndex,
67 const Histogram &yHist, utils::Duration effectiveExposureValue);
68
70 {
71 frameCount_ = 0;
72 }
73
74private:
75 virtual double estimateLuminance(const double gain) const = 0;
76
77 void parseRelativeLuminanceTarget(const YamlObject &tuningData);
78 void parseConstraint(const YamlObject &modeDict, int32_t id);
79 int parseConstraintModes(const YamlObject &tuningData);
80 int parseExposureModes(const YamlObject &tuningData);
81 double estimateInitialGain() const;
82 double constraintClampGain(uint32_t constraintModeIndex,
83 const Histogram &hist,
84 double gain);
85 utils::Duration filterExposure(utils::Duration exposureValue);
86
87 uint64_t frameCount_;
88 utils::Duration filteredExposure_;
89 double relativeLuminanceTarget_;
90
91 std::map<int32_t, std::vector<AgcConstraint>> constraintModes_;
92 std::map<int32_t, std::shared_ptr<ExposureModeHelper>> exposureModeHelpers_;
93 ControlInfoMap::Map controls_;
94};
95
96} /* namespace ipa */
97
98} /* namespace libcamera */
std::unordered_map< const ControlId *, ControlInfo > Map
The base std::unsorted_map<> container.
Definition: controls.h:369
A class representing the tree structure of the YAML content.
Definition: yaml_parser.h:28
A mean-based auto-exposure algorithm.
Definition: agc_mean_luminance.h:29
void setLimits(utils::Duration minExposureTime, utils::Duration maxExposureTime, double minGain, double maxGain)
Set the ExposureModeHelper limits for this class.
Definition: agc_mean_luminance.cpp:382
void resetFrameCount()
Reset the frame counter.
Definition: agc_mean_luminance.h:69
std::map< int32_t, std::vector< AgcConstraint > > constraintModes()
Get the constraint modes that have been parsed from tuning data.
Definition: agc_mean_luminance.h:50
int parseTuningData(const YamlObject &tuningData)
Parse tuning data for AeConstraintMode and AeExposureMode controls.
Definition: agc_mean_luminance.cpp:359
ControlInfoMap::Map controls()
Get the controls that have been generated after parsing tuning data.
Definition: agc_mean_luminance.h:60
std::tuple< utils::Duration, double, double > calculateNewEv(uint32_t constraintModeIndex, uint32_t exposureModeIndex, const Histogram &yHist, utils::Duration effectiveExposureValue)
Calculate the new exposure value and splut it between exposure time and gain.
Definition: agc_mean_luminance.cpp:532
std::map< int32_t, std::shared_ptr< ExposureModeHelper > > exposureModeHelpers()
Get the ExposureModeHelpers that have been parsed from tuning data.
Definition: agc_mean_luminance.h:55
The base class for creating histograms.
Definition: histogram.h:23
Helper class from std::chrono::duration that represents a time duration in nanoseconds with double pr...
Definition: utils.h:370
Framework to manage controls related to an object.
Helper class that performs computations relating to exposure.
Class to represent Histograms and manipulate them.
Top-level libcamera namespace.
Definition: backtrace.h:17
The boundaries and target for an AeConstraintMode constraint.
Definition: agc_mean_luminance.h:34
double qHi
The upper quantile to use for the constraint.
Definition: agc_mean_luminance.h:41
Bound
Specify whether the constraint defines a lower or upper bound.
Definition: agc_mean_luminance.h:35
double qLo
The lower quantile to use for the constraint.
Definition: agc_mean_luminance.h:40
Bound bound
The type of constraint bound.
Definition: agc_mean_luminance.h:39
double yTarget
The luminance target for the constraint.
Definition: agc_mean_luminance.h:42
Miscellaneous utility functions.
A YAML parser helper.