이 페이지에서

Particle QML Type

이미터와 어펙터에 의해 조작되는 입자를 나타냅니다. 더 보기...

Import Statement: import QtQuick.Particles

속성

상세 설명

입자 요소는 항상 ParticleSystem 에서 내부적으로 관리되며, QML에서는 생성할 수 없습니다. 그러나 때로는 입자 상태를 임의로 변경할 수 있도록 신호를 통해 노출되기도 합니다.

속성 설명

alpha : real

ImageParticle 색상이 적용된 입자를 그릴 수 있습니다. 이때 알파 값은 소스 이미지에 적용되는 색상의 알파 채널로 사용됩니다.

값의 범위는 0.0에서 1.0까지입니다.

autoRotate : bool

autoRotate가 true인 경우, 파티클의 회전은 이동 방향을 향하도록 설정되며, 여기에 rotation 또는 rotationVelocity 속성에서 지정된 회전 각도가 더해집니다.

ax : real

입자의 현재 x축 방향 가속도.

ay : real

입자의 현재 y 방향 가속도.

blue : real

ImageParticle 색상이 입혀진 입자를 그릴 수 있습니다. 이때, 파란색은 원본 이미지에 적용된 색상의 파란색 채널로 사용됩니다.

값의 범위는 0.0에서 1.0까지입니다.

currentSize : real

입자의 currentSize는 currentTime에 따라 startSize 와 endSize 사이에서 보간됩니다.

endSize : real

입자 이미지가 수명 종료 시점에 가지는 픽셀 크기입니다. 이 값이 0보다 작으면 무시되며, 입자는 수명 전체에 걸쳐 기본 크기( startSize )를 유지합니다.

green : real

ImageParticle 색상이 입혀진 입자를 그릴 수 있습니다. 이때, 소스 이미지에 적용된 색상의 녹색 채널로 녹색이 사용됩니다.

값의 범위는 0.0에서 1.0까지입니다.

initialAX : real

입자가 생성된 시점에서의 x 방향 가속도.

이 시뮬레이션 방식은 특정 시점의 값을 산출하여 변경하는 것보다 초기값을 변경하는 방식을 선호합니다. 현재 값 대신 CustomEmitters에서 초기값을 변경하십시오.

initialAY : real

입자가 생성을 시작한 시점의 y 방향 가속도.

이 시뮬레이션 방법은 특정 시점의 값을 산출하여 변경하기보다는 초기 값을 변경하는 방식을 선호합니다. 현재 값 대신 CustomEmitters에서 초기 값을 변경하십시오.

initialVX : real

입자가 생성된 시점의 x 방향 속도.

이 시뮬레이션 방식은 특정 시점의 값을 산출하여 변경하는 것보다 초기 값을 변경하는 방식을 선호합니다. 현재 값 대신 CustomEmitters에서 초기 값을 변경하십시오.

initialVY : real

입자가 생성된 시점에서의 y 방향 속도.

이 시뮬레이션 방식은 특정 시점의 값을 산출하여 변경하기보다는 초기값을 변경하는 방식을 선호합니다. 현재 값 대신 CustomEmitters에서 초기값을 변경하십시오.

initialX : real

입자의 수명 시작 시점에서의 x 좌표.

이 시뮬레이션 방식은 특정 시점의 값을 산출하여 변경하기보다는 초기 값을 변경하는 방식을 선호합니다. 현재 값 대신 CustomEmitters에서 초기 값을 변경하십시오.

initialY : real

입자의 수명 시작 시점에서의 y 좌표.

이 시뮬레이션 방식은 특정 시점의 값을 산출하여 변경하는 것보다 초기 값을 변경하는 방식을 선호합니다. 현재 값 대신 CustomEmitters에서 초기 값을 변경하십시오.

lifeLeft : real

현재 시점에서 입자가 남아 있는 수명(초 단위).

lifeSpan : real

입자가 존재하는 시간(초 단위).

red : real

ImageParticle 색상이 입혀진 입자를 그릴 수 있습니다. 이때, 빨간색은 원본 이미지에 적용된 색상의 빨간색 채널로 사용됩니다.

값의 범위는 0.0에서 1.0까지입니다.

rotation : real

입자가 생성될 때 입자 이미지가 시계 방향으로 회전하는 각도(도).

rotationVelocity : real

입자 이미지가 존재하는 동안 시계 방향으로 회전하는 각도(초당 도).

startSize : real

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

t : real

시뮬레이션이 시작된 후부터 입자가 생성된 시점까지의 시간(초 단위).

update : bool

Affector 내부에서는 update가 true로 설정된 경우에만 파티클에 적용된 변경 사항이 반영됩니다.

vx : real

입자의 현재 x 방향 속도.

vy : real

입자의 현재 y 방향 속도.

x : real

입자의 현재 x 좌표.

xDeformationVectorX : real

X 축을 따라 변형 벡터의 x 성분입니다. ` ImageParticle `는 정사각형이 아닌 도형 위에 입자를 그릴 수 있습니다. 이 함수는 x 및 y 변형 벡터로 그려진 평행사변형 위에 텍스처 사각형을 그립니다.

xDeformationVectorY : real

X축을 따라 변형 벡터의 x 성분입니다. ` ImageParticle `는 정사각형이 아닌 모양 위에 입자를 그릴 수 있습니다. 이 함수는 x 및 y 변형 벡터로 그려진 평행사변형 위에 텍스처 사각형을 그립니다.

y : real

입자의 현재 y 좌표.

yDeformationVectorX : real

X축을 따라 변형 벡터의 y 성분입니다. ` ImageParticle `는 정사각형이 아닌 도형 위에 입자를 그릴 수 있습니다. 이 함수는 x 및 y 변형 벡터로 그려진 평행사변형 위에 텍스처 사각형을 그립니다.

yDeformationVectorY : real

Y축을 따라 변형 벡터의 y 성분입니다. ` ImageParticle `는 정사각형이 아닌 모양 위에 입자를 그릴 수 있습니다. 이 함수는 x 및 y 변형 벡터로 그려진 평행사변형 위에 텍스처 사각형을 그립니다.

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