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 QHWVIDEOBUFFER_P_H |
5 | #define QHWVIDEOBUFFER_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 "qabstractvideobuffer.h" |
19 | #include "qvideoframe.h" |
20 | |
21 | #include <QtGui/qmatrix4x4.h> |
22 | |
23 | QT_BEGIN_NAMESPACE |
24 | |
25 | class QRhi; |
26 | class QRhiTexture; |
27 | class QVideoFrame; |
28 | |
29 | /** |
30 | * @brief QVideoFrameTexturesHandles is the base class, providing texture handles for frame planes. |
31 | * Instances of the class may own textures, share ownership, or refer to inner hw textures |
32 | * of QVideoFrame. Referencing to inner frame's textures without shared ownership is |
33 | * not recommended, we strive to get around it; if texture are referencing, |
34 | * the source frame must be kept in QVideoFrameTextures's instance |
35 | * (see QVideoFrameTextures::setSourceFrame). |
36 | */ |
37 | class Q_MULTIMEDIA_EXPORT QVideoFrameTexturesHandles |
38 | { |
39 | public: |
40 | virtual ~QVideoFrameTexturesHandles(); |
41 | |
42 | virtual quint64 textureHandle(QRhi &, int /*plane*/) { return 0; }; |
43 | }; |
44 | using QVideoFrameTexturesHandlesUPtr = std::unique_ptr<QVideoFrameTexturesHandles>; |
45 | |
46 | /** |
47 | * @brief QVideoFrameTextures is the base class representing an abstraction layer |
48 | * between QVideoFrame's texture(s) and rhi's plane textures. |
49 | * QVideoFrameTextures must own the inner rhi textures or |
50 | * share ownership. QVideoFrameTextures instances are propagated to |
51 | * QVideoFrameTexturesPool, where their lifetime is managed |
52 | * according to results of QRhi::currentFrameSlot upon rendering. |
53 | * |
54 | */ |
55 | class Q_MULTIMEDIA_EXPORT QVideoFrameTextures |
56 | { |
57 | public: |
58 | virtual ~QVideoFrameTextures(); |
59 | virtual QRhiTexture *texture(uint plane) const = 0; |
60 | |
61 | /** |
62 | * @brief The virtual method should be invoked after QRhi::endFrame to unmap and free |
63 | * internal resources that are not needed anymore. |
64 | */ |
65 | virtual void onFrameEndInvoked() { } |
66 | |
67 | virtual QVideoFrameTexturesHandlesUPtr takeHandles() { return nullptr; } |
68 | |
69 | /** |
70 | * @brief Sets the source frame. It is a temporary solution to delegate |
71 | * frame's shared ownership to the instance. |
72 | * Ideally, the creators of QVideoFrameTextures's or QVideoFrameTexturesHandles's |
73 | * instances should manage ownership. |
74 | */ |
75 | void setSourceFrame(QVideoFrame sourceFrame) { m_sourceFrame = std::move(sourceFrame); } |
76 | |
77 | private: |
78 | QVideoFrame m_sourceFrame; |
79 | }; |
80 | using QVideoFrameTexturesUPtr = std::unique_ptr<QVideoFrameTextures>; |
81 | |
82 | class Q_MULTIMEDIA_EXPORT QHwVideoBuffer : public QAbstractVideoBuffer, |
83 | public QVideoFrameTexturesHandles |
84 | { |
85 | public: |
86 | QHwVideoBuffer(QVideoFrame::HandleType type, QRhi *rhi = nullptr); |
87 | |
88 | ~QHwVideoBuffer() override; |
89 | |
90 | QVideoFrame::HandleType handleType() const { return m_type; } |
91 | virtual QRhi *rhi() const { return m_rhi; } |
92 | |
93 | QVideoFrameFormat format() const override { return {}; } |
94 | |
95 | virtual QMatrix4x4 externalTextureMatrix() const { return {}; } |
96 | |
97 | virtual QVideoFrameTexturesUPtr mapTextures(QRhi &, QVideoFrameTexturesUPtr& /*oldTextures*/) { return nullptr; }; |
98 | |
99 | virtual void initTextureConverter(QRhi &) { } |
100 | |
101 | protected: |
102 | QVideoFrame::HandleType m_type; |
103 | QRhi *m_rhi = nullptr; |
104 | }; |
105 | |
106 | QT_END_NAMESPACE |
107 | |
108 | #endif // QHWVIDEOBUFFER_P_H |
109 | |