En esta página

QOpenGLTimerQuery Class

La clase QOpenGLTimerQuery envuelve un objeto de consulta de temporizador de OpenGL. Más...

Encabezado: #include <QOpenGLTimerQuery>
CMake: find_package(Qt6 REQUIRED COMPONENTS OpenGL)
target_link_libraries(mytarget PRIVATE Qt6::OpenGL)
qmake: QT += opengl
Heredado de: QObject

Funciones públicas

QOpenGLTimerQuery(QObject *parent = nullptr)
virtual ~QOpenGLTimerQuery()
void begin()
bool create()
void destroy()
void end()
bool isCreated() const
bool isResultAvailable() const
GLuint objectId() const
void recordTimestamp()
GLuint64 waitForResult() const
GLuint64 waitForTimestamp() const

Descripción detallada

Los objetos de consulta de temporizador de OpenGL son recursos gestionados por OpenGL que permiten medir los tiempos de ejecución de secuencias de comandos de OpenGL en la GPU.

OpenGL ofrece distintos niveles de compatibilidad con las consultas de temporizador, dependiendo de la versión de OpenGL que se tenga y de la presencia de las extensiones ARB_timer_query o EXT_timer_query. La compatibilidad se puede resumir de la siguiente manera:

  • OpenGL >= 3.3 ofrece compatibilidad total con todas las funciones de consulta de temporizador.
  • OpenGL 3.2 con la extensión ARB_timer_query ofrece compatibilidad completa con todas las funciones de consulta de temporizador.
  • Qt OpenGL <= 3.2 con la extensión EXT_timer_query ofrece compatibilidad limitada, ya que no se puede consultar la marca de tiempo de la GPU. Los casos en los que esto afecte a las funciones proporcionadas por las clases de Qt se destacarán en la documentación de las funciones.
  • OpenGL ES 2 (y OpenGL ES 3) no ofrecen compatibilidad alguna con las consultas de temporizador de OpenGL.

OpenGL representa el tiempo con una granularidad de 1 nanosegundo (1e-9 segundos). Como consecuencia de ello, los enteros de 32 bits solo permitirían una duración total de aproximadamente 4 segundos, lo que no sería difícil de superar en operaciones de bajo rendimiento o de larga duración. Por lo tanto, OpenGL utiliza tipos enteros de 64 bits para representar los tiempos. Una variable GLuint64 tiene suficiente anchura para contener una duración de cientos de años, lo cual es más que suficiente para las necesidades de renderizado en tiempo real.

Al igual que con las demás clases de Qt OpenGL, QOpenGLTimerQuery dispone de una función create() para crear el objeto OpenGL subyacente. Esto permite al desarrollador asegurarse de que existe un contexto OpenGL válido en ese momento.

Una vez creado, las consultas del temporizador pueden realizarse de varias maneras. El método más sencillo consiste en delimitar un bloque de comandos con llamadas a ` begin()` y ` end()`. Esto indica a OpenGL que mida el tiempo transcurrido desde la finalización de todos los comandos emitidos antes de ` begin()` hasta la finalización de todos los comandos emitidos antes de ` end()`.

Al final de un fotograma, podemos recuperar los resultados llamando a waitForResult(). Como indica el nombre de esta función, bloquea la ejecución de la CPU hasta que OpenGL notifica que el resultado de la consulta del temporizador está disponible. Para evitar el bloqueo, puedes comprobar si el resultado de la consulta está disponible llamando a isResultAvailable(). Ten en cuenta que las GPU modernas cuentan con un pipelining muy profundo y es posible que los resultados de las consultas no estén disponibles hasta entre 1 y 5 fotogramas después de su emisión.

Ten en cuenta que OpenGL no permite anidar ni intercalar múltiples consultas de temporizador utilizando begin() y end(). El uso de múltiples consultas de temporizador y recordTimestamp() evita esta limitación. Al utilizar recordTimestamp(), el resultado se puede obtener más tarde mediante isResultAvailable() y waitForResult(). Qt proporciona la clase de conveniencia QOpenGLTimeMonitor, que facilita el uso de múltiples objetos de consulta.

