1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
|
// Copyright (C) 2013 Klarälvdalens Datakonsult AB, a KDAB Group company, info@kdab.com, author Giuseppe D'Angelo <giuseppe.dangelo@kdab.com>
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
#ifndef QOPENGLDEBUG_H
#define QOPENGLDEBUG_H
#include <QtOpenGL/qtopenglglobal.h>
#ifndef QT_NO_OPENGL
#include <QtCore/qshareddata.h>
#include <QtCore/qflags.h>
#include <QtCore/qlist.h>
#include <QtCore/qmetatype.h>
#include <QtCore/qdebug.h>
#include <QtGui/qopenglcontext.h>
#if defined(Q_QDOC)
#undef GLuint
typedef unsigned int GLuint;
#endif
QT_BEGIN_NAMESPACE
class QOpenGLDebugLogger;
class QOpenGLDebugLoggerPrivate;
class QOpenGLDebugMessagePrivate;
class Q_OPENGL_EXPORT QOpenGLDebugMessage
{
public:
enum Source {
InvalidSource = 0x00000000,
APISource = 0x00000001,
WindowSystemSource = 0x00000002,
ShaderCompilerSource = 0x00000004,
ThirdPartySource = 0x00000008,
ApplicationSource = 0x00000010,
OtherSource = 0x00000020,
LastSource = OtherSource, // private API
AnySource = 0xffffffff
};
Q_DECLARE_FLAGS(Sources, Source)
enum Type {
InvalidType = 0x00000000,
ErrorType = 0x00000001,
DeprecatedBehaviorType = 0x00000002,
UndefinedBehaviorType = 0x00000004,
PortabilityType = 0x00000008,
PerformanceType = 0x00000010,
OtherType = 0x00000020,
MarkerType = 0x00000040,
GroupPushType = 0x00000080,
GroupPopType = 0x00000100,
LastType = GroupPopType, // private API
AnyType = 0xffffffff
};
Q_DECLARE_FLAGS(Types, Type)
enum Severity {
InvalidSeverity = 0x00000000,
HighSeverity = 0x00000001,
MediumSeverity = 0x00000002,
LowSeverity = 0x00000004,
NotificationSeverity = 0x00000008,
LastSeverity = NotificationSeverity, // private API
AnySeverity = 0xffffffff
};
Q_DECLARE_FLAGS(Severities, Severity)
QOpenGLDebugMessage();
QOpenGLDebugMessage(const QOpenGLDebugMessage &debugMessage);
QOpenGLDebugMessage &operator=(const QOpenGLDebugMessage &debugMessage);
QT_MOVE_ASSIGNMENT_OPERATOR_IMPL_VIA_PURE_SWAP(QOpenGLDebugMessage)
~QOpenGLDebugMessage();
void swap(QOpenGLDebugMessage &other) noexcept { d.swap(other.d); }
Source source() const;
Type type() const;
Severity severity() const;
GLuint id() const;
QString message() const;
static QOpenGLDebugMessage createApplicationMessage(const QString &text,
GLuint id = 0,
Severity severity = NotificationSeverity,
Type type = OtherType);
static QOpenGLDebugMessage createThirdPartyMessage(const QString &text,
GLuint id = 0,
Severity severity = NotificationSeverity,
Type type = OtherType);
bool operator==(const QOpenGLDebugMessage &debugMessage) const;
inline bool operator!=(const QOpenGLDebugMessage &debugMessage) const { return !operator==(debugMessage); }
private:
friend class QOpenGLDebugLogger;
friend class QOpenGLDebugLoggerPrivate;
QSharedDataPointer<QOpenGLDebugMessagePrivate> d;
};
Q_DECLARE_SHARED(QOpenGLDebugMessage)
Q_DECLARE_OPERATORS_FOR_FLAGS(QOpenGLDebugMessage::Sources)
Q_DECLARE_OPERATORS_FOR_FLAGS(QOpenGLDebugMessage::Types)
Q_DECLARE_OPERATORS_FOR_FLAGS(QOpenGLDebugMessage::Severities)
#ifndef QT_NO_DEBUG_STREAM
Q_OPENGL_EXPORT QDebug operator<<(QDebug debug, const QOpenGLDebugMessage &message);
Q_OPENGL_EXPORT QDebug operator<<(QDebug debug, QOpenGLDebugMessage::Source source);
Q_OPENGL_EXPORT QDebug operator<<(QDebug debug, QOpenGLDebugMessage::Type type);
Q_OPENGL_EXPORT QDebug operator<<(QDebug debug, QOpenGLDebugMessage::Severity severity);
#endif
class QOpenGLDebugLoggerPrivate;
class Q_OPENGL_EXPORT QOpenGLDebugLogger : public QObject
{
Q_OBJECT
Q_PROPERTY(LoggingMode loggingMode READ loggingMode)
public:
enum LoggingMode {
AsynchronousLogging,
SynchronousLogging
};
Q_ENUM(LoggingMode)
explicit QOpenGLDebugLogger(QObject *parent = nullptr);
~QOpenGLDebugLogger();
bool initialize();
bool isLogging() const;
LoggingMode loggingMode() const;
qint64 maximumMessageLength() const;
void pushGroup(const QString &name,
GLuint id = 0,
QOpenGLDebugMessage::Source source = QOpenGLDebugMessage::ApplicationSource);
void popGroup();
void enableMessages(QOpenGLDebugMessage::Sources sources = QOpenGLDebugMessage::AnySource,
QOpenGLDebugMessage::Types types = QOpenGLDebugMessage::AnyType,
QOpenGLDebugMessage::Severities severities = QOpenGLDebugMessage::AnySeverity);
void enableMessages(const QList<GLuint> &ids,
QOpenGLDebugMessage::Sources sources = QOpenGLDebugMessage::AnySource,
QOpenGLDebugMessage::Types types = QOpenGLDebugMessage::AnyType);
void disableMessages(QOpenGLDebugMessage::Sources sources = QOpenGLDebugMessage::AnySource,
QOpenGLDebugMessage::Types types = QOpenGLDebugMessage::AnyType,
QOpenGLDebugMessage::Severities severities = QOpenGLDebugMessage::AnySeverity);
void disableMessages(const QList<GLuint> &ids,
QOpenGLDebugMessage::Sources sources = QOpenGLDebugMessage::AnySource,
QOpenGLDebugMessage::Types types = QOpenGLDebugMessage::AnyType);
QList<QOpenGLDebugMessage> loggedMessages() const;
public Q_SLOTS:
void logMessage(const QOpenGLDebugMessage &debugMessage);
void startLogging(LoggingMode loggingMode = AsynchronousLogging);
void stopLogging();
Q_SIGNALS:
void messageLogged(const QOpenGLDebugMessage &debugMessage);
private:
Q_DISABLE_COPY(QOpenGLDebugLogger)
Q_DECLARE_PRIVATE(QOpenGLDebugLogger)
Q_PRIVATE_SLOT(d_func(), void _q_contextAboutToBeDestroyed())
};
QT_END_NAMESPACE
QT_DECL_METATYPE_EXTERN(QOpenGLDebugMessage, Q_OPENGL_EXPORT)
#endif // QT_NO_OPENGL
#endif // QOPENGLDEBUG_H
|
