libcamera v0.7.0+1-4ceceb68
Supporting cameras in Linux since 2019
Loading...
Searching...
No Matches
converter_dw100.h
1/* SPDX-License-Identifier: LGPL-2.1-or-later */
2/*
3 * Copyright (C) 2025, Ideas on Board Oy
4 *
5 * DW100 Dewarp Engine integration
6 */
7
8#pragma once
9
10#include <memory>
11#include <queue>
12
14#include <libcamera/controls.h>
16
17#include "libcamera/internal/converter/converter_dw100_vertexmap.h"
20
21namespace libcamera {
22
23class MediaDevice;
24class Rectangle;
25class Stream;
26
28{
29public:
30 virtual ~ConverterDW100Module() = default;
31
32 static std::unique_ptr<ConverterDW100Module> createModule(DeviceEnumerator *enumerator);
33
34 int init(const YamlObject &params);
35
36 int configure(const StreamConfiguration &inputCfg,
37 const std::vector<std::reference_wrapper<StreamConfiguration>>
38 &outputCfg);
39 bool isConfigured(const Stream *stream) const;
40
41 Size adjustInputSize(const PixelFormat &pixFmt, const Size &size,
43 Size adjustOutputSize(const PixelFormat &pixFmt, const Size &size,
45
46 int exportBuffers(const Stream *stream, unsigned int count,
47 std::vector<std::unique_ptr<FrameBuffer>> *buffers);
48 int validateOutput(StreamConfiguration *cfg, bool *adjusted,
50 int queueBuffers(FrameBuffer *input,
51 const std::map<const Stream *, FrameBuffer *> &outputs);
52
53 int start();
54 void stop();
55
56 void updateControlInfos(const Stream *stream, ControlInfoMap::Map &infos);
57 void setControls(const Stream *stream, const ControlList &controls);
58 void populateMetadata(const Stream *stream, ControlList &meta);
59
60 void setSensorCrop(const Rectangle &rect);
61 void setTransform(const Stream *stream, const Transform &transform);
62
65
66private:
67 ConverterDW100Module(std::shared_ptr<MediaDevice> media);
68
69 int applyControls(const Stream *stream, const V4L2Request *request);
70 void reinitRequest(V4L2Request *request);
71
72 struct DewarpParms {
74 std::vector<double> coeffs;
75 };
76
77 struct VertexMapInfo {
79 bool update;
80 };
81
82 std::map<const Stream *, VertexMapInfo> vertexMaps_;
83 std::optional<DewarpParms> dewarpParams_;
84 unsigned int inputBufferCount_;
85 V4L2M2MConverter converter_;
86 Rectangle sensorCrop_;
87 bool running_;
88
89 std::vector<std::unique_ptr<V4L2Request>> requests_;
90 std::queue<V4L2Request *> availableRequests_;
91};
92
93} /* namespace libcamera */
std::unordered_map< const ControlId *, ControlInfo > Map
The base std::unsorted_map<> container.
Definition controls.h:367
Associate a list of ControlId with their values for an object.
Definition controls.h:409
A converter module for the dw100 dewarper.
Definition converter_dw100.h:28
Signal< FrameBuffer * > inputBufferReady
A signal emitted when the input frame buffer completes.
Definition converter_dw100.h:63
int validateOutput(StreamConfiguration *cfg, bool *adjusted, Converter::Alignment align=Converter::Alignment::Down)
Validate and possibily adjust cfg to a valid converter output.
Definition converter_dw100.cpp:213
static std::unique_ptr< ConverterDW100Module > createModule(DeviceEnumerator *enumerator)
Create a ConverterDW100Module.
Definition converter_dw100.cpp:53
int init(const YamlObject &params)
Initialize the module with configuration data.
Definition converter_dw100.cpp:100
void setControls(const Stream *stream, const ControlList &controls)
Set libcamera controls.
Definition converter_dw100.cpp:364
Size adjustOutputSize(const PixelFormat &pixFmt, const Size &size, Converter::Alignment align=Converter::Alignment::Down)
Adjust the converter output size to a valid value.
Definition converter_dw100.cpp:194
int start()
Start the converter streaming operation.
Definition converter_dw100.cpp:278
void setTransform(const Stream *stream, const Transform &transform)
Set transform.
Definition converter_dw100.cpp:447
Signal< FrameBuffer * > outputBufferReady
A signal emitted on each frame buffer completion of the output queue.
Definition converter_dw100.h:64
void stop()
Stop the converter streaming operation.
Definition converter_dw100.cpp:317
void updateControlInfos(const Stream *stream, ControlInfoMap::Map &infos)
Update the controls.
Definition converter_dw100.cpp:333
int exportBuffers(const Stream *stream, unsigned int count, std::vector< std::unique_ptr< FrameBuffer > > *buffers)
Export buffers from the converter device.
Definition converter_dw100.cpp:204
bool isConfigured(const Stream *stream) const
Check if a given stream is configured.
Definition converter_dw100.cpp:176
Size adjustInputSize(const PixelFormat &pixFmt, const Size &size, Converter::Alignment align=Converter::Alignment::Down)
Adjust the converter input size to a valid value.
Definition converter_dw100.cpp:184
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_dw100.cpp:144
void populateMetadata(const Stream *stream, ControlList &meta)
Retrieve updated metadata.
Definition converter_dw100.cpp:398
void setSensorCrop(const Rectangle &rect)
Set sensor crop rectangle.
Definition converter_dw100.cpp:429
int queueBuffers(FrameBuffer *input, const std::map< const Stream *, FrameBuffer * > &outputs)
Queue buffers to converter device.
Definition converter_dw100.cpp:234
Alignment
The alignment mode specified when adjusting the converter input or output sizes.
Definition converter.h:45
@ Down
Adjust the Converter sizes to a smaller valid size.
Enumerate, store and search media devices.
Definition device_enumerator.h:38
Helper class to compute dw100 vertex maps.
Definition converter_dw100_vertexmap.h:26
Frame buffer data and its associated dynamic metadata.
Definition framebuffer.h:50
Matrix class.
Definition matrix.h:31
libcamera image pixel format
Definition pixel_format.h:17
Describe a rectangle's position and dimensions.
Definition geometry.h:247
Generic signal and slot communication mechanism.
Definition signal.h:39
Describe a two-dimensional size.
Definition geometry.h:51
Video stream for a camera.
Definition stream.h:76
V4L2Request object and API.
Definition v4l2_request.h:22
A class representing the tree structure of the YAML content.
Definition yaml_parser.h:28
Camera controls identifiers.
Framework to manage controls related to an object.
V4L2 M2M based converter.
Enumeration and matching of media devices.
Frame buffer handling.
Top-level libcamera namespace.
Definition backtrace.h:17
Transform
Enum to represent a 2D plane transform.
Definition transform.h:14
Configuration parameters for a stream.
Definition stream.h:40