Emitter QML Type
논리적 입자를 방출합니다. 더 보기...
Import Statement: | import QtQuick.Particles |
속성
- acceleration : StochasticDirection
- emitRate : real
- enabled : bool
- endSize : real
- group : string
- lifeSpan : int
- lifeSpanVariation : int
- maximumEmitted : int
- shape : Shape
- size : real
- sizeVariation : real
- startTime : int
- system : ParticleSystem
- velocity : StochasticDirection
- velocityFromMovement : real
신호
- emitParticles(Array particles)
방법
상세 설명
이 요소는 주어진 시작 속성을 사용하여 ParticleSystem 로 논리 입자를 방출합니다.
논리적 파티클은 자동으로 렌더링되지 않으므로 이를 시각화하는 ParticlePainter 요소가 하나 이상 있어야 합니다.
주어진 시작 속성은 파티클의 수명 중 언제든 동일한 ParticleSystem 에 있는 어펙터 엘리먼트에 의해 수정될 수 있습니다. 여기에는 수명과 같은 어트리뷰트가 포함됩니다.
프로퍼티 문서
acceleration : StochasticDirection |
방출되는 파티클의 시작 가속도입니다.
emitRate : real |
초당 방출되는 파티클 수입니다.
기본값은 초당 파티클 10개입니다.
enabled : bool |
false로 설정하면 이미터는 true로 설정될 때까지 방출을 중단합니다.
기본값은 참입니다.
endSize : real |
수명이 끝날 때 파티클의 픽셀 단위 크기입니다. 파티클의 수명 동안 이 값과 크기를 선형 보간하여 크기가 결정됩니다. endSize가 -1이면 파티클의 크기는 시작 크기에서 일정하게 유지됩니다.
기본값은 -1입니다.
group : string |
파티클이 방출될 논리적 파티클 그룹입니다.
기본값은 ""(빈 문자열)입니다.
lifeSpan : int |
방출된 각 파티클이 지속될 시간(밀리초)입니다.
파티클이 일정 시간이 지나면 자동으로 죽지 않게 하려면(예: 수동으로 폐기하려는 경우), lifeSpan을 Emitter.InfiniteLife로 설정합니다.
생명력이 600000(10분)보다 크거나 같으면 무한으로 처리됩니다. 수명이 0 이하인 파티클은 죽은 상태로 시작됩니다.
기본값은 1000(1초)입니다.
lifeSpanVariation : int |
파티클 수명은 양방향으로 최대 이만큼 달라집니다.
기본값은 0입니다.
maximumEmitted : int |
이 이미터가 한 번에 생존할 수 있는 최대 파티클 수입니다.
성능 최적화(버스트 및 펄스 사용 시) 또는 방출 시차를 두기 위해 설정할 수 있습니다.
이 값을 0보다 작은 값으로 설정하면 이 이미터가 살아있을 수 있는 파티클 수에 최대 제한이 없습니다.
기본값은 -1입니다.
shape : Shape |
이 모양은 이미터의 크기와 함께 적용됩니다. 파티클은 셰이프가 덮는 모든 영역에서 무작위로 방출됩니다.
기본 모양은 이미터의 전체 바운딩 박스에 해당하는 채워진 직사각형입니다.
size : real |
파티클의 수명이 시작될 때 파티클의 픽셀 단위 크기입니다.
기본값은 16입니다.
sizeVariation : real |
startTime : int |
이미터를 로드할 때 이 값을 설정하면 과거부터 시작 시간 밀리초 전까지의 파티클을 방출합니다. 당시 방출된 것처럼 시뮬레이션되지만 이펙터가 적용되지 않습니다. 이펙터는 현재 시간부터 적용됩니다.
system : ParticleSystem |
이미터가 방출될 파티클 시스템입니다. 이미터가 다음과 같은 직계 자손인 경우 생략할 수 있습니다. ParticleSystem
velocity : StochasticDirection |
방출되는 파티클의 시작 속도입니다.
velocityFromMovement : real |
이 값이 0이 아닌 경우 이미터의 모든 움직임은 움직임에 따라 파티클에 추가 시작 속도를 제공합니다. 추가 벡터는 이미터의 움직임과 같은 각도로, 이미터 움직임의 크기에 velocityFromMovement를 곱한 값이 됩니다.
기본값은 0입니다.
신호 문서
emitParticles(Array particles) |
이 신호는 파티클이 방출될 때 방출됩니다. particles 는 파티클 오브젝트의 자바스크립트 배열입니다. 핸들러 내에서 직접 파티클 어트리뷰트를 수정할 수 있습니다.
참고: 자바스크립트는 실행 속도가 느리므로 대용량 파티클 시스템에서는 사용하지 않는 것이 좋습니다.
참고: 해당 핸들러는 onEmitParticles
입니다.
메서드 문서
burst(int count) |
이 이미터에서 count 로 지정된 파티클 수를 즉시 방출합니다.
이 이미터에서 count 로 지정된 파티클 수를 즉시 방출합니다. 파티클은 이미터가 (x, y)에 위치한 것처럼 방출되지만 다른 모든 프로퍼티는 동일합니다.
pulse(int duration) |
이미터가 활성화되지 않은 경우 지정된 duration (밀리초) 동안 활성화한 다음 다시 끕니다.
© 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.