Sur cette page

LineParticle3D QML Type

Particule de ligne. En savoir plus...

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

SpriteParticle3D

Propriétés

Description détaillée

La fonction LineParticle3D crée des particules de type sprite en forme de ligne.

La ligne est générée à partir de la trajectoire de la particule lorsqu’elle se déplace. La longueur de la ligne est définie soit par le paramètre « length », soit par le nombre de segments et le delta minimal entre les points. Dans ce dernier cas, la longueur de la ligne peut varier si la vitesse de la particule varie.

Documentation des propriétés

TexcoordMode : enumeration

Définit le mode de coordonnées de texture de la particule de ligne.

ConstanteDescription
LineParticle3D.AbsoluteLes coordonnées de texture sont spécifiées par rapport à la position mondiale.
LineParticle3D.RelativeLes coordonnées de texture sont spécifiées par rapport au premier point de la ligne.
LineParticle3D.FillLes coordonnées de texture sont spécifiées de telle sorte que la texture remplisse toute la ligne.

alphaFade : real

Cette propriété définit le facteur de fondu alpha de la ligne. La valeur de alphaFade est comprise entre 0 et 1. Lorsqu'elle est supérieure à 0,0, la ligne s'estompe d'autant plus que le segment est éloigné du premier segment de particule. L'alpha d'un segment est calculé comme suit : segmentAlpha(s) = (1,0 - alphaFade) ^ s, où s est l'indice du segment. La valeur par défaut est 0,0.

eolFadeOutDuration : int

Cette propriété définit la durée de la disparition progressive de la ligne à la fin de sa durée de vie. Si cette option est activée, chaque ligne reste à l'endroit où elle se trouvait lorsque la particule a atteint la fin de sa durée de vie, puis disparaît progressivement pendant cette durée. La valeur par défaut est 0.

length : real

Cette propriété détermine la longueur de la ligne. Si une valeur est définie, la longueur de la ligne est limitée à cette valeur. Dans ce cas, le delta minimal de la ligne correspond à la longueur divisée par le nombre de segments. Si aucune valeur n’est définie, la longueur de la ligne varie en fonction de la vitesse de déplacement de la particule, ainsi que du nombre de segments et du delta minimal. La valeur par défaut est -1,0.

lengthDeltaMin : real

Cette propriété définit la longueur minimale entre les points d'un segment. Ce paramètre est ignoré si le paramètre « longueur » est défini. La valeur par défaut est 10,0.

lengthVariation : real

Cette propriété définit la variation de longueur appliquée à chaque ligne. La variation n’est appliquée que si la propriété « length » est également définie. La longueur de ligne obtenue est limitée aux valeurs positives.

La valeur par défaut est 0,0.

scaleMultiplier : real

Cette propriété contient le facteur d'échelle de la ligne. La plage de valeurs de `scaleMultiplier` est comprise entre [0, 2]. `scaleMultiplier` modifie la taille des segments de ligne. Si la valeur est inférieure à 1,0, la ligne devient plus fine à mesure que le segment s'éloigne du premier segment ; si la valeur est supérieure à 1,0, la ligne devient plus épaisse. La taille d'un segment est calculée comme suit : taille(s) = scaleMultiplier ^ s, où s est l'index du segment.

segmentCount : int

Cette propriété indique le nombre de segments composant la ligne. La ligne est dessinée à partir d'un segment + 1 point, le point supplémentaire correspondant à la position actuelle de la particule. La valeur par défaut est 1.

texcoordMode : TexcoordMode

Cette propriété définit le mode de coordonnées de texture de la ligne.

texcoordMultiplier : real

Cette propriété contient le multiplicateur des coordonnées de texture de la ligne. Cette valeur est appliquée aux coordonnées de texture de la ligne. La valeur par défaut est 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.