LineParticle3D QML Type

行粒子。更多

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

SpriteParticle3D

属性

详细说明

LineParticle3D 可创建线条形状的精灵粒子。

线是根据粒子移动时的路径创建的。线的长度由length 参数或线段计数和点之间的最小 delta 值指定。在后一种情况下,如果粒子的速度发生变化,线条的长度也会随之变化。

属性文档

TexcoordMode : enumeration

定义线粒子的纹理坐标模式。

常数说明
LineParticle3D.Absolute纹理坐标是相对于世界位置指定的。
LineParticle3D.Relative纹理坐标相对于线条的第一个线条点。
LineParticle3D.Fill纹理坐标是指纹理填充整条直线的坐标。

alphaFade : real

此属性用于保存线条的 alphaFade 因子。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。


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