En esta página

QOpenGLDebugMessage Class

La clase QOpenGLDebugMessage envuelve un mensaje de depuración de OpenGL. Más información...

Cabecera: #include <QOpenGLDebugMessage>
CMake: find_package(Qt6 REQUIRED COMPONENTS OpenGL)
target_link_libraries(mytarget PRIVATE Qt6::OpenGL)
qmake: QT += opengl

Nota: Todas las funciones de esta clase son reentrantes.

Tipos públicos

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

Funciones públicas

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

Miembros públicos estáticos

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)

Descripción detallada

Los mensajes de depuración suelen ser generados por el servidor OpenGL y, a continuación, leídos por los clientes OpenGL (ya sea desde el registro de depuración interno de OpenGL o registrados en tiempo real). Un mensaje de depuración tiene una representación textual, un identificador numérico específico del proveedor, un origen, un tipo y un nivel de gravedad.

También es posible que las aplicaciones o las bibliotecas y kits de herramientas de terceros creen e inserten mensajes en el registro de depuración. Para ello, se pueden utilizar las funciones estáticas ` createApplicationMessage()` o ` createThirdPartyMessage()`.

Véase también QOpenGLDebugLogger.

Documentación sobre tipos de miembro

enum QOpenGLDebugMessage::Severity
flags QOpenGLDebugMessage::Severities

La enumeración «Severity» define el nivel de gravedad del mensaje de depuración.

ConstanteValorDescripción
QOpenGLDebugMessage::InvalidSeverity0x00000000La gravedad del mensaje no es válida; esta es la gravedad de un objeto ` QOpenGLDebugMessage ` construido de forma predeterminada.
QOpenGLDebugMessage::HighSeverity0x00000001El mensaje tiene una gravedad alta.
QOpenGLDebugMessage::MediumSeverity0x00000002El mensaje tiene una gravedad media.
QOpenGLDebugMessage::LowSeverity0x00000004El mensaje tiene una gravedad baja.
QOpenGLDebugMessage::NotificationSeverity0x00000008El mensaje es una notificación.
QOpenGLDebugMessage::AnySeverity0xffffffffEste valor corresponde a una máscara de todas las severidades de mensaje posibles.

El tipo «Severities» es una definición de tipo (typedef) para QFlags<Severity>. Almacena una combinación OR de valores de gravedad.

enum QOpenGLDebugMessage::Source
flags QOpenGLDebugMessage::Sources

La enumeración «Source» define el origen del mensaje de depuración.

ConstanteValorDescripción
QOpenGLDebugMessage::InvalidSource0x00000000El origen del mensaje no es válido; se trata del origen de un objeto ` QOpenGLDebugMessage ` construido de forma predeterminada.
QOpenGLDebugMessage::APISource0x00000001El mensaje se generó en respuesta a llamadas a la API de OpenGL.
QOpenGLDebugMessage::WindowSystemSource0x00000002El mensaje fue generado por el sistema de ventanas.
QOpenGLDebugMessage::ShaderCompilerSource0x00000004El mensaje fue generado por el compilador de shaders.
QOpenGLDebugMessage::ThirdPartySource0x00000008El mensaje fue generado por un tercero, por ejemplo, un marco de trabajo de OpenGL o un kit de herramientas de depuración.
QOpenGLDebugMessage::ApplicationSource0x00000010El mensaje fue generado por la propia aplicación.
QOpenGLDebugMessage::OtherSource0x00000020El mensaje fue generado por una fuente no incluida en esta enumeración.
QOpenGLDebugMessage::AnySource0xffffffffEste valor corresponde a una máscara de todas las fuentes de mensajes posibles.

El tipo «Sources» es un typedef para QFlags<Source>. Almacena una combinación OR de valores de «Source».

enum QOpenGLDebugMessage::Type
flags QOpenGLDebugMessage::Types

La enumeración «Type» define el tipo del mensaje de depuración.

ConstanteValorDescripción
QOpenGLDebugMessage::InvalidType0x00000000El tipo del mensaje no es válido; se trata del tipo de un objeto ` QOpenGLDebugMessage ` construido de forma predeterminada.
QOpenGLDebugMessage::ErrorType0x00000001El mensaje representa un error.
QOpenGLDebugMessage::DeprecatedBehaviorType0x00000002El mensaje indica un uso de comportamiento obsoleto.
QOpenGLDebugMessage::UndefinedBehaviorType0x00000004El mensaje indica un uso de comportamiento indefinido.
QOpenGLDebugMessage::PortabilityType0x00000008El mensaje indica un uso de un comportamiento específico del proveedor, lo que podría plantear problemas de portabilidad.
QOpenGLDebugMessage::PerformanceType0x00000010El mensaje indica un problema de rendimiento.
QOpenGLDebugMessage::OtherType0x00000020El mensaje indica un tipo no incluido en esta enumeración.
QOpenGLDebugMessage::MarkerType0x00000040El mensaje representa un marcador en el registro de depuración.
QOpenGLDebugMessage::GroupPushType0x00000080El mensaje representa una operación de inserción en un grupo de depuración.
QOpenGLDebugMessage::GroupPopType0x00000100El mensaje representa una operación de extracción de un grupo de depuración.
QOpenGLDebugMessage::AnyType0xffffffffEste valor corresponde a una máscara de todos los tipos de mensajes posibles.

El tipo «Types» es una definición de tipo (typedef) para QFlags<Type>. Almacena una combinación OR de valores de «Type».

Documentación de las funciones de miembro

QOpenGLDebugMessage::QOpenGLDebugMessage()

Crea un mensaje de depuración con una cadena de mensaje vacía, el identificador establecido en 0, la fuente establecida en InvalidSource, el tipo establecido en InvalidType y la gravedad establecida en InvalidSeverity.

Nota: Este constructor no debe utilizarse para crear un mensaje de depuración; en su lugar, utilice las funciones estáticas createApplicationMessage() o createThirdPartyMessage().

Véase también createApplicationMessage() y createThirdPartyMessage().

QOpenGLDebugMessage::QOpenGLDebugMessage(const QOpenGLDebugMessage &debugMessage)

Crea un mensaje de depuración como copia de debugMessage.

Véase también operator=().

[noexcept] QOpenGLDebugMessage::~QOpenGLDebugMessage()

Elimina este mensaje de depuración.

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

Crea y devuelve un mensaje de depuración con el texto « text », el identificador « id », el nivel de gravedad « severity » y el tipo « type ». La fuente del mensaje se establecerá en « ApplicationSource ».

Véase también QOpenGLDebugLogger::logMessage() y createThirdPartyMessage().

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

Crea y devuelve un mensaje de depuración con el texto « text », el identificador « id », el nivel de gravedad « severity » y el tipo « type ». La fuente del mensaje se establecerá en « ThirdPartySource ».

Véase también QOpenGLDebugLogger::logMessage() y createApplicationMessage().

GLuint QOpenGLDebugMessage::id() const

Devuelve el identificador del mensaje de depuración. Los identificadores suelen ser específicos de cada proveedor.

QString QOpenGLDebugMessage::message() const

Devuelve el mensaje de texto que contiene este mensaje de depuración.

QOpenGLDebugMessage::Severity QOpenGLDebugMessage::severity() const

Devuelve el nivel de gravedad del mensaje de depuración.

QOpenGLDebugMessage::Source QOpenGLDebugMessage::source() const

Devuelve la fuente del mensaje de depuración.

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

Intercambia este mensaje con other. Esta operación es muy rápida y nunca falla.

QOpenGLDebugMessage::Type QOpenGLDebugMessage::type() const

Devuelve el tipo del mensaje de depuración.

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

Devuelve « true » si este mensaje es distinto de « debugMessage », o «false» en caso contrario.

Véase también operator==().

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

La instrucción «move» asigna « debugMessage » a este objeto.

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

Asigna el mensaje « debugMessage » a este objeto y devuelve una referencia a la copia.

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

Devuelve « true » si este mensaje de depuración es igual a « debugMessage », o «false» en caso contrario. Dos mensajes de depuración son iguales si tienen el mismo texto, el mismo identificador, la misma fuente, el mismo tipo y la misma gravedad.

Véase también operator!=().

Elementos no miembros relacionados

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

Escribe el nivel de gravedad severity en el objeto de depuración debug con fines de depuración.

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

Escribe la fuente source en el objeto de depuración debug con fines de depuración.

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

Escribe el tipo « type » en el objeto de depuración « debug » con fines de depuración.

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

Escribe el mensaje « message » en el objeto de depuración « debug » con fines de depuración.

© 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.