libcamera v0.1.0+127-8e215127-dirty (2023-12-02T01:06:12+00:00)
Supporting cameras in Linux since 2019
converter_v4l2_m2m.h
Go to the documentation of this file.
1/* SPDX-License-Identifier: LGPL-2.1-or-later */
2/*
3 * Copyright (C) 2020, Laurent Pinchart
4 * Copyright 2022 NXP
5 *
6 * converter_v4l2_m2m.h - V4l2 M2M Format converter interface
7 */
8
9#pragma once
10
11#include <functional>
12#include <map>
13#include <memory>
14#include <string>
15#include <tuple>
16#include <vector>
17
18#include <libcamera/base/log.h>
20
22
24
25namespace libcamera {
26
27class FrameBuffer;
28class MediaDevice;
29class Size;
30class SizeRange;
31struct StreamConfiguration;
32class V4L2M2MDevice;
33
35{
36public:
38
39 int loadConfiguration([[maybe_unused]] const std::string &filename) { return 0; }
40 bool isValid() const { return m2m_ != nullptr; }
41
42 std::vector<PixelFormat> formats(PixelFormat input);
43 SizeRange sizes(const Size &input);
44
45 std::tuple<unsigned int, unsigned int>
46 strideAndFrameSize(const PixelFormat &pixelFormat, const Size &size);
47
48 int configure(const StreamConfiguration &inputCfg,
49 const std::vector<std::reference_wrapper<StreamConfiguration>> &outputCfg);
50 int exportBuffers(unsigned int ouput, unsigned int count,
51 std::vector<std::unique_ptr<FrameBuffer>> *buffers);
52
53 int start();
54 void stop();
55
56 int queueBuffers(FrameBuffer *input,
57 const std::map<unsigned int, FrameBuffer *> &outputs);
58
59private:
60 class Stream : protected Loggable
61 {
62 public:
63 Stream(V4L2M2MConverter *converter, unsigned int index);
64
65 bool isValid() const { return m2m_ != nullptr; }
66
67 int configure(const StreamConfiguration &inputCfg,
68 const StreamConfiguration &outputCfg);
69 int exportBuffers(unsigned int count,
70 std::vector<std::unique_ptr<FrameBuffer>> *buffers);
71
72 int start();
73 void stop();
74
75 int queueBuffers(FrameBuffer *input, FrameBuffer *output);
76
77 protected:
78 std::string logPrefix() const override;
79
80 private:
81 void captureBufferReady(FrameBuffer *buffer);
82 void outputBufferReady(FrameBuffer *buffer);
83
84 V4L2M2MConverter *converter_;
85 unsigned int index_;
86 std::unique_ptr<V4L2M2MDevice> m2m_;
87
88 unsigned int inputBufferCount_;
89 unsigned int outputBufferCount_;
90 };
91
92 std::unique_ptr<V4L2M2MDevice> m2m_;
93
94 std::vector<Stream> streams_;
95 std::map<FrameBuffer *, unsigned int> queue_;
96};
97
98} /* namespace libcamera */
Abstract Base Class for converter.
Definition: converter.h:32
Signal< FrameBuffer * > outputBufferReady
A signal emitted on each frame buffer completion of the output queue.
Definition: converter.h:59
Frame buffer data and its associated dynamic metadata.
Definition: framebuffer.h:50
Base class to support log message extensions.
Definition: log.h:91
The MediaDevice represents a Media Controller device with its full graph of connected objects.
Definition: media_device.h:26
libcamera image pixel format
Definition: pixel_format.h:18
Describe a range of sizes.
Definition: geometry.h:201
Describe a two-dimensional size.
Definition: geometry.h:53
Video stream for a camera.
Definition: stream.h:75
The V4L2 M2M converter implements the converter interface based on V4L2 M2M device.
Definition: converter_v4l2_m2m.h:35
V4L2M2MConverter(MediaDevice *media)
Construct a V4L2M2MConverter instance.
Definition: converter_v4l2_m2m.cpp:196
int loadConfiguration(const std::string &filename)
Definition: converter_v4l2_m2m.h:39
int queueBuffers(FrameBuffer *input, const std::map< unsigned int, FrameBuffer * > &outputs)
Queue buffers to converter device.
Definition: converter_v4l2_m2m.cpp:403
std::tuple< unsigned int, unsigned int > strideAndFrameSize(const PixelFormat &pixelFormat, const Size &size)
Retrieve the output stride and frame size for an input configutation.
Definition: converter_v4l2_m2m.cpp:313
void stop()
Stop the converter streaming operation.
Definition: converter_v4l2_m2m.cpp:394
SizeRange sizes(const Size &input)
Retrieve the range of minimum and maximum output sizes for an input size.
Definition: converter_v4l2_m2m.cpp:264
std::vector< PixelFormat > formats(PixelFormat input)
Definition: converter_v4l2_m2m.cpp:224
bool isValid() const
Definition: converter_v4l2_m2m.h:40
int exportBuffers(unsigned int ouput, unsigned int count, std::vector< std::unique_ptr< FrameBuffer > > *buffers)
Export buffers from the converter device.
Definition: converter_v4l2_m2m.cpp:364
int start()
Start the converter streaming operation.
Definition: converter_v4l2_m2m.cpp:376
int configure(const StreamConfiguration &inputCfg, const std::vector< std::reference_wrapper< StreamConfiguration > > &outputCfg)
Configure a set of output stream conversion from an input stream.
Definition: converter_v4l2_m2m.cpp:330
Abstract converter.
Logging infrastructure.
Top-level libcamera namespace.
Definition: backtrace.h:17
libcamera pixel format
Signal & slot implementation.
Configuration parameters for a stream.
Definition: stream.h:41