ParticleSystem3D QML Type

파티클, 이미터 및 어펙터 유형을 포함하는 시스템입니다. 더 보기...

Import Statement: import QtQuick3D.Particles3D
Since: Qt 6.2
Inherits:

Node

프로퍼티

방법

상세 설명

이 엘리먼트는 파티클 시스템의 루트로, 시스템 타이밍을 처리하고 파티클, 이미터, 이펙터 등 다른 모든 관련 엘리먼트를 그룹화합니다. 시스템 요소를 그룹화하려면 이와 같이 파티클 시스템 3D의 직접 자손이어야 합니다:

ParticleSystem3D {
    ParticleEmitter3D {
        ...
    }
    SpriteParticle3D {
        ...
    }
}

또는 시스템 요소가 직접 자식이 아닌 경우 system 프로퍼티를 사용하여 해당 요소가 속한 파티클시스템3D를 가리켜야 합니다. 다음과 같이요:

ParticleSystem3D {
    id: psystem
}
ParticleEmitter3D {
    system: psystem
    ...
}
SpriteParticle3D {
    system: psystem
    ...
}

프로퍼티 문서

logging : bool

loggingData 을 수집하려면 true 로 설정합니다.

참고: 이 프로퍼티는 퍼포먼스에 약간의 영향을 미치므로 릴리스에서는 활성화하지 않는 것이 좋습니다.

기본값은 false 입니다.

loggingData도 참조하세요 .


loggingData : ParticleSystem3DLogging [read-only]

이 프로퍼티에는 파티클 이펙트를 개발하고 최적화할 때 유용한 로깅 데이터가 포함되어 있습니다.

참고: 이 프로퍼티는 loggingtrue 로 설정되어 있고 파티클 시스템이 실행 중인 경우에만 올바른 데이터를 포함합니다.

logging도 참조하십시오 .


paused : bool

이 프로퍼티는 시스템이 현재 일시 중지되었는지 여부를 정의합니다. 일시 중지가 true 로 설정되어 있으면 파티클 시스템은 시뮬레이션을 진행하지 않습니다. 일시 중지를 false 으로 다시 설정하면 시뮬레이션이 일시 중지된 동일한 지점에서 다시 시작됩니다.

기본값은 false 입니다.


running : bool

이 속성은 시스템이 현재 실행 중인지 여부를 정의합니다. 실행 중이 false 으로 설정되어 있으면 파티클 시스템이 시뮬레이션을 중지합니다. 시스템이 다시 실행 중으로 설정되면 모든 파티클이 소멸됩니다.

time 프로퍼티를 수동으로 수정/애니메이션할 때는 실행을 false 으로 설정해야 합니다.

기본값은 true 입니다.


seed : int

이 프로퍼티는 파티클 무작위화에 사용되는 시드 값을 정의합니다. 동일한 시드를 사용하면 모든 실행에서 파티클 효과가 동일하게 적용됩니다. 이는 무작위 동작보다 결정론적 동작을 원할 때 유용합니다.

기본값은 useRandomSeedfalse 로 설정된 경우 0 이며, useRandomSeedtrue 로 설정된 경우 1..INT32_MAX 의 중간 값입니다.

참고: 파티클 애니메이션 중에는 이 프로퍼티를 수정해서는 안 됩니다.

useRandomSeed참조하십시오 .


startTime : int

이 프로퍼티는 시스템이 시작되는 시간을 밀리초 단위로 정의합니다. 파티클 세트가 이미 방출되도록 시스템을 워밍업하는 데 유용할 수 있습니다. 예를 들어 startTime이 2000으로 설정되어 있고 time 시스템이 0에서 1000까지 애니메이션을 실행하는 경우 실제로 애니메이션은 2000에서 3000ms 사이의 파티클을 표시합니다.

기본값은 0 입니다.


time : int

이 속성은 시스템의 시간을 밀리초 단위로 정의합니다.

참고: 시간 속성을 수정할 때는 일반적으로 runningfalse 으로 설정해야 합니다.

다음은 시스템을 절반 속도로 3초 동안 반복하여 수동으로 애니메이션을 적용하는 예제입니다:

ParticleSystem3D {
    running: false
    NumberAnimation on time {
        loops: Animation.Infinite
        from: 0
        to: 3000
        duration: 6000
    }
}

useRandomSeed : bool

이 프로퍼티는 파티클 시스템 시드를 무작위로 할지 사용자 정의할지를 정의합니다. true 으로 설정하면 파티클 시스템이 다시 시작될 때마다 seed 에 대한 새로운 임의 값이 생성됩니다.

기본값은 true 입니다.

참고: 파티클 애니메이션 중에는 이 프로퍼티를 수정해서는 안 됩니다.

seed참조하세요 .


메서드 문서

reset()

이 메서드는 파티클 시스템의 내부 상태를 초기 상태로 리셋합니다. running 프로퍼티가 false 인 경우 시스템을 초기화할 때 사용할 수 있습니다. runningtrue 인 경우 시스템이 내부 상태를 관리하므로 이 메서드를 호출할 필요가 없지만 false 인 경우 시스템을 리셋해야 할 시점을 시스템에 알려야 합니다.


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