object.h
Go to the documentation of this file.
/* SPDX-License-Identifier: LGPL-2.1-or-later */
/*
* Copyright (C) 2019, Google Inc.
*
* object.h - Base object
*/
#ifndef __LIBCAMERA_OBJECT_H__
#define __LIBCAMERA_OBJECT_H__
#include <list>
#include <memory>
#include <vector>
#include <libcamera/bound_method.h>
namespace libcamera {
class Message;
template<typename... Args>
class Signal;
class SignalBase;
class Thread;
class Object
{
public:
Object(Object *parent = nullptr);
virtual ~Object();
void postMessage(std::unique_ptr<Message> msg);
template<typename T, typename R, typename... FuncArgs, typename... Args,
typename std::enable_if_t<std::is_base_of<Object, T>::value> * = nullptr>
R invokeMethod(R (T::*func)(FuncArgs...), ConnectionType type,
Args... args)
{
T *obj = static_cast<T *>(this);
auto *method = new BoundMethodMember<T, R, FuncArgs...>(obj, this, func, type);
return method->activate(args..., true);
}
Thread *thread() const { return thread_; }
void moveToThread(Thread *thread);
Object *parent() const { return parent_; }
protected:
virtual void message(Message *msg);
private:
friend class SignalBase;
friend class Thread;
void notifyThreadMove();
void connect(SignalBase *signal);
void disconnect(SignalBase *signal);
Object *parent_;
std::vector<Object *> children_;
Thread *thread_;
std::list<SignalBase *> signals_;
unsigned int pendingMessages_;
};
} /* namespace libcamera */
#endif /* __LIBCAMERA_OBJECT_H__ */
bound_method.h
Method bind and invocation.
libcamera::ConnectionType
ConnectionType
Connection type for asynchronous communication.
Definition: bound_method.h:19
libcamera::Message
A message that can be posted to a Thread.
Definition: message.h:22
libcamera::Object
Base object to support automatic signal disconnection.
Definition: object.h:25
libcamera::Object::Object
Object(Object *parent=nullptr)
Construct an Object instance.
Definition: object.cpp:61
libcamera::Object::invokeMethod
R invokeMethod(R(T::*func)(FuncArgs...), ConnectionType type, Args... args)
Invoke a method asynchronously on an Object instance.
Definition: object.h:34
libcamera::Object::parent
Object * parent() const
Retrieve the object's parent.
Definition: object.h:45
libcamera::Object::message
virtual void message(Message *msg)
Message handler for the object.
Definition: object.cpp:133
libcamera::Object::moveToThread
void moveToThread(Thread *thread)
Move the object and all its children to a different thread.
Definition: object.cpp:197
libcamera::Object::thread
Thread * thread() const
Retrieve the thread the object is bound to.
Definition: object.h:42
libcamera::Object::~Object
virtual ~Object()
Destroy an Object instance.
Definition: object.cpp:77
libcamera::Object::postMessage
void postMessage(std::unique_ptr< Message > msg)
Post a message to the object's thread.
Definition: object.cpp:116
libcamera::Thread
A thread of execution.
Definition: thread.h:31