1/****************************************************************************
2**
3** Copyright (C) 2016 The Qt Company Ltd.
4** Contact: https://www.qt.io/licensing/
5**
6** This file is part of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:LGPL$
9** Commercial License Usage
10** Licensees holding valid commercial Qt licenses may use this file in
11** accordance with the commercial license agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and The Qt Company. For licensing terms
14** and conditions see https://www.qt.io/terms-conditions. For further
15** information use the contact form at https://www.qt.io/contact-us.
16**
17** GNU Lesser General Public License Usage
18** Alternatively, this file may be used under the terms of the GNU Lesser
19** General Public License version 3 as published by the Free Software
20** Foundation and appearing in the file LICENSE.LGPL3 included in the
21** packaging of this file. Please review the following information to
22** ensure the GNU Lesser General Public License version 3 requirements
23** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
24**
25** GNU General Public License Usage
26** Alternatively, this file may be used under the terms of the GNU
27** General Public License version 2.0 or (at your option) the GNU General
28** Public license version 3 or any later version approved by the KDE Free
29** Qt Foundation. The licenses are as published by the Free Software
30** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
31** included in the packaging of this file. Please review the following
32** information to ensure the GNU General Public License requirements will
33** be met: https://www.gnu.org/licenses/gpl-2.0.html and
34** https://www.gnu.org/licenses/gpl-3.0.html.
35**
36** $QT_END_LICENSE$
37**
38****************************************************************************/
39
40#ifndef QABSTRACTVIDEOBUFFER_H
41#define QABSTRACTVIDEOBUFFER_H
42
43#include <QtMultimedia/qtmultimediaglobal.h>
44#include <QtMultimedia/qmultimedia.h>
45
46
47#include <QtCore/qmetatype.h>
48
49QT_BEGIN_NAMESPACE
50
51
52class QVariant;
53
54class QAbstractVideoBufferPrivate;
55
56class Q_MULTIMEDIA_EXPORT QAbstractVideoBuffer
57{
58public:
59 enum HandleType
60 {
61 NoHandle,
62 GLTextureHandle,
63 XvShmImageHandle,
64 CoreImageHandle,
65 QPixmapHandle,
66 EGLImageHandle,
67 GLTextureRectangleHandle,
68 UserHandle = 1000
69 };
70
71 enum MapMode
72 {
73 NotMapped = 0x00,
74 ReadOnly = 0x01,
75 WriteOnly = 0x02,
76 ReadWrite = ReadOnly | WriteOnly
77 };
78
79 QAbstractVideoBuffer(HandleType type);
80 virtual ~QAbstractVideoBuffer();
81 virtual void release();
82
83 HandleType handleType() const;
84
85 virtual MapMode mapMode() const = 0;
86
87 virtual uchar *map(MapMode mode, int *numBytes, int *bytesPerLine) = 0;
88 int mapPlanes(MapMode mode, int *numBytes, int bytesPerLine[4], uchar *data[4]);
89 virtual void unmap() = 0;
90
91 virtual QVariant handle() const;
92
93protected:
94 QAbstractVideoBuffer(QAbstractVideoBufferPrivate &dd, HandleType type);
95
96 QAbstractVideoBufferPrivate *d_ptr; // For expansion, not used currently
97 HandleType m_type;
98
99private:
100 Q_DECLARE_PRIVATE(QAbstractVideoBuffer)
101 Q_DISABLE_COPY(QAbstractVideoBuffer)
102};
103
104class QAbstractPlanarVideoBufferPrivate;
105class Q_MULTIMEDIA_EXPORT QAbstractPlanarVideoBuffer : public QAbstractVideoBuffer
106{
107public:
108 QAbstractPlanarVideoBuffer(HandleType type);
109 virtual ~QAbstractPlanarVideoBuffer();
110
111 uchar *map(MapMode mode, int *numBytes, int *bytesPerLine) override;
112 virtual int map(MapMode mode, int *numBytes, int bytesPerLine[4], uchar *data[4]) = 0;
113
114protected:
115 QAbstractPlanarVideoBuffer(QAbstractPlanarVideoBufferPrivate &dd, HandleType type);
116
117private:
118 Q_DISABLE_COPY(QAbstractPlanarVideoBuffer)
119};
120
121#ifndef QT_NO_DEBUG_STREAM
122Q_MULTIMEDIA_EXPORT QDebug operator<<(QDebug, QAbstractVideoBuffer::HandleType);
123Q_MULTIMEDIA_EXPORT QDebug operator<<(QDebug, QAbstractVideoBuffer::MapMode);
124#endif
125
126QT_END_NAMESPACE
127
128Q_DECLARE_METATYPE(QAbstractVideoBuffer::HandleType)
129Q_DECLARE_METATYPE(QAbstractVideoBuffer::MapMode)
130
131#endif
132

source code of qtmultimedia/src/multimedia/video/qabstractvideobuffer.h