From deb13f102a0773ef87310346f1755b16215e62f4 Mon Sep 17 00:00:00 2001
From: Yoann Lopes <yoann.lopes@theqtcompany.com>
Date: Fri, 17 Oct 2014 16:51:23 +0200
Subject: [PATCH 1/6] Add QT_GSTREAMER_CAMERABIN_VIDEOSRC environment variable.

It can be used to set which video source element should be used by
the camerabin.

Change-Id: I8d1cd8c4ba6fe5a89817699f645b0997e713aaca
Reviewed-by: Samuli Piippo <samuli.piippo@digia.com>
Reviewed-by: Christian Stromme <christian.stromme@digia.com>
---
 src/gsttools/qgstutils.cpp                    | 25 ++++++++++---
 src/multimedia/gsttools_headers/qgstutils_p.h |  2 ++
 .../gstreamer/camerabin/camerabinsession.cpp  | 36 +++++++++++++++++--
 3 files changed, 56 insertions(+), 7 deletions(-)

diff --git a/src/gsttools/qgstutils.cpp b/src/gsttools/qgstutils.cpp
index 8d484aa6..556fc03c 100644
--- a/src/gsttools/qgstutils.cpp
+++ b/src/gsttools/qgstutils.cpp
@@ -430,13 +430,15 @@ QVector<QGstUtils::CameraInfo> QGstUtils::enumerateCameras(GstElementFactory *fa
                     QStringLiteral("primary"),
                     QGstreamerVideoInputDeviceControl::primaryCamera(),
                     0,
-                    QCamera::BackFace
+                    QCamera::BackFace,
+                    QByteArray()
                 };
                 const CameraInfo secondary = {
                     QStringLiteral("secondary"),
                     QGstreamerVideoInputDeviceControl::secondaryCamera(),
                     0,
-                    QCamera::FrontFace
+                    QCamera::FrontFace,
+                    QByteArray()
                 };
 
                 devices.append(primary);
