RenderStats QML Type

Enthält Informationen zur Darstellung der Szene. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• 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)

Ausführliche Beschreibung

Der Typ „RenderStats“ liefert Informationen zu den Rendering-Statistiken einer Szene. Er kann nicht direkt erstellt werden, sondern muss über ein „ View3D “ abgerufen werden.

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

Dokumentation zu den Eigenschaften

drawCallCount : quint64 [read-only, since 6.5]

Diese Eigenschaft enthält die Gesamtzahl der Draw-Calls (einschließlich nicht indizierter, indizierter, instanzierter und instanziert-indizierter Draw-Calls), die während des letzten Rendervorgangs des „ 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 Gesamtanzahl der Eckpunkte in den Draw-Calls, die während des letzten Rendervorgangs der „ View3D “ registriert wurden.

Der Wert umfasst die Anzahl der Scheitelpunkte und Indizes aus den Draw-Calls, die während des letzten Rendervorgangs von „ View3D “ registriert wurden. Obwohl nicht garantiert werden kann, dass diese Zahl absolut genau ist, liefert sie voraussichtlich einen guten Anhaltspunkt für die Komplexität der Szenenwiedergabe.

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 Generierung und Verarbeitung von Shader-Code für Nachbearbeitungseffekte in dem Fenster aufgewendet wurden, zu dem der „ View3D “ gehört.

Der Wert wird nur aktualisiert, wenn „ extendedDataCollectionEnabled “ aktiviert ist.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.

extendedDataCollectionEnabled : bool [since 6.5]

Diese Eigenschaft legt fest, ob Statistiken zu Render-Passes und Draw-Calls verarbeitet und bereitgestellt werden. Dies kann zu geringfügigen Leistungseinbußen 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“.

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 seit dem letzten Bild verstrichene Zeit in Millisekunden.

graphicsAPIName : string [read-only, since 6.5]

Diese Eigenschaft enthält den Namen des derzeit verwendeten Backends der Grafik-API (RHI).

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 in Byte der Bilddaten für Textur-Maps, die derzeit im Fenster des „ View3D “ registriert sind. Der Wert gilt pro Fenster, d. h., wenn sich mehrere „ View3D “-Objekte innerhalb desselben „ QQuickWindow “ befinden, melden diese wahrscheinlich denselben Wert.

Der Wert wird nur aktualisiert, wenn „ extendedDataCollectionEnabled “ aktiviert ist.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.

lastCompletedGpuTime : real [read-only, since 6.6]

Wenn die Erfassung von GPU-Zeitdaten aktiviert ist enabled in Qt Quickund die entsprechenden Funktionen von der zugrunde liegenden Grafik-API unterstützt werden, enthält diese Eigenschaft die zuletzt abgerufene verstrichene GPU-Zeit in Millisekunden.

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 Generierung und Verarbeitung von Shader-Code für DefaultMaterial, PrincipledMaterial und CustomMaterial in dem Fenster aufgewendet wurden, zu dem die „ View3D “ gehört.

Der Wert wird nur aktualisiert, wenn „ extendedDataCollectionEnabled “ aktiviert ist.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.

maxFrameTime : real [read-only]

Diese Eigenschaft gibt die maximale Zeit an, die in der letzten Sekunde für das Rendern eines einzelnen Frames aufgewendet wurde.

meshDataSize : quint64 [read-only, since 6.5]

Diese Eigenschaft enthält die ungefähre Größe in Byte der Mesh-Daten, die derzeit im Fenster von „ View3D “ registriert sind. Der Wert gilt pro Fenster, d. h., wenn sich mehrere „ View3D “-Objekte innerhalb desselben „ QQuickWindow “-Fensters befinden, melden diese wahrscheinlich denselben Wert.

Der Wert wird nur aktualisiert, wenn „ extendedDataCollectionEnabled “ aktiviert ist.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.

pipelineCount : int [read-only, since 6.5]

Diese Eigenschaft enthält die Gesamtzahl der zwischengespeicherten Grafik-Pipelines für das Fenster, zu dem die „ View3D “ gehört.

