diff options
Diffstat (limited to 'src/plugins/multimedia/ffmpeg/qffmpegthread_p.h')
-rw-r--r-- | src/plugins/multimedia/ffmpeg/qffmpegthread_p.h | 96 |
1 files changed, 96 insertions, 0 deletions
diff --git a/src/plugins/multimedia/ffmpeg/qffmpegthread_p.h b/src/plugins/multimedia/ffmpeg/qffmpegthread_p.h new file mode 100644 index 000000000..a7c5b0927 --- /dev/null +++ b/src/plugins/multimedia/ffmpeg/qffmpegthread_p.h @@ -0,0 +1,96 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only +#ifndef QFFMPEGTHREAD_P_H +#define QFFMPEGTHREAD_P_H + +// +// W A R N I N G +// ------------- +// +// This file is not part of the Qt API. It exists purely as an +// implementation detail. This header file may change from version to +// version without notice, or even be removed. +// +// We mean it. +// + +#include <private/qtmultimediaglobal_p.h> + +#include <qmutex.h> +#include <qwaitcondition.h> +#include <qthread.h> + +QT_BEGIN_NAMESPACE + +class QAudioSink; + +namespace QFFmpeg +{ + +/*! + FFmpeg thread that is used to implement a consumer pattern. + + This thread processes work items until no more data is available. + When no more data is available, it sleeps until it is notified about + more available data. + */ +class ConsumerThread : public QThread +{ +public: + /*! + Stops the thread and deletes this object + */ + void stopAndDelete(); + +protected: + + /*! + Called on this thread when thread starts + */ + virtual void init() = 0; + + /*! + Called on this thread before thread exits + */ + virtual void cleanup() = 0; + + /*! + Process one work item. Called repeatedly until hasData() returns + false, in which case the thread sleeps until the next dataReady() + notification. + + Note: processOne() should never block. + */ + virtual void processOne() = 0; + + /*! + Wake thread from sleep and process data until + hasData() returns false. The method is supposed to be invoked + right after the scope of QMutexLocker that lockLoopData returns. + */ + void dataReady(); + + /*! + Must return true when data is available for processing + */ + virtual bool hasData() const = 0; + + /*! + Locks the loop data mutex. It must be used to protect loop data + like a queue of video frames. + */ + QMutexLocker<QMutex> lockLoopData() const; + +private: + void run() final; + + mutable QMutex m_loopDataMutex; + QWaitCondition m_condition; + bool m_exit = false; +}; + +} + +QT_END_NAMESPACE + +#endif |