RenderStats QML Type

シーンレンダリングの情報を提供します。詳細...

Import Statement: import QtQuick3D

プロパティ

詳細説明

RenderStats タイプは、シーンのレンダリング統計に関する情報を提供します。これは直接作成できませんが、View3D から取得できます。

データを画面上に表示するには、DebugView アイテムを使用してください。

プロパティ ドキュメント

drawCallCount : quint64 [read-only, since 6.5]

このプロパティは、View3D の最後のレンダリング中に登録された描画呼び出しの総数(非インデックス化、インデックス化、インスタンス化、およびインスタンス化インデックス化描画呼び出しを含む)を保持する。

この値は、extendedDataCollectionEnabled が有効な場合にのみ更新されます。

このプロパティは Qt 6.5 で導入されました。


drawVertexCount : quint64 [read-only, since 6.5]

このプロパティは、View3D の最後のレンダリング中に登録された描画呼び出しの頂点数の合計を保持します。

この値には、View3D の最後のレンダリング中に登録された描画呼び出しの頂点数とインデックス数が含まれます。この数が完全に正確であることは保証されませんが、シーンのレンダリングの複雑さの良い目安になることが期待されます。

この値は、extendedDataCollectionEnabled が有効な場合にのみ更新されます。

このプロパティは Qt 6.5 で導入されました。


effectGenerationTime : qint64 [read-only, since 6.5]

このプロパティは、View3D が属するウィンドウの後処理エフェクトのシェーダーコードの生成と処理に費やされたミリ秒の総数を保持します。

この値は、extendedDataCollectionEnabled が有効な場合にのみ更新されます。

注: 値はQQuickWindow ごとに報告されます。同じウィンドウ内に複数のView3D インスタンスがある場合、DebugView は、それらのすべての View3D に対して同じ値を表示します。

このプロパティは Qt 6.5 で導入されました。


extendedDataCollectionEnabled : bool [since 6.5]

このプロパティは、レンダーパスと描画コールの統計が処理され、利用可能になるかどうかを制御します。これは、わずかなパフォーマンスコストが発生する可能性があるため、オプションとなっています。

drawCallCountdrawVertexCountrenderPassCount などのプロパティは、このプロパティが true に設定されている場合にのみ更新されます。

デフォルト値はfalseです。

注: View3D に関連付けられたDebugView の可視性を変更すると、DebugViewvisible プロパティに基づく値が自動的に切り替わります。

このプロパティは Qt 6.5 で導入されました。


fps : int [read-only]

このプロパティは、最後の 1 秒間にレンダリングされたフレーム数を保持します。


frameTime : real [read-only]

このプロパティは、最後のフレームからの経過時間をミリ秒単位で保持します。


graphicsAPIName : string [read-only, since 6.5]

このプロパティは、現在使用されているグラフィックス API(RHI)バックエンドの名前を保持します。

このプロパティは Qt 6.5 で導入されました。


imageDataSize : quint64 [read-only, since 6.5]

このプロパティは、View3D のウィンドウに現在登録されているテクスチャ・マップのイメージ・データのおおよそのサイズをバイト単位で保持します。つまり、同じQQuickWindow 内に複数のView3D オブジェクトがある場合、それらのオブジェクトはおそらく同じ値を報告します。

この値は、extendedDataCollectionEnabled が有効な場合にのみ更新されます。

注: 値はQQuickWindow 毎に報告されます。同じウィンドウ内に複数のView3D インスタンスがある場合、DebugView は、それらすべての View3D に対して同じ値を表示します。

このプロパティは Qt 6.5 で導入されました。


lastCompletedGpuTime : real [read-only, since 6.6]

GPU タイミング収集が enabled in Qt Quickこのプロパティは、GPU タイミング収集が Qt 6.5 で導入され、関連する機能が基礎となるグラフィックス API でサポートされている場合、最後に取得された GPU 経過時間をミリ秒単位で格納します。

注意: この値は非同期に取得され、通常は前のフレームよりも古いフレームを参照します。

注: 結果は、View3D が属するQQuickWindow のコンテンツ全体のレンダリングに基づいている。これには、すべての 2D 要素とそのウィンドウ内のすべてのView3D アイテムを含む、Qt Quick シーンのすべてのコンテンツが含まれます。

このプロパティは Qt 6.6 で導入されました。

QQuickGraphicsConfiguration::setTimestamps()も参照してください


materialGenerationTime : qint64 [read-only, since 6.5]

このプロパティは、View3D が属するウィンドウ内のDefaultMaterialPrincipledMaterialCustomMaterial のシェーダー・コードの生成と処理に費やされた総ミリ秒数を保持します。

この値は、extendedDataCollectionEnabled が有効な場合にのみ更新されます。

注: この値はQQuickWindow ごとに報告されます。同じウィンドウ内に複数のView3D インスタンスがある場合、DebugView は、それらすべての View3D に対して同じ値を表示します。

このプロパティは Qt 6.5 で導入されました。


maxFrameTime : real [read-only]

このプロパティは、最後の 1 秒間に 1 フレームのレンダリングに費やされた最大時間を保持します。


meshDataSize : quint64 [read-only, since 6.5]

このプロパティは、View3D のウィンドウに現在登録されているメッシュデータのおおよそのサイズをバイト単位で保持します。この値はウィンドウ単位です。つまり、同じQQuickWindow 内に複数のView3D オブジェクトがある場合、それらのオブジェクトはおそらく同じ値を報告します。

この値は、extendedDataCollectionEnabled が有効な場合にのみ更新されます。

