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
방법
- void reset()
상세 설명
이 요소는 파티클 시스템의 루트이며, 시스템 타이밍을 처리하고 파티클, 이미터, 어펙터와 같은 다른 모든 관련 요소들을 한데 묶어줍니다. 시스템 요소들을 그룹화하려면, 다음과 같이 ParticleSystem3D의 직접 자식 노드여야 합니다:
ParticleSystem3D {
ParticleEmitter3D {
...
}
SpriteParticle3D {
...
}
}또는 시스템 요소가 직접 자식이 아닌 경우, ` system ` 속성을 사용하여 어떤 `ParticleSystem3D`에 속하는지 지정해야 합니다. 다음과 같이:
ParticleSystem3D {
id: psystem
}
ParticleEmitter3D {
system: psystem
...
}
SpriteParticle3D {
system: psystem
...
}속성 설명서
logging : bool
loggingData 를 수집하려면 이 값을 true로 설정하십시오.
참고: 이 속성은 성능에 약간의 영향을 미치므로, 릴리스 버전에서는 활성화하지 않는 것이 좋습니다.
기본값은 ` false`입니다.
loggingData도 참조하십시오 .
loggingData : ParticleSystem3DLogging [read-only]
이 속성에는 파티클 이펙트를 개발하고 최적화할 때 유용할 수 있는 로깅 데이터가 포함되어 있습니다.
참고: 이 속성은 ‘ logging ’가 ‘ true ’로 설정되어 있고 파티클 시스템이 실행 중일 때만 정확한 데이터를 포함합니다.
‘ logging’ 항목도 참조하십시오 .
paused : bool
이 속성은 시스템이 현재 일시 정지 상태인지 여부를 정의합니다. ‘paused’가 ‘ true ’로 설정되면, 파티클 시스템은 시뮬레이션을 진행하지 않습니다. ‘paused’가 다시 ‘ false ’로 설정되면, 시뮬레이션은 일시 정지되었던 지점부터 재개됩니다.
기본값은 false 입니다.
running : bool
이 속성은 시스템이 현재 실행 중인지 여부를 정의합니다. ‘running’이 ‘ false ’으로 설정되면 파티클 시스템의 시뮬레이션이 중지됩니다. 시스템이 다시 ‘running’으로 설정되면 모든 파티클이 소멸됩니다.
time 속성을 수동으로 수정하거나 애니메이션을 적용할 때는 ‘ false ’로 설정해야 합니다.
기본값은 ' true'입니다.
seed : int
이 속성은 입자 무작위화에 사용되는 시드 값을 정의합니다. 동일한 시드를 사용하면 실행할 때마다 입자 효과가 동일하게 나타납니다. 이는 무작위적인 동작보다 결정론적인 동작이 필요한 경우에 유용합니다.
0 기본값은 useRandomSeed 이며, 가 false 로 설정된 경우, 그리고 1..INT32_MAX 와 true 사이의 값으로, useRandomSeed 가 로 설정된 경우입니다.
참고: 이 속성은 파티클 애니메이션이 진행되는 동안 수정해서는 안 됩니다.
useRandomSeed도 참조하십시오 .
startTime : int
이 속성은 시스템이 시작되는 시점을 밀리초 단위로 정의합니다. 이 속성은 시스템이 예열되어 일련의 입자가 이미 방출된 상태가 되도록 하는 데 유용할 수 있습니다. 예를 들어, startTime이 2000으로 설정되어 있고 시스템 time 이 0에서 1000까지 애니메이션이 진행되는 경우, 실제로는 2000ms부터 3000ms까지 입자가 표시됩니다.
기본값은 0 입니다.
time : int
이 속성은 시스템의 시간을 밀리초 단위로 정의합니다.
참고: time 속성을 수정할때는 일반적으로 ` running `을 ` false`으로 설정해야 합니다.
다음은 시스템이 반속도로 3초 동안 반복적으로 애니메이션되도록 수동으로 설정하는 예시입니다:
ParticleSystem3D {
running: false
NumberAnimation on time {
loops: Animation.Infinite
from: 0
to: 3000
duration: 6000
}
}useRandomSeed : bool
이 속성은 파티클 시스템의 시드 값을 무작위로 설정할지, 아니면 사용자가 직접 지정할지 여부를 정의합니다. ‘ true ’로 설정된 경우, 파티클 시스템이 재시작될 때마다 ‘ seed ’에 대한 새로운 무작위 값이 생성됩니다.
기본값은 ‘ true ’입니다.
참고: 이 속성은 파티클 애니메이션이 진행되는 동안에는 수정해서는 안 됩니다.
seed도 참조하십시오 .
메서드 문서
void reset()
이 메서드는 파티클 시스템의 내부 상태를 초기 상태로 재설정합니다. 이 메서드는 ` running ` 속성이 ` false `로 설정되어 있을 때 시스템을 재설정하는 데 사용할 수 있습니다. ` running `가 ` true `인 경우, 시스템이 내부 상태를 직접 관리하므로 이 메서드를 호출할 필요가 없지만, ` false `인 경우에는 시스템을 언제 재설정해야 하는지 시스템에 알려주어야 합니다.
© 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.