Der Wert wird nur aktualisiert, wenn „ extendedDataCollectionEnabled “ aktiviert ist.

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 Grafik-Pipelines auf der Ebene der Rendering-Hardware-Schnittstelle aufgewendet wurden. Dies kann unter anderem Folgendes umfassen: Kompilierungszeiten für die Kompilierung von HLSL in ein Zwischenformat, die Kompilierung von MSL, die Kompilierung von GLSL-Code mit `glCompileShader` oder das Verknüpfen mithilfe von Programm-Binärdateien sowie die Generierung von Vulkan-Pipelines mit allem, was dazu gehört (z. B. SPIR-V-zu-ISA-Kompilierung). Der Wert spiegelt das gesamte „ Qt Quick “- und „ Qt Quick 3D “-Rendering in dem Fenster wider, zu dem die „ View3D “ gehört.

Diese Zeitangaben dienen als allgemeine, grobe Richtwerte. In Kombination mit ` materialGenerationTime` können Anwendungsentwickler diese Werte nutzen, um zu überprüfen, ob die für die Material- und Grafik-Pipeline-Verarbeitung aufgewendete Zeit während der normalen Nutzung der Anwendung angemessen gering ist, sobald alle Caches (sowohl persistente als auch im Arbeitsspeicher befindliche) „warm“ sind. Ziehen Sie keine Schlussfolgerungen aus dem ersten Start der Anwendung. (Da diese möglicherweise noch nicht von persistenten, festplattenbasierten Caches profitiert.)

Der Wert wird nur aktualisiert, wenn „ extendedDataCollectionEnabled “ aktiviert ist.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.

renderPassCount : int [read-only, since 6.5]

Diese Eigenschaft enthält die Gesamtzahl der Render-Durchläufe, die beim letzten Rendervorgang des „ View3D “ registriert wurden.

Viele Funktionen, wie beispielsweise Echtzeit-Shadow-Mapping, Postprocessing-Effekte, die Tiefen- und Bildschirmtexturen sowie bestimmte Antialiasing-Verfahren, erfordern mehrere zusätzliche Render-Durchläufe. Es kann zwar nicht garantiert werden, dass diese Zahl absolut alle Render-Durchläufe umfasst, sie liefert jedoch voraussichtlich einen guten Anhaltspunkt für die Komplexität der Szenenwiedergabe.

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 wurde, in Millisekunden. Dies ist ein Teil der Gesamt-Renderzeit, die unter „ renderTime “ angegeben wird.

renderTime : real [read-only]

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

syncTime : real [read-only]

Diese Eigenschaft enthält die Zeit, die innerhalb der Synchronisierungsfunktion verbracht wurde, in Millisekunden. Die Eigenschaftswerte der Objekte werden während der Synchronisierung aktualisiert.

vmemAllocCount : quint32 [read-only, since 6.5]

Gegebenenfalls die Anzahl der Zuweisungen, die von der Bibliothek für die Grafikspeicherzuweisung vorgenommen wurden. Dies umfasst Zuweisungen aus allen „ Qt Quick “- und „ Qt Quick 3D “-Renderings im „ QQuickWindow “, zu dem das „ View3D “ gehört. Bei Grafik-APIs wie OpenGL, Direct3D und Metal ist der Wert Null, da die Speicherzuweisung in diesem Fall nicht unter der Kontrolle von Qt steht.

Der Wert wird nur aktualisiert, wenn „ extendedDataCollectionEnabled “ aktiviert ist.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.

vmemUsedBytes : quint64 [read-only, since 6.5]

Gegebenenfalls die Anzahl der Bytes, die von der Grafik-Speicherzuweisungsbibliothek zugewiesen wurden. Dies umfasst Zuweisungen aus allen „ Qt Quick “- und „ Qt Quick 3D “-Renderings in der „ QQuickWindow “, zu der die „ View3D “ gehört. Bei Grafik-APIs wie OpenGL, Direct3D und Metal ist der Wert Null, da die Speicherzuweisung in diesen Fällen nicht unter der Kontrolle von Qt steht.

Der Wert wird nur aktualisiert, wenn „ extendedDataCollectionEnabled “ aktiviert ist.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.