注: 値はQQuickWindow 毎に報告されます。同じウィンドウ内に複数のView3D インスタンスがある場合、DebugView は、それらすべての View3D に対して同じ値を表示します。

このプロパティは Qt 6.5 で導入されました。


pipelineCount : int [read-only, since 6.5]

このプロパティは、View3D が属するウィンドウのキャッシュされたグラフィックス パイプラインの総数を保持します。

この値は、extendedDataCollectionEnabled が有効な場合にのみ更新されます。

注意: この値はQQuickWindow ごとに報告されます。同じウィンドウ内に複数のView3D インスタンスがある場合、DebugView は、それらすべての View3D に対して同じ値を表示します。

このプロパティは Qt 6.5 で導入されました。


pipelineCreationTime : qint64 [read-only, since 6.5]

このプロパティは、レンダリング・ハードウェア・インターフェイス・レベルのグラフィックス・パイプラインの作成に費やされた総ミリ秒数を保持します。これには、特に、HLSL を中間フォーマットにコンパイルするコンパイル時間、MSL をコンパイルするコンパイル時間、glCompileShader を使用して GLSL コードをコンパイルするコンパイル時間、またはプログラムバイナリを使用してリンクするコンパイル時間、およびすべてを伴う Vulkan パイプラインを生成するコンパイル時間(SPIR-V -> ISA コンパイルなど)が含まれます。この値は、Qt Quick およびQt Quick のすべての 3D レンダリングを、View3D が属するウィンドウに反映します。

注意: この値には、Qt の制御下にある操作が含まれます。基礎となるグラフィックス API によっては、パイプライン(シェーダー、グラフィックス状態)に関連する操作が非同期に行われることがあり、グラフィックススタックのさまざまなレベルでのキャッシュの影響を受けることがあります。QQuickWindow::releaseResources() を呼び出すか、対応するDebugView ボタンをクリックすることで、キャッシュされたリソースを解放することも、基本的な詳細(rhi バックエンド、グラフィックス API)によって結果が異なる場合があります。

このタイミングは、一般的な高レベルの表示として提供されています。materialGenerationTime と組み合わせることで、アプリケーション開発者はこれらの値を使用し て、すべてのキャッシュ(永続的およびインメモリの両方)がウォームアップされれば、アプリケー ションの通常の使用において、マテリアルとグラフィックスパイプラインの処理に費やされる時間 が合理的に低いことを確認することができます。アプリケーションの最初の実行から結論を出すことは避けてください。(アプリケーションの最初の実行から結論を出すのは避けてください。)

この値は、extendedDataCollectionEnabled が有効な場合にのみ更新されます。

注: 値はQQuickWindow 毎に報告される。同じウィンドウ内に複数のView3D インスタンスがある場合、DebugView は、それらのすべての View3D に対して同じ値を表示します。

このプロパティは Qt 6.5 で導入されました。


renderPassCount : int [read-only, since 6.5]

このプロパティは、View3D の最後のレンダリング中に登録されたレンダーパスの合計数を保持します。

リアルタイムシャドウマッピング、ポストプロセッシングエフェクト、デプスとスクリーンテクスチャ、特定のアンチエイリアシング手法など、多くの機能には複数の追加レンダーパスが含まれます。この数値は、絶対にすべてのレンダーパスを含むことを保証するものではありませんが、シーンレンダリングの複雑さの良い指標を与えることが期待されます。

この値は、extendedDataCollectionEnabled が有効な場合にのみ更新されます。

このプロパティは、Qt 6.5 で導入されました。


renderPrepareTime : real [read-only]

このプロパティは、レンダリングの準備段階で費やされた時間をミリ秒単位で保持します。これは、renderTime で報告される総レンダリング時間のサブセットです。


renderTime : real [read-only]

このプロパティは、準備段階と描画呼び出しの記録の両方を含む、新しいフレームの生成に費やされた時間の量を保持します。値の単位はミリ秒です。


syncTime : real [read-only]

このプロパティは、同期関数内で費やされた時間をミリ秒単位で保持します。オブジェクトのプロパティ値は、同期中に更新される。


vmemAllocCount : quint32 [read-only, since 6.5]

該当する場合、グラフィックス・メモリ・アロケータ・ライブラリによって行われた割り当ての数。これには、View3D が属するQQuickWindow 内のすべてのQt Quick およびQt Quick の 3D レンダリングによる割り当てが含まれます。OpenGL、Direct3D、MetalなどのグラフィックスAPIでは、メモリ割り当てがQtの制御下にないため、値は0になります。

この値は、extendedDataCollectionEnabled が有効な場合にのみ更新されます。

注意: 値はQQuickWindow 毎に報告されます。同じウィンドウ内に複数のView3D インスタンスがある場合、DebugView はそれらすべての View3D に対して同じ値を表示します。

このプロパティは Qt 6.5 で導入されました。


vmemUsedBytes : quint64 [read-only, since 6.5]

該当する場合、グラフィックス・メモリ・アロケータ・ライブラリによる割り当てによって使用されたバイト数。これには、View3D が属するQQuickWindow のすべてのQt QuickQt Quick の 3D レンダリングからの割り当てが含まれます。OpenGL、Direct3D、MetalなどのグラフィックスAPIでは、メモリ割り当てがQtの制御下にないため、この値は0になります。

この値は、extendedDataCollectionEnabled が有効な場合にのみ更新されます。

注意: 値はQQuickWindow 毎に報告されます。同じウィンドウ内に複数のView3D インスタンスがある場合、DebugView はそれらのすべての View3D に対して同じ値を表示します。

このプロパティは Qt 6.5 で導入されました。


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