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 参数或线段计数和点之间的最小 delta 值指定。在后一种情况下,如果粒子的速度发生变化,线条的长度也会随之变化。
属性文档
TexcoordMode : enumeration
定义线粒子的纹理坐标模式。
| 常数 | 说明 |
|---|---|
LineParticle3D.Absolute | 纹理坐标相对于世界位置。 |
LineParticle3D.Relative | 纹理坐标相对于线条的第一个线条点。 |
LineParticle3D.Fill | 指定纹理坐标,使纹理填充整条直线。 |
alphaFade : real
该属性用于保存线条的 alpha 淡入淡出因子。alphaFade 的取值范围为 [0,1]。当值大于 0.0 时,会导致线段距离第一个粒子线段越远,线条越淡。线段的 alpha 值是这样计算的:segmentAlpha(s) = (1.0 - alphaFade) ^ s,其中 s 是线段索引。默认值为 0.0。
eolFadeOutDuration : int
该属性用于保存线条生命周期结束时的淡出时间。如果设置了该属性,每一行都会保持在粒子生命周期结束时的位置,然后在这段时间内淡出。默认值为 0。
length : real
该属性表示行的长度。如果设置了该值,线条长度就会受限于该值。在这种情况下,线条的最小 delta 值为长度除以线段数。如果未设置该值,线条长度将根据粒子的移动速度、线段数和最小 delta 值而变化。默认值为-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.