QOpenGLTimeMonitor Class
La clase QOpenGLTimeMonitor agrupa una secuencia de objetos de consulta de temporizadores de OpenGL. Más información...
| Encabezado: | #include <QOpenGLTimeMonitor> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS OpenGL) target_link_libraries(mytarget PRIVATE Qt6::OpenGL) |
| qmake: | QT += opengl |
| Heredan: | QObject |
- Lista de todos los miembros, incluidos los heredados
- QOpenGLTimeMonitor forma parte de «Renderizado en 3D».
Funciones públicas
| QOpenGLTimeMonitor(QObject *parent = nullptr) | |
| virtual | ~QOpenGLTimeMonitor() |
| bool | create() |
| void | destroy() |
| bool | isCreated() const |
| bool | isResultAvailable() const |
| QList<GLuint> | objectIds() const |
| int | recordSample() |
| void | reset() |
| int | sampleCount() const |
| void | setSampleCount(int sampleCount) |
| QList<GLuint64> | waitForIntervals() const |
| QList<GLuint64> | waitForSamples() const |
Descripción detallada
La clase QOpenGLTimeMonitor es un envoltorio práctico que agrupa una colección de objetos de consulta del temporizador de OpenGL, utilizados para medir intervalos de tiempo en la GPU con el nivel de granularidad que requiera tu aplicación de renderizado.
Los objetos de consulta de temporizador de OpenGL se consultan en secuencia para registrar las marcas de tiempo de la GPU en las posiciones de interés de su código de renderizado. Una vez que los resultados de todas las consultas de temporizador estén disponibles, se pueden recuperar y QOpenGLTimeMonitor calculará los intervalos de tiempo registrados por usted.
El caso de uso típico de esta clase es realizar un análisis de rendimiento de los algoritmos de renderizado de su aplicación o ajustar dichos algoritmos en tiempo real para lograr un equilibrio dinámico entre rendimiento y calidad.
Antes de utilizar QOpenGLTimerMonitor en su función de renderizado, debe establecer el número requerido de puntos de muestra que desea registrar llamando a setSamples(). Tenga en cuenta que la medición de N puntos de muestra producirá N-1 intervalos de tiempo. Una vez establecido el número de puntos de muestreo, llama a la función create() con un contexto OpenGL válido y actual para crear los objetos de temporizador de consulta necesarios. Estos pasos suelen realizarse una sola vez en una función de inicialización.
Utiliza la función ` recordSample()` para delimitar los bloques de código que contengan comandos OpenGL cuyo tiempo desees medir. Puedes comprobar la disponibilidad de las muestras de tiempo y los intervalos de tiempo resultantes con ` isResultAvailable()`. Los intervalos de tiempo calculados y las muestras de marca de tiempo sin procesar se pueden recuperar con las funciones bloqueantes ` waitForIntervals()` y ` waitForSamples()`, respectivamente.
Tras recuperar los resultados y antes de iniciar una nueva ronda de toma de muestras (por ejemplo, en el siguiente fotograma), asegúrate de llamar a la función reset(), que borrará los resultados almacenados en caché y restablecerá el índice del temporizador al primer objeto temporizador.
Véase también QOpenGLTimerQuery.
Documentación de las funciones de miembro
[explicit] QOpenGLTimeMonitor::QOpenGLTimeMonitor(QObject *parent = nullptr)
Crea una instancia de `QOpenGLTimeMonitor` con el ` parent` indicado. Antes de utilizarla, debes llamar a ` create()` con un contexto OpenGL válido.
Véase también setSampleCount() y create().
[virtual noexcept] QOpenGLTimeMonitor::~QOpenGLTimeMonitor()
Elimina el objeto « QOpenGLTimeMonitor » y cualquier recurso OpenGL subyacente.
bool QOpenGLTimeMonitor::create()
Crea objetos de consulta de temporizador de OpenGL mediante ` sampleCount()` que se utilizarán para registrar el tiempo que tardan en ejecutarse los comandos de OpenGL entre llamadas sucesivas a ` recordSample()`.
Devuelve true si se han podido crear los objetos de consulta del temporizador de OpenGL.
Véanse también destroy(), setSampleCount() y recordSample().
void QOpenGLTimeMonitor::destroy()
Elimina cualquier objeto de consulta de temporizador de OpenGL utilizado en esta instancia.
Véase también create().
bool QOpenGLTimeMonitor::isCreated() const
Devuelve « true » si se han creado los objetos de consulta OpenGL subyacentes. Si devuelve « true » y el contexto OpenGL asociado es el actual, entonces podrás registrar muestras de tiempo con este objeto.
bool QOpenGLTimeMonitor::isResultAvailable() const
Devuelve ` true ` si hay resultados disponibles de la consulta del temporizador de OpenGL.
Véase también waitForSamples() y waitForIntervals().
QList<GLuint> QOpenGLTimeMonitor::objectIds() const
Devuelve una matriz de tipos « QList » que contiene los identificadores (ID) de los objetos de consulta del temporizador de OpenGL.
int QOpenGLTimeMonitor::recordSample()
Envía una consulta de temporizador de OpenGL en este punto de la cola de comandos de OpenGL. Al llamar a esta función de forma secuencial en la función de renderizado de tu aplicación, se recopilarán datos sobre el tiempo que tarda la GPU en ejecutar los comandos de OpenGL entre llamadas sucesivas a esta función.
Véase también setSampleCount(), isResultAvailable(), waitForSamples() y waitForIntervals().
void QOpenGLTimeMonitor::reset()
Restablece el monitor de tiempo para que esté listo para su uso en otro fotograma de renderizado. Llama a esta función una vez que hayas obtenido los resultados anteriores y antes de llamar a recordSample() por primera vez en el siguiente fotograma.
Véase también recordSample().
int QOpenGLTimeMonitor::sampleCount() const
Devuelve el número de puntos de muestra que se han solicitado con ` setSampleCount()`. Si la llamada a `create` se ha realizado correctamente tras ` setSampleCount()`, el valor devuelto será el número real de puntos de muestra que se pueden utilizar.
El valor por defecto del recuento de muestras es 2, lo que da lugar a la medición de un único intervalo.
Véase también ` setSampleCount()`.
void QOpenGLTimeMonitor::setSampleCount(int sampleCount)
Establece el número de puntos de muestreo en sampleCount. Tras establecer el número de muestras con esta función, debes llamar a create() para instanciar los objetos de consulta del temporizador de OpenGL subyacentes.
El nuevo valor de ` sampleCount ` debe ser, como mínimo, 2.
Véanse también sampleCount(), create() y recordSample().
QList<GLuint64> QOpenGLTimeMonitor::waitForIntervals() const
Devuelve un ` QList ` que contiene los intervalos de tiempo delimitados por las llamadas a ` recordSample()`. El vector resultante contendrá un elemento menos, ya que representa los intervalos intermedios y no las muestras de marcas de tiempo reales.
Esta función se bloqueará hasta que OpenGL indique que los resultados están disponibles. Se recomienda comprobar la disponibilidad del resultado antes de llamar a esta función con ` isResultAvailable()`.
Véase también waitForSamples() y isResultAvailable().
QList<GLuint64> QOpenGLTimeMonitor::waitForSamples() const
Devuelve un objeto ` QList ` que contiene las marcas de tiempo de la GPU obtenidas con ` recordSample()`.
Esta función se bloqueará hasta que OpenGL indique que los resultados están disponibles. Se recomienda comprobar la disponibilidad del resultado antes de llamar a esta función con ` isResultAvailable()`.
Nota: Esta función solo funciona en sistemas que tengan OpenGL >=3.3 o la extensión ARB_timer_query. Consulte QOpenGLTimerQuery para obtener más detalles.
Véanse también waitForIntervals() y isResultAvailable().
© 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.