libcamera: include/libcamera/internal/software_isp/swstats_cpu.h Source File

libcamera v0.7.0 Supporting cameras in Linux since 2019

Loading...
Searching...
No Matches
swstats_cpu.h
1/* SPDX-License-Identifier: LGPL-2.1-or-later */
2/*
3 * Copyright (C) 2023, Linaro Ltd
4 * Copyright (C) 2023, Red Hat Inc.
5 *
6 * Authors:
7 * Hans de Goede <hdegoede@redhat.com>
8 *
9 * CPU based software statistics implementation
10 */
11
12#pragma once
13
14#include <stdint.h>
15
16#include <libcamera/base/signal.h>
17
18#include <libcamera/geometry.h>
19
20#include "libcamera/internal/bayer_format.h"
21#include "libcamera/internal/framebuffer.h"
22#include "libcamera/internal/global_configuration.h"
23#include "libcamera/internal/shared_mem_object.h"
24#include "libcamera/internal/software_isp/swisp_stats.h"
25
26#include "benchmark.h"
27
28namespace libcamera {
29
30class PixelFormat;
31class MappedFrameBuffer;
32struct StreamConfiguration;
33
34 class SwStatsCpu
35{
36public:
37 SwStatsCpu(const GlobalConfiguration &configuration);
38 ~SwStatsCpu() = default;
39
40 /*
41 * The combination of pipeline + sensor delays means that
42 * exposure changes can take up to 3 frames to get applied,
43 * Run stats once every 4 frames to ensure any previous
44 * exposure changes have been applied.
45 */
46 static constexpr uint32_t kStatPerNumFrames = 4;
47
48 bool isValid() const { return sharedStats_.fd().isValid(); }
49
50 const SharedFD &getStatsFD() { return sharedStats_.fd(); }
51
52 const Size &patternSize() { return patternSize_; }
53
54 int configure(const StreamConfiguration &inputCfg);
55 void setWindow(const Rectangle &window);
56 void startFrame(uint32_t frame);
57 void finishFrame(uint32_t frame, uint32_t bufferId);
58 void processFrame(uint32_t frame, uint32_t bufferId, FrameBuffer *input);
59
60 void processLine0(uint32_t frame, unsigned int y, const uint8_t *src[])
61 {
62 if (frame % kStatPerNumFrames)
63 return;
64
65 if ((y & ySkipMask_) || y < static_cast<unsigned int>(window_.y) ||
66 y >= (window_.y + window_.height))
67 return;
68
69 (this->*stats0_)(src);
70 }
71
72 void processLine2(uint32_t frame, unsigned int y, const uint8_t *src[])
73 {
74 if (frame % kStatPerNumFrames)
75 return;
76
77 if ((y & ySkipMask_) || y < static_cast<unsigned int>(window_.y) ||
78 y >= (window_.y + window_.height))
79 return;
80
81 (this->*stats2_)(src);
82 }
83
84 Signal<uint32_t, uint32_t> statsReady;
85
86private:
87 using statsProcessFn = void (SwStatsCpu::*)(const uint8_t *src[]);
88 using processFrameFn = void (SwStatsCpu::*)(MappedFrameBuffer &in);
89
90 int setupStandardBayerOrder(BayerFormat::Order order);
91 /* Bayer 8 bpp unpacked */
92 void statsBGGR8Line0(const uint8_t *src[]);
93 /* Bayer 10 bpp unpacked */
94 void statsBGGR10Line0(const uint8_t *src[]);
95 /* Bayer 12 bpp unpacked */
96 void statsBGGR12Line0(const uint8_t *src[]);
97 /* Bayer 10 bpp packed */
98 void statsBGGR10PLine0(const uint8_t *src[]);
99 void statsGBRG10PLine0(const uint8_t *src[]);
100
101 void processBayerFrame2(MappedFrameBuffer &in);
102
103 processFrameFn processFrame_;
104
105 /* Variables set by configure(), used every line */
106 statsProcessFn stats0_;
107 statsProcessFn stats2_;
108 bool swapLines_;
109
110 unsigned int ySkipMask_;
111
112 Rectangle window_;
113
114 Size patternSize_;
115
116 unsigned int xShift_;
117 unsigned int stride_;
118
119 SharedMemObject<SwIspStats> sharedStats_;
120 SwIspStats stats_;
121 Benchmark bench_;
122};
123
124} /* namespace libcamera */
bayer_format.h
Class to represent Bayer formats and manipulate them.
libcamera::BayerFormat::Order
Order
The order of the colour channels in the Bayer pattern.
Definition bayer_format.h:25
libcamera::Benchmark
Simple builtin benchmark.
Definition benchmark.h:21
libcamera::FrameBuffer
Frame buffer data and its associated dynamic metadata.
Definition framebuffer.h:50
libcamera::GlobalConfiguration
Support for global libcamera configuration.
Definition global_configuration.h:22
libcamera::MappedFrameBuffer
Map a FrameBuffer using the MappedBuffer interface.
Definition mapped_framebuffer.h:47
libcamera::PixelFormat
libcamera image pixel format
Definition pixel_format.h:17
libcamera::Rectangle
Describe a rectangle's position and dimensions.
Definition geometry.h:247
libcamera::SharedFD
RAII-style wrapper for file descriptors.
Definition shared_fd.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::Size
Describe a two-dimensional size.
Definition geometry.h:51
libcamera::SwStatsCpu::kStatPerNumFrames
static constexpr uint32_t kStatPerNumFrames
Run stats once every kStatPerNumFrames frames.
Definition swstats_cpu.h:46
libcamera::SwStatsCpu::getStatsFD
const SharedFD & getStatsFD()
Get the file descriptor for the statistics.
Definition swstats_cpu.h:50
libcamera::SwStatsCpu::processLine0
void processLine0(uint32_t frame, unsigned int y, const uint8_t *src[])
Process line 0.
Definition swstats_cpu.h:60
libcamera::SwStatsCpu::processLine2
void processLine2(uint32_t frame, unsigned int y, const uint8_t *src[])
Process line 2 and 3.
Definition swstats_cpu.h:72
libcamera::SwStatsCpu::statsReady
Signal< uint32_t, uint32_t > statsReady
Signals that the statistics are ready.
Definition swstats_cpu.h:84
libcamera::SwStatsCpu::configure
int configure(const StreamConfiguration &inputCfg)
Configure the statistics object for the passed in input format.
Definition swstats_cpu.cpp:395
libcamera::SwStatsCpu::finishFrame
void finishFrame(uint32_t frame, uint32_t bufferId)
Finish statistics calculation for the current frame.
Definition swstats_cpu.cpp:346
libcamera::SwStatsCpu::setWindow
void setWindow(const Rectangle &window)
Specify window coordinates over which to gather statistics.
Definition swstats_cpu.cpp:474
libcamera::SwStatsCpu::SwStatsCpu
SwStatsCpu(const GlobalConfiguration &configuration)
Construct a SwStatsCpu object.
Definition swstats_cpu.cpp:157
libcamera::SwStatsCpu::isValid
bool isValid() const
Gets whether the statistics object is valid.
Definition swstats_cpu.h:48
libcamera::SwStatsCpu::processFrame
void processFrame(uint32_t frame, uint32_t bufferId, FrameBuffer *input)
Calculate statistics for a frame in one go.
Definition swstats_cpu.cpp:520
libcamera::SwStatsCpu::patternSize
const Size & patternSize()
Get the pattern size.
Definition swstats_cpu.h:52
libcamera::SwStatsCpu::startFrame
void startFrame(uint32_t frame)
Reset state to start statistics gathering for a new frame.
Definition swstats_cpu.cpp:327
geometry.h
Data structures related to geometric objects.
framebuffer.h
Internal frame buffer handling support.
libcamera
Top-level libcamera namespace.
Definition backtrace.h:17
signal.h
Signal & slot implementation.
libcamera::StreamConfiguration
Configuration parameters for a stream.
Definition stream.h:40
libcamera::SwIspStats
Struct that holds the statistics for the Software ISP.
Definition swisp_stats.h:24