Véase también QOpenGLTimeMonitor.

Documentación de funciones miembro

[explicit] QOpenGLTimerQuery::QOpenGLTimerQuery(QObject *parent = nullptr)

Crea una instancia de `QOpenGLTimerQuery` con el ` parent` indicado. Antes de utilizarla, debes llamar a ` create()` con un contexto de OpenGL válido.

[virtual noexcept] QOpenGLTimerQuery::~QOpenGLTimerQuery()

Elimina el objeto ` QOpenGLTimerQuery ` y el recurso OpenGL subyacente.

void QOpenGLTimerQuery::begin()

Marca el punto de inicio en la cola de comandos de OpenGL para una secuencia de comandos cuya sincronización se controlará mediante este objeto de consulta.

Esto resulta útil para casos de uso sencillos. Por lo general, es mejor utilizar ` recordTimestamp()`.

Véase también end(), isResultAvailable(), waitForResult() y recordTimestamp().

bool QOpenGLTimerQuery::create()

Crea el objeto de consulta del temporizador de OpenGL subyacente. Para que esta función se ejecute correctamente, debe existir un contexto de OpenGL válido que admita objetos de consulta.

Devuelve « true » si el objeto de consulta del temporizador de OpenGL se ha creado correctamente.

void QOpenGLTimerQuery::destroy()

Destruye el objeto de consulta del temporizador OpenGL subyacente. El contexto que estaba activo en el momento en que se llamó a ` create()` debe ser el mismo que esté activo al llamar a esta función.

void QOpenGLTimerQuery::end()

Marca el punto final en la cola de comandos de OpenGL para una secuencia de comandos cuya ejecución debe ser cronometrada por este objeto de consulta.

Esto resulta útil para casos de uso sencillos. Por lo general, es mejor utilizar recordTimestamp().

Véanse también begin(), isResultAvailable(), waitForResult() y recordTimestamp().

bool QOpenGLTimerQuery::isCreated() const

Devuelve ` true ` si se ha creado el objeto de consulta OpenGL subyacente. Si devuelve ` true ` y el contexto OpenGL asociado es el actual, entonces podrás realizar consultas con este objeto.

bool QOpenGLTimerQuery::isResultAvailable() const

Devuelve ` true ` si el resultado de la consulta del temporizador de OpenGL está disponible.

Esta función es no bloqueante y, en principio, debería utilizarse para comprobar la disponibilidad del resultado de la consulta antes de llamar a waitForResult().

Véase también waitForResult().

GLuint QOpenGLTimerQuery::objectId() const

Devuelve el identificador del objeto de consulta OpenGL subyacente.

void QOpenGLTimerQuery::recordTimestamp()

Coloca un marcador en la cola de comandos de OpenGL para que la GPU registre la marca de tiempo cuando la GPU llegue a dicho marcador. Esta función no es bloqueante y el resultado estará disponible más adelante.

La disponibilidad del resultado se puede comprobar con isResultAvailable(). El resultado se puede recuperar con waitForResult(), que se bloqueará si el resultado aún no está disponible.

Véanse también waitForResult(), isResultAvailable(), begin() y end().

GLuint64 QOpenGLTimerQuery::waitForResult() const

Devuelve el resultado de la consulta del temporizador de OpenGL.

Esta función se bloqueará hasta que OpenGL facilite el resultado. Se recomienda llamar a ` isResultAvailable()` para asegurarse de que el resultado está disponible y evitar así bloqueos y retrasos innecesarios.

Véase también isResultAvailable().

GLuint64 QOpenGLTimerQuery::waitForTimestamp() const

Devuelve la marca de tiempo actual de la GPU cuando todos los comandos OpenGL emitidos anteriormente han sido recibidos por la GPU, aunque no necesariamente ejecutados por ella.

Esta función queda bloqueada hasta que se devuelve el resultado.

Véase también recordTimestamp().

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