Класс QOpenGLDebugMessage
Класс QOpenGLDebugMessage оборачивает сообщение об отладке OpenGL. Подробнее...
| Заголовок: | #include <QOpenGLDebugMessage> |
| CMake: | find_package(Qt6 COMPONENTS OpenGL REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::OpenGL) |
| qmake: | QT += opengl |
| С тех пор: | Qt 5.1 |
Примечание: Все функции в этом классе являются реентерабельными.
Открытые типы
| флаги | Степень серьезности |
| перечисление | Severity { InvalidSeverity, HighSeverity, MediumSeverity, LowSeverity, NotificationSeverity, AnySeverity } |
| перечисление | Источник { InvalidSource, APISource, WindowSystemSource, ShaderCompilerSource, ThirdPartySource, …, AnySource } |
| флаги | Источники |
| перечисление | Тип { InvalidType, ErrorType, DeprecatedBehaviorType, UndefinedBehaviorType, PortabilityType, …, AnyType } |
| флаги | Типы |
Открытые функции
| QOpenGLDebugMessage(const QOpenGLDebugMessage &debugMessage) | |
| QOpenGLDebugMessage() | |
| QOpenGLDebugMessage & | operator=(QOpenGLDebugMessage &&debugMessage) |
| QOpenGLDebugMessage & | operator=(const QOpenGLDebugMessage &debugMessage) |
| ~QOpenGLDebugMessage() | |
| GLuint | id() const |
| QString | message() const |
| QOpenGLDebugMessage::Severity | severity() const |
| QOpenGLDebugMessage::Source | source() const |
| void | swap(QOpenGLDebugMessage &debugMessage) |
| QOpenGLDebugMessage::Type | type() const |
| bool | operator!=(const QOpenGLDebugMessage &debugMessage) const |
| bool | operator==(const QOpenGLDebugMessage &debugMessage) const |
Статические открытые члены
| QOpenGLDebugMessage | createApplicationMessage(const QString &text, GLuint id = 0, QOpenGLDebugMessage::Severity severity = NotificationSeverity, QOpenGLDebugMessage::Type type = OtherType) |
| QOpenGLDebugMessage | createThirdPartyMessage(const QString &text, GLuint id = 0, QOpenGLDebugMessage::Severity severity = NotificationSeverity, QOpenGLDebugMessage::Type type = OtherType) |
Связанные нечлены
| QDebug | operator<<(QDebug debug, QOpenGLDebugMessage::Source source) |
| QDebug | operator<<(QDebug debug, QOpenGLDebugMessage::Type type) |
| QDebug | operator<<(QDebug debug, QOpenGLDebugMessage::Severity severity) |
| QDebug | operator<<(QDebug debug, const QOpenGLDebugMessage &message) |
Подробное описание
Сообщения об отладке обычно создаются сервером OpenGL, а затем считываются клиентами OpenGL (либо из внутреннего журнала отладки OpenGL, либо в режиме реального времени). Сообщение об отладке имеет текстовое представление, специфический для поставщика числовой идентификатор, источник, тип и степень серьезности.
Также приложения или сторонние библиотеки и наборы инструментов могут создавать и вставлять сообщения в журнал отладки. Для этого можно использовать статические функции createApplicationMessage() или createThirdPartyMessage().
См. также QOpenGLDebugLogger.
Документация по типам членов
перечисление QOpenGLDebugMessage::Severity QOpenGLDebugMessage::Severities
Перечисление Severity определяет степень серьезности сообщения об отладке.
| Константа | Значение | Описание |
|---|---|---|
QOpenGLDebugMessage::InvalidSeverity |
0x00000000 |
Степень серьезности сообщения недействительна; это степень серьезности объекта QOpenGLDebugMessage, созданного по умолчанию. |
QOpenGLDebugMessage::HighSeverity |
0x00000001 |
Сообщение имеет высокую степень серьезности. |
QOpenGLDebugMessage::MediumSeverity |
0x00000002 |
Сообщение имеет среднюю степень серьезности. |
QOpenGLDebugMessage::LowSeverity |
0x00000004 |
Сообщение имеет низкую степень серьезности. |
QOpenGLDebugMessage::NotificationSeverity |
0x00000008 |
Сообщение является уведомлением. |
QOpenGLDebugMessage::AnySeverity |
0xffffffff |
Это значение соответствует маске всех возможных степеней серьезности сообщений. |
Тип Severities — это псевдоним для QFlags<Severity>. Он хранит логическое ИЛИ сочетание значений Severity.
перечисление QOpenGLDebugMessage::Source QOpenGLDebugMessage::Sources
Перечисление Source определяет источник сообщения об отладке.
| Константа | Значение | Описание |
|---|---|---|
QOpenGLDebugMessage::InvalidSource |
0x00000000 |
Источник сообщения недействителен; это источник объекта QOpenGLDebugMessage, созданного по умолчанию. |
QOpenGLDebugMessage::APISource |
0x00000001 |
Сообщение было сгенерировано в ответ на вызовы API OpenGL. |
QOpenGLDebugMessage::WindowSystemSource |
0x00000002 |
Сообщение было сгенерировано системными средствами отображения. |
QOpenGLDebugMessage::ShaderCompilerSource |
0x00000004 |
Сообщение было сгенерировано компилятором шейдеров. |
QOpenGLDebugMessage::ThirdPartySource |
0x00000008 |
Сообщение было сгенерировано третьей стороной, например, фреймворком OpenGL или инструментом отладки. |
QOpenGLDebugMessage::ApplicationSource |
0x00000010 |
Сообщение было сгенерировано самим приложением. |
QOpenGLDebugMessage::OtherSource |
0x00000020 |
Сообщение было сгенерировано источником, не включённым в это перечисление. |
QOpenGLDebugMessage::AnySource |
0xffffffff |
Это значение соответствует маске всех возможных источников сообщений. |
Тип Sources — это псевдоним для QFlags<Source>. Он хранит логическое ИЛИ сочетание значений Source.
перечисление QOpenGLDebugMessage::Typeфлаги QOpenGLDebugMessage::Types
Перечисление Type определяет тип сообщения отладки.
| Постоянная | Значение | Описание |
|---|---|---|
QOpenGLDebugMessage::InvalidType |
0x00000000 |
Тип сообщения недействителен; это тип объекта QOpenGLDebugMessage, созданного по умолчанию. |
QOpenGLDebugMessage::ErrorType |
0x00000001 |
Сообщение представляет ошибку. |
QOpenGLDebugMessage::DeprecatedBehaviorType |
0x00000002 |
Сообщение представляет использование устаревшего поведения. |
QOpenGLDebugMessage::UndefinedBehaviorType |
0x00000004 |
Сообщение представляет использование неопределённого поведения. |
QOpenGLDebugMessage::PortabilityType |
0x00000008 |
Сообщение представляет использование поведения, специфичного для поставщика, что может вызывать проблемы с переносимостью. |
QOpenGLDebugMessage::PerformanceType |
0x00000010 |
Сообщение представляет проблему производительности. |
QOpenGLDebugMessage::OtherType |
0x00000020 |
Сообщение представляет тип, не включённый в это перечисление. |
QOpenGLDebugMessage::MarkerType |
0x00000040 |
Сообщение представляет метку в журнале отладки. |
QOpenGLDebugMessage::GroupPushType |
0x00000080 |
Сообщение представляет операцию добавления в группу отладки. |
QOpenGLDebugMessage::GroupPopType |
0x00000100 |
Сообщение представляет операцию удаления из группы отладки. |
QOpenGLDebugMessage::AnyType |
0xffffffff |
Это значение соответствует маске всех возможных типов сообщений. |
Тип Types — это псевдоним для QFlags<Type>. Он хранит логическое ИЛИ сочетание значений Type.
Документация по функциям-членам
QOpenGLDebugMessage::QOpenGLDebugMessage(const QOpenGLDebugMessage &debugMessage)
Создаёт сообщение отладки как копию debugMessage.
См. также operator=().
QOpenGLDebugMessage::QOpenGLDebugMessage()
Создаёт сообщение отладки с пустой строкой сообщения, id, установленным в 0, источником, установленным в InvalidSource, типом, установленным в InvalidType, и уровнем важности, установленным в InvalidSeverity.
Примечание: Этот конструктор не следует использовать для создания сообщения отладки; вместо этого используйте статические функции createApplicationMessage() или createThirdPartyMessage().
См. также createApplicationMessage() и createThirdPartyMessage().
QOpenGLDebugMessage &QOpenGLDebugMessage::operator=(QOpenGLDebugMessage &&debugMessage)
Перемещает присвоение debugMessage данному объекту.
QOpenGLDebugMessage &QOpenGLDebugMessage::operator=(const QOpenGLDebugMessage &debugMessage)
Присваивает сообщение debugMessage данному объекту и возвращает ссылку на копию.
QOpenGLDebugMessage::~QOpenGLDebugMessage()
Уничтожает это сообщение отладки.
[static] QOpenGLDebugMessage QOpenGLDebugMessage::createApplicationMessage(const QString &text, GLuint id = 0, QOpenGLDebugMessage::Severity severity = NotificationSeverity, QOpenGLDebugMessage::Type type = OtherType)
Создаёт и возвращает сообщение отладки с текстом text, id id, уровнем важности severity и типом type. Источник сообщения будет установлен в ApplicationSource.
См. также QOpenGLDebugLogger::logMessage() и createThirdPartyMessage().
[static] QOpenGLDebugMessage QOpenGLDebugMessage::createThirdPartyMessage(const QString &text, GLuint id = 0, QOpenGLDebugMessage::Severity severity = NotificationSeverity, QOpenGLDebugMessage::Type type = OtherType)
Создаёт и возвращает сообщение отладки с текстом text, id id, уровнем важности severity и типом type. Источник сообщения будет установлен в ThirdPartySource.
См. также QOpenGLDebugLogger::logMessage() и createApplicationMessage().
GLuint QOpenGLDebugMessage::id() const
Возвращает id сообщения отладки. Ids, как правило, зависят от поставщика.
QString QOpenGLDebugMessage::message() const
Возвращает текстовое сообщение, содержащееся в этом сообщении отладки.
QOpenGLDebugMessage::Severity QOpenGLDebugMessage::severity() const
Возвращает уровень важности сообщения отладки.
QOpenGLDebugMessage::Source QOpenGLDebugMessage::source() const
Возвращает источник сообщения отладки.
void QOpenGLDebugMessage::swap(QOpenGLDebugMessage &debugMessage)
Меняет местами сообщение debugMessage с данным сообщением. Эта операция очень быстрая и никогда не терпит неудачу.
QOpenGLDebugMessage::Type QOpenGLDebugMessage::type() const
Возвращает тип сообщения отладки.
bool QOpenGLDebugMessage::operator!=(const QOpenGLDebugMessage &debugMessage) const
Возвращает true, если это сообщение отличается от debugMessage, или false в противном случае.
См. также operator==().
bool QOpenGLDebugMessage::operator==(const QOpenGLDebugMessage &debugMessage) const
Возвращает true, если это сообщение отладки равно debugMessage, или false в противном случае. Два сообщения отладки равны, если у них одинаковое текстовое сообщение, одинаковый id, одинаковый источник, одинаковый тип и одинаковый уровень важности.
См. также operator!=().
Связанные нечлены
QDebug operator<<(QDebug debug, QOpenGLDebugMessage::Source source)
Записывает источник source в объект отладки debug для целей отладки.
QDebug operator<<(QDebug debug, QOpenGLDebugMessage::Type type)
Записывает тип type в объект отладки debug для целей отладки.
QDebug operator<<(QDebug debug, QOpenGLDebugMessage::Severity severity)
Записывает уровень важности severity в объект отладки debug для целей отладки.
QDebug operator<<(QDebug debug, const QOpenGLDebugMessage &message)
Записывает сообщение message в объект отладки debug для целей отладки.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qopengldebugmessage.html
