ParticleEmitter3D QML Type

논리적 파티클용 이미터. 더 보기...

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

Node

Inherited By:

TrailEmitter3D

프로퍼티

방법

  • vector3d burst(int count)
  • vector3d burst(int count, int duration)
  • vector3d burst(int count, int duration, vector3d position)

상세 설명

이 요소는 주어진 시작 속성을 가진 논리적 파티클을 ParticleSystem3D 으로 방출합니다.

ParticleSystem3D 에 파티클이 있으려면 적어도 하나의 이미터가 필요합니다. 방출량을 제어하는 방법에는 몇 가지가 있습니다:

  • 초당 몇 개의 파티클을 지속적으로 방출할지 제어하는 emitRate 을 설정합니다.
  • emitBursts 프로퍼티에 EmitBurst3D 요소를 추가하여 선언적으로 버스트를 방출합니다.
  • burst() 메서드 중 하나를 호출하여 버스트를 즉시 방출합니다.

프로퍼티 문서

depthBias : real

이미터의 뎁스 바이어스를 보유합니다. 오브젝트를 정렬할 때 카메라로부터의 오브젝트 거리에 뎁스 바이어스가 추가됩니다. 이는 서로 가까운 오브젝트 간에 렌더링 순서를 강제하는 데 사용할 수 있으며, 다른 프레임에서 다른 순서로 렌더링될 수 있습니다. 음수 값은 정렬 값을 카메라에 더 가깝게 이동시키고 양수 값은 카메라에서 더 멀리 이동시킵니다.


emitBursts : List<EmitBurst3D>

이 프로퍼티는 EmitBurst3D 요소의 목록을 받아 버스트를 선언적으로 정의합니다. 버스트 시작 시간, 양, 지속 시간을 미리 알고 있는 경우 burst()를 Timer 으로 호출하는 것보다 이 프로퍼티를 사용하는 것이 더 좋습니다.

예를 들어 처음에 100개의 파티클을 방출하고 2초에 50개의 파티클을 방출하는 것이 좋습니다:

ParticleEmitter3D {
    emitBursts: [
        EmitBurst3D {
            time: 0
            amount: 100
        },
        EmitBurst3D {
            time: 2000
            amount: 50
        }
    ]
}

burst()도 참조하세요 .


emitRate : real

이 속성은 초당 파티클의 일정한 방출 속도를 정의합니다. 예를 들어 emitRate가 120이고 시스템이 초당 60프레임으로 애니메이션을 재생하면 매 프레임마다 2개의 새 파티클이 방출됩니다.

기본값은 0 입니다.


enabled : bool

활성화가 false 로 설정되어 있으면 이 이미터는 파티클을 방출하지 않습니다. 일반적으로 이 설정은 이미터를 조건부로 켜거나 끄는 데 사용됩니다. 버스트를 계속 방출하려면 false 으로 전환하는 대신 emitRate 을 0으로 유지하세요.

기본값은 true 입니다.


lifeSpan : int

이 속성은 단일 파티클의 수명을 밀리초 단위로 정의합니다.

기본값은 1000 입니다.

lifeSpanVariation도 참조하십시오 .


lifeSpanVariation : int

이 프로퍼티는 단일 파티클의 수명 변화를 밀리초 단위로 정의합니다.

예를 들어 3초에서 4초 사이에 존재하는 파티클을 방출합니다:

ParticleEmitter3D {
    ...
    lifeSpan: 3500
    lifeSpanVariation: 500
}

기본값은 0 입니다.

lifeSpan참조하십시오 .


particle : Particle3D

이 프로퍼티는 이 이미터가 방출하는 논리적 파티클을 정의합니다. 이미터에 파티클이 정의되어 있어야 하며, 그렇지 않으면 아무 것도 방출하지 않습니다. 파티클은 SpriteParticle3D 또는 ModelParticle3D 일 수 있습니다.


particleEndScale : real

이 프로퍼티는 파티클 끝에 있는 파티클의 스케일 배수를 정의합니다 lifeSpan. 파티클 끝 크기에 변화를 주려면 particleEndScaleVariation 을 사용합니다. 값이 음수이면 끝 스케일은 particleScale 와 같으므로 파티클 lifeSpan 동안 스케일이 변경되지 않습니다.

기본값은 -1.0 입니다.

particleScaleparticleScaleVariation도 참조하십시오 .


