summaryrefslogtreecommitdiffstats
path: root/src/multimedia/video/qvideoprobe.cpp
diff options
context:
space:
mode:
Diffstat (limited to 'src/multimedia/video/qvideoprobe.cpp')
-rw-r--r--src/multimedia/video/qvideoprobe.cpp218
1 files changed, 0 insertions, 218 deletions
diff --git a/src/multimedia/video/qvideoprobe.cpp b/src/multimedia/video/qvideoprobe.cpp
deleted file mode 100644
index f7995b297..000000000
--- a/src/multimedia/video/qvideoprobe.cpp
+++ /dev/null
@@ -1,218 +0,0 @@
-/****************************************************************************
-**
-** Copyright (C) 2016 The Qt Company Ltd.
-** Contact: https://www.qt.io/licensing/
-**
-** This file is part of the Qt Toolkit.
-**
-** $QT_BEGIN_LICENSE:LGPL$
-** Commercial License Usage
-** Licensees holding valid commercial Qt licenses may use this file in
-** accordance with the commercial license agreement provided with the
-** Software or, alternatively, in accordance with the terms contained in
-** a written agreement between you and The Qt Company. For licensing terms
-** and conditions see https://www.qt.io/terms-conditions. For further
-** information use the contact form at https://www.qt.io/contact-us.
-**
-** GNU Lesser General Public License Usage
-** Alternatively, this file may be used under the terms of the GNU Lesser
-** General Public License version 3 as published by the Free Software
-** Foundation and appearing in the file LICENSE.LGPL3 included in the
-** packaging of this file. Please review the following information to
-** ensure the GNU Lesser General Public License version 3 requirements
-** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
-**
-** GNU General Public License Usage
-** Alternatively, this file may be used under the terms of the GNU
-** General Public License version 2.0 or (at your option) the GNU General
-** Public license version 3 or any later version approved by the KDE Free
-** Qt Foundation. The licenses are as published by the Free Software
-** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
-** included in the packaging of this file. Please review the following
-** information to ensure the GNU General Public License requirements will
-** be met: https://www.gnu.org/licenses/gpl-2.0.html and
-** https://www.gnu.org/licenses/gpl-3.0.html.
-**
-** $QT_END_LICENSE$
-**
-****************************************************************************/
-
-
-/*!
- \class QVideoProbe
- \inmodule QtMultimedia
-
- \ingroup multimedia
- \ingroup multimedia_video
-
- \brief The QVideoProbe class allows you to monitor video frames being played or recorded.
-
- \code
- QMediaPlayer *player = new QMediaPlayer();
- QVideoProbe *probe = new QVideoProbe;
-
- connect(probe, SIGNAL(videoFrameProbed(QVideoFrame)), this, SLOT(processFrame(QVideoFrame)));
-
- probe->setSource(player); // Returns true, hopefully.
-
- player->setVideoOutput(myVideoSurface);
- player->setMedia(QUrl::fromLocalFile("observation.mp4"));
- player->play(); // Start receiving frames as they get presented to myVideoSurface
- \endcode
-
- This same approach works with the QCamera object as well, to receive viewfinder or video
- frames as they are captured.
-
- \sa QAudioProbe, QMediaPlayer, QCamera
-*/
-
-#include "qvideoprobe.h"
-#include "qmediavideoprobecontrol.h"
-#include "qmediaservice.h"
-#include "qmediarecorder.h"
-#include "qsharedpointer.h"
-#include "qpointer.h"
-
-QT_BEGIN_NAMESPACE
-
-class QVideoProbePrivate {
-public:
- QPointer<QMediaObject> source;
- QPointer<QMediaVideoProbeControl> probee;
-};
-
-/*!
- Creates a new QVideoProbe class with \a parent. After setting the
- source to monitor with \l setSource(), the \l videoFrameProbed()
- signal will be emitted when video frames are flowing in the
- source media object.
- */
-QVideoProbe::QVideoProbe(QObject *parent)
- : QObject(parent)
- , d(new QVideoProbePrivate)
-{
-
-}
-
-/*!
- Destroys this probe and disconnects from any
- media object.
- */
-QVideoProbe::~QVideoProbe()
-{
- if (d->source) {
- // Disconnect
- if (d->probee) {
- disconnect(d->probee.data(), SIGNAL(videoFrameProbed(QVideoFrame)), this, SIGNAL(videoFrameProbed(QVideoFrame)));
- disconnect(d->probee.data(), SIGNAL(flush()), this, SIGNAL(flush()));
- }
- d->source.data()->service()->releaseControl(d->probee.data());
- }
-}
-
-/*!
- Sets the media object to monitor to \a source.
-
- If \a source is zero, this probe will be deactivated
- and this function wil return true.
-
- If the media object does not support monitoring
- video, this function will return false.
-
- Any previously monitored objects will no longer be monitored.
- Passing in the same object will be ignored, but
- monitoring will continue.
- */
-bool QVideoProbe::setSource(QMediaObject *source)
-{
- // Need to:
- // 1) disconnect from current source if necessary
- // 2) see if new one has the probe control
- // 3) connect if so
-
- // in case source was destroyed but probe control is still valid
- if (!d->source && d->probee) {
- disconnect(d->probee.data(), SIGNAL(videoFrameProbed(QVideoFrame)), this, SIGNAL(videoFrameProbed(QVideoFrame)));
- disconnect(d->probee.data(), SIGNAL(flush()), this, SIGNAL(flush()));
- d->probee.clear();
- }
-
- if (source != d->source.data()) {
- if (d->source) {
- Q_ASSERT(d->probee);
- disconnect(d->probee.data(), SIGNAL(videoFrameProbed(QVideoFrame)), this, SIGNAL(videoFrameProbed(QVideoFrame)));
- disconnect(d->probee.data(), SIGNAL(flush()), this, SIGNAL(flush()));
- d->source.data()->service()->releaseControl(d->probee.data());
- d->source.clear();
- d->probee.clear();
- }
-
- if (source) {
- QMediaService *service = source->service();
- if (service) {
- d->probee = service->requestControl<QMediaVideoProbeControl*>();
- }
-
- if (d->probee) {
- connect(d->probee.data(), SIGNAL(videoFrameProbed(QVideoFrame)), this, SIGNAL(videoFrameProbed(QVideoFrame)));
- connect(d->probee.data(), SIGNAL(flush()), this, SIGNAL(flush()));
- d->source = source;
- }
- }
- }
-
- return (!source || d->probee != nullptr);
-}
-
-/*!
- Starts monitoring the given \a mediaRecorder.
-
- If there is no mediaObject associated with \a mediaRecorder, or if it is
- zero, this probe will be deactivated and this function wil return true.
-
- If the media recorder instance does not support monitoring
- video, this function will return false.
-
- Any previously monitored objects will no longer be monitored.
- Passing in the same object will be ignored, but
- monitoring will continue.
- */
-bool QVideoProbe::setSource(QMediaRecorder *mediaRecorder)
-{
- QMediaObject *source = mediaRecorder ? mediaRecorder->mediaObject() : nullptr;
- bool result = setSource(source);
-
- if (!mediaRecorder)
- return true;
-
- if (mediaRecorder && !source)
- return false;
-
- return result;
-}
-
-/*!
- Returns true if this probe is monitoring something, or false otherwise.
-
- The source being monitored does not need to be active.
- */
-bool QVideoProbe::isActive() const
-{
- return d->probee != nullptr;
-}
-
-/*!
- \fn QVideoProbe::videoFrameProbed(const QVideoFrame &frame)
-
- This signal should be emitted when a video \a frame is processed in the
- media service.
-*/
-
-/*!
- \fn QVideoProbe::flush()
-
- This signal should be emitted when it is required to release all frames.
- Application must release all outstanding references to video frames.
-*/
-
-QT_END_NAMESPACE
generated by cgit v1.2.3 (git 2.25.1) at 2024-05-25 23:07:47 +0000