RenderStats QML Type

Liefert Informationen über das Rendering der Szene. Mehr...

Import Statement: import QtQuick3D

Eigenschaften

Detaillierte Beschreibung

Der Typ RenderStats liefert Informationen über die Rendering-Statistiken der Szene. Er kann nicht direkt erstellt werden, aber er kann von einem View3D abgerufen werden.

Verwenden Sie das Element DebugView, um die Daten auf dem Bildschirm anzuzeigen.

Eigenschaft Dokumentation

drawCallCount : quint64 [read-only, since 6.5]

Diese Eigenschaft enthält die Gesamtzahl der Zeichenaufrufe (einschließlich nicht indizierter, indizierter, instanzierter und instanzierter indizierter Zeichenaufrufe), die während des letzten Renderings der View3D registriert wurden.

Der Wert wird nur aktualisiert, wenn extendedDataCollectionEnabled aktiviert ist.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.


drawVertexCount : quint64 [read-only, since 6.5]

Diese Eigenschaft enthält die Gesamtzahl der Scheitelpunkte in Zeichenaufrufen, die während des letzten Renderings von View3D registriert wurden.

Der Wert beinhaltet die Anzahl der Scheitelpunkte und die Anzahl der Indizes der Zeichenaufrufe, die während des letzten Renderings von View3D registriert wurden. Obwohl nicht garantiert werden kann, dass die Zahl absolut genau ist, wird erwartet, dass sie einen guten Hinweis auf die Komplexität des Renderings der Szene gibt.

Der Wert wird nur aktualisiert, wenn extendedDataCollectionEnabled aktiviert ist.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.


effectGenerationTime : qint64 [read-only, since 6.5]

Diese Eigenschaft enthält die Gesamtzahl der Millisekunden, die für die Erzeugung und Verarbeitung von Shader-Code für Nachbearbeitungseffekte in dem Fenster, zu dem View3D gehört, aufgewendet werden.

Der Wert wird nur aktualisiert, wenn extendedDataCollectionEnabled aktiviert ist.

Hinweis: Der Wert wird proQQuickWindow gemeldet. Wenn es mehrere View3D Instanzen innerhalb desselben Fensters gibt, zeigt DebugView denselben Wert für alle diese View3Ds an.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.


extendedDataCollectionEnabled : bool [since 6.5]

Diese Eigenschaft steuert, ob Renderpass- und Zeichenaufrufstatistiken verarbeitet und verfügbar gemacht werden. Dies kann zu einem geringen Leistungsverlust führen und ist daher optional.

Eigenschaften wie drawCallCount, drawVertexCount oder renderPassCount werden nur aktualisiert, wenn diese Eigenschaft auf true gesetzt ist.

Der Standardwert ist false.

Hinweis: Das Ändern der Sichtbarkeit von DebugView, das mit View3D verknüpft ist, schaltet automatisch den Wert basierend auf der Eigenschaft visible von DebugView um.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.


fps : int [read-only]

Diese Eigenschaft enthält die Anzahl der Frames, die in der letzten Sekunde gerendert wurden.


frameTime : real [read-only]

Diese Eigenschaft enthält die Zeit, die seit dem letzten Frame verstrichen ist, in Millisekunden.


graphicsAPIName : string [read-only, since 6.5]

Diese Eigenschaft enthält den Namen des aktuellen Grafik-API (RHI) Backends, das gerade verwendet wird.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.


imageDataSize : quint64 [read-only, since 6.5]

Diese Eigenschaft enthält die ungefähre Größe der Bilddaten für Texturkarten in Bytes, die derzeit im Fenster von View3D registriert sind. Der Wert gilt pro Fenster, d.h. wenn es mehrere View3D Objekte innerhalb desselben QQuickWindow gibt, werden diese wahrscheinlich denselben Wert melden.

Der Wert wird nur aktualisiert, wenn extendedDataCollectionEnabled aktiviert ist.

Hinweis: Der Wert wird auf einerQQuickWindow Basis gemeldet. Wenn es mehrere View3D Instanzen innerhalb desselben Fensters gibt, zeigt DebugView denselben Wert für alle diese View3Ds an.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.


lastCompletedGpuTime : real [read-only, since 6.6]

Wenn GPU timing collection ist enabled in Qt Quickist und die relevanten Features von der zugrundeliegenden Grafik-API unterstützt werden, enthält diese Eigenschaft die zuletzt abgerufene verstrichene GPU-Zeit in Millisekunden.

