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このプロパティには、最後に取得された GPU 経過時間がミリ秒単位で格納されます。
注意: この値は非同期に取得され、通常は前のフレームよりも古いフレームを参照します。
注： 結果は、View3D が属するQQuickWindow のコンテンツ全体のレンダリングに基づいている。これには、すべての 2D 要素とそのウィンドウ内のすべてのView3D アイテムを含む、Qt Quick シーンのすべてのコンテンツが含まれます。
このプロパティは 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]
このプロパティは、同期関数内で費やされる時間をミリ秒単位で保持する。オブジェクトのプロパティ値は、同期中に更新されます。
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 Quick とQt Quick 3D のレンダリングからの割り当てが含まれます。OpenGL、Direct3D、MetalなどのグラフィックスAPIでは、メモリ割り当てがQtの制御下にないため、値は0になります。
この値は、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.
