ParticleSystem3DLogging QML Type

Fournit des informations sur le système de particules. En savoir plus…

• Liste de tous les membres, y compris les membres hérités

Propriétés

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

Description détaillée

Le type « ParticleSystem3DLogging » fournit des informations sur les statistiques du système de particules. Cet élément ne peut pas être créé directement, mais peut être récupéré à partir d’un « ParticleSystem3D ».

Documentation sur les propriétés

loggingInterval : int

Cette propriété définit, en millisecondes, la fréquence de mise à jour des données de journalisation. Un intervalle de mise à jour plus long améliore la précision des valeurs « time » et « timeAverage », tandis qu’un intervalle plus court permet de disposer de données plus récentes.

La valeur par défaut est 1000.

particlesMax : int [read-only]

Cette propriété indique le nombre maximal de particules dans ce système. Ce nombre maximal correspond à la somme des propriétés « maxAmount » de toutes les particules du système.

particlesUsed : int [read-only]

Cette propriété indique le nombre de particules actuellement utilisées dans ce système. À un moment donné de l'animation du système de particules, cette valeur devrait être proche de particlesMax. Si elle est nettement inférieure, envisagez de réduire les valeurs de maxAmount. Si elle atteint particlesMax, cela signifie que les particules sont utilisées efficacement, mais cela peut également indiquer qu'elles sont réutilisées avant d'avoir atteint la fin de leur lifeSpan. Dans ce cas, envisagez d'augmenter les valeurs de maxAmount.

time : real [read-only]

Cette propriété stocke la durée, en millisecondes, nécessaire à l'émission et à l'animation des particules à chaque image.

timeAverage : real [read-only]

Cette propriété indique le temps moyen, en millisecondes, nécessaire à l'émission et à l'animation des particules à chaque image. La moyenne est calculée à partir des 50 % centraux des 100 dernières mises à jour de journalisation. Ainsi, lorsque la valeur « loggingInterval » est égale à 1 000, cela correspond à une moyenne de time au cours des 100 dernières secondes. Cette valeur peut être utilisée pour mesurer les performances du système de particules actuel.

timeDeviation : real [read-only, since 6.3]

Cette propriété indique l'écart des temps moyens, exprimé en millisecondes. La valeur correspond à la différence entre les valeurs maximale et minimale des 50 % centraux des résultats, également appelée écart interquartile (IQR). Un écart plus important signifie que les temps varient davantage ; on peut donc considérer que l'timeAverage est moins précise.

Cette propriété a été introduite dans Qt 6.3.

updates : int [read-only]

Cette propriété contient le nombre de mises à jour du système de particules depuis le dernier enregistrement. Lorsque la valeur de « loggingInterval » est égale à 1 000 (valeur par défaut), on peut considérer que ce nombre correspond au nombre d'images par seconde (fps).