Hinweis: Der Wert wird asynchron abgerufen und bezieht sich in der Regel auf einen Frame, der älter als der vorherige ist, was bedeutet, dass der Wert nicht unbedingt mit den anderen, CPU-seitigen Timings synchron ist.

Hinweis: Das Ergebnis basiert auf dem Rendering des gesamten Inhalts von QQuickWindow, zu dem View3D gehört. Es umfasst den gesamten Inhalt der Qt Quick Szene, einschließlich aller 2D-Elemente und aller View3D Elemente innerhalb dieses Fensters.

Diese Eigenschaft wurde in Qt 6.6 eingeführt.

Siehe auch QQuickGraphicsConfiguration::setTimestamps().


materialGenerationTime : qint64 [read-only, since 6.5]

Diese Eigenschaft enthält die Gesamtzahl der Millisekunden, die für die Erzeugung und Verarbeitung von Shader-Code für DefaultMaterial, PrincipledMaterial und CustomMaterial in dem Fenster, zu dem View3D gehört, aufgewendet wurden.

Der Wert wird nur aktualisiert, wenn extendedDataCollectionEnabled aktiviert ist.

Hinweis: Der Wert wird auf einerQQuickWindow Basis berichtet. Wenn es mehrere View3D Instanzen innerhalb desselben Fensters gibt, zeigt DebugView denselben Wert für alle diese View3Ds an.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.


maxFrameTime : real [read-only]

Diese Eigenschaft enthält die maximale Zeit, die für das Rendern eines Einzelbildes in der letzten Sekunde benötigt wird.


meshDataSize : quint64 [read-only, since 6.5]

Diese Eigenschaft gibt die ungefähre Größe der Mesh-Daten in Bytes an, die derzeit im Fenster von View3D registriert sind. Der Wert gilt pro Fenster, d.h. wenn es mehrere View3D Objekte innerhalb desselben QQuickWindow gibt, werden diese wahrscheinlich denselben Wert melden.

Der Wert wird nur aktualisiert, wenn extendedDataCollectionEnabled aktiviert ist.

Hinweis: Der Wert wird auf einerQQuickWindow Basis gemeldet. Wenn es mehrere View3D Instanzen innerhalb desselben Fensters gibt, zeigt DebugView denselben Wert für alle diese View3Ds an.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.


pipelineCount : int [read-only, since 6.5]

Diese Eigenschaft enthält die Gesamtzahl der zwischengespeicherten Grafikpipelines für das Fenster, zu dem die View3D gehört.

Der Wert wird nur aktualisiert, wenn extendedDataCollectionEnabled aktiviert ist.

Hinweis: Der Wert wird auf einerQQuickWindow Basis berichtet. Wenn es mehrere View3D Instanzen innerhalb desselben Fensters gibt, zeigt DebugView denselben Wert für alle diese View3Ds an.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.


pipelineCreationTime : qint64 [read-only, since 6.5]

Diese Eigenschaft enthält die Gesamtzahl der Millisekunden, die für die Erstellung von Grafikpipelines auf der Ebene der Rendering-Hardware-Schnittstelle aufgewendet wurden. Dies kann unter anderem Folgendes beinhalten: Kompilierungszeiten für die Kompilierung von HLSL in ein Zwischenformat, die Kompilierung von MSL, die Kompilierung von GLSL-Code mit glCompileShader oder das Linken unter Verwendung von Programmbinärdateien und die Generierung von Vulkan-Pipelines mit allem, was dazu gehört (z. B. SPIR-V -> ISA-Kompilierung). Der Wert spiegelt das gesamte Rendering von Qt Quick und Qt Quick 3D in dem Fenster wider, zu dem das View3D gehört.

Hinweis: Der Wert umfasst Operationen, die unter der Kontrolle von Qt stehen. Abhängig von der zugrundeliegenden Grafik-API können einige Operationen, die mit der Pipeline (Shader, Grafikstatus) zusammenhängen, asynchron ablaufen und von der Zwischenspeicherung auf verschiedenen Ebenen im Grafik-Stack betroffen sein. Das Freigeben von zwischengespeicherten Ressourcen durch den Aufruf von QQuickWindow::releaseResources() oder das Klicken auf die entsprechende Schaltfläche DebugView kann ebenfalls unterschiedliche Ergebnisse haben, abhängig von den zugrunde liegenden Details (rhi-Backend, Grafik-API); es kann diesen Zähler aufgrund einer unterschiedlichen Anzahl von Faktoren beeinflussen oder auch nicht.