@@ -498,14 +500,17 @@ QVector<QGstUtils::CameraInfo> QGstUtils::enumerateCameras(GstElementFactory *fa
 
         if (isCamera) {
             // find out its driver "name"
+            QByteArray driver;
             QString name;
             struct v4l2_capability vcap;
             memset(&vcap, 0, sizeof(struct v4l2_capability));
 
-            if (ioctl(fd, VIDIOC_QUERYCAP, &vcap) != 0)
+            if (ioctl(fd, VIDIOC_QUERYCAP, &vcap) != 0) {
                 name = entryInfo.fileName();
-            else
+            } else {
+                driver = QByteArray((const char*)vcap.driver);
                 name = QString::fromUtf8((const char*)vcap.card);
+            }
             //qDebug() << "found camera: " << name;
 
 
@@ -513,7 +518,8 @@ QVector<QGstUtils::CameraInfo> QGstUtils::enumerateCameras(GstElementFactory *fa
                 entryInfo.absoluteFilePath(),
                 name,
                 0,
-                QCamera::UnspecifiedPosition
+                QCamera::UnspecifiedPosition,
+                driver
             };
             devices.append(device);
         }
@@ -561,6 +567,15 @@ int QGstUtils::cameraOrientation(const QString &device, GstElementFactory * fact
     return 0;
 }
 
+QByteArray QGstUtils::cameraDriver(const QString &device, GstElementFactory *factory)
+{
+    foreach (const CameraInfo &camera, enumerateCameras(factory)) {
+        if (camera.name == device)
+            return camera.driver;
+    }
+    return QByteArray();
+}
+
 
 void qt_gst_object_ref_sink(gpointer object)
 {
diff --git a/src/multimedia/gsttools_headers/qgstutils_p.h b/src/multimedia/gsttools_headers/qgstutils_p.h
index 48434b2f..65ff759a 100644
--- a/src/multimedia/gsttools_headers/qgstutils_p.h
+++ b/src/multimedia/gsttools_headers/qgstutils_p.h
@@ -65,6 +65,7 @@ namespace QGstUtils {
         QString description;
         int orientation;
         QCamera::Position position;
+        QByteArray driver;
     };
 
     QMap<QByteArray, QVariant> gstTagListToMap(const GstTagList *list);
@@ -84,6 +85,7 @@ namespace QGstUtils {
     QString cameraDescription(const QString &device, GstElementFactory * factory = 0);
     QCamera::Position cameraPosition(const QString &device, GstElementFactory * factory = 0);
     int cameraOrientation(const QString &device, GstElementFactory * factory = 0);
+    QByteArray cameraDriver(const QString &device, GstElementFactory * factory = 0);
 }
 
 void qt_gst_object_ref_sink(gpointer object);
diff --git a/src/plugins/gstreamer/camerabin/camerabinsession.cpp b/src/plugins/gstreamer/camerabin/camerabinsession.cpp
index 01978397..a4038c58 100644
--- a/src/plugins/gstreamer/camerabin/camerabinsession.cpp
+++ b/src/plugins/gstreamer/camerabin/camerabinsession.cpp
@@ -412,9 +412,41 @@ GstElement *CameraBinSession::buildCameraSource()
         if (g_object_class_find_property(G_OBJECT_GET_CLASS(m_videoSrc), "video-source")) {
             GstElement *src = 0;
 
-            if (m_videoInputFactory)
+            /* QT_GSTREAMER_CAMERABIN_VIDEOSRC can be used to set the video source element.
+
+               --- Usage
+
+                 QT_GSTREAMER_CAMERABIN_VIDEOSRC=[drivername=elementname[,drivername2=elementname2 ...],][elementname]
+
+               --- Examples
+
+                 Always use 'somevideosrc':
+                 QT_GSTREAMER_CAMERABIN_VIDEOSRC="somevideosrc"
+
+                 Use 'somevideosrc' when the device driver is 'somedriver', otherwise use default:
+                 QT_GSTREAMER_CAMERABIN_VIDEOSRC="somedriver=somevideosrc"
+
+                 Use 'somevideosrc' when the device driver is 'somedriver', otherwise use 'somevideosrc2'
+                 QT_GSTREAMER_CAMERABIN_VIDEOSRC="somedriver=somevideosrc,somevideosrc2"
+            */
+            const QByteArray envVideoSource = qgetenv("QT_GSTREAMER_CAMERABIN_VIDEOSRC");
+            if (!envVideoSource.isEmpty()) {
+                QList<QByteArray> sources = envVideoSource.split(',');
+                foreach (const QByteArray &source, sources) {
+                    QList<QByteArray> keyValue = source.split('=');
+                    if (keyValue.count() == 1) {
+                        src = gst_element_factory_make(keyValue.at(0), "camera_source");
+                        break;
+                    } else if (keyValue.at(0) == QGstUtils::cameraDriver(m_inputDevice, m_sourceFactory)) {
+                        src = gst_element_factory_make(keyValue.at(1), "camera_source");
+                        break;
+                    }
+                }
+            } else if (m_videoInputFactory) {
                 src = m_videoInputFactory->buildElement();
-            else
+            }
+
+            if (!src)
                 src = gst_element_factory_make("v4l2src", "camera_source");
 
             if (src) {

From f1b775ab4fd5ae09b5ef25fee2a2c3748e0192ee Mon Sep 17 00:00:00 2001
From: Friedemann Kleint <Friedemann.Kleint@digia.com>
Date: Wed, 29 Oct 2014 10:00:56 +0100
Subject: [PATCH 2/6] WMF plugin: Initialize member variable m_stateDirty.

Fix purify warning:
[W] UMR: Uninitialized memory read in MFPlayerControl::refreshState(void) {1 occurrence}

Task-number: QTBUG-41966
Change-Id: I1416f906dcc8c31a528ab7f09a258873fcfe9d1e
Reviewed-by: Yoann Lopes <yoann.lopes@theqtcompany.com>
---
 src/plugins/wmf/player/mfplayercontrol.cpp | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/plugins/wmf/player/mfplayercontrol.cpp b/src/plugins/wmf/player/mfplayercontrol.cpp
index 33754831..02bd902e 100644
--- a/src/plugins/wmf/player/mfplayercontrol.cpp
+++ b/src/plugins/wmf/player/mfplayercontrol.cpp
@@ -39,6 +39,7 @@
 MFPlayerControl::MFPlayerControl(MFPlayerSession *session)
 : QMediaPlayerControl(session)
 , m_state(QMediaPlayer::StoppedState)
+, m_stateDirty(false)
 , m_videoAvailable(false)
 , m_audioAvailable(false)
 , m_duration(-1)

From d0ed4f3b085414dc8288363e527e49ebfd2eb339 Mon Sep 17 00:00:00 2001
From: Venugopal Shivashankar <venugopal.shivashankar@digia.com>
Date: Thu, 30 Oct 2014 19:57:30 +0100
Subject: [PATCH 3/6] Doc: Added the missing screenshot image

Change-Id: Ifcef698bd735b7fe7e5f4a92984be07a01f283fb
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@digia.com>
---
 .../player/doc/images/mediaplayerex.jpg         | Bin 0 -> 28825 bytes
 .../player/doc/src/player.qdoc                  |   2 ++
 2 files changed, 2 insertions(+)
 create mode 100644 examples/multimediawidgets/player/doc/images/mediaplayerex.jpg

diff --git a/examples/multimediawidgets/player/doc/images/mediaplayerex.jpg b/examples/multimediawidgets/player/doc/images/mediaplayerex.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..e875bd1340a90638dc86ea14abfaf0ef314aab09
GIT binary patch
literal 28825
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
DYC=s`

literal 0
HcmV?d00001

diff --git a/examples/multimediawidgets/player/doc/src/player.qdoc b/examples/multimediawidgets/player/doc/src/player.qdoc
index ac5d700d..3da4c674 100644
--- a/examples/multimediawidgets/player/doc/src/player.qdoc
+++ b/examples/multimediawidgets/player/doc/src/player.qdoc
@@ -31,6 +31,8 @@
     \ingroup multimedia_examples
     \brief Playing audio and video.
 
+    \image mediaplayerex.jpg
+
     \e{Media Player} demonstrates a simple multimedia player that can play
     audio and or video files using various codecs.
 

From ad929984e3560407cd530d4420bda97e973d5e7d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20Str=C3=B8mme?=
 <christian.stromme@theqtcompany.com>
Date: Fri, 31 Oct 2014 13:47:19 +0100
Subject: [PATCH 4/6] OpenSL ES: Don't store or return the adjusted volume
 level.

According to our own docs we should always return 1.0 (MAX) volume level
if the device doesn't support setting the volume, which is the case
for OpenSL ES on Android.

Task-number: QTBUG-42159
Change-Id: I9144e9e2cd84cc80633c68c5d6fa32b8dbd0fcd5
Reviewed-by: Yoann Lopes <yoann.lopes@theqtcompany.com>
---
 src/plugins/opensles/qopenslesaudioinput.cpp | 5 ++---
 src/plugins/opensles/qopenslesaudioinput.h   | 1 -
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/src/plugins/opensles/qopenslesaudioinput.cpp b/src/plugins/opensles/qopenslesaudioinput.cpp
index cd592a7d..181649ae 100644
--- a/src/plugins/opensles/qopenslesaudioinput.cpp
+++ b/src/plugins/opensles/qopenslesaudioinput.cpp
@@ -70,7 +70,6 @@ QOpenSLESAudioInput::QOpenSLESAudioInput(const QByteArray &device)
     , m_errorState(QAudio::NoError)
     , m_deviceState(QAudio::StoppedState)
     , m_lastNotifyTime(0)
-    , m_volume(1)
     , m_bufferSize(0)
     , m_periodSize(0)
     , m_intervalTime(1000)
@@ -480,12 +479,12 @@ qint64 QOpenSLESAudioInput::elapsedUSecs() const
 void QOpenSLESAudioInput::setVolume(qreal vol)
 {
     // Volume interface is not available for the recorder on Android
-    m_volume = vol;
+    Q_UNUSED(vol);
 }
 
 qreal QOpenSLESAudioInput::volume() const
 {
-    return m_volume;
+    return qreal(1.0);
 }
 
 void QOpenSLESAudioInput::reset()
diff --git a/src/plugins/opensles/qopenslesaudioinput.h b/src/plugins/opensles/qopenslesaudioinput.h
index 7ffff047..481ff371 100644
--- a/src/plugins/opensles/qopenslesaudioinput.h
+++ b/src/plugins/opensles/qopenslesaudioinput.h
@@ -113,7 +113,6 @@ private:
     QAudio::State m_deviceState;
     QTime m_clockStamp;
     qint64 m_lastNotifyTime;
-    qreal m_volume;
     int m_bufferSize;
     int m_periodSize;
     int m_intervalTime;

From e92bcbfa4dc8ea5e78e4c1712fffc9be0104a73e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20Str=C3=B8mme?=
 <christian.stromme@theqtcompany.com>
Date: Thu, 30 Oct 2014 18:29:38 +0100
Subject: [PATCH 5/6] OpenSL ES: improve buffer logic

Don't use relaxed load and stores, we need to be stricter to avoid
problems with high frequency re-fills of the buffer. If we don't enforce
ordering we might end-up spending more time trying to acquire an open
slot in the buffer. Updating processes bytes is also moved off the
"OpenSL" thread.

Added some comments for improved readability.

Change-Id: Ie27965fc6bf4b8394081ae6419f4933522ada98e
Reviewed-by: Yoann Lopes <yoann.lopes@theqtcompany.com>
---
 src/plugins/opensles/qopenslesaudiooutput.cpp | 34 ++++++++++++++-----
 src/plugins/opensles/qopenslesaudiooutput.h   |  1 +
 2 files changed, 27 insertions(+), 8 deletions(-)

diff --git a/src/plugins/opensles/qopenslesaudiooutput.cpp b/src/plugins/opensles/qopenslesaudiooutput.cpp
index c45fbd3c..b89d8b93 100644
--- a/src/plugins/opensles/qopenslesaudiooutput.cpp
+++ b/src/plugins/opensles/qopenslesaudiooutput.cpp
@@ -157,7 +157,7 @@ int QOpenSLESAudioOutput::bytesFree() const
     if (m_state != QAudio::ActiveState && m_state != QAudio::IdleState)
         return 0;
 
-    return m_availableBuffers.load() ? m_bufferSize : 0;
+    return m_availableBuffers.loadAcquire() ? m_bufferSize : 0;
 }
 
 int QOpenSLESAudioOutput::periodSize() const
@@ -343,6 +343,11 @@ void QOpenSLESAudioOutput::onEOSEvent()
     setError(QAudio::UnderrunError);
 }
 
+void QOpenSLESAudioOutput::onBytesProcessed(qint64 bytes)
+{
+    m_processedBytes += bytes;
+}
+
 void QOpenSLESAudioOutput::bufferAvailable(quint32 count, quint32 playIndex)
 {
     Q_UNUSED(count);
@@ -351,11 +356,13 @@ void QOpenSLESAudioOutput::bufferAvailable(quint32 count, quint32 playIndex)
     if (m_state == QAudio::StoppedState)
         return;
 
-    if (!m_pullMode) {
-        m_availableBuffers.fetchAndAddRelaxed(1);
+    if (!m_pullMode) { // We're in push mode.
+        // Signal that there is a new open slot in the buffer and return
+        m_availableBuffers.fetchAndAddRelease(1);
         return;
     }
 
+    // We're in pull mode.
     const int index = m_nextBuffer * m_bufferSize;
     const qint64 readSize = m_audioSource->read(m_buffers + index, m_bufferSize);
 
@@ -370,8 +377,8 @@ void QOpenSLESAudioOutput::bufferAvailable(quint32 count, quint32 playIndex)
         return;
     }
 
-    m_processedBytes += readSize;
     m_nextBuffer = (m_nextBuffer + 1) % BUFFER_COUNT;
+    QMetaObject::invokeMethod(this, "onBytesProcessed", Qt::QueuedConnection, Q_ARG(qint64, readSize));
 }
 
 void QOpenSLESAudioOutput::playCallback(SLPlayItf player, void *ctx, SLuint32 event)
@@ -570,7 +577,7 @@ void QOpenSLESAudioOutput::destroyPlayer()
     m_buffers = Q_NULLPTR;
     m_processedBytes = 0;
     m_nextBuffer = 0;
-    m_availableBuffers = BUFFER_COUNT;
+    m_availableBuffers.storeRelease(BUFFER_COUNT);
     m_playItf = Q_NULLPTR;
     m_volumeItf = Q_NULLPTR;
     m_bufferQueueItf = Q_NULLPTR;
@@ -599,20 +606,32 @@ void QOpenSLESAudioOutput::startPlayer()
 
 qint64 QOpenSLESAudioOutput::writeData(const char *data, qint64 len)
 {
-    if (!len || !m_availableBuffers.load())
+    if (!len)
         return 0;
 
     if (len > m_bufferSize)
         len = m_bufferSize;
 
+    // Acquire one slot in the buffer
+    const int before = m_availableBuffers.fetchAndAddAcquire(-1);
+
+    // If there where no vacant slots, then we just overdrew the buffer account...
+    if (before < 1) {
+        m_availableBuffers.fetchAndAddRelease(1);
+        return 0;
+    }
+
     const int index = m_nextBuffer * m_bufferSize;
     ::memcpy(m_buffers + index, data, len);
     const SLuint32 res = (*m_bufferQueueItf)->Enqueue(m_bufferQueueItf,
                                                       m_buffers + index,
                                                       len);
 
-    if (res == SL_RESULT_BUFFER_INSUFFICIENT)
+    // If we where unable to enqueue a new buffer, give back the acquired slot.
+    if (res == SL_RESULT_BUFFER_INSUFFICIENT) {
+        m_availableBuffers.fetchAndAddRelease(1);
         return 0;
+    }
 
     if (res != SL_RESULT_SUCCESS) {
         setError(QAudio::FatalError);
@@ -621,7 +640,6 @@ qint64 QOpenSLESAudioOutput::writeData(const char *data, qint64 len)
     }
 
     m_processedBytes += len;
-    m_availableBuffers.fetchAndAddRelaxed(-1);
     setState(QAudio::ActiveState);
     setError(QAudio::NoError);
     m_nextBuffer = (m_nextBuffer + 1) % BUFFER_COUNT;
diff --git a/src/plugins/opensles/qopenslesaudiooutput.h b/src/plugins/opensles/qopenslesaudiooutput.h
index 200b4a3c..f36a5bf0 100644
--- a/src/plugins/opensles/qopenslesaudiooutput.h
+++ b/src/plugins/opensles/qopenslesaudiooutput.h
@@ -79,6 +79,7 @@ private:
     friend class SLIODevicePrivate;
 
     Q_INVOKABLE void onEOSEvent();
+    Q_INVOKABLE void onBytesProcessed(qint64 bytes);
     void bufferAvailable(quint32 count, quint32 playIndex);
 
     static void playCallback(SLPlayItf playItf, void *ctx, SLuint32 event);

From 2020b032e83d1b61736a80a6815635aa7451deed Mon Sep 17 00:00:00 2001
From: Friedemann Kleint <Friedemann.Kleint@digia.com>
Date: Thu, 6 Nov 2014 16:24:57 +0100
Subject: [PATCH 6/6] Check whether current context can be obtained when
 deleting textures.

Add a warning in that case.

Task-number: QTBUG-41966
Change-Id: I491ee9e13c9504040ab789951656983a736d9203
Reviewed-by: Yoann Lopes <yoann.lopes@theqtcompany.com>
---
 src/plugins/wmf/evrd3dpresentengine.cpp          | 8 ++++++--
 src/qtmultimediaquicktools/qsgvideonode_i420.cpp | 8 ++++++--
 2 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/src/plugins/wmf/evrd3dpresentengine.cpp b/src/plugins/wmf/evrd3dpresentengine.cpp
index 42d0dea4..9a508520 100644
--- a/src/plugins/wmf/evrd3dpresentengine.cpp
+++ b/src/plugins/wmf/evrd3dpresentengine.cpp
@@ -184,8 +184,12 @@ D3DPresentEngine::~D3DPresentEngine()
         m_egl->destroySurface(m_eglDisplay, m_eglSurface);
         m_eglSurface = NULL;
     }
-    if (m_glTexture)
-        QOpenGLContext::currentContext()->functions()->glDeleteTextures(1, &m_glTexture);
+    if (m_glTexture) {
+        if (QOpenGLContext *current = QOpenGLContext::currentContext())
+            current->functions()->glDeleteTextures(1, &m_glTexture);
+        else
+            qWarning() << "D3DPresentEngine: Cannot obtain GL context, unable to delete textures";
+    }
 
     delete m_glContext;
     delete m_offscreenSurface;
diff --git a/src/qtmultimediaquicktools/qsgvideonode_i420.cpp b/src/qtmultimediaquicktools/qsgvideonode_i420.cpp
index 5b8b7ce8..17b4924d 100644
--- a/src/qtmultimediaquicktools/qsgvideonode_i420.cpp
+++ b/src/qtmultimediaquicktools/qsgvideonode_i420.cpp
@@ -227,8 +227,12 @@ QSGVideoMaterial_YUV420::QSGVideoMaterial_YUV420(const QVideoSurfaceFormat &form
 
 QSGVideoMaterial_YUV420::~QSGVideoMaterial_YUV420()
 {
-    if (!m_textureSize.isEmpty())
-        QOpenGLContext::currentContext()->functions()->glDeleteTextures(Num_Texture_IDs, m_textureIds);
+    if (!m_textureSize.isEmpty()) {
+        if (QOpenGLContext *current = QOpenGLContext::currentContext())
+            current->functions()->glDeleteTextures(Num_Texture_IDs, m_textureIds);
+        else
+            qWarning() << "QSGVideoMaterial_YUV420: Cannot obtain GL context, unable to delete textures";
+    }
 }
 
 void QSGVideoMaterial_YUV420::bind()