ParticleSystem3DLogging QML Type
파티클 시스템에 대한 정보를 제공합니다. 더 보기...
| Import Statement: | import QtQuick3D.Particles3D |
| Since: | Qt 6.2 |
| Inherits: |
속성
- 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와 일치하는 것으로 간주할 수 있습니다.
© 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.