RenderStats QML Type
Proporciona información del 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 puede crearse directamente, pero puede recuperarse de un View3D.
Utilice 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 a dibujo (incluyendo llamadas a dibujo no indexadas, indexadas, instanciadas e instanciadas indexadas) que se registraron durante el último renderizado de View3D.
El valor sólo se actualiza cuando extendedDataCollectionEnabled está habilitado.
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 en llamadas de dibujo que se registraron durante el último renderizado de View3D.
El valor incluye el número de vértices y el recuento de índices de las llamadas a dibujo que se registraron durante el último renderizado de View3D. Aunque no se garantiza que el número sea totalmente exacto, se espera que proporcione una buena indicación de la complejidad del renderizado de la escena.
El valor sólo se actualiza cuando extendedDataCollectionEnabled está habilitado.
Esta propiedad se introdujo en Qt 6.5.
effectGenerationTime : qint64 [read-only, since 6.5]
Esta propiedad contiene el número total de milisegundos empleados en generar y procesar código shader para efectos de post-procesado en la ventana a la que pertenece View3D.
El valor se actualiza sólo cuando extendedDataCollectionEnabled está habilitado.
Nota: El valor se notifica por cadaQQuickWindow. 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 las estadísticas de pases de renderizado y llamadas a dibujo se procesan y están disponibles. Esto puede suponer un pequeño coste de rendimiento, por lo que es opcional.
Las propiedades como drawCallCount, drawVertexCount, o renderPassCount sólo se actualizan cuando esta propiedad tiene el valor true.
El valor por defecto es false.
Nota: Cambiar la visibilidad de un DebugView asociado con el View3D cambia automáticamente el valor basado en la propiedad visible del 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 la cantidad de 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) actualmente en uso.
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 actualmente registrados en la ventana de View3D. El valor es por ventana, lo que significa que si hay múltiples objetos View3D dentro del mismo QQuickWindow, es probable que reporten el mismo valor.
El valor sólo se actualiza cuando extendedDataCollectionEnabled está activado.
Nota: el valor se indica por cadaQQuickWindow. Si hay múltiples 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.
lastCompletedGpuTime : real [read-only, since 6.6]
Cuando la colección de tiempos de GPU es enabled in Qt Quicky las características relevantes están soportadas por la API gráfica subyacente, esta propiedad contiene el último tiempo transcurrido en la GPU en milisegundos.
Nota: El valor se recupera de forma asíncrona, y normalmente se refiere a un fotograma anterior al anterior, lo que significa que el valor no está necesariamente sincronizado con los otros tiempos del lado de la CPU.
Nota: El resultado se basa en el renderizado de todo el contenido de QQuickWindow al que pertenece View3D. Incluye todo el contenido de la escena Qt Quick, incluyendo todos los elementos 2D y todos los elementos View3D 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 código shader para DefaultMaterial, PrincipledMaterial, y CustomMaterial en la ventana a la que pertenece View3D.
El valor se actualiza sólo cuando extendedDataCollectionEnabled está habilitado.
Nota: El valor se informa por cadaQQuickWindow. 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.
maxFrameTime : real [read-only]
Esta propiedad contiene el tiempo máximo empleado en renderizar un único 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 actualmente registrados en la ventana de View3D. El valor es por ventana, lo que significa que si hay varios objetos View3D dentro del mismo QQuickWindow, es probable que informen del mismo valor.
El valor sólo se actualiza cuando extendedDataCollectionEnabled está activado.
Nota: el valor se indica por cadaQQuickWindow. Si hay múltiples 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.
pipelineCount : int [read-only, since 6.5]
Esta propiedad contiene el número total de canalizaciones gráficas almacenadas en caché para la ventana a la que pertenece View3D.
El valor se actualiza sólo cuando extendedDataCollectionEnabled está habilitado.
Nota: El valor se muestra por cadaQQuickWindow. 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.
pipelineCreationTime : qint64 [read-only, since 6.5]
Esta propiedad contiene el número total de milisegundos invertidos en la creación de canalizaciones gráficas en el nivel de interfaz de hardware de renderizado. Esto puede incluir, entre otras cosas: tiempos de compilación para compilar HLSL a un formato intermedio, compilar MSL, compilar código GLSL con glCompileShader o enlazar utilizando binarios de programa, y generar canalizaciones Vulkan con todo lo que ello conlleva (por ejemplo, compilación SPIR-V -> 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 pipeline (shader, estado gráfico) pueden ocurrir de forma asíncrona, y pueden verse afectadas por el almacenamiento en caché en varios niveles de la pila gráfica. La liberación de recursos en caché llamando a QQuickWindow::releaseResources() o haciendo clic en el botón DebugView correspondiente también puede tener resultados variables, dependiendo de los detalles subyacentes (rhi backend, API de gráficos); puede o no afectar a este contador debido a un número variable de factores.
Esta temporización se proporciona como una indicación general de alto nivel. Combinado con materialGenerationTime, los desarrolladores de aplicaciones pueden utilizar estos valores para confirmar que el tiempo empleado en el procesamiento de material y canalización de gráficos 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 calientes. Evite sacar conclusiones de la primera ejecución de la aplicación. (ya que puede que aún no se beneficie de las cachés persistentes basadas en disco)
El valor sólo se actualiza cuando extendedDataCollectionEnabled está activado.
Nota: El valor se informa por cadaQQuickWindow. Si hay múltiples instancias de View3D dentro de la misma ventana, DebugView muestra el mismo valor para todos esos View3Ds.
Esta propiedad se introdujo en Qt 6.5.
renderPassCount : int [read-only, since 6.5]
Esta propiedad contiene el número total de pases de render que se registraron durante el último renderizado de View3D.
Muchas características, como el mapeado de sombras en tiempo real, los efectos de postprocesado, las texturas de profundidad y de pantalla, y ciertos métodos de antialiasing implican múltiples pases de render adicionales. Aunque no se garantiza que el número incluya absolutamente todos los pases de renderizado, se espera que ofrezca una buena indicación de la complejidad del renderizado de la escena.
El valor sólo se actualiza cuando extendedDataCollectionEnabled está activado.
Esta propiedad se introdujo en Qt 6.5.
renderPrepareTime : real [read-only]
Esta propiedad contiene la cantidad de tiempo empleado en la fase de preparación del renderizado, en milisegundos. Se trata de un subconjunto del tiempo total de renderizado indicado en renderTime.
renderTime : real [read-only]
Esta propiedad contiene la cantidad de tiempo empleado en generar un nuevo fotograma, incluyendo tanto la fase de preparación como la grabación de las llamadas a dibujo. El valor está en milisegundos.
syncTime : real [read-only]
Esta propiedad contiene la cantidad de tiempo transcurrido 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 proceda, el número de asignaciones realizadas por la biblioteca del asignador de memoria gráfica. Esto incluye las asignaciones de todo el renderizado 3D de Qt Quick y Qt Quick en el QQuickWindow al que pertenece el View3D. El valor es cero con APIs gráficas como OpenGL, Direct3D y Metal porque la asignación de memoria no está entonces bajo el control de Qt.
El valor se actualiza sólo cuando extendedDataCollectionEnabled está habilitado.
Nota: El valor se informa por cadaQQuickWindow. Si hay múltiples instancias de View3D dentro de la misma ventana, DebugView muestra el mismo valor para todos esos View3Ds.
Esta propiedad se introdujo en Qt 6.5.
vmemUsedBytes : quint64 [read-only, since 6.5]
Cuando proceda, el número de bytes utilizados por las asignaciones realizadas por la biblioteca del asignador de memoria gráfica. Esto incluye las asignaciones de todo el renderizado 3D de Qt Quick y Qt Quick en el QQuickWindow al que pertenece el View3D. El valor es cero con APIs gráficas como OpenGL, Direct3D y Metal porque la asignación de memoria no está entonces bajo el control de Qt.
El valor se actualiza sólo cuando extendedDataCollectionEnabled está habilitado.
Nota: El valor se informa por cadaQQuickWindow. Si hay múltiples instancias de View3D dentro de la misma ventana, DebugView muestra el mismo valor para todos esos View3Ds.
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.
