이 페이지에서

ParticleGroup QML Type

논리적 입자 그룹에 속성을 설정하기 위해. 더 보기...

Import Statement: import QtQuick.Particles

속성

상세 설명

이 요소를 사용하면 파티클 그룹에 시간 기반 전환 효과를 설정할 수 있습니다.

또한 이 요소를 사용하여 논리적 파티클 그룹과 관련된 파티클 시스템 요소들을 그룹화할 수 있습니다. ParticleGroup의 직접 자식으로 설정된 Emitter, Affector 및 Painter는 해당 논리적 파티클 그룹에 자동으로 적용됩니다. TrailEmitter는 그룹을 자동으로 따라갑니다.

그룹에 ParticleGroup 요소가 정의되어 있지 않은 경우, 해당 그룹은 마치 전환 속성이 전혀 설정되지 않은 것처럼 정상적으로 작동합니다.

속성 설명

duration : int

그룹이 전환을 시도하기 전까지의 시간(밀리초 단위).

durationVariation : ParticleSystem

그룹 내 각 입자마다 전환 주기의 지속 시간이 변동할 수 있는 최대 밀리초 수입니다.

기본값은 0입니다.

name : string

이것은 입자 그룹의 이름이며, 다른 요소들이 이 그룹을 일반적으로 지칭하는 방식입니다.

요소들이 명시적인 ' ParticleGroup '가 생성되지 않은 이름을 참조하더라도 정상적으로 작동합니다(그룹에 전환 효과가 지정되지 않은 상태로). 그룹에 지속 시간 기반 전환 효과를 할당할 필요가 없다면, 해당 이름의 ' ParticleGroup '를 생성할 필요는 없습니다(물론 생성할 수는 있습니다).

system : ParticleSystem

이 시스템은 해당 그룹을 포함하게 될 시스템입니다.

ParticleGroup 가 ParticleSystem 의 직접 하위 요소인 경우, 해당 그룹은 자동으로 과 연관됩니다.

to : ParticleSystem

이 그룹에 유효한 전환의 가중치 목록입니다.

선택된 전환이 이 그룹 내에 머무르는 경우, 다음 전환이 시도되기 전까지 (+/- 최대 durationVariation) 밀리초의 추가 지연 시간이 발생합니다.

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