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 : float
- graphicsAPIName : string
(since 6.5)
- imageDataSize : quint64
(since 6.5)
- lastCompletedGpuTime : float
(since 6.6)
- materialGenerationTime : qint64
(since 6.5)
- maxFrameTime : float
- meshDataSize : quint64
(since 6.5)
- pipelineCount : int
(since 6.5)
- pipelineCreationTime : qint64
(since 6.5)
- renderPassCount : int
(since 6.5)
- renderPrepareTime : float
- renderTime : float
- syncTime : float
- vmemAllocCount : quint32
(since 6.5)
- vmemUsedBytes : quint64
(since 6.5)
詳細説明
RenderStats 型は、シーンのレンダリング統計に関する情報を提供します。これは直接作成することはできませんが、View3D から取得することができます。
データを画面に表示するには、DebugView アイテムを使用してください。
プロパティ ドキュメント
drawCallCount : quint64 |
このプロパティは、View3D の最後のレンダリング中に登録された描画呼び出しの総数(非インデックス化、インデックス化、インスタンス化、およびインスタンス化インデックス化描画呼び出しを含む)を保持する。
この値は、extendedDataCollectionEnabled が有効な場合にのみ更新されます。
このプロパティは Qt 6.5 で導入されました。
drawVertexCount : quint64 |
このプロパティは、View3D の最後のレンダリング中に登録された描画呼び出しの頂点数の合計を保持します。
この値には、View3D の最後のレンダリング中に登録された描画呼び出しの頂点数とインデックス数が含まれます。この数が完全に正確であることは保証されませんが、シーンのレンダリングの複雑さの良い目安になることが期待されます。
この値は、extendedDataCollectionEnabled が有効な場合にのみ更新されます。
このプロパティは Qt 6.5 で導入されました。
effectGenerationTime : qint64 |
このプロパティは、View3D が属するウィンドウの後処理エフェクトのシェーダーコードの生成と処理に費やされたミリ秒の総数を保持します。
この値は、extendedDataCollectionEnabled が有効な場合にのみ更新されます。
注: 値はQQuickWindow ごとに報告されます。同じウィンドウ内に複数のView3D インスタンスがある場合、DebugView は、それらのすべての View3D に対して同じ値を表示します。
このプロパティは Qt 6.5 で導入されました。
extendedDataCollectionEnabled : bool |
このプロパティは、レンダーパスと描画コールの統計が処理され、利用可能になるかどうかを制御します。これは、わずかなパフォーマンスコストが発生する可能性があるため、オプションとなっています。
drawCallCount 、drawVertexCount 、renderPassCount などのプロパティは、このプロパティが true に設定されている場合にのみ更新されます。
デフォルト値はfalseです。
このプロパティは Qt 6.5 で導入されました。
fps : int |
このプロパティは、最後の 1 秒間にレンダリングされたフレーム数を保持します。
frameTime : float |
このプロパティは、最後のフレームからの経過時間をミリ秒単位で保持します。
graphicsAPIName : string |
このプロパティは、現在使用されているグラフィックス API(RHI)バックエンドの名前を保持します。
このプロパティは Qt 6.5 で導入されました。
imageDataSize : quint64 |
このプロパティは、View3D のウィンドウに現在登録されているテクスチャ・マップのイメージ・データのおおよそのサイズをバイト単位で保持します。つまり、同じQQuickWindow 内に複数のView3D オブジェクトがある場合、それらのオブジェクトはおそらく同じ値を報告します。
この値は、extendedDataCollectionEnabled が有効な場合にのみ更新されます。
注: 値はQQuickWindow ごとに報告されます。同じウィンドウ内に複数のView3D インスタンスがある場合、DebugView は、それらすべての View3D に対して同じ値を表示します。
このプロパティは Qt 6.5 で導入されました。
lastCompletedGpuTime : float |
GPU タイミング収集がenabled in Qt Quick であり、関連する機能が基礎となるグラフィックス API でサポートされている場合、このプロパティには、最後に取得された GPU 経過時間がミリ秒単位で格納されます。
注意: この値は非同期で取得され、通常は前のフレームより古いフレームを指しま す。つまり、この値は他の CPU 側のタイミングと必ずしも同期していません。
注: 結果は、View3D が属するQQuickWindow のコンテンツ全体のレンダリングに基づいています。これには、そのウィンドウ内のすべての 2D 要素とすべてのView3D アイテムを含む、Qt Quick シーンのすべてのコンテンツが含まれます。
このプロパティは Qt 6.6 で導入されました。
QQuickGraphicsConfiguration::setTimestamps()も参照してください 。
materialGenerationTime : qint64 |
このプロパティは、View3D が属するウィンドウで、DefaultMaterial 、PrincipledMaterial 、CustomMaterial のシェーダー・コードの生成と処理に費やされた合計ミリ秒数を保持します。
この値は、extendedDataCollectionEnabled が有効な場合にのみ更新されます。
注: この値はQQuickWindow ごとに報告されます。同じウィンドウ内に複数のView3D インスタンスがある場合、DebugView は、それらのすべての View3D に対して同じ値を表示します。
このプロパティは Qt 6.5 で導入されました。
maxFrameTime : float |
このプロパティは、最後の 1 秒間に 1 フレームのレンダリングに費やされた最大時間を保持します。
meshDataSize : quint64 |
このプロパティは、View3D のウィンドウに現在登録されているメッシュデータのおおよそのサイズをバイト単位で保持します。この値はウィンドウ単位です。つまり、同じQQuickWindow 内に複数のView3D オブジェクトがある場合、それらのオブジェクトはおそらく同じ値を報告します。
この値は、extendedDataCollectionEnabled が有効な場合にのみ更新されます。
注: 値はQQuickWindow ごとに報告されます。同じウィンドウ内に複数のView3D インスタンスがある場合、DebugView は、それらすべての View3D に対して同じ値を表示します。
このプロパティは Qt 6.5 で導入されました。
pipelineCount : int |
このプロパティは、View3D が属するウィンドウのキャッシュされたグラフィックス パイプラインの総数を保持します。
この値は、extendedDataCollectionEnabled が有効な場合にのみ更新されます。
注意: この値はQQuickWindow ごとに報告されます。同じウィンドウ内に複数のView3D インスタンスがある場合、DebugView は、それらすべての View3D に対して同じ値を表示します。
このプロパティは Qt 6.5 で導入されました。
pipelineCreationTime : qint64 |
このプロパティは、レンダリング・ハードウェア・インターフェイス・レベルのグラフィックス・パイプラインの作成に費やされた総ミリ秒数を保持します。これには、特に、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 |
このプロパティは、View3D の最後のレンダリング中に登録されたレンダーパスの合計数を保持します。
リアルタイムシャドウマッピング、ポストプロセッシングエフェクト、デプスとスクリーンテクスチャ、特定のアンチエイリアシング手法など、多くの機能には複数の追加レンダーパスが含まれます。この数値は、絶対にすべてのレンダーパスを含むことを保証するものではありませんが、シーンレンダリングの複雑さの良い指標を与えることが期待されます。
この値は、extendedDataCollectionEnabled が有効な場合にのみ更新されます。
このプロパティは、Qt 6.5 で導入されました。
renderPrepareTime : float |
このプロパティは、レンダリングの準備段階で費やされた時間をミリ秒単位で保持します。これは、renderTime で報告される総レンダリング時間のサブセットです。
renderTime : float |
このプロパティは、準備段階と描画呼び出しの記録の両方を含む、新しいフレームの生成に費やされた時間の量を保持します。値の単位はミリ秒です。
syncTime : float |
このプロパティは、同期関数内で費やされた時間をミリ秒単位で保持します。オブジェクトのプロパティ値は、同期中に更新される。
vmemAllocCount : quint32 |
該当する場合、グラフィックス・メモリ・アロケータ・ライブラリによって行われた割り当ての数。これには、View3D が属するQQuickWindow のすべての Qt Quick および Qt Quick 3D レンダリングによる割り当てが含まれます。OpenGL、Direct3D、MetalなどのグラフィックスAPIでは、メモリ割り当てがQtの制御下にないため、値は0になります。
この値は、extendedDataCollectionEnabled が有効な場合にのみ更新されます。
注意: 値はQQuickWindow 毎に報告されます。同じウィンドウ内に複数のView3D インスタンスがある場合、DebugView はそれらのすべての View3D に対して同じ値を表示します。
このプロパティは Qt 6.5 で導入されました。
vmemUsedBytes : quint64 |
該当する場合、グラフィックス・メモリ・アロケータ・ライブラリによる割り当てによって使用されたバイト数。これには、View3D が属するQQuickWindow のすべての Qt Quick および Qt Quick 3D レンダリングからの割り当てが含まれます。OpenGL、Direct3D、MetalなどのグラフィックスAPIでは、メモリ割り当てがQtの制御下にないため、この値は0になります。
この値は、extendedDataCollectionEnabled が有効な場合にのみ更新されます。
注意: 値はQQuickWindow 毎に報告されます。同じウィンドウ内に複数のView3D インスタンスがある場合、DebugView はそれらのすべての View3D に対して同じ値を表示します。
このプロパティは Qt 6.5 で導入されました。
©2024 The Qt Company Ltd. 本書に含まれるドキュメントの著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。