libcamera v0.7.2 Supporting cameras in Linux since 2019

Loading...
Searching...
No Matches
software_isp.h
1/* SPDX-License-Identifier: LGPL-2.1-or-later */
2/*
3 * Copyright (C) 2023, Linaro Ltd
4 *
5 * Simple software ISP implementation
6 */
7
8#pragma once
9
10#include <deque>
11#include <functional>
12#include <map>
13#include <memory>
14#include <stdint.h>
15#include <string>
16#include <tuple>
17#include <vector>
18
19#include <libcamera/base/class.h>
20#include <libcamera/base/log.h>
21#include <libcamera/base/object.h>
22#include <libcamera/base/signal.h>
23#include <libcamera/base/thread.h>
24
25#include <libcamera/geometry.h>
26#include <libcamera/pixel_format.h>
27
28#include <libcamera/ipa/soft_ipa_interface.h>
29#include <libcamera/ipa/soft_ipa_proxy.h>
30
31#include "libcamera/internal/camera_sensor.h"
32#include "libcamera/internal/dma_buf_allocator.h"
33#include "libcamera/internal/pipeline_handler.h"
34#include "libcamera/internal/shared_mem_object.h"
35#include "libcamera/internal/software_isp/debayer_params.h"
36
37 namespace libcamera {
38
39 class Debayer;
40 class FrameBuffer;
41 class PixelFormat;
42 class Stream;
43 struct StreamConfiguration;
44
45 LOG_DECLARE_CATEGORY(SoftwareIsp)
46
47class SoftwareIsp : public Object
48{
49 public:
50 SoftwareIsp(PipelineHandler *pipe, const CameraSensor *sensor,
51 ControlInfoMap *ipaControls);
52 ~SoftwareIsp();
53
54 int loadConfiguration([[maybe_unused]] const std::string &filename) { return 0; }
55
56 bool isValid() const;
57
58 std::vector<PixelFormat> formats(PixelFormat input);
59
60 SizeRange sizes(PixelFormat inputFormat, const Size &inputSize);
61
62 std::tuple<unsigned int, unsigned int>
63 strideAndFrameSize(const PixelFormat &outputFormat, const Size &size);
64 uint32_t preferredInputStride(const PixelFormat &inputFormat, const Size &size);
65
66 int configure(const StreamConfiguration &inputCfg,
67 const std::vector<std::reference_wrapper<const StreamConfiguration>> &outputCfgs,
68 const ipa::soft::IPAConfigInfo &configInfo);
69
70 int exportBuffers(const Stream *stream, unsigned int count,
71 std::vector<std::unique_ptr<FrameBuffer>> *buffers);
72
73 void processStats(const uint32_t frame, const uint32_t bufferId,
74 const ControlList &sensorControls);
75
76 int start();
77 void stop();
78
79 void queueRequest(const uint32_t frame, const ControlList &controls);
80 int queueBuffers(uint32_t frame, FrameBuffer *input,
81 const std::map<const Stream *, FrameBuffer *> &outputs);
82
83 void process(uint32_t frame, FrameBuffer *input, FrameBuffer *output);
84
85 Signal<FrameBuffer *> inputBufferReady;
86 Signal<FrameBuffer *> outputBufferReady;
87 Signal<uint32_t, uint32_t> ispStatsReady;
88 Signal<uint32_t, const ControlList &> metadataReady;
89 Signal<const ControlList &> setSensorControls;
90
91 private:
92 void saveIspParams();
93 void setSensorCtrls(const ControlList &sensorControls);
94 void statsReady(uint32_t frame, uint32_t bufferId);
95 void inputReady(FrameBuffer *input);
96 void outputReady(FrameBuffer *output);
97 std::unique_ptr<Debayer> debayer_;
98 Thread ispWorkerThread_;
99 SharedMemObject<DebayerParams> sharedParams_;
100 DebayerParams debayerParams_;
101 DmaBufAllocator dmaHeap_;
102 bool ccmEnabled_;
103
104 std::unique_ptr<ipa::soft::IPAProxySoft> ipa_;
105 std::deque<FrameBuffer *> queuedInputBuffers_;
106 std::deque<FrameBuffer *> queuedOutputBuffers_;
107};
108
109} /* namespace libcamera */
camera_sensor.h
A camera sensor.
class.h
Utilities to help constructing class interfaces.
libcamera::CameraSensor
A abstract camera sensor.
Definition camera_sensor.h:40
libcamera::ControlInfoMap
A map of ControlId to ControlInfo.
Definition controls.h:365
libcamera::ControlList
Associate a list of ControlId with their values for an object.
Definition controls.h:409
libcamera::Debayer
Base debayering class.
Definition debayer.h:36
libcamera::DmaBufAllocator
Helper class for dma-buf allocations.
Definition dma_buf_allocator.h:24
libcamera::FrameBuffer
Frame buffer data and its associated dynamic metadata.
Definition framebuffer.h:50
libcamera::Object::Object
Object(Object *parent=nullptr)
Construct an Object instance.
Definition object.cpp:69
libcamera::PipelineHandler
Create and manage cameras based on a set of media devices.
Definition pipeline_handler.h:36
libcamera::PixelFormat
libcamera image pixel format
Definition pixel_format.h:17
libcamera::SharedMemObject
Helper class to allocate an object in shareable memory.
Definition shared_mem_object.h:60
libcamera::Signal
Generic signal and slot communication mechanism.
Definition signal.h:39
libcamera::SizeRange
Describe a range of sizes.
Definition geometry.h:205
libcamera::Size
Describe a two-dimensional size.
Definition geometry.h:51
libcamera::SoftwareIsp
Class for the Software ISP.
Definition software_isp.h:48
libcamera::SoftwareIsp::loadConfiguration
int loadConfiguration(const std::string &filename)
Load a configuration from a file.
Definition software_isp.h:54
libcamera::SoftwareIsp::inputBufferReady
Signal< FrameBuffer * > inputBufferReady
A signal emitted when the input frame buffer completes.
Definition software_isp.h:85
libcamera::SoftwareIsp::setSensorControls
Signal< const ControlList & > setSensorControls
A signal emitted when the values to write to the sensor controls are ready.
Definition software_isp.h:89
libcamera::SoftwareIsp::metadataReady
Signal< uint32_t, const ControlList & > metadataReady
A signal emitted when the metadata for IPA is ready.
Definition software_isp.h:88
libcamera::SoftwareIsp::ispStatsReady
Signal< uint32_t, uint32_t > ispStatsReady
A signal emitted when the statistics for IPA are ready.
Definition software_isp.h:87
libcamera::SoftwareIsp::SoftwareIsp
SoftwareIsp(PipelineHandler *pipe, const CameraSensor *sensor, ControlInfoMap *ipaControls)
Constructs SoftwareIsp object.
Definition software_isp.cpp:82
libcamera::SoftwareIsp::outputBufferReady
Signal< FrameBuffer * > outputBufferReady
A signal emitted when the output frame buffer completes.
Definition software_isp.h:86
libcamera::Stream
Video stream for a camera.
Definition stream.h:76
geometry.h
Data structures related to geometric objects.
log.h
Logging infrastructure.
LOG_DECLARE_CATEGORY
#define LOG_DECLARE_CATEGORY(name)
Declare a category of log messages.
Definition log.h:51
libcamera::controls
Namespace for libcamera controls.
Definition control_ids.h:22
libcamera
Top-level libcamera namespace.
Definition backtrace.h:17
object.h
Base object to support automatic signal disconnection.
pipeline_handler.h
Create pipelines and cameras from a set of media devices.
pixel_format.h
libcamera pixel format
signal.h
Signal & slot implementation.
libcamera::DebayerParams
Struct to hold the debayer parameters.
Definition debayer_params.h:20
libcamera::StreamConfiguration
Configuration parameters for a stream.
Definition stream.h:40
thread.h
Thread support.