Sur cette page

QOpenGLDebugMessage Class

La classe QOpenGLDebugMessage contient un message de débogage OpenGL. Plus d'informations...

En-tête : #include <QOpenGLDebugMessage>
CMake : find_package(Qt6 REQUIRED COMPONENTS OpenGL)
target_link_libraries(mytarget PRIVATE Qt6::OpenGL)
qmake : QT += opengl

Remarque : toutes les fonctions de cette classe sont réentrantes.

Types publics

flags Severities
enum Severity { InvalidSeverity, HighSeverity, MediumSeverity, LowSeverity, NotificationSeverity, AnySeverity }
enum Source { InvalidSource, APISource, WindowSystemSource, ShaderCompilerSource, ThirdPartySource, …, AnySource }
flags Sources
enum Type { InvalidType, ErrorType, DeprecatedBehaviorType, UndefinedBehaviorType, PortabilityType, …, AnyType }
flags Types

Fonctions publiques

QOpenGLDebugMessage()
QOpenGLDebugMessage(const QOpenGLDebugMessage &debugMessage)
~QOpenGLDebugMessage()
GLuint id() const
QString message() const
QOpenGLDebugMessage::Severity severity() const
QOpenGLDebugMessage::Source source() const
void swap(QOpenGLDebugMessage &other)
QOpenGLDebugMessage::Type type() const
bool operator!=(const QOpenGLDebugMessage &debugMessage) const
QOpenGLDebugMessage &operator=(QOpenGLDebugMessage &&debugMessage)
QOpenGLDebugMessage &operator=(const QOpenGLDebugMessage &debugMessage)
bool operator==(const QOpenGLDebugMessage &debugMessage) const

Membres publics statiques

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::Severity severity)
QDebug operator<<(QDebug debug, QOpenGLDebugMessage::Source source)
QDebug operator<<(QDebug debug, QOpenGLDebugMessage::Type type)
QDebug operator<<(QDebug debug, const QOpenGLDebugMessage &message)

Description détaillée

Les messages de débogage sont généralement créés par le serveur OpenGL et ensuite lus par les clients OpenGL (soit à partir du journal de débogage interne d'OpenGL, soit enregistrés en temps réel). Un message de débogage a une représentation textuelle, un identifiant numérique spécifique au fournisseur, une source, un type et une gravité.

Il est également possible pour les applications, les bibliothèques tierces et les boîtes à outils de créer et d'insérer des messages dans le journal de débogage. Pour ce faire, vous pouvez utiliser les fonctions statiques createApplicationMessage() ou createThirdPartyMessage().

Voir également QOpenGLDebugLogger.

Documentation des types de membres

enum QOpenGLDebugMessage::Severity
flags QOpenGLDebugMessage::Severities

L'enum Severity définit la gravité du message de débogage.

ConstanteValeurDescription
QOpenGLDebugMessage::InvalidSeverity0x00000000La gravité du message n'est pas valide ; il s'agit de la gravité d'un objet QOpenGLDebugMessage construit par défaut.
QOpenGLDebugMessage::HighSeverity0x00000001Le message a une gravité élevée.
QOpenGLDebugMessage::MediumSeverity0x00000002Le message a une gravité moyenne.
QOpenGLDebugMessage::LowSeverity0x00000004Le message a une gravité faible.
QOpenGLDebugMessage::NotificationSeverity0x00000008Le message est une notification.
QOpenGLDebugMessage::AnySeverity0xffffffffCette valeur correspond à un masque de toutes les sévérités possibles du message.

Le type Severities est un typedef pour QFlags<Severity>. Il stocke une combinaison OU de valeurs de gravité.

enum QOpenGLDebugMessage::Source
flags QOpenGLDebugMessage::Sources

L'enum Source définit la source du message de débogage.

ConstanteValeurDescription
QOpenGLDebugMessage::InvalidSource0x00000000La source du message n'est pas valide ; il s'agit de la source d'un objet QOpenGLDebugMessage construit par défaut.
QOpenGLDebugMessage::APISource0x00000001Le message a été généré en réponse à des appels de l'API OpenGL.
QOpenGLDebugMessage::WindowSystemSource0x00000002Le message a été généré par le système de fenêtres.
QOpenGLDebugMessage::ShaderCompilerSource0x00000004Le message a été généré par le compilateur de shaders.
QOpenGLDebugMessage::ThirdPartySource0x00000008Le message a été généré par une tierce partie, par exemple un cadre OpenGL ou une boîte à outils de débogage.
QOpenGLDebugMessage::ApplicationSource0x00000010Le message a été généré par l'application elle-même.
QOpenGLDebugMessage::OtherSource0x00000020Le message a été généré par une source non incluse dans cette énumération.
QOpenGLDebugMessage::AnySource0xffffffffCette valeur correspond à un masque de toutes les sources de messages possibles.

Le type Sources est un typedef pour QFlags<Source>. Il stocke une combinaison OU de valeurs Source.

enum QOpenGLDebugMessage::Type
flags QOpenGLDebugMessage::Types

L'enum Type définit le type du message de débogage.

ConstanteValeurDescription
QOpenGLDebugMessage::InvalidType0x00000000Le type du message n'est pas valide ; il s'agit du type d'un objet QOpenGLDebugMessage construit par défaut.
QOpenGLDebugMessage::ErrorType0x00000001Le message représente une erreur.
QOpenGLDebugMessage::DeprecatedBehaviorType0x00000002Le message représente une utilisation d'un comportement déprécié.
QOpenGLDebugMessage::UndefinedBehaviorType0x00000004Le message représente l'utilisation d'un comportement non défini.
QOpenGLDebugMessage::PortabilityType0x00000008Le message représente l'utilisation d'un comportement spécifique au fournisseur, qui pourrait poser des problèmes de portabilité.
QOpenGLDebugMessage::PerformanceType0x00000010Le message représente un problème de performance.
QOpenGLDebugMessage::OtherType0x00000020Le message représente un type non inclus dans cette énumération.
QOpenGLDebugMessage::MarkerType0x00000040Le message représente un marqueur dans le journal de débogage.
QOpenGLDebugMessage::GroupPushType0x00000080Le message représente une opération de poussée de groupe de débogage.
QOpenGLDebugMessage::GroupPopType0x00000100Le message représente une opération de débogage de groupe.
QOpenGLDebugMessage::AnyType0xffffffffCette valeur correspond à un masque de tous les types de messages possibles.

Le type Types est un typedef pour QFlags<Type>. Il stocke une combinaison OR de valeurs de type.

Documentation des fonctions membres

QOpenGLDebugMessage::QOpenGLDebugMessage()

Construit un message de débogage avec une chaîne de message vide, un identifiant à 0, une source à InvalidSource, un type à InvalidType, et une gravité à InvalidSeverity.

Remarque : ce constructeur ne doit pas être utilisé pour créer un message de débogage ; utilisez plutôt les fonctions statiques createApplicationMessage() ou createThirdPartyMessage().

Voir aussi createApplicationMessage() et createThirdPartyMessage().

QOpenGLDebugMessage::QOpenGLDebugMessage(const QOpenGLDebugMessage &debugMessage)

Construit un message de débogage sous la forme d'une copie de debugMessage.

Voir aussi operator=().

[noexcept] QOpenGLDebugMessage::~QOpenGLDebugMessage()

Détruit ce message de débogage.

[static] QOpenGLDebugMessage QOpenGLDebugMessage::createApplicationMessage(const QString &text, GLuint id = 0, QOpenGLDebugMessage::Severity severity = NotificationSeverity, QOpenGLDebugMessage::Type type = OtherType)

Construit et renvoie un message de débogage avec text comme texte, id comme identifiant, severity comme gravité et type comme type. La source du message sera définie à ApplicationSource.

Voir aussi QOpenGLDebugLogger::logMessage() et createThirdPartyMessage().

[static] QOpenGLDebugMessage QOpenGLDebugMessage::createThirdPartyMessage(const QString &text, GLuint id = 0, QOpenGLDebugMessage::Severity severity = NotificationSeverity, QOpenGLDebugMessage::Type type = OtherType)

Construit et renvoie un message de débogage avec text comme texte, id comme identifiant, severity comme gravité et type comme type. La source du message sera définie à ThirdPartySource.

Voir aussi QOpenGLDebugLogger::logMessage() et createApplicationMessage().

GLuint QOpenGLDebugMessage::id() const

Renvoie l'identifiant du message de débogage. Les identifiants sont généralement propres à chaque fournisseur.

QString QOpenGLDebugMessage::message() const

Renvoie le message textuel contenu dans ce message de débogage.

QOpenGLDebugMessage::Severity QOpenGLDebugMessage::severity() const

Renvoie la gravité du message de débogage.

QOpenGLDebugMessage::Source QOpenGLDebugMessage::source() const

Renvoie la source du message de débogage.

[noexcept] void QOpenGLDebugMessage::swap(QOpenGLDebugMessage &other)

Remplace ce message] par other. Cette opération est très rapide et n'échoue jamais.

QOpenGLDebugMessage::Type QOpenGLDebugMessage::type() const

Renvoie le type de message de débogage.

bool QOpenGLDebugMessage::operator!=(const QOpenGLDebugMessage &debugMessage) const

Renvoie true si ce message est différent de debugMessage, ou false dans le cas contraire.

Voir aussi operator==().

[noexcept] QOpenGLDebugMessage &QOpenGLDebugMessage::operator=(QOpenGLDebugMessage &&debugMessage)

Déplacer - assigne debugMessage à cet objet.

QOpenGLDebugMessage &QOpenGLDebugMessage::operator=(const QOpenGLDebugMessage &debugMessage)

Attribue le message debugMessage à cet objet et renvoie une référence à la copie.

bool QOpenGLDebugMessage::operator==(const QOpenGLDebugMessage &debugMessage) const

Renvoie true si ce message de débogage est égal à debugMessage, ou false dans le cas contraire. Deux messages de débogage sont égaux s'ils ont le même message textuel, le même identifiant, la même source, le même type et la même gravité.

Voir également operator!=().

Non-membres apparentés

QDebug operator<<(QDebug debug, QOpenGLDebugMessage::Severity severity)

Écrit la gravité severity dans l'objet de débogage debug à des fins de débogage.

QDebug operator<<(QDebug debug, QOpenGLDebugMessage::Source source)

Écrit la source source dans l'objet de débogage debug à des fins de débogage.

QDebug operator<<(QDebug debug, QOpenGLDebugMessage::Type type)

Écrit le type type dans l'objet de débogage debug à des fins de débogage.

QDebug operator<<(QDebug debug, const QOpenGLDebugMessage &message)

Écrit le message message dans l'objet de débogage debug à des fins de débogage.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.