RenderStats QML Type
シーンのレンダリングに関する情報を提供します。詳細...
| Import Statement: | import QtQuick3D |
プロパティ
- 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)
詳細な説明
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]
このプロパティは、レンダーパスおよびドローコールの統計情報が処理され、利用可能になるかどうかを制御します。これにはわずかなパフォーマンスのオーバーヘッドが生じる可能性があるため、オプションとなっています。
drawCallCount 、drawVertexCount 、renderPassCount などのプロパティは、このプロパティが true に設定されている場合にのみ更新されます。
デフォルト値は false です。
このプロパティは 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、かつ基盤となるグラフィックスAPIが関連する機能をサポートしている場合、このプロパティには最後に取得されたGPU経過時間がミリ秒単位で格納されます。
注：この値は 非同期で取得され、通常は直前のフレームよりも古いフレームのものを指します。つまり、この値は必ずしも他の CPU 側のタイミングと同期しているとは限りません。
注：結果は 、View3D が属するQQuickWindow のコンテンツ全体のレンダリングに基づいています。これには、Qt Quick シーンのすべてのコンテンツ（そのウィンドウ内のすべての2D要素およびView3D アイテムを含む）が含まれます。
このプロパティは Qt 6.6 で導入されました。
QQuickGraphicsConfiguration::setTimestamps()も参照してください 。
materialGenerationTime : qint64 [read-only, since 6.5]
このプロパティは、View3D が属するウィンドウ内で、DefaultMaterial 、PrincipledMaterial 、およびCustomMaterial のシェーダーコードの生成と処理に費やされた合計ミリ秒数を保持します。
この値は、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へのコンパイルなど、それに伴うすべての処理を含む）。 この値は、View3D が属するウィンドウ内で行われるすべてのQt Quick およびQt Quick による3Dレンダリングを反映しています。
注：この値には 、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]
このプロパティには、sync関数内で費やされた時間がミリ秒単位で格納されます。オブジェクトのプロパティ値は、同期処理中に更新されます。
vmemAllocCount : quint32 [read-only, since 6.5]
該当する場合、グラフィックスメモリアロケータライブラリによって行われた割り当ての回数です。これには、View3D が属するQQuickWindow 内のすべてのQt Quick およびQt Quick による3Dレンダリングからの割り当てが含まれます。OpenGL、Direct3D、MetalなどのグラフィックスAPIでは、メモリ割り当てがQtの管理下にはないため、この値はゼロになります。
この値は、extendedDataCollectionEnabled が有効になっている場合にのみ更新されます。
注：この値は 、QQuickWindow ごとに報告されます。同じウィンドウ内に複数のView3D インスタンスが存在する場合、DebugView はそれらのすべてのView3Dに対して同じ値を表示します。
このプロパティは Qt 6.5 で導入されました。
vmemUsedBytes : quint64 [read-only, since 6.5]
該当する場合、グラフィックスメモリアロケータライブラリによる割り当てで使用されるバイト数です。これには、View3D が属するQQuickWindow 内のすべてのQt Quick およびQt Quick による3Dレンダリングからの割り当てが含まれます。OpenGL、Direct3D、MetalなどのグラフィックスAPIでは、メモリ割り当てがQtの管理下にはないため、この値はゼロになります。
この値は、extendedDataCollectionEnabled が有効な場合にのみ更新されます。
注：この値は 、QQuickWindow ごとに報告されます。同じウィンドウ内に複数のView3D インスタンスが存在する場合、DebugView はそれらのすべてのView3Dに対して同じ値を表示します。
このプロパティは 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.
