LineParticle3D QML Type
선 입자. 더 보기...
| Import Statement: | import QtQuick3D.Particles3D |
| Since: | Qt 6.4 |
| Inherits: |
속성
- TexcoordMode : enumeration
- alphaFade : real
- eolFadeOutDuration : int
- length : real
- lengthDeltaMin : real
- lengthVariation : real
- scaleMultiplier : real
- segmentCount : int
- texcoordMode : TexcoordMode
- texcoordMultiplier : real
상세 설명
LineParticle3D는 선 형태의 스프라이트 파티클을 생성합니다.
선은 파티클이 이동할 때 그 경로를 따라 생성됩니다. 선의 길이는 ` length ` 매개변수나 세그먼트 수 및 점 사이의 최소 델타 값을 통해 지정됩니다. 후자의 경우, 파티클의 속도가 변하면 선의 길이도 달라질 수 있습니다.
속성 설명
TexcoordMode : enumeration
선 입자의 텍스처 좌표 모드를 정의합니다.
| 상수 | 설명 |
|---|---|
LineParticle3D.Absolute | 텍스처 좌표는 월드 위치를 기준으로 지정됩니다. |
LineParticle3D.Relative | 텍스처 좌표는 라인의 첫 번째 점에 상대적으로 지정됩니다. |
LineParticle3D.Fill | 텍스처 좌표는 텍스처가 선 전체를 채우도록 지정됩니다. |
alphaFade : real
이 속성은 선의 알파 페이드 계수를 저장합니다. alphaFade 값의 범위는 [0, 1]입니다. 이 값이 0.0보다 클 경우, 첫 번째 입자 세그먼트로부터 세그먼트가 멀어질수록 선이 점차 희미해집니다. 세그먼트의 알파 값은 다음과 같이 계산됩니다: segmentAlpha(s) = (1.0 - alphaFade) ^ s (여기서 s는 세그먼트 인덱스입니다). 기본값은 0.0입니다.
eolFadeOutDuration : int
이 속성은 라인의 수명 종료 시 페이드아웃 지속 시간을 지정합니다. 이 속성이 설정되면, 각 라인은 입자가 수명 종료 시점에 도달했을 때의 위치에 그대로 머무른 후, 이 기간 동안 페이드아웃됩니다. 기본값은 0입니다.
length : real
이 속성은 선의 길이를 저장합니다. 값이 설정된 경우, 선의 길이는 해당 값으로 제한됩니다. 이 경우 선의 최소 델타는 길이를 세그먼트 수로 나눈 값이 됩니다. 값이 설정되지 않은 경우, 선의 길이는 입자의 이동 속도와 세그먼트 수, 최소 델타에 따라 달라집니다. 기본값은 -1.0입니다.
lengthDeltaMin : real
이 속성은 세그먼트 점들 사이의 최소 길이를 나타냅니다. 길이 매개변수가 설정된 경우 이 매개변수는 무시됩니다. 기본값은 10.0입니다.
lengthVariation : real
이 속성은 각 선에 적용되는 길이 변동을 저장합니다. 변동은 ‘ length ’ 속성도 함께 설정된 경우에만 적용됩니다. 결과적인 선 길이는 양수 값으로 제한됩니다.
기본값은 0.0입니다.
scaleMultiplier : real
이 속성은 선의 배율 계수를 저장합니다. scaleMultiplier의 값 범위는 [0, 2]입니다. scaleMultiplier는 선분의 크기를 조정합니다. 값이 1.0보다 작으면 첫 번째 선분에서 멀어질수록 선의 크기가 작아지고, 값이 1.0보다 크면 선의 크기가 커집니다. 각 선분의 크기는 다음과 같이 계산됩니다: size(s) = scaleMultiplier ^ s, 여기서 s는 선분의 인덱스입니다.
segmentCount : int
이 속성은 선의 세그먼트 수를 나타냅니다. 선은 세그먼트 + 1개의 점을 사용하여 그려지며, 여기서 추가되는 1개는 입자의 현재 위치에서 비롯됩니다. 기본값은 1입니다.
texcoordMode : TexcoordMode
이 속성은 선의 텍스처 좌표 모드를 나타냅니다.
texcoordMultiplier : real
이 속성은 선의 텍스처 좌표 배율을 나타냅니다. 이 값은 선의 텍스처 좌표 값에 곱해집니다. 기본값은 1.0입니다.
© 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.