Particle3D QML Type

추상 논리 입자. 더 보기...

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

Object3D

Inherited By:

ModelBlendParticle3D, ModelParticle3D, and SpriteParticle3D

속성

상세 설명

이 요소는 논리적 파티클의 공통 속성을 정의합니다. Particle3D는 파티클의 추상적인 베이스 클래스이며, 대신 ModelParticle3D 또는 SpriteParticle3D 을 사용합니다.

참고: 모델에 사용되는 머티리얼과 달리 파티클은 기본적으로 반투명도를 가정하여 블렌딩이 활성화된 상태로 렌더링됩니다. 이는 파티클 텍스처, 색상(알파) 변화, 페이딩 등으로 인해 대부분의 경우 원하는 동작입니다. 블렌딩이 필요하지 않은 경우 hasTransparencyfalse 으로 설정하면 성능이 향상될 수 있습니다.

프로퍼티 문서

AlignMode : enumeration

정렬 유형을 정의합니다.

Constant설명
Particle3D.AlignNone정렬이 없습니다. 파티클 회전은 particleRotation 로 정의할 수 있습니다.
Particle3D.AlignTowardsTarget파티클을 alignTargetPosition 방향으로 정렬합니다.
Particle3D.AlignTowardsStartVelocity파티클을 시작 velocity 방향으로 정렬합니다.

FadeType : enumeration

페이드 효과의 유형을 정의합니다.

Constant설명
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

이 프로퍼티는 파티클이 정렬되는 위치를 정의합니다. 이 속성은 alignModeParticle3D.AlignTowardsTarget 로 설정된 경우에만 적용됩니다.

alignMode참조 .


color : color

이 속성은 파티클을 색칠하는 데 사용되는 기본 색을 정의합니다.

기본값은 "#FFFFFF" (흰색)입니다.


colorVariation : vector4d

이 속성은 파티클을 색칠하는 데 사용되는 색상 변형을 정의합니다. 값은 RGBA 순서이며 각 값은 0.0(변형 없음)에서 1.0(전체 변형) 사이여야 합니다.

예를 들어, 불투명도가 40%~60%인 반투명 빨간색의 파티클을 만들려면 #ff0000 ~ #e50000 사이로 설정합니다:

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 입니다.

fadeInEffectfadeOutDuration참조하십시오 .


fadeInEffect : FadeType

이 속성은 파티클이 나타날 때 사용되는 페이드 효과를 정의합니다.

기본값은 Particle3D.FadeOpacity 입니다.

fadeInDurationfadeOutEffect도 참조하십시오 .


fadeOutDuration : int

이 속성은 페이드 아웃 효과의 지속 시간(밀리초)을 정의합니다.

기본값은 250 입니다.

fadeOutEffectfadeInDuration도 참조하십시오 .


fadeOutEffect : FadeType

이 속성은 파티클이 lifeSpan 에 도달하여 사라질 때 사용되는 페이드 효과를 정의합니다.

기본값은 Particle3D.FadeOpacity 입니다.

fadeOutDurationfadeInEffect도 참조하십시오 .


hasTransparency : bool

이 프로퍼티는 파티클에 투명도가 있고 배경과 블렌딩되어야 하는지 여부를 정의합니다. 일반적으로 파티클 색상에 전체 알파가 없거나 텍스처에 반투명 픽셀이 포함되어 있거나 파티클 불투명도가 페이드 인 또는 페이드 아웃되는 경우와 같이 이 속성은 참이어야 합니다. 특정 경우에 이 값을 false로 설정하면 최적화할 수 있습니다.

기본값은 true 입니다.

color, fadeInEffect, fadeOutEffect참조하세요 .


maxAmount : int

이 속성은 동시에 존재할 수 있는 최대 파티클의 양을 정의합니다. particlesUsed 을 사용하여 할당된 파티클이 얼마나 효율적으로 사용되는지 디버깅할 수 있습니다. maxAmount가 너무 작으면 파티클이 lifeSpan 에 도달하기 전에 재사용되고, 너무 크면 파티클에 불필요한 메모리가 할당됩니다.

참고: maxAmount를 변경하면 파티클 시스템의 모든 파티클이 초기화됩니다.

기본값은 100 입니다.


sortMode : SortMode

이 속성은 파티클에 사용되는 정렬 모드를 정의합니다.

기본값은 Particle3D.SortNone 입니다.


unifiedColorVariation : bool

이 속성은 colorVariation 을 모든 색상 채널에 균일하게 적용할지 여부를 정의합니다. 즉, 모든 변형이 동일한 무작위 양으로 적용됩니다.

예를 들어 #ffff00#7f7f00 사이에 노란색이 있는 파티클을 만들려면 RG 색상 채널의 값이 항상 같아야 합니다:

ModelParticle3D {
    ...
    color: "#ffff00"
    colorVariation: Qt.vector4d(0.5, 0.5, 0.0, 0.0)
    unifiedColorVariation: true
}

기본값은 false 입니다.

colorVariation참조하세요 .


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