libcamera v0.3.1
Supporting cameras in Linux since 2019
Loading...
Searching...
No Matches
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 minShutter, utils::Duration maxShutter,
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:308
A class representing the tree structure of the YAML content.
Definition yaml_parser.h:26
A mean-based auto-exposure algorithm.
Definition agc_mean_luminance.h:29
void setLimits(utils::Duration minShutter, utils::Duration maxShutter, 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
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
ControlInfoMap::Map controls()
Get the controls that have been generated after parsing tuning data.
Definition agc_mean_luminance.h:60
int parseTuningData(const YamlObject &tuningData)
Parse tuning data for AeConstraintMode and AeExposureMode controls.
Definition agc_mean_luminance.cpp:359
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 shutter time and gain.
Definition agc_mean_luminance.cpp:531
The base class for creating histograms.
Definition histogram.h:24
Helper class from std::chrono::duration that represents a time duration in nanoseconds with double pr...
Definition utils.h:354
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 yTarget
The luminance target for the constraint.
Definition agc_mean_luminance.h:42
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
@ Upper
The constraint defines an upper bound.
@ Lower
The constraint defines a lower bound.
Bound bound
The type of constraint bound.
Definition agc_mean_luminance.h:39
double qLo
The lower quantile to use for the constraint.
Definition agc_mean_luminance.h:40
Miscellaneous utility functions.
A YAML parser helper.