ModelBlendParticle3D QML Type
입자 효과와 3D 모델을 결합합니다. 더 보기...
| Import Statement: | import QtQuick3D.Particles3D |
| Inherits: |
속성
- ModelBlendEmitMode : enumeration
- ModelBlendMode : enumeration
- activationNode : Node
- delegate : Component
- emitMode : bool
- endNode : Node
- endTime : int
- modelBlendMode : ModelBlendMode
상세 설명
이 타입은 파티클 효과를 3D 모델과 블렌딩하는 방법을 제공합니다. 제공된 모델은 삼각형 기반이어야 합니다. 모델의 각 삼각형은 파티클로 변환되며, 이 파티클들은 이미터에 의해 사용됩니다. 파티클 셰이더 대신, 모델에 지정된 표면 셰이더( material )를 사용하여 모델에 셰이딩이 적용됩니다. 효과의 블렌딩 방식은 표면 블렌딩 모드( modelBlendMode)에 의해 결정됩니다.
사용 가능한 모드는 다음과 같습니다:
- Construct: 모델이 파티클을 기반으로 구성됩니다.
- 'Explode': 모델이 파티클로 변환되는 모드입니다.
- '이동(Transfer)' 모드: '구성'과 '폭발'을 결합하여 모델을 한 위치에서 다른 위치로 이동시키는 효과를 생성합니다.
기본적으로 입자는 모델에 지정된 순서대로 방출되지만, emitMode 가 Random 로 설정되어 있거나 emitMode 가 Activation 로 설정되어 있고 activationNode 가 설정된 경우는 예외입니다.
기본 클래스와 이미터에 정의된 일부 기능은 이 유형에서는 작동하지 않습니다:
- Particle3D::alignMode 모델 내에서 입자가 임의의 방향을 가질 수 있으므로 이 기능은 작동하지 않습니다.
- Particle3D::sortMode 입자가 모델에서 프리미티브가 지정된 순서대로 항상 렌더링되므로 이 기능은 작동하지 않습니다.
- ParticleEmitter3D::depthBias 모델의 깊이 바이어스가 대신 사용되므로 이 기능은 작동하지 않습니다.
참고: 기본 fadeInEffect 및 fadeOutEffect 값은 Particle3D.FadeNone 입니다.
속성 설명서
ModelBlendEmitMode : enumeration
파티클의 방출 모드를 정의합니다
| 상수 | 설명 |
|---|---|
ModelBlendParticle3D.Sequential | 입자는 모델에 정의된 순서대로 방출됩니다. |
ModelBlendParticle3D.Random | 입자가 무작위 순서로 방출됩니다. |
ModelBlendParticle3D.Activation | activationNode 에 의해 활성화될 때 입자가 방출됩니다. |
ModelBlendMode : enumeration
입자 효과의 블렌딩 모드를 정의합니다.
| 상수 | 설명 |
|---|---|
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
}참고: 델리게이트에서 인스턴스화된모델은 자체적인 layers 할당을 유지하며, ParticleSystem3D 의 layers 값은 해당 모델에 적용되지 않습니다. 특정 콘텐츠 레이어에 파티클을 렌더링하려면 델리게이트에서 layers 속성을 설정하십시오.
emitMode : bool
이 속성은 파티클의 방출 모드를 지정합니다.
endNode : Node
이 속성은 파티클 이펙트 종료 시 모델의 변환을 지정하는 노드를 포함합니다. 이 속성은 ‘ ModelBlendParticle3D.Construct ’ 및 ‘ ModelBlendParticle3D.Transfer ’ 블렌드 모드를 사용할 때 모델이 생성되는 크기, 위치 및 회전을 정의합니다.
endTime : int
이 속성은 파티클의 종료 시간을 밀리초 단위로 저장합니다. 종료 시간은 생성 과정에서 사용되며, 효과와 모델의 위치가 블렌딩되는 시점부터 파티클의 수명 기간을 정의합니다. 종료 시간 이전에는 파티클의 위치가 파티클 효과에 의해서만 결정되지만, 종료 시간 동안에는 파티클의 위치가 모델의 최종 위치와 선형적으로 블렌딩됩니다.
modelBlendMode : ModelBlendMode
이 속성은 파티클 효과의 블렌딩 모드를 지정합니다.
© 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.