qgstreamervideosource.h

Go to the documentation of this file.

// Copyright (C) 2026 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 QGSTREAMERVIDEOSOURCE_H
#define QGSTREAMERVIDEOSOURCE_H
 
#include <QtCore/qobject.h>
#include <QtCore/qstring.h>
#include <QtMultimedia/qtmultimediaglobal.h>
 
// NOLINTBEGIN (bugprone-reserved-identifier)
typedef struct _GstElement GstElement;
// NOLINTEND (bugprone-reserved-identifier)
 
QT_BEGIN_NAMESPACE
 
class QPlatformCamera;
class QGstreamerVideoSourcePrivate;
class QMediaCaptureSession;
 
class Q_MULTIMEDIA_EXPORT QGstreamerVideoSource : public QObject
{
    Q_OBJECT
    Q_PROPERTY(bool active READ isActive WRITE setActive NOTIFY activeChanged)
    Q_PROPERTY(QString gstBinDescription READ gstBinDescription CONSTANT)
 
public:
    explicit QGstreamerVideoSource(const QString &gstBinDescription, QObject *parent = nullptr);
    explicit QGstreamerVideoSource(GstElement *gstElement, QObject *parent = nullptr);
    ~QGstreamerVideoSource() override;
 
    bool isActive() const;
    QString gstBinDescription() const;
    GstElement *gstElement() const;
    QMediaCaptureSession *captureSession() const;
 
public Q_SLOTS:
    void setActive(bool active);
    void start() { setActive(true); }
    void stop() { setActive(false); }
 
Q_SIGNALS:
    void activeChanged(bool active);
 
protected:
    explicit QGstreamerVideoSource(QObject *parent);
 
private:
    QPlatformCamera *platformVideoSource() const;
    void setCaptureSession(QMediaCaptureSession *session);
 
    Q_DISABLE_COPY(QGstreamerVideoSource)
    Q_DECLARE_PRIVATE(QGstreamerVideoSource)
    friend class QMediaCaptureSession;
};
 
QT_END_NAMESPACE
 
#endif // QGSTREAMERVIDEOSOURCE_H