libcamera v0.5.1
Supporting cameras in Linux since 2019
Loading...
Searching...
No Matches
object.h
Go to the documentation of this file.
1/* SPDX-License-Identifier: LGPL-2.1-or-later */
2/*
3 * Copyright (C) 2019, Google Inc.
4 *
5 * Base object
6 */
7
8#pragma once
9
10#include <list>
11#include <memory>
12#include <utility>
13#include <vector>
14
17
18namespace libcamera {
19
20class Message;
21template<typename... Args>
22class Signal;
23class SignalBase;
24class Thread;
25
26class Object
27{
28public:
29 Object(Object *parent = nullptr);
30 virtual ~Object();
31
32 void deleteLater();
33
34 void postMessage(std::unique_ptr<Message> msg);
35
36 template<typename T, typename R, typename... FuncArgs, typename... Args,
37 std::enable_if_t<std::is_base_of<Object, T>::value> * = nullptr>
38 R invokeMethod(R (T::*func)(FuncArgs...), ConnectionType type,
39 Args&&... args)
40 {
41 T *obj = static_cast<T *>(this);
42 auto *method = new BoundMethodMember<T, R, FuncArgs...>(obj, this, func, type);
43 return method->activate(std::forward<Args>(args)..., true);
44 }
45
46 Thread *thread() const { return thread_; }
48
49 Object *parent() const { return parent_; }
50
51protected:
52 virtual void message(Message *msg);
53
54 bool assertThreadBound(const char *message);
55
56private:
58
59 friend class SignalBase;
60 friend class Thread;
61
62 void notifyThreadMove();
63
64 void connect(SignalBase *signal);
65 void disconnect(SignalBase *signal);
66
67 Object *parent_;
68 std::vector<Object *> children_;
69
70 Thread *thread_;
71 std::list<SignalBase *> signals_;
72 unsigned int pendingMessages_;
73};
74
75} /* namespace libcamera */
Method bind and invocation.
Utilities to help constructing class interfaces.
#define LIBCAMERA_DISABLE_COPY_AND_MOVE(klass)
Disable copy and move construction and assignment of the klass.
Definition class.h:29
A message that can be posted to a Thread.
Definition message.h:24
Base object to support automatic signal disconnection.
Definition object.h:27
Object(Object *parent=nullptr)
Construct an Object instance.
Definition object.cpp:69
R invokeMethod(R(T::*func)(FuncArgs...), ConnectionType type, Args &&... args)
Invoke a method asynchronously on an Object instance.
Definition object.h:38
Object * parent() const
Retrieve the object's parent.
Definition object.h:49
virtual void message(Message *msg)
Message handler for the object.
Definition object.cpp:201
bool assertThreadBound(const char *message)
Check if the caller complies with thread-bound constraints.
Definition object.cpp:247
void deleteLater()
Schedule deletion of the instance in the thread it belongs to.
Definition object.cpp:160
void moveToThread(Thread *thread)
Move the object and all its children to a different thread.
Definition object.cpp:306
virtual ~Object()
Destroy an Object instance.
Definition object.cpp:98
Thread * thread() const
Retrieve the thread the object is bound to.
Definition object.h:46
void postMessage(std::unique_ptr< Message > msg)
Post a message to the object's thread.
Definition object.cpp:184
Generic signal and slot communication mechanism.
Definition signal.h:39
A thread of execution.
Definition thread.h:31
Top-level libcamera namespace.
Definition backtrace.h:17
ConnectionType
Connection type for asynchronous communication.
Definition bound_method.h:19