ModelBlendParticle3D QML Type

파티클 효과를 3D 모델과 혼합합니다. 더 보기...

Import Statement: import QtQuick3D.Particles3D
Inherits:

Particle3D

속성

상세 설명

이 유형은 파티클 효과를 3D 모델과 블렌딩하는 방법을 제공합니다. 제공된 모델은 트라이앵글 기반이어야 합니다. 모델의 각 트라이앵글은 파티클로 변환된 다음 이미터에서 사용됩니다. 파티클 셰이더 대신 모델에 지정된 material 을 사용하여 모델을 음영 처리합니다. 이펙트가 블렌딩되는 방식은 modelBlendMode 에 의해 결정됩니다.

가능한 모드는 다음과 같습니다:

  • 생성- 파티클에서 모델을 생성합니다.
  • 폭발: 모델이 파티클로 변환됩니다.
  • 전송- 생성 및 폭발을 결합하여 모델이 한 위치에서 다른 위치로 전송되는 효과를 생성합니다.

기본적으로 파티클은 emitModeRandom 로 설정되거나 emitModeActivation 로 설정되고 activationNode 가 설정되지 않는 한 모델에 지정된 순서대로 방출됩니다.

베이스 클래스 및 이미터에 정의된 일부 기능은 이 유형에서 작동하지 않습니다:

  • Particle3D::alignMode 파티클이 모델에서 임의의 방향에 있을 수 있으므로 작동하지 않습니다.
  • Particle3D::sortMode 는 파티클이 항상 모델에 지정된 프리미티브 순서대로 렌더링되므로 작동하지 않습니다.
  • ParticleEmitter3D::depthBias 는 모델 깊이 바이어스가 대신 사용되므로 작동하지 않습니다.

참고: 기본값 fadeInEffectfadeOutEffectParticle3D.FadeNone 입니다.

속성 문서

ModelBlendEmitMode : enumeration

파티클의 이미트 모드를 정의합니다.

Constant설명
ModelBlendParticle3D.Sequential파티클이 모델에 정의된 순서대로 방출됩니다.
ModelBlendParticle3D.Random파티클은 무작위 순서로 방출됩니다.
ModelBlendParticle3D.Activation파티클은 activationNode 에 의해 활성화될 때 방출됩니다.

ModelBlendMode : enumeration

파티클 효과의 블렌딩 모드를 정의합니다.

Constant설명
ModelBlendParticle3D.Explode모델이 폭발합니다. 즉, 파티클이 모델 위치에서 방출됩니다.
ModelBlendParticle3D.Construct모델이 구성됩니다. 즉, 파티클이 이미터에서 날아가 마지막에 모델을 구성합니다.
ModelBlendParticle3D.Transfer같은 모델에 대해 폭발과 전송을 결합합니다.

activationNode : Node

이 프로퍼티에는 파티클을 활성화하고 일반 이미트 루틴을 오버라이드하는 노드가 있습니다. 활성화 노드는 파티클에서 모델을 폭발/구축할 때 파티클이 공간적으로 방출되는 방식을 제어하는 데 사용할 수 있습니다. 활성화 노드는 해당 파티클의 중심이 활성화 노드의 z축의 양의 절반에 있으면 파티클을 방출합니다. 활성화 노드가 모델을 통과하도록 애니메이션하면 활성화 노드가 이동하는 경로를 따라 파티클이 순차적으로 방출됩니다.


delegate : Component

델리게이트는 ModelBlendParticle3D 에 대한 모델을 정의하는 템플릿을 제공합니다.

예를 들어, 기본 머티리얼과 함께 기본 구체 모델을 사용하는 경우

Component {
    id: modelComponent
    Model {
        source: "#Sphere"
        scale: Qt.vector3d(0.5, 0.5, 0.5)
        materials: DefaultMaterial { diffuseColor: "red" }
    }
}

ModelBlendParticle3D {
    id: particleRedSphere
    delegate: modelComponent
}

emitMode : bool

이 프로퍼티는 파티클의 이미트 모드를 보유합니다.


endNode : Node

이 프로퍼티에는 파티클 이펙트 종료 시 모델의 트랜스폼을 지정하는 노드가 있습니다. ModelBlendParticle3D.ConstructModelBlendParticle3D.Transfer 블렌드 모드를 사용할 때 모델이 구성되는 크기, 위치 및 회전을 정의합니다.


endTime : int

이 프로퍼티는 파티클의 종료 시간을 밀리초 단위로 유지합니다. 종료 시간은 구성 중에 사용되며 이펙트가 모델 위치와 블렌딩되는 마지막의 파티클 수명부터 지속 시간을 정의합니다. 종료 시간 이전에는 파티클 위치가 파티클 효과로만 정의되지만 종료 시간 동안 파티클 위치는 모델 종료 위치와 선형적으로 블렌딩됩니다.


modelBlendMode : ModelBlendMode

이 프로퍼티는 파티클 효과의 블렌딩 모드를 유지합니다.


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