RenderStats QML Type
Ofrece información sobre el renderizado de la escena. Más...
| Import Statement: | import QtQuick3D |
Propiedades
- drawCallCount : quint64
(since 6.5) - drawVertexCount : quint64
(since 6.5) - effectGenerationTime : qint64
(since 6.5) - extendedDataCollectionEnabled : bool
(since 6.5) - fps : int
- frameTime : real
- graphicsAPIName : string
(since 6.5) - imageDataSize : quint64
(since 6.5) - lastCompletedGpuTime : real
(since 6.6) - materialGenerationTime : qint64
(since 6.5) - maxFrameTime : real
- meshDataSize : quint64
(since 6.5) - pipelineCount : int
(since 6.5) - pipelineCreationTime : qint64
(since 6.5) - renderPassCount : int
(since 6.5) - renderPrepareTime : real
- renderTime : real
- syncTime : real
- vmemAllocCount : quint32
(since 6.5) - vmemUsedBytes : quint64
(since 6.5)
Descripción detallada
El tipo RenderStats proporciona información sobre las estadísticas de renderizado de la escena. No se puede crear directamente, pero se puede obtener a partir de un objeto ` View3D`.
Utiliza el elemento « DebugView » para mostrar los datos en pantalla.
Documentación de propiedades
drawCallCount : quint64 [read-only, since 6.5]
Esta propiedad contiene el número total de llamadas de dibujo (incluidas las no indexadas, las indexadas, las instanciadas y las instanciadas e indexadas) que se registraron durante el último renderizado de View3D.
El valor solo se actualiza cuando está activada la opción « extendedDataCollectionEnabled ».
Esta propiedad se introdujo en Qt 6.5.
drawVertexCount : quint64 [read-only, since 6.5]
Esta propiedad contiene el número total de vértices de las llamadas de dibujo que se registraron durante el último renderizado del View3D.
El valor incluye el número de vértices y el recuento de índices de las llamadas de dibujo registradas durante el último renderizado de « View3D ». Aunque no se garantiza que la cifra sea totalmente precisa, se espera que ofrezca una buena indicación de la complejidad del renderizado de la escena.
El valor solo se actualiza cuando está activada la opción « extendedDataCollectionEnabled ».
Esta propiedad se introdujo en Qt 6.5.
effectGenerationTime : qint64 [read-only, since 6.5]
Esta propiedad contiene el número total de milisegundos dedicados a generar y procesar el código del shader para los efectos de posprocesamiento en la ventana a la que pertenece el « View3D ».
El valor solo se actualiza cuando « extendedDataCollectionEnabled » está activado.
Nota: El valor se indica por cada «QQuickWindow ». Si hay varias instancias de « View3D » dentro de la misma ventana, « DebugView » muestra el mismo valor para todas esas «View3D».
Esta propiedad se introdujo en Qt 6.5.
extendedDataCollectionEnabled : bool [since 6.5]
Esta propiedad controla si se procesan y se ponen a disposición las estadísticas de pasadas de renderizado y llamadas de dibujo. Esto puede suponer un pequeño coste de rendimiento, por lo que es opcional.
Propiedades como drawCallCount, drawVertexCount o renderPassCount solo se actualizan cuando esta propiedad se establece en «true».
El valor por defecto es «false».
Nota: Al cambiar la visibilidad de una « DebugView » asociada a la « View3D », el valor cambia automáticamente en función de la propiedad « visible » de la « DebugView ».
Esta propiedad se introdujo en Qt 6.5.
fps : int [read-only]
Esta propiedad contiene el número de fotogramas renderizados durante el último segundo.
frameTime : real [read-only]
Esta propiedad contiene el tiempo transcurrido desde el último fotograma, en milisegundos.
graphicsAPIName : string [read-only, since 6.5]
Esta propiedad contiene el nombre del backend de la API gráfica (RHI) que se está utilizando actualmente.
Esta propiedad se introdujo en Qt 6.5.
imageDataSize : quint64 [read-only, since 6.5]
Esta propiedad contiene el tamaño aproximado, en bytes, de los datos de imagen de los mapas de textura registrados actualmente en la ventana de « View3D ». El valor es específico de cada ventana, lo que significa que, si hay varios objetos « View3D » dentro de la misma ventana « QQuickWindow », es probable que todos ellos muestren el mismo valor.
El valor solo se actualiza cuando extendedDataCollectionEnabled está habilitado.
Nota: El valor se indica por cadaQQuickWindow. Si hay varias instancias de View3D dentro de la misma ventana, el DebugView muestra el mismo valor para todas esas View3D.
Esta propiedad se introdujo en Qt 6.5.
lastCompletedGpuTime : real [read-only, since 6.6]
Cuando la recopilación de datos de tiempo de la GPU está enabled in Qt Quicky la API gráfica subyacente admite las funciones pertinentes, esta propiedad contiene el último tiempo transcurrido en la GPU recuperado, expresado en milisegundos.
Nota: El valor se recupera de forma asíncrona y, por lo general, hace referencia a un fotograma anterior al anterior, lo que significa que el valor no está necesariamente sincronizado con los demás tiempos del lado de la CPU.
Nota: El resultado se basa en el renderizado de todo el contenido de la ventana « QQuickWindow » a la que pertenece la ventana « View3D ». Incluye todo el contenido de una escena « Qt Quick », incluidos todos los elementos 2D y todos los elementos « View3D » que se encuentren dentro de esa ventana.
Esta propiedad se introdujo en Qt 6.6.
Véase también QQuickGraphicsConfiguration::setTimestamps().
materialGenerationTime : qint64 [read-only, since 6.5]
Esta propiedad contiene el número total de milisegundos empleados en generar y procesar el código de shader para DefaultMaterial, PrincipledMaterial y CustomMaterial en la ventana a la que pertenece View3D.
El valor solo se actualiza cuando extendedDataCollectionEnabled está habilitado.
Nota: El valor se indica por cadaQQuickWindow. Si hay varias instancias de View3D dentro de la misma ventana, el DebugView muestra el mismo valor para todas esas View3D.
Esta propiedad se introdujo en Qt 6.5.
maxFrameTime : real [read-only]
Esta propiedad contiene el tiempo máximo empleado en renderizar un fotograma durante el último segundo.
meshDataSize : quint64 [read-only, since 6.5]
Esta propiedad contiene el tamaño aproximado, en bytes, de los datos de malla registrados actualmente en la ventana de « View3D ». El valor es específico de cada ventana, lo que significa que, si hay varios objetos « View3D » dentro de la misma ventana « QQuickWindow », es probable que todos ellos muestren el mismo valor.
El valor solo se actualiza cuando extendedDataCollectionEnabled está habilitado.
Nota: El valor se indica por cadaQQuickWindow. Si hay varias instancias de View3D dentro de la misma ventana, el DebugView muestra el mismo valor para todos esos View3D.
Esta propiedad se introdujo en Qt 6.5.
pipelineCount : int [read-only, since 6.5]
Esta propiedad contiene el número total de tuberías gráficas almacenadas en caché para la ventana a la que pertenece el objeto « View3D ».
El valor solo se actualiza cuando está habilitado el « extendedDataCollectionEnabled ».
Nota: El valor se indica por cadaQQuickWindow. Si hay varias instancias de View3D dentro de la misma ventana, el DebugView muestra el mismo valor para todas esas View3D.
Esta propiedad se introdujo en Qt 6.5.
pipelineCreationTime : qint64 [read-only, since 6.5]
Esta propiedad contiene el número total de milisegundos empleados en la creación de tuberías gráficas a nivel de la interfaz del hardware de renderizado. Esto puede incluir, entre otras cosas: los tiempos de compilación de HLSL a un formato intermedio, la compilación de MSL, la compilación de código GLSL con glCompileShader o la vinculación mediante binarios de programa, y la generación de pipelines de Vulkan con todo lo que ello conlleva (por ejemplo, la compilación de SPIR-V a ISA). El valor refleja todo el renderizado 3D de Qt Quick y Qt Quick en la ventana a la que pertenece View3D.
Nota: El valor incluye operaciones que están bajo el control de Qt. Dependiendo de la API gráfica subyacente, algunas operaciones relacionadas con el canal (shader, estado gráfico) pueden producirse de forma asíncrona y verse afectadas por el almacenamiento en caché en diversos niveles de la pila gráfica. Liberar recursos almacenados en caché llamando a ` QQuickWindow::releaseResources()` o haciendo clic en el botón correspondiente de « DebugView » también puede dar resultados variables, dependiendo de los detalles subyacentes (backend de rhi, API gráfica); puede afectar o no a este contador debido a diversos factores.
Esta información sobre tiempos se ofrece a modo de indicación general y de alto nivel. En combinación con ` materialGenerationTime`, los desarrolladores de aplicaciones pueden utilizar estos valores para confirmar que el tiempo dedicado al procesamiento de materiales y del canal gráfico es razonablemente bajo durante el uso normal de la aplicación, una vez que todas las cachés (tanto persistentes como en memoria) están «calentadas». Evita sacar conclusiones a partir de la primera ejecución de la aplicación (ya que es posible que aún no se beneficie de las cachés persistentes basadas en disco).
El valor solo se actualiza cuando está habilitado extendedDataCollectionEnabled.
Nota: El valor se indica por cada instancia de «QQuickWindow ». Si hay varias instancias de « View3D » dentro de la misma ventana, « DebugView » muestra el mismo valor para todas esas «View3D».
Esta propiedad se introdujo en Qt 6.5.
renderPassCount : int [read-only, since 6.5]
Esta propiedad contiene el número total de pasadas de renderizado que se registraron durante el último renderizado del objeto « View3D ».
Muchas funciones, como el mapeado de sombras en tiempo real, los efectos de posprocesamiento, las texturas de profundidad y de pantalla, y ciertos métodos de suavizado, implican múltiples pasadas de renderizado adicionales. Aunque no se garantiza que el número incluya absolutamente todas las pasadas de renderizado, se espera que ofrezca una buena indicación de la complejidad del renderizado de la escena.
El valor solo se actualiza cuando está activado el renderizado de la luz de fondo ( extendedDataCollectionEnabled ).
Esta propiedad se introdujo en Qt 6.5.
renderPrepareTime : real [read-only]
Esta propiedad recoge el tiempo empleado en la fase de preparación del renderizado, en milisegundos. Se trata de un subconjunto del tiempo total de renderizado que se indica en renderTime.
renderTime : real [read-only]
Esta propiedad indica el tiempo empleado en generar un nuevo fotograma, incluyendo tanto la fase de preparación como el registro de las llamadas de dibujo. El valor se expresa en milisegundos.
syncTime : real [read-only]
Esta propiedad contiene el tiempo empleado dentro de la función de sincronización, en milisegundos. Los valores de las propiedades de los objetos se actualizan durante la sincronización.
vmemAllocCount : quint32 [read-only, since 6.5]
Cuando procede, el número de asignaciones realizadas por la biblioteca de asignación de memoria gráfica. Esto incluye las asignaciones de todas las representaciones 3D de « Qt Quick » y « Qt Quick » en el « QQuickWindow » al que pertenece el « View3D ». El valor es cero con API gráficas como OpenGL, Direct3D y Metal, ya que en esos casos la asignación de memoria no está bajo el control de Qt.
El valor solo se actualiza cuando está habilitado extendedDataCollectionEnabled.
Nota: El valor se indica por cadaQQuickWindow. Si hay varias instancias de View3D dentro de la misma ventana, el DebugView muestra el mismo valor para todas esas View3D.
Esta propiedad se introdujo en Qt 6.5.
vmemUsedBytes : quint64 [read-only, since 6.5]
Cuando procede, el número de bytes utilizados por las asignaciones realizadas por la biblioteca del asignador de memoria gráfica. Esto incluye las asignaciones de todas las representaciones 3D de Qt Quick y Qt Quick en el QQuickWindow al que pertenece el View3D. El valor es cero con API gráficas como OpenGL, Direct3D y Metal, ya que en esos casos la asignación de memoria no está bajo el control de Qt.
El valor solo se actualiza cuando está habilitado extendedDataCollectionEnabled.
Nota: El valor se indica por cadaQQuickWindow. Si hay varias instancias de View3D dentro de la misma ventana, el DebugView muestra el mismo valor para todos esos View3D.
Esta propiedad se introdujo en Qt 6.5.
© 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.