RenderStats QML Type
Fournit des informations sur le rendu de la scène. Plus d'informations...
| Import Statement: | import QtQuick3D |
Propriétés
- 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)
Description détaillée
Le type RenderStats fournit des informations sur les statistiques de rendu de la scène. Il ne peut pas être créé directement, mais peut être récupéré à partir d'un site View3D.
Utilisez l'élément DebugView pour afficher les données à l'écran.
Propriété Documentation
drawCallCount : quint64 [read-only, since 6.5]
Cette propriété contient le nombre total d'appels de dessin (y compris les appels de dessin non indexés, indexés, instanciés et instanciés indexés) qui ont été enregistrés lors du dernier rendu du site View3D.
La valeur est mise à jour uniquement lorsque extendedDataCollectionEnabled est activé.
Cette propriété a été introduite dans Qt 6.5.
drawVertexCount : quint64 [read-only, since 6.5]
Cette propriété contient le nombre total de sommets dans les appels de dessin qui ont été enregistrés lors du dernier rendu de View3D.
La valeur comprend le nombre de sommets et le nombre d'index des appels de dessin qui ont été enregistrés lors du dernier rendu du site View3D. Bien qu'il ne soit pas garanti que ce nombre soit totalement exact, il devrait donner une bonne indication de la complexité du rendu de la scène.
La valeur est mise à jour uniquement lorsque extendedDataCollectionEnabled est activé.
Cette propriété a été introduite dans Qt 6.5.
effectGenerationTime : qint64 [read-only, since 6.5]
Cette propriété indique le nombre total de millisecondes consacrées à la génération et au traitement du code de shader pour les effets de post-traitement dans la fenêtre à laquelle appartient le site View3D.
La valeur n'est mise à jour que lorsque extendedDataCollectionEnabled est activé.
Remarque : la valeur est indiquée pour chaqueQQuickWindow. S'il existe plusieurs instances de View3D dans la même fenêtre, DebugView affiche la même valeur pour tous ces View3D.
Cette propriété a été introduite dans Qt 6.5.
extendedDataCollectionEnabled : bool [since 6.5]
Cette propriété détermine si les statistiques relatives aux passes de rendu et aux appels de dessin sont traitées et mises à disposition. Cela peut entraîner un léger coût en termes de performances et est donc facultatif.
Les propriétés telles que drawCallCount, drawVertexCount, ou renderPassCount ne sont mises à jour que lorsque cette propriété est définie sur true.
La valeur par défaut est false.
Remarque : la modification de la visibilité d'un DebugView associé à un View3D fait automatiquement basculer la valeur en fonction de la propriété visible de DebugView.
Cette propriété a été introduite dans Qt 6.5.
fps : int [read-only]
Cette propriété contient le nombre d'images rendues au cours de la dernière seconde.
frameTime : real [read-only]
Cette propriété indique le temps écoulé depuis la dernière image, en millisecondes.
graphicsAPIName : string [read-only, since 6.5]
Cette propriété contient le nom de l'API graphique (RHI) actuellement utilisée.
Cette propriété a été introduite dans Qt 6.5.
imageDataSize : quint64 [read-only, since 6.5]
Cette propriété indique la taille approximative en octets des données d'image pour les cartes de texture actuellement enregistrées dans la fenêtre de View3D. La valeur est propre à chaque fenêtre, ce qui signifie que s'il y a plusieurs objets View3D dans la même fenêtre QQuickWindow, ils indiqueront probablement la même valeur.
La valeur n'est mise à jour que lorsque extendedDataCollectionEnabled est activé.
Remarque : la valeur est indiquée pour chaqueQQuickWindow. S'il y a plusieurs instances View3D dans la même fenêtre, DebugView affiche la même valeur pour tous ces View3D.
Cette propriété a été introduite dans Qt 6.5.
lastCompletedGpuTime : real [read-only, since 6.6]
Lorsque la collecte des données temporelles du GPU est enabled in Qt Quicket que les fonctionnalités correspondantes sont prises en charge par l'API graphique sous-jacente, cette propriété contient le dernier temps GPU écoulé en millisecondes.
Remarque : la valeur est récupérée de manière asynchrone et se réfère généralement à une image plus ancienne que la précédente, ce qui signifie que la valeur n'est pas nécessairement synchronisée avec les autres temporisations côté CPU.
Remarque : le résultat est basé sur le rendu de l'ensemble du contenu du site QQuickWindow auquel appartient le site View3D. Il inclut tout le contenu de la scène Qt Quick, y compris tous les éléments 2D et tous les éléments View3D à l'intérieur de cette fenêtre.
Cette propriété a été introduite dans Qt 6.6.
Voir également QQuickGraphicsConfiguration::setTimestamps().
materialGenerationTime : qint64 [read-only, since 6.5]
Cette propriété indique le nombre total de millisecondes consacrées à la génération et au traitement du code shader pour DefaultMaterial, PrincipledMaterial et CustomMaterial dans la fenêtre à laquelle appartient View3D.
La valeur n'est mise à jour que lorsque extendedDataCollectionEnabled est activé.
Remarque : la valeur est indiquée pour chaqueQQuickWindow. S'il existe plusieurs instances View3D dans la même fenêtre, DebugView affiche la même valeur pour tous ces View3D.
Cette propriété a été introduite dans Qt 6.5.
maxFrameTime : real [read-only]
Cette propriété indique le temps maximum passé à rendre une seule image au cours de la dernière seconde.
meshDataSize : quint64 [read-only, since 6.5]
Cette propriété indique la taille approximative en octets des données de maillage actuellement enregistrées dans la fenêtre de View3D. La valeur est propre à chaque fenêtre, ce qui signifie que s'il y a plusieurs objets View3D dans le même QQuickWindow, ceux-ci indiqueront probablement la même valeur.
La valeur n'est mise à jour que lorsque extendedDataCollectionEnabled est activé.
Remarque : la valeur est indiquée pour chaqueQQuickWindow. S'il y a plusieurs instances View3D dans la même fenêtre, DebugView affiche la même valeur pour tous ces View3D.
Cette propriété a été introduite dans Qt 6.5.
pipelineCount : int [read-only, since 6.5]
Cette propriété contient le nombre total de pipelines graphiques mis en cache pour la fenêtre à laquelle appartient le site View3D.
La valeur est mise à jour uniquement lorsque extendedDataCollectionEnabled est activé.
Remarque : la valeur est indiquée pour chaqueQQuickWindow. S'il existe plusieurs instances View3D dans la même fenêtre, DebugView affiche la même valeur pour tous ces View3D.
Cette propriété a été introduite dans Qt 6.5.
pipelineCreationTime : qint64 [read-only, since 6.5]
Cette propriété contient le nombre total de millisecondes consacrées à la création de pipelines graphiques au niveau de l'interface du matériel de rendu. Cela peut inclure, entre autres, les temps de compilation de HLSL vers un format intermédiaire, la compilation de MSL, la compilation du code GLSL avec glCompileShader ou la liaison à l'aide de binaires de programme, et la génération de pipelines Vulkan avec tout ce que cela implique (par exemple, la compilation SPIR-V -> ISA). La valeur reflète tous les rendus 3D de Qt Quick et Qt Quick dans la fenêtre à laquelle appartient View3D.
Remarque : la valeur comprend les opérations qui sont sous le contrôle de Qt. En fonction de l'API graphique sous-jacente, certaines opérations liées au pipeline (shader, état graphique) peuvent se produire de manière asynchrone et être affectées par la mise en cache à différents niveaux de la pile graphique. La libération des ressources mises en cache en appelant QQuickWindow::releaseResources() ou en cliquant sur le bouton DebugView correspondant peut également avoir des résultats variables, en fonction des détails sous-jacents (backend rhi, API graphique) ; cela peut ou non affecter ce compteur en raison d'un nombre variable de facteurs.
Ce calendrier est fourni à titre d'indication générale de haut niveau. Combiné avec materialGenerationTime, les développeurs d'applications peuvent utiliser ces valeurs pour confirmer que le temps passé sur le matériel et le traitement du pipeline graphique est raisonnablement bas pendant l'utilisation normale de l'application, une fois que tous les caches (à la fois persistants et en mémoire) sont chauds. Évitez de tirer des conclusions à partir de la première exécution de l'application. (car celle-ci ne bénéficie peut-être pas encore de caches persistants sur disque).
La valeur est mise à jour uniquement lorsque extendedDataCollectionEnabled est activé.
Remarque : la valeur est indiquée pour chaque siteQQuickWindow. S'il y a plusieurs instances View3D dans la même fenêtre, DebugView affiche la même valeur pour tous ces View3D.
Cette propriété a été introduite dans Qt 6.5.
renderPassCount : int [read-only, since 6.5]
Cette propriété contient le nombre total de passes de rendu qui ont été enregistrées lors du dernier rendu du site View3D.
De nombreuses fonctionnalités, telles que le mappage des ombres en temps réel, les effets de post-traitement, les textures de profondeur et d'écran, ainsi que certaines méthodes d'anticrénelage, impliquent plusieurs passes de rendu supplémentaires. Bien qu'il ne soit pas garanti que ce nombre comprenne absolument toutes les passes de rendu, il devrait donner une bonne indication de la complexité du rendu de la scène.
La valeur est mise à jour uniquement lorsque extendedDataCollectionEnabled est activé.
Cette propriété a été introduite dans Qt 6.5.
renderPrepareTime : real [read-only]
Cette propriété indique le temps passé dans la phase de préparation du rendu, en millisecondes. Il s'agit d'un sous-ensemble du temps de rendu total indiqué à l'adresse renderTime.
renderTime : real [read-only]
Cette propriété indique le temps passé à générer une nouvelle image, y compris la phase de préparation et l'enregistrement des appels de dessin. La valeur est exprimée en millisecondes.
syncTime : real [read-only]
Cette propriété indique le temps passé dans la fonction de synchronisation, en millisecondes. Les valeurs des propriétés des objets sont mises à jour pendant la synchronisation.
vmemAllocCount : quint32 [read-only, since 6.5]
Le cas échéant, le nombre d'allocations effectuées par la bibliothèque d'allocation de la mémoire graphique. Cela inclut les allocations de tous les rendus 3D Qt Quick et Qt Quick dans le QQuickWindow auquel appartient le View3D. La valeur est nulle avec les API graphiques telles que OpenGL, Direct3D et Metal car l'allocation de mémoire n'est alors pas sous le contrôle de Qt.
La valeur est mise à jour uniquement lorsque extendedDataCollectionEnabled est activé.
Remarque : la valeur est indiquée pour chaque siteQQuickWindow. S'il y a plusieurs instances View3D dans la même fenêtre, DebugView affiche la même valeur pour tous ces View3D.
Cette propriété a été introduite dans Qt 6.5.
vmemUsedBytes : quint64 [read-only, since 6.5]
Le cas échéant, le nombre d'octets utilisés par les allocations effectuées par la bibliothèque d'allocation de la mémoire graphique. Cela inclut les allocations de tous les rendus 3D de Qt Quick et Qt Quick dans le QQuickWindow auquel appartient le View3D. La valeur est nulle avec les API graphiques telles que OpenGL, Direct3D et Metal car l'allocation de mémoire n'est alors pas sous le contrôle de Qt.
La valeur est mise à jour uniquement lorsque extendedDataCollectionEnabled est activé.
Remarque : la valeur est indiquée pour chaque siteQQuickWindow. S'il y a plusieurs instances View3D dans la même fenêtre, DebugView affiche la même valeur pour tous ces View3D.
Cette propriété a été introduite dans 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.
