ParticleSystem3D QML Type
파티클, 이미터 및 어펙터 유형을 포함하는 시스템입니다. 더 보기...
Import Statement: | import QtQuick3D.Particles3D |
Since: | Qt 6.2 |
Inherits: |
프로퍼티
- logging : bool
- loggingData : ParticleSystem3DLogging
- paused : bool
- running : bool
- seed : int
- startTime : int
- time : int
- useRandomSeed : bool
방법
- reset()
상세 설명
이 엘리먼트는 파티클 시스템의 루트로, 시스템 타이밍을 처리하고 파티클, 이미터, 이펙터 등 다른 모든 관련 엘리먼트를 그룹화합니다. 시스템 요소를 그룹화하려면 이와 같이 파티클 시스템 3D의 직접 자손이어야 합니다:
ParticleSystem3D { ParticleEmitter3D { ... } SpriteParticle3D { ... } }
또는 시스템 요소가 직접 자식이 아닌 경우 system
프로퍼티를 사용하여 해당 요소가 속한 파티클시스템3D를 가리켜야 합니다. 다음과 같이요:
ParticleSystem3D { id: psystem } ParticleEmitter3D { system: psystem ... } SpriteParticle3D { system: psystem ... }
프로퍼티 문서
logging : bool |
loggingData 을 수집하려면 true 로 설정합니다.
참고: 이 프로퍼티는 퍼포먼스에 약간의 영향을 미치므로 릴리스에서는 활성화하지 않는 것이 좋습니다.
기본값은 false
입니다.
loggingData도 참조하세요 .
loggingData : ParticleSystem3DLogging |
paused : bool |
이 프로퍼티는 시스템이 현재 일시 중지되었는지 여부를 정의합니다. 일시 중지가 true
로 설정되어 있으면 파티클 시스템은 시뮬레이션을 진행하지 않습니다. 일시 중지를 false
으로 다시 설정하면 시뮬레이션이 일시 중지된 동일한 지점에서 다시 시작됩니다.
기본값은 false
입니다.
running : bool |
이 속성은 시스템이 현재 실행 중인지 여부를 정의합니다. 실행 중이 false
으로 설정되어 있으면 파티클 시스템이 시뮬레이션을 중지합니다. 시스템이 다시 실행 중으로 설정되면 모든 파티클이 소멸됩니다.
time 프로퍼티를 수동으로 수정/애니메이션할 때는 실행을 false
으로 설정해야 합니다.
기본값은 true
입니다.
seed : int |
이 프로퍼티는 파티클 무작위화에 사용되는 시드 값을 정의합니다. 동일한 시드를 사용하면 모든 실행에서 파티클 효과가 동일하게 적용됩니다. 이는 무작위 동작보다 결정론적 동작을 원할 때 유용합니다.
기본값은 useRandomSeed 이 false
로 설정된 경우 0
이며, useRandomSeed 이 true
로 설정된 경우 1..INT32_MAX
의 중간 값입니다.
참고: 파티클 애니메이션 중에는 이 프로퍼티를 수정해서는 안 됩니다.
useRandomSeed 를참조하십시오 .
startTime : int |
이 프로퍼티는 시스템이 시작되는 시간을 밀리초 단위로 정의합니다. 파티클 세트가 이미 방출되도록 시스템을 워밍업하는 데 유용할 수 있습니다. 예를 들어 startTime이 2000으로 설정되어 있고 time 시스템이 0에서 1000까지 애니메이션을 실행하는 경우 실제로 애니메이션은 2000에서 3000ms 사이의 파티클을 표시합니다.
기본값은 0
입니다.
time : int |
이 속성은 시스템의 시간을 밀리초 단위로 정의합니다.
참고: 시간 속성을 수정할 때는 일반적으로 running 을 false
으로 설정해야 합니다.
다음은 시스템을 절반 속도로 3초 동안 반복하여 수동으로 애니메이션을 적용하는 예제입니다:
ParticleSystem3D { running: false NumberAnimation on time { loops: Animation.Infinite from: 0 to: 3000 duration: 6000 } }
useRandomSeed : bool |
메서드 문서
reset() |
© 2025 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.