Particle3D QML Type
추상적인 논리적 입자. 더 보기...
| Import Statement: | import QtQuick3D.Particles3D |
| Since: | Qt 6.2 |
| Inherits: | |
| Inherited By: | LineParticle3D, ModelBlendParticle3D, ModelParticle3D, and SpriteParticle3D |
속성
- AlignMode : enumeration
- FadeType : enumeration
- SortMode : enumeration
- alignMode : AlignMode
- alignTargetPosition : vector3d
- color : color
- colorVariation : vector4d
- fadeInDuration : int
- fadeInEffect : FadeType
- fadeOutDuration : int
- fadeOutEffect : FadeType
- hasTransparency : bool
- maxAmount : int
- sortMode : SortMode
- unifiedColorVariation : bool
상세 설명
이 요소는 논리적 파티클의 공통 속성을 정의합니다. Particle3D는 파티클의 추상 기본 클래스이므로, 대신 ModelParticle3D 또는 SpriteParticle3D 을 사용하십시오.
참고: 모델에 사용되는 머티리얼과 달리 , 파티클은 기본적으로 반투명성을 가정하여 렌더링되며, 따라서 블렌딩이 활성화된 상태로 렌더링됩니다. 이는 파티클 텍스처, 색상(알파) 변화, 페이딩 등으로 인해 대부분의 경우 바람직한 동작입니다. 블렌딩이 필요하지 않은 경우, 성능 향상을 위해 hasTransparency 를 false 로 설정하십시오.
속성 설명서
AlignMode : enumeration
정렬 유형을 정의합니다.
| 상수 | 설명 |
|---|---|
Particle3D.AlignNone | 정렬 없음. 입자의 회전은 ` particleRotation`를 사용하여 정의할 수 있습니다. |
Particle3D.AlignTowardsTarget | alignTargetPosition 방향으로 파티클을 정렬합니다. |
Particle3D.AlignTowardsStartVelocity | 입자를 시작 velocity 방향으로 정렬합니다. |
FadeType : enumeration
페이딩 효과의 유형을 정의합니다.
| 상수 | 설명 |
|---|---|
Particle3D.FadeNone | 페이딩 없음. |
Particle3D.FadeOpacity | 입자 불투명도를 0.0에서 시작하여 0.0으로 페이드합니다. |
Particle3D.FadeScale | 파티클 스케일을 0.0에서 시작하여 0.0까지 페이드합니다. |
SortMode : enumeration
입자의 정렬 모드를 정의합니다. 정렬 모드는 입자가 그려지는 순서를 결정합니다.
| 상수 | 설명 |
|---|---|
Particle3D.SortNone | 정렬 없음. |
Particle3D.SortNewest | 입자 수명에 따라 정렬하며, 가장 최근에 생성된 입자부터 먼저 표시합니다. |
Particle3D.SortOldest | 입자 수명에 따라 정렬하며, 가장 최근의 입자부터 먼저 표시합니다. |
Particle3D.SortDistance | 카메라와의 거리를 기준으로 정렬하며, 가장 먼 것부터 먼저 표시합니다. |
alignMode : AlignMode
이 속성은 파티클에 적용되는 정렬 모드를 정의합니다. 파티클 정렬이란 파티클이 향하는 방향을 의미합니다.
참고: ‘ SpriteParticle3D ’ billboard 속성이 ‘ true ’로 설정된경우 , ‘alignMode’는 적용되지 않습니다.
기본값은 ` Particle3D.AlignNone`입니다.
alignTargetPosition도 참조하십시오 .
alignTargetPosition : vector3d
이 속성은 입자가 정렬되는 위치를 정의합니다. 이 속성은 ‘ alignMode ’가 ‘ Particle3D.AlignTowardsTarget ’로 설정된 경우에만 적용됩니다.
‘ alignMode’ 항목도 참조하십시오 .
color : color
이 속성은 입자에 색상을 입힐 때 사용되는 기본 색상을 정의합니다.
기본값은 "#FFFFFF" (흰색)입니다.
colorVariation : vector4d
이 속성은 입자에 색상을 입힐 때 사용되는 색상 변동을 정의합니다. 값은 RGBA 순서로 지정되며, 각 값은 0.0(변동 없음)에서 1.0(완전한 변동) 사이여야 합니다.
예를 들어, #ff0000 에서 #e50000 사이의 반투명한 빨간색을 가지며, 불투명도가 40%에서 60%인 입자를 생성하려면:
ModelParticle3D {
...
color: "#7fff0000"
colorVariation: Qt.vector4d(0.1, 0.0, 0.0, 0.2)
}기본값은 (0, 0, 0, 0) (변동 없음)입니다.
unifiedColorVariation항목도 참조하십시오 .
fadeInDuration : int
이 속성은 페이딩 효과가 지속되는 시간을 밀리초 단위로 정의합니다.
참고: 페이딩지속 시간은 입자 lifeSpan 의 일부입니다. 예를 들어, lifeSpan 가 3000이고, fadeInDuration 가 500이며, fadeOutDuration 가 500인 경우, 입자가 완전히 보이는 시간은 2000ms입니다.
기본값은 250 입니다.
fadeInEffect 및 fadeOutDuration도 참조하십시오 .
fadeInEffect : FadeType
이 속성은 파티클이 나타날 때 적용되는 페이딩 효과를 정의합니다.
기본값은 ‘ Particle3D.FadeOpacity ’입니다.
fadeInDuration 및 fadeOutEffect도 참조하십시오 .
fadeOutDuration : int
이 속성은 페이드 아웃 효과의 지속 시간을 밀리초 단위로 지정합니다.
기본값은 250 입니다.
fadeOutEffect 및 fadeInDuration도 참조하십시오 .
fadeOutEffect : FadeType
이 속성은 입자가 lifeSpan 에 도달하여 사라질 때 적용되는 페이딩 효과를 정의합니다.
기본값은 Particle3D.FadeOpacity 입니다.
‘ fadeOutDuration ’ 및 ‘ fadeInEffect ’항목도 참조하십시오 .
hasTransparency : bool
이 속성은 파티클에 투명도가 있는지, 그리고 배경과 블렌딩되어야 하는지를 정의합니다. 일반적으로 파티클 색상의 알파 값이 100%가 아니거나, 텍스처에 반투명한 픽셀이 포함되어 있거나, 파티클의 불투명도가 페이드 인/아웃되는 경우와 같이 이 값은 true로 설정되어야 합니다. 특정 경우에는 이 값을 false로 설정하여 최적화를 이룰 수 있습니다.
기본값은 ` true`입니다.
color, fadeInEffect, fadeOutEffect항목도 참조하십시오 .
maxAmount : int
이 속성은 동시에 존재할 수 있는 파티클의 최대 개수를 정의합니다. 할당된 파티클이 얼마나 효율적으로 사용되는지 디버깅하려면 ` particlesUsed `을 사용할 수 있습니다. `maxAmount` 값이 너무 작으면, 파티클이 ` lifeSpan`이 끝나기도 전에 재사용됩니다. `maxAmount` 값이 너무 크면 파티클을 위해 불필요한 메모리가 할당됩니다.
참고: maxAmount를변경하면 파티클 시스템의 모든 파티클이 초기화됩니다.
기본값은 100 입니다.
sortMode : SortMode
이 속성은 파티클에 적용되는 정렬 모드를 정의합니다.
기본값은 ` Particle3D.SortNone`입니다.
unifiedColorVariation : bool
이 속성은 ‘ colorVariation ’가 모든 색상 채널에 균일하게 적용되어야 하는지 여부를 정의합니다. 즉, 모든 변형이 동일한 무작위 양으로 적용된다는 의미입니다.
예를 들어, #ffff00 와 #7f7f00 사이의 노란색을 띠는 입자를 생성하고, R 및 G 색상 채널의 값이 항상 동일하도록 하려면:
ModelParticle3D {
...
color: "#ffff00"
colorVariation: Qt.vector4d(0.5, 0.5, 0.0, 0.0)
unifiedColorVariation: true
}기본값은 false 입니다.
colorVariation도 참조하십시오 .
© 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.