Dieses Timing wird als allgemeiner, hochrangiger Hinweis gegeben. In Kombination mit materialGenerationTime können Anwendungsentwickler diese Werte verwenden, um sich zu vergewissern, dass die für die Material- und Grafikpipeline-Verarbeitung aufgewendete Zeit während der normalen Nutzung der Anwendung relativ gering ist, sobald alle Caches (sowohl persistente als auch In-Memory-Caches) warm sind. Vermeiden Sie es, Schlussfolgerungen aus dem ersten Durchlauf der Anwendung zu ziehen. (da diese möglicherweise noch nicht von persistenten, festplattenbasierten Caches profitiert)

Der Wert wird nur aktualisiert, wenn extendedDataCollectionEnabled aktiviert ist.

Hinweis: Der Wert wird proQQuickWindow gemeldet. Wenn es mehrere View3D Instanzen innerhalb desselben Fensters gibt, zeigt DebugView denselben Wert für alle diese View3Ds an.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.


renderPassCount : int [read-only, since 6.5]

Diese Eigenschaft enthält die Gesamtzahl der Rendering-Durchläufe, die während des letzten Renderings der View3D registriert wurden.

Viele Features, wie z.B. Realtime Shadow Mapping, Postprocessing-Effekte, die Tiefen- und Bildschirmtexturen und bestimmte Antialiasing-Methoden erfordern mehrere zusätzliche Renderdurchgänge. Es ist zwar nicht garantiert, dass die Zahl absolut alle Rendering-Durchgänge umfasst, aber es wird erwartet, dass sie einen guten Hinweis auf die Komplexität des Renderings der Szene gibt.

Der Wert wird nur aktualisiert, wenn extendedDataCollectionEnabled aktiviert ist.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.


renderPrepareTime : real [read-only]

Diese Eigenschaft enthält die Zeit, die in der Vorbereitungsphase des Renderings verbracht wird, in Millisekunden. Dies ist eine Untermenge der gesamten Renderzeit, die in renderTime angegeben wird.


renderTime : real [read-only]

Diese Eigenschaft gibt die Zeit an, die für die Erzeugung eines neuen Frames aufgewendet wird, einschließlich der Vorbereitungsphase und der Aufzeichnung von Zeichenaufrufen. Der Wert wird in Millisekunden angegeben.


syncTime : real [read-only]

Diese Eigenschaft enthält die Zeit, die innerhalb der Sync-Funktion verbracht wird, in Millisekunden. Die Eigenschaftswerte der Objekte werden während der Synchronisierung aktualisiert.


vmemAllocCount : quint32 [read-only, since 6.5]

Falls zutreffend, die Anzahl der von der Grafikspeicher-Zuordnungsbibliothek vorgenommenen Zuweisungen. Dazu gehören Zuweisungen von allen Qt Quick und Qt Quick 3D Renderings in der QQuickWindow, zu der die View3D gehört. Der Wert ist Null bei Grafik-APIs wie OpenGL, Direct3D und Metal, da die Speicherzuweisung in diesem Fall nicht unter der Kontrolle von Qt steht.

Der Wert wird nur aktualisiert, wenn extendedDataCollectionEnabled aktiviert ist.

Hinweis: Der Wert wird auf einerQQuickWindow Basis berichtet. Wenn es mehrere View3D Instanzen im gleichen Fenster gibt, zeigt DebugView den gleichen Wert für alle diese View3Ds an.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.


vmemUsedBytes : quint64 [read-only, since 6.5]

Falls zutreffend, die Anzahl der Bytes, die durch Zuweisungen der Grafikspeicher-Zuweisungsbibliothek verwendet wurden. Dies beinhaltet Zuweisungen von allen Qt Quick und Qt Quick 3D Renderings in der QQuickWindow, zu der die View3D gehört. Der Wert ist Null bei Grafik-APIs wie OpenGL, Direct3D und Metal, da die Speicherzuweisung nicht unter der Kontrolle von Qt steht.

Der Wert wird nur aktualisiert, wenn extendedDataCollectionEnabled aktiviert ist.

Hinweis: Der Wert wird auf einerQQuickWindow Basis berichtet. Wenn es mehrere View3D Instanzen im gleichen Fenster gibt, zeigt DebugView den gleichen Wert für alle diese View3Ds an.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.


© 2025 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.