LineParticle3D QML Type
Particule de ligne. En savoir plus...
| Import Statement: | import QtQuick3D.Particles3D |
| Since: | Qt 6.4 |
| Inherits: |
Propriétés
- TexcoordMode : enumeration
- alphaFade : real
- eolFadeOutDuration : int
- length : real
- lengthDeltaMin : real
- lengthVariation : real
- scaleMultiplier : real
- segmentCount : int
- texcoordMode : TexcoordMode
- texcoordMultiplier : real
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.
| Constante | Description |
|---|---|
LineParticle3D.Absolute | Les coordonnées de texture sont spécifiées par rapport à la position mondiale. |
LineParticle3D.Relative | Les coordonnées de texture sont spécifiées par rapport au premier point de la ligne. |
LineParticle3D.Fill | Les 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.