RenderStats QML Type
Fournit des informations sur le rendu de la scène. En savoir plus...
| 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 objet View3D.
Utilisez l'élément « DebugView » pour afficher les données à l'écran.
Documentation sur les propriétés
drawCallCount : quint64 [read-only, since 6.5]
Cette propriété contient le nombre total d'appels de dessin (y compris les appels non indexés, indexés, instanciés et instanciés indexés) qui ont été enregistrés lors du dernier rendu de l'View3D.
La valeur n’est mise à jour que lorsque l’option « extendedDataCollectionEnabled » est activée.
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 présents dans les appels de dessin enregistrés lors du dernier rendu de l'View3D.
Cette valeur inclut le nombre de sommets et d’indices issus des appels de dessin enregistrés lors du dernier rendu de l’ View3D. Bien que cette valeur ne soit pas garantie d’être totalement exacte, elle devrait donner une bonne indication de la complexité du rendu de la scène.
Cette valeur n’est mise à jour que lorsque l’option « extendedDataCollectionEnabled » est activée.
Cette propriété a été introduite dans Qt 6.5.
effectGenerationTime : qint64 [read-only, since 6.5]
Cette propriété contient 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 l'View3D.
La valeur n’est mise à jour que lorsque l’ extendedDataCollectionEnabled est activée.
Remarque : la valeur est indiquée pour chaque instance d’QQuickWindow. S’il existe plusieurs instances d’ View3D dans la même fenêtre, la propriété DebugView affiche la même valeur pour toutes ces instances de 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 impact sur les 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 » bascule automatiquement la valeur en fonction de la propriété « visible » du « DebugView ».
Cette propriété a été introduite dans Qt 6.5.
fps : int [read-only]
Cette propriété contient le nombre d'images affichées 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 du backend de l'API graphique (RHI) actuellement utilisé.
Cette propriété a été introduite dans Qt 6.5.
imageDataSize : quint64 [read-only, since 6.5]
Cette propriété contient la taille approximative, en octets, des données d'image correspondant aux textures actuellement associées à la fenêtre de l'View3D. La valeur est spécifique à chaque fenêtre ; ainsi, si plusieurs objets View3D coexistent au sein d'une même instance de l'QQuickWindow, ceux-ci renverront probablement la même valeur.
La valeur n’est mise à jour que lorsque l’option « extendedDataCollectionEnabled » est activée.
Remarque : la valeur est renvoyée parQQuickWindow. S’il existe plusieurs instances d’ View3D au sein d’une même fenêtre, l’ 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 de temps du GPU est enabled in Qt Quicket que les fonctionnalités concernées sont prises en charge par l’API graphique sous-jacente, cette propriété contient le dernier temps écoulé sur le GPU récupéré, en millisecondes.
Remarque : la valeur est récupérée de manière asynchrone et fait généralement référence à une image antérieure à la précédente, ce qui signifie qu’elle n’est pas nécessairement synchronisée avec les autres temps mesurés côté CPU.
Remarque : le résultat est basé sur le rendu de l’intégralité du contenu de l’ QQuickWindow e à laquelle appartient l’ 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 présents dans 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é contient le nombre total de millisecondes consacrées à la génération et au traitement du code de shader pour DefaultMaterial, PrincipledMaterial et CustomMaterial dans la fenêtre à laquelle appartient l’ View3D.
La valeur n’est mise à jour que lorsque extendedDataCollectionEnabled est activé.
Remarque : la valeur est indiquée pour chaque instance de «QQuickWindow ». S’il existe plusieurs instances de « View3D » au sein d’une même fenêtre, la propriété « DebugView » affiche la même valeur pour toutes ces instances de « View3D ».
Cette propriété a été introduite dans Qt 6.5.
maxFrameTime : real [read-only]
Cette propriété contient la durée maximale consacrée au rendu d'une seule image au cours de la dernière seconde.
meshDataSize : quint64 [read-only, since 6.5]
Cette propriété contient la taille approximative, en octets, des données de maillage actuellement enregistrées dans la fenêtre de l’ View3D. La valeur est spécifique à chaque fenêtre ; ainsi, s’il existe plusieurs objets View3D au sein d’un même QQuickWindow, ceux-ci afficheront probablement la même valeur.
La valeur n’est mise à jour que lorsque l’option « extendedDataCollectionEnabled » est activée.
Remarque : la valeur est renvoyée parQQuickWindow. S'il existe plusieurs instances d'View3D au sein d'une même fenêtre, l'DebugView affiche la même valeur pour toutes ces instances de 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 l'View3D.
La valeur n'est mise à jour que lorsque l'extendedDataCollectionEnabled est activée.
Remarque : la valeur est indiquée pour chaque instance d’QQuickWindow. S’il existe plusieurs instances d’ View3D au sein d’une même fenêtre, l’ DebugView affiche la même valeur pour toutes ces instances de View3D.
Cette propriété a été introduite dans Qt 6.5.
pipelineCreationTime : qint64 [read-only, since 6.5]
Cette propriété indique le nombre total de millisecondes consacrées à la création de pipelines graphiques au niveau de l'interface matérielle de rendu. Cela peut inclure, entre autres : les temps de compilation pour convertir le HLSL en un format intermédiaire, la compilation du MSL, la compilation du code GLSL à l’aide de glCompileShader ou la liaison à l’aide de binaires de programme, ainsi que la génération de pipelines Vulkan avec tout ce que cela implique (par exemple, la compilation SPIR-V → ISA). La valeur reflète l'ensemble du rendu 3D de l'Qt Quick et de l'Qt Quick dans la fenêtre à laquelle appartient l'View3D.
Remarque : cette valeur inclut les opérations gérées par Qt. En fonction de l’API graphique sous-jacente, certaines opérations liées au pipeline (shaders, état graphique) peuvent s’exécuter de manière asynchrone et être affectées par la mise en cache à différents niveaux de la pile graphique. La libération d’une ressource mise en cache via l’appel à ` QQuickWindow::releaseResources()` ou en cliquant sur le bouton correspondant de l’ DebugView peut également donner 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 certain nombre de facteurs.
Ces durées sont fournies à titre indicatif général et de haut niveau. En combinaison avec ` materialGenerationTime`, les développeurs d’applications peuvent utiliser ces valeurs pour vérifier que le temps consacré au traitement des matériaux et du pipeline graphique reste raisonnablement faible lors d’une utilisation normale de l’application, une fois que tous les caches (tant persistants qu’en mémoire) sont « chauds ». Évitez de tirer des conclusions dès la première exécution de l’application (car celle-ci ne bénéficie peut-être pas encore des caches persistants sur disque).
La valeur n’est mise à jour que lorsque extendedDataCollectionEnabled est activé.
Remarque : la valeur est indiquée pour chaque instance de `QQuickWindow `. S’il existe plusieurs instances ` View3D ` au sein d’une même fenêtre, l’ DebugView affiche la même valeur pour toutes ces instances de `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 enregistrées lors du dernier rendu de l'View3D.
De nombreuses fonctionnalités, telles que le mappage d'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 que ce nombre ne garantisse pas d'inclure absolument toutes les passes de rendu, il est censé donner une bonne indication de la complexité du rendu de la scène.
La valeur n’est mise à jour que lorsque l’option « extendedDataCollectionEnabled » est activée.
Cette propriété a été introduite dans Qt 6.5.
renderPrepareTime : real [read-only]
Cette propriété indique la durée, en millisecondes, de la phase de préparation du rendu. Il s'agit d'une partie de la durée totale de rendu indiquée dans renderTime.
renderTime : real [read-only]
Cette propriété indique le temps passé à générer une nouvelle image, en incluant à la fois 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 la durée, en millisecondes, passée à l'intérieur de la fonction de synchronisation. Les valeurs de cette propriété des objets sont mises à jour pendant la synchronisation.
vmemAllocCount : quint32 [read-only, since 6.5]
Le cas échéant, nombre d'allocations effectuées par la bibliothèque de gestion de la mémoire graphique. Ce chiffre inclut les allocations issues de tous les rendus 3D Qt Quick et Qt Quick au sein de l'QQuickWindow à laquelle appartient l'View3D. La valeur est égale à zéro avec des API graphiques telles qu'OpenGL, Direct3D et Metal, car l'allocation de mémoire n'est alors pas sous le contrôle de Qt.
La valeur n’est mise à jour que lorsque l’ extendedDataCollectionEnabled est activée.
Remarque : la valeur est indiquée pour chaque instance d’QQuickWindow. S’il existe plusieurs instances d’ View3D dans la même fenêtre, l’ DebugView affiche la même valeur pour toutes ces instances de View3D.
Cette propriété a été introduite dans Qt 6.5.
vmemUsedBytes : quint64 [read-only, since 6.5]
Le cas échéant, nombre d’octets utilisés par les allocations effectuées par la bibliothèque de gestion de la mémoire graphique. Cela inclut les allocations issues de tous les rendus 3D Qt Quick et Qt Quick dans l’ QQuickWindow à laquelle appartient l’ View3D. La valeur est égale à zéro avec les API graphiques telles qu’OpenGL, Direct3D et Metal, car l’allocation de mémoire n’est alors pas sous le contrôle de Qt.
La valeur n’est mise à jour que lorsque l’ extendedDataCollectionEnabled est activée.
Remarque : la valeur est indiquée pour chaque instance d'QQuickWindow. S'il existe plusieurs instances d'View3D dans la même fenêtre, l'DebugView affiche la même valeur pour toutes ces instances 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.
