1// Copyright (C) 2024 The Qt Company Ltd.
2// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
3
4#ifndef QGST_DISCOVERER_P_H
5#define QGST_DISCOVERER_P_H
6
7//
8// W A R N I N G
9// -------------
10//
11// This file is not part of the Qt API. It exists purely as an
12// implementation detail. This header file may change from version to
13// version without notice, or even be removed.
14//
15// We mean it.
16//
17
18#include <QtCore/qglobal.h>
19#include <QtCore/qlocale.h>
20#include <QtCore/qsize.h>
21#include <QtCore/private/qexpected_p.h>
22
23#include <QtMultimedia/private/qmultimediautils_p.h>
24
25#include "qgst_p.h"
26#include "qgst_handle_types_p.h"
27
28#include <gst/pbutils/gstdiscoverer.h>
29
30#include <vector>
31
32QT_BEGIN_NAMESPACE
33
34class QMediaMetaData;
35
36namespace QGst {
37
38using QGstDiscovererHandle = QGstImpl::QGstHandleHelper<GstDiscoverer>::SharedHandle;
39using QGstDiscovererInfoHandle = QGstImpl::QGstHandleHelper<GstDiscovererInfo>::SharedHandle;
40using QGstDiscovererAudioInfoHandle =
41 QGstImpl::QGstHandleHelper<GstDiscovererAudioInfo>::SharedHandle;
42using QGstDiscovererVideoInfoHandle =
43 QGstImpl::QGstHandleHelper<GstDiscovererVideoInfo>::SharedHandle;
44using QGstDiscovererSubtitleInfoHandle =
45 QGstImpl::QGstHandleHelper<GstDiscovererSubtitleInfo>::SharedHandle;
46using QGstDiscovererStreamInfoHandle =
47 QGstImpl::QGstHandleHelper<GstDiscovererStreamInfo>::SharedHandle;
48
49struct QGstDiscovererStreamInfo
50{
51 int streamNumber{};
52 QString streamID;
53 QGstTagListHandle tags;
54 QGstCaps caps;
55};
56
57struct QGstDiscovererVideoInfo : QGstDiscovererStreamInfo
58{
59 QSize size;
60 int bitDepth{};
61 Fraction framerate{};
62 Fraction pixelAspectRatio{};
63 bool isInterlaced{};
64 int bitrate{};
65 int maxBitrate{};
66 bool isImage{};
67};
68
69struct QGstDiscovererAudioInfo : QGstDiscovererStreamInfo
70{
71 int channels{};
72 uint64_t channelMask{};
73 int sampleRate{};
74 int bitsPerSample{};
75 int bitrate{};
76 int maxBitrate{};
77 QLocale::Language language{};
78};
79
80struct QGstDiscovererSubtitleInfo : QGstDiscovererStreamInfo
81{
82 QLocale::Language language{};
83};
84
85struct QGstDiscovererContainerInfo : QGstDiscovererStreamInfo
86{
87 QGstTagListHandle tags;
88};
89
90struct QGstDiscovererInfo
91{
92 bool isLive{};
93 bool isSeekable{};
94 std::optional<std::chrono::nanoseconds> duration;
95
96 std::optional<QGstDiscovererContainerInfo> containerInfo;
97 QGstTagListHandle tags;
98 std::vector<QGstDiscovererVideoInfo> videoStreams;
99 std::vector<QGstDiscovererAudioInfo> audioStreams;
100 std::vector<QGstDiscovererSubtitleInfo> subtitleStreams;
101 std::vector<QGstDiscovererContainerInfo> containerStreams;
102};
103
104// For now we only perform synchronous discovery. Our future selves may want to perform the
105// discovery asynchronously.
106class QGstDiscoverer
107{
108public:
109 QGstDiscoverer();
110
111 q23::expected<QGstDiscovererInfo, QUniqueGErrorHandle> discover(const QString &uri);
112 q23::expected<QGstDiscovererInfo, QUniqueGErrorHandle> discover(const QUrl &);
113 q23::expected<QGstDiscovererInfo, QUniqueGErrorHandle> discover(QIODevice *);
114
115private:
116 q23::expected<QGstDiscovererInfo, QUniqueGErrorHandle> discover(const char *);
117 QGstDiscovererHandle m_instance;
118};
119
120QMediaMetaData toContainerMetadata(const QGstDiscovererInfo &);
121QMediaMetaData toStreamMetadata(const QGstDiscovererVideoInfo &);
122QMediaMetaData toStreamMetadata(const QGstDiscovererAudioInfo &);
123QMediaMetaData toStreamMetadata(const QGstDiscovererSubtitleInfo &);
124
125} // namespace QGst
126
127QT_END_NAMESPACE
128
129#endif // QGST_DISCOVERER_P_H
130

source code of qtmultimedia/src/plugins/multimedia/gstreamer/common/qgst_discoverer_p.h