ParticleSystem3DLogging QML Type

パーティクルシステムに関する情報を提供します。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• loggingInterval : int
• particlesMax : int
• particlesUsed : int
• time : real
• timeAverage : real
• timeDeviation : real (since 6.3)
• updates : int

詳細説明

ParticleSystem3DLogging 型は、パーティクルシステムの統計情報に関する情報を提供します。この要素は直接作成することはできませんが、ParticleSystem3D から取得することができます。

プロパティのドキュメント

loggingInterval : int

このプロパティは、ロギングデータの更新頻度をミリ秒単位で指定します。更新間隔を長くすると、time およびtimeAverage の精度が高まりますが、更新間隔を短くすると、データがより最新の状態に保たれます。

デフォルト値は1000 です。

particlesMax : int [read-only]

このプロパティは、このシステム内のパーティクルの最大数を保持します。最大数は、システムのパーティクルmaxAmount のプロパティの合計値です。

particlesUsed : int [read-only]

このプロパティは、このシステムで現在使用中のパーティクルの数を保持します。この値は、パーティクルシステムのアニメーションの特定の時点において、particlesMax に近い値になるはずです。もしこの値が大幅に小さい場合は、maxAmount の値を小さくすることを検討してください。particlesMax に達した場合、パーティクルは効率的に使用されていますが、これはパーティクルがlifeSpan の終了前に再利用されていることを意味する可能性もあります。この場合は、maxAmount の値を大きくすることを検討してください。

time : real [read-only]

このプロパティは、各フレームでパーティクルの発射およびアニメーション処理に要した時間をミリ秒単位で保持します。

timeAverage : real [read-only]

このプロパティには、各フレームにおけるパーティクルのエミッションおよびアニメーション処理に要した平均時間（ミリ秒単位）が格納されます。 平均値は、過去最大100件のロギング更新のうち、中央値の50％から算出されます。したがって、loggingInterval が1000の場合、これは過去100秒間の平均time を表します。これは、現在のパーティクルシステムのパフォーマンスを測定するために使用できます。

timeDeviation : real [read-only, since 6.3]

このプロパティは、平均時間の偏差をミリ秒単位で保持します。この値は、結果の中央50％の最大値と最小値の差であり、四分位範囲（IQR）とも呼ばれます。偏差が大きいほど、時間の変動が激しいことを意味するため、timeAverage の精度は低いと見なすことができます。

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

updates : int [read-only]

このプロパティは、前回のログ記録以降に行われたパーティクルシステムの更新回数を保持します。loggingInterval が1000（デフォルト）の場合、これはfpsと一致すると見なすことができます。