이 페이지에서

Emitter QML Type

논리 입자를 방출합니다. 더 보기...

Import Statement: import QtQuick.Particles
Inherited By:

TrailEmitter

속성

신호

방법

  • void burst(int count)
  • void burst(int count, int x, int y)
  • void pulse(int duration)

상세 설명

이 요소는 지정된 시작 속성을 가진 논리적 입자를 ParticleSystem 로 방출합니다.

논리 입자는 자동으로 렌더링되지 않으므로, 이를 시각화하기 위해 하나 이상의 ParticlePainter 요소가 필요합니다.

지정된 시작 속성은 동일한 ParticleSystem 내의 모든 Affector 요소에 의해 입자의 수명 주기 중 언제든지 수정될 수 있습니다. 여기에는 수명(lifespan)과 같은 속성도 포함됩니다.

속성 문서

acceleration : StochasticDirection

방출된 입자의 초기 가속도.

emitRate : real

초당 방출되는 입자 수.

기본값은 초당 10개 입자입니다.

enabled : bool

false로 설정하면, true로 설정될 때까지 이미터는 방출을 중단합니다.

기본값은 true입니다.

endSize : real

입자의 수명이 끝날 때의 크기(픽셀 단위). 입자의 수명 기간 동안 크기는 이 값과 size 값을 기준으로 선형 보간됩니다. endSize가 -1인 경우, 입자의 크기는 시작 크기 그대로 유지됩니다.

기본값은 -1입니다.

group : string

이것은 해당 객체가 방출할 논리적 입자 그룹입니다.

기본값은 "" (빈 문자열)입니다.

lifeSpan : int

방출된 각 입자가 유지되어야 하는 시간(밀리초 단위).

특정 시간이 지난 후 파티클이 자동으로 소멸되지 않게 하려면(예: 수동으로 제거하려는 경우), lifeSpan을 Emitter.InfiniteLife로 설정하십시오.

600000(10분) 이상인 lifeSpan은 무한한 것으로 간주됩니다. lifeSpan이 0 이하인 파티클은 처음부터 소멸된 상태로 시작됩니다.

기본값은 1000(1초)입니다.

lifeSpanVariation : int

입자의 수명은 이 범위 내에서 양방향으로 변동할 수 있습니다.

기본값은 0입니다.

maximumEmitted : int

이 이미터가 한 번에 유지할 수 있는 활성 입자의 최대 수입니다.

이 값은 성능 최적화(버스트 및 펄스 사용 시)를 위해, 또는 입자 방출을 시차 있게 하기 위해 설정할 수 있습니다.

이 값이 0 미만으로 설정된 경우, 이 이미터가 유지할 수 있는 활성 입자 수에 최대 제한이 없습니다.

기본값은 -1입니다.

shape : Shape

이 도형은 이미터의 크기에 맞춰 적용됩니다. 입자는 도형이 덮고 있는 모든 영역에서 무작위로 방출됩니다.

기본 도형은 채워진 직사각형이며, 이는 이미터의 전체 바운딩 박스와 일치합니다.

size : real

입자가 생성될 때의 픽셀 단위 크기.

기본값은 16입니다.

sizeVariation : real

입자의 크기는 size/endSize 에서 이 정도 범위 내에서 위아래로 변동할 수 있습니다. 단일 입자의 경우, size와 endSize 모두에 동일한 무작위 값이 더해집니다.

기본값은 0입니다.

startTime : int

이 값이 이미터가 로드될 때 설정되어 있다면, startTime 밀리초 전까지의 과거 시점에서 입자가 방출됩니다. 이 입자들은 마치 그 시점에 방출된 것처럼 시뮬레이션되지만, 그 입자에는 어떠한 어펙터도 적용되지 않습니다. 어펙터는 현재 시점부터 적용됩니다.

system : ParticleSystem

이것은 이미터가 물체를 방출할 파티클 시스템입니다. 이미터가 의 직접 자식인 경우에는 이 항목을 생략할 수 있습니다. ParticleSystem

velocity : StochasticDirection

방출된 입자의 초기 속도.

velocityFromMovement : real

이 값이 0이 아닌 경우, 이미터의 모든 움직임은 해당 움직임을 기반으로 입자에 추가적인 초기 속도를 부여합니다. 추가되는 벡터는 이미터의 움직임과 동일한 각도를 가지며, 그 크기는 이미터의 움직임의 크기에 velocityFromMovement를 곱한 값이 됩니다.

기본값은 0입니다.

신호 문서

emitParticles(Array particles)

이 신호는 파티클이 방출될 때 발생합니다. ` particles `는 Particle 객체로 구성된 JavaScript 배열입니다. 핸들러 내에서 파티클 속성을 직접 수정할 수 있습니다.

참고: 자바스크립트는 실행 속도가 느리기 때문에, 입자 수가 많은 입자 시스템에서는 이 기능을 사용하지 않는 것이 좋습니다.

참고: 해당 핸들러는 onEmitParticles 입니다.

메서드 문서

void burst(int count)

count 로 지정된 수의 입자를 이 이미터에서 즉시 방출합니다.

void burst(int count, int x, int y)

count 로 지정된 수의 입자를 이 이미터에서 즉시 방출합니다. 입자는 마치 이미터가 (x, y) 위치에 있는 것처럼 방출되지만, 그 외의 모든 속성은 동일하게 유지됩니다.

void pulse(int duration)

이미터가 활성화되어 있지 않은 경우, 지정된 duration (밀리초 단위) 동안 활성화한 다음 다시 비활성화합니다.

© 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.