libcamera  v0.2.0+85-1c5830a9
Supporting cameras in Linux since 2019
camera_sensor_helper.h
Go to the documentation of this file.
1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
2 /*
3  * Copyright (C) 2021, Google Inc.
4  *
5  * camera_sensor_helper.h - Helper class that performs sensor-specific parameter computations
6  */
7 
8 #pragma once
9 
10 #include <stdint.h>
11 
12 #include <memory>
13 #include <string>
14 #include <vector>
15 
16 #include <libcamera/base/class.h>
17 
18 namespace libcamera {
19 
20 namespace ipa {
21 
23 {
24 public:
25  CameraSensorHelper() = default;
26  virtual ~CameraSensorHelper() = default;
27 
28  virtual uint32_t gainCode(double gain) const;
29  virtual double gain(uint32_t gainCode) const;
30 
31 protected:
35  };
36 
38  int16_t m0;
39  int16_t c0;
40  int16_t m1;
41  int16_t c1;
42  };
43 
45  double a;
46  double m;
47  };
48 
52  };
53 
56 
57 private:
59 };
60 
62 {
63 public:
64  CameraSensorHelperFactoryBase(const std::string name);
65  virtual ~CameraSensorHelperFactoryBase() = default;
66 
67  static std::unique_ptr<CameraSensorHelper> create(const std::string &name);
68 
69  static std::vector<CameraSensorHelperFactoryBase *> &factories();
70 
71 private:
73 
74  static void registerType(CameraSensorHelperFactoryBase *factory);
75 
76  virtual std::unique_ptr<CameraSensorHelper> createInstance() const = 0;
77 
78  std::string name_;
79 };
80 
81 template<typename _Helper>
83 {
84 public:
85  CameraSensorHelperFactory(const char *name)
87  {
88  }
89 
90 private:
91  std::unique_ptr<CameraSensorHelper> createInstance() const override
92  {
93  return std::make_unique<_Helper>();
94  }
95 };
96 
97 #define REGISTER_CAMERA_SENSOR_HELPER(name, helper) \
98 static CameraSensorHelperFactory<helper> global_##helper##Factory(name);
99 
100 } /* namespace ipa */
101 
102 } /* namespace libcamera */
Registration of CameraSensorHelperFactory classes and creation of instances.
Definition: camera_sensor_helper.h:82
Base class for computing sensor tuning parameters using sensor-specific constants.
Definition: camera_sensor_helper.h:22
virtual double gain(uint32_t gainCode) const
Compute the real gain from the V4L2 subdev control gain code.
Definition: camera_sensor_helper.cpp:91
Utilities to help constructing class interfaces.
AnalogueGainConstants gainConstants_
The analogue gain parameters used for calculation.
Definition: camera_sensor_helper.h:55
double m
Constant used in the exponential gain coding/decoding.
Definition: camera_sensor_helper.h:46
int16_t c1
Constant used in the linear gain coding/decoding.
Definition: camera_sensor_helper.h:41
Base class for camera sensor helper factories.
Definition: camera_sensor_helper.h:61
int16_t m0
Constant used in the linear gain coding/decoding.
Definition: camera_sensor_helper.h:38
Top-level libcamera namespace.
Definition: backtrace.h:17
AnalogueGainType
The gain calculation modes as defined by the MIPI CCS.
Definition: camera_sensor_helper.h:32
int16_t c0
Constant used in the linear gain coding/decoding.
Definition: camera_sensor_helper.h:39
AnalogueGainLinearConstants linear
Constants for the linear gain model.
Definition: camera_sensor_helper.h:50
AnalogueGainExpConstants exp
Constants for the exponential gain model.
Definition: camera_sensor_helper.h:51
CameraSensorHelperFactory(const char *name)
Construct a camera sensor helper factory.
Definition: camera_sensor_helper.h:85
Gain is expressed using an exponential model.
Definition: camera_sensor_helper.h:34
Analogue gain model constants.
Definition: camera_sensor_helper.h:49
Analogue gain constants for the exponential gain model.
Definition: camera_sensor_helper.h:44
virtual uint32_t gainCode(double gain) const
Construct a CameraSensorHelper instance.
Definition: camera_sensor_helper.cpp:59
#define LIBCAMERA_DISABLE_COPY_AND_MOVE(klass)
Disable copy and move construction and assignment of the klass.
int16_t m1
Constant used in the linear gain coding/decoding.
Definition: camera_sensor_helper.h:40
double a
Constant used in the exponential gain coding/decoding.
Definition: camera_sensor_helper.h:45
AnalogueGainType gainType_
The analogue gain model type.
Definition: camera_sensor_helper.h:54
Gain is computed using linear gain estimation.
Definition: camera_sensor_helper.h:33
Analogue gain constants for the linear gain model.
Definition: camera_sensor_helper.h:37