En esta página

QOpenGLDebugMessage Class

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

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 creados por el servidor OpenGL y luego 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, una fuente, un tipo y una gravedad.

También es posible que las aplicaciones o las bibliotecas y 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 de tipos de miembros

enum QOpenGLDebugMessage::Severidad
flags QOpenGLDebugMessage::Severidades

El enum Severity define la severidad del mensaje de depuración.

ConstanteValorDescripción
QOpenGLDebugMessage::InvalidSeverity0x00000000La severidad del mensaje no es válida; esta es la severidad de un objeto QOpenGLDebugMessage construido por defecto.
QOpenGLDebugMessage::HighSeverity0x00000001El mensaje tiene una severidad 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 posibles severidades del mensaje.

El tipo Severities es un typedef para QFlags<Severity>. Almacena una combinación OR de valores de Severidad.

enum QOpenGLDebugMessage::Source
flags QOpenGLDebugMessage::Sources

El enum Source define el origen del mensaje de depuración.

ConstanteValorDescripción
QOpenGLDebugMessage::InvalidSource0x00000000La fuente del mensaje no es válida; es la fuente de un objeto QOpenGLDebugMessage construido por defecto.
QOpenGLDebugMessage::APISource0x00000001El mensaje fue generado en respuesta a llamadas de la API OpenGL.
QOpenGLDebugMessage::WindowSystemSource0x00000002El mensaje fue generado por el sistema de ventanas.
QOpenGLDebugMessage::ShaderCompilerSource0x00000004El mensaje ha sido generado por el compilador de shaders.
QOpenGLDebugMessage::ThirdPartySource0x00000008El mensaje fue generado por un tercero, por ejemplo un framework OpenGL o un kit de herramientas de depuración.
QOpenGLDebugMessage::ApplicationSource0x00000010El mensaje ha sido 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 posibles fuentes de mensajes.

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

enum QOpenGLDebugMessage::Type
flags QOpenGLDebugMessage::Types

El enum Type define el tipo del mensaje de depuración.

ConstanteValorDescripción
QOpenGLDebugMessage::InvalidType0x00000000El tipo del mensaje no es válido; es el tipo de un objeto QOpenGLDebugMessage construido por defecto.
QOpenGLDebugMessage::ErrorType0x00000001El mensaje representa un error.
QOpenGLDebugMessage::DeprecatedBehaviorType0x00000002El mensaje representa un uso de un comportamiento obsoleto.
QOpenGLDebugMessage::UndefinedBehaviorType0x00000004El mensaje representa un uso de un comportamiento no definido.
QOpenGLDebugMessage::PortabilityType0x00000008El mensaje representa un uso de un comportamiento específico del proveedor, que podría plantear problemas de portabilidad.
QOpenGLDebugMessage::PerformanceType0x00000010El mensaje representa un problema de rendimiento.
QOpenGLDebugMessage::OtherType0x00000020El mensaje representa 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 de grupo de depuración.
QOpenGLDebugMessage::GroupPopType0x00000100El mensaje representa una operación "pop" de grupo de depuración.
QOpenGLDebugMessage::AnyType0xffffffffEste valor corresponde a una máscara de todos los tipos de mensajes posibles.

El tipo Types es un typedef para QFlags<Type>. Almacena una combinación OR de valores Type.

Documentación de las funciones miembro

QOpenGLDebugMessage::QOpenGLDebugMessage()

Construye un mensaje de depuración con una cadena de mensaje vacía, id establecido a 0, source establecido a InvalidSource, type establecido a InvalidType, y severity establecido a 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)

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

Véase también operator=().

[noexcept] QOpenGLDebugMessage::~QOpenGLDebugMessage()

Destruye este mensaje de depuración.

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

Construye y devuelve un mensaje de depuración con text como texto, id como id, severity como gravedad y type como tipo. El origen del mensaje será 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)

Construye y devuelve un mensaje de depuración con text como texto, id como id, severity como gravedad y type como tipo. El origen del mensaje será ThirdPartySource.

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

GLuint QOpenGLDebugMessage::id() const

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

QString QOpenGLDebugMessage::message() const

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

QOpenGLDebugMessage::Severity QOpenGLDebugMessage::severity() const

Devuelve la gravedad del mensaje de depuración.

QOpenGLDebugMessage::Source QOpenGLDebugMessage::source() const

Devuelve el origen del mensaje de depuración.

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

Cambia este mensaje] por 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 diferente de debugMessage, o false en caso contrario.

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

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

Mover-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 mensaje textual, el mismo id, el mismo origen, el mismo tipo y la misma severidad.

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

No miembros relacionados

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

Escribe la 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.