1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
|
/* SPDX-License-Identifier: BSD-2-Clause */
/*
* Copyright (C) 2019-2021, Raspberry Pi Ltd
*
* general metadata class
*/
#pragma once
/* A simple class for carrying arbitrary metadata, for example about an image. */
#include <any>
#include <map>
#include <mutex>
#include <string>
#include <utility>
#include <libcamera/base/thread_annotations.h>
namespace RPiController {
class LIBCAMERA_TSA_CAPABILITY("mutex") Metadata
{
public:
Metadata() = default;
Metadata(Metadata const &other)
{
std::scoped_lock otherLock(other.mutex_);
data_ = other.data_;
}
Metadata(Metadata &&other)
{
std::scoped_lock otherLock(other.mutex_);
data_ = std::move(other.data_);
other.data_.clear();
}
template<typename T>
void set(std::string const &tag, T &&value)
{
std::scoped_lock lock(mutex_);
data_[tag] = std::forward<T>(value);
}
template<typename T>
int get(std::string const &tag, T &value) const
{
std::scoped_lock lock(mutex_);
auto it = data_.find(tag);
if (it == data_.end())
return -1;
value = std::any_cast<T>(it->second);
return 0;
}
void clear()
{
std::scoped_lock lock(mutex_);
data_.clear();
}
Metadata &operator=(Metadata const &other)
{
std::scoped_lock lock(mutex_, other.mutex_);
data_ = other.data_;
return *this;
}
Metadata &operator=(Metadata &&other)
{
std::scoped_lock lock(mutex_, other.mutex_);
data_ = std::move(other.data_);
other.data_.clear();
return *this;
}
void merge(Metadata &other)
{
std::scoped_lock lock(mutex_, other.mutex_);
data_.merge(other.data_);
}
void mergeCopy(const Metadata &other)
{
std::scoped_lock lock(mutex_, other.mutex_);
/*
* If the metadata key exists, ignore this item and copy only
* unique key/value pairs.
*/
data_.insert(other.data_.begin(), other.data_.end());
}
void erase(std::string const &tag)
{
std::scoped_lock lock(mutex_);
eraseLocked(tag);
}
template<typename T>
T *getLocked(std::string const &tag)
{
/*
* This allows in-place access to the Metadata contents,
* for which you should be holding the lock.
*/
auto it = data_.find(tag);
if (it == data_.end())
return nullptr;
return std::any_cast<T>(&it->second);
}
template<typename T>
void setLocked(std::string const &tag, T &&value)
{
/* Use this only if you're holding the lock yourself. */
data_[tag] = std::forward<T>(value);
}
void eraseLocked(std::string const &tag)
{
auto it = data_.find(tag);
if (it == data_.end())
return;
data_.erase(it);
}
/*
* Note: use of (lowercase) lock and unlock means you can create scoped
* locks with the standard lock classes.
* e.g. std::lock_guard<RPiController::Metadata> lock(metadata)
*/
void lock() LIBCAMERA_TSA_ACQUIRE() { mutex_.lock(); }
auto try_lock() LIBCAMERA_TSA_ACQUIRE() { return mutex_.try_lock(); }
void unlock() LIBCAMERA_TSA_RELEASE() { mutex_.unlock(); }
private:
mutable std::mutex mutex_;
std::map<std::string, std::any> data_;
};
} /* namespace RPiController */
|