particleEndScaleVariation : real

이 프로퍼티는 파티클의 끝 스케일 변화를 정의합니다. 값이 음수이면 최종 스케일에도 particleScaleVariation 이 사용됩니다. 예를 들어 스케일 0.5 - 1.5에서 시작하여 스케일 1.0 - 5.0에서 끝나는 파티클을 방출하는 경우입니다:

ParticleEmitter3D {
    ...
    particleScale: 1.0
    particleScaleVariation: 0.5
    particleEndScale: 3.0
    particleEndScaleVariation: 2.0
}

기본값은 -1.0 입니다.

particleEndScale참조하세요 .


particleRotation : vector3d

이 속성은 처음에 파티클의 회전을 정의합니다. 회전은 오일러 각도로 정의됩니다.

particleRotationVariation도 참조하십시오 .


particleRotationVariation : vector3d

이 프로퍼티는 처음에 파티클의 회전 변화를 정의합니다. 회전 변화는 오일러 각도의 각도로 정의됩니다.

예를 들어 파티클을 완전히 무작위 회전으로 방출할 수 있습니다:

ParticleEmitter3D {
    ...
    particleRotationVariation: Qt.vector3d(180, 180, 180)
}

particleRotation참조하십시오 .


particleRotationVelocity : vector3d

이 속성은 처음에 파티클의 회전 속도를 정의합니다. 회전 속도는 오일러 각도 단위의 초당 도(度)로 정의됩니다.

particleRotationVelocityVariation도 참조하십시오 .


particleRotationVelocityVariation : vector3d

이 프로퍼티는 파티클의 회전 속도 변화를 정의합니다. 회전 속도 변화는 오일러 각도 단위의 초당 도수로 정의됩니다.

예를 들어 초당 -100도에서 100도 사이의 임의의 회전 속도를 가진 파티클을 임의의 방향으로 임의의 회전으로 방출할 수 있습니다:

ParticleEmitter3D {
    ...
    particleRotationVariation: Qt.vector3d(180, 180, 180)
    particleRotationVelocityVariation: Qt.vector3d(100, 100, 100)
}

particleRotationVelocity참조하십시오 .


particleScale : real

이 프로퍼티는 처음에 파티클의 스케일 배수를 정의합니다. 입자 크기에 변화를 주려면 particleScaleVariation 을 사용합니다.

기본값은 1.0 입니다.

particleEndScaleparticleScaleVariation도 참조하십시오 .


particleScaleVariation : real

이 프로퍼티는 파티클의 스케일 변화를 정의합니다. 예를 들어 0.5 - 1.5 스케일로 파티클을 방출합니다:

ParticleEmitter3D {
    ...
    particleScale: 1.0
    particleScaleVariation: 0.5
}

기본값은 0.0 입니다.

particleScaleparticleEndScaleVariation도 참조하십시오 .


이 속성은 방출 영역의 선택적 모양을 정의합니다. ParticleShape3D 또는 ParticleModelShape3D 모양은 이미터 노드 속성에 따라 스케일, 위치 및 회전이 결정됩니다. 모양 fill 속성이 false로 설정되면 모양 표면에서만 방출이 발생합니다.

셰이프가 정의되지 않은 경우 이미터 노드의 중심점에서 방출이 수행됩니다.


system : ParticleSystem3D

이 속성은 이미터에 대한 ParticleSystem3D 을 정의합니다. 시스템이 이미터의 직접 부모인 경우 이 프로퍼티는 정의할 필요가 없습니다.


velocity : Direction3D

이 프로퍼티는 방출된 파티클의 시작 속도를 설정하는 데 사용할 수 있습니다. 속도를 설정하지 않으면 파티클이 움직이지 않고 시작되며, 속도를 사용하는 경우 affectors 에서 속도를 가져옵니다.


메서드 문서

vector3d burst(int count)

이 이미터에서 count 양의 파티클을 즉시 방출합니다.


vector3d burst(int count, int duration)

이 메서드는 다음 duration 밀리초 동안 이 이미터에서 count 양의 파티클을 방출합니다.


vector3d burst(int count, int duration, vector3d position)

이 메서드는 다음 duration 밀리초 동안 이 이미터에서 count 양의 파티클을 방출합니다. 파티클은 이미터가 position 에 있는 것처럼 방출되지만 다른 모든 속성은 동일합니다.


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