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