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）相等。