Attractor3D QML Type
Attire les particules vers une position ou une forme. Plus d'informations...
| Import Statement: | import QtQuick3D.Particles3D |
| Since: | Qt 6.2 |
| Inherits: |
Propriétés
- duration : int
- durationVariation : int
- hideAtEnd : bool
- positionVariation : vector3d
- positionsAmount : int
- shape : ParticleAbstractShape3D
- useCachedPositions : bool
Description détaillée
Cet élément attire les particules vers une position à l'intérieur de la vue 3D. Pour modéliser la gravité d'un objet massif dont le centre de gravité est éloigné, utilisez Gravity3D.
La position d'attraction est définie soit avec les éléments position et positionVariation soit avec shape. Si les deux sont définis, shape est utilisé.
Documentation sur les propriétés
duration : int
Cette propriété définit la durée en millisecondes nécessaire aux particules pour atteindre la position d'action. Lorsque la valeur est -1, la durée de vie des particules est utilisée comme durée.
La valeur par défaut est -1.
durationVariation : int
Cette propriété définit la variation de la durée en millisecondes. La durée réelle pour atteindre l'attracteur est comprise entre duration - durationVariation et duration + durationVariation.
La valeur par défaut est 0 (pas de variation).
hideAtEnd : bool
Cette propriété définit si la particule doit disparaître lorsqu'elle atteint l'attracteur.
La valeur par défaut est false.
positionVariation : vector3d
Cette propriété définit la variation de la position d'attraction. Elle peut être utilisée pour ne pas attirer vers un seul point, mais au hasard vers une zone plus large. Voici un exemple qui montre comment attirer des particules vers un point aléatoire à l'intérieur d'un cube (50, 50, 50) à la position (100, 0, 0) dans un délai de 2 à 4 secondes :
Attractor3D { position: Qt.vector3d(100, 0, 0) positionVariation: Qt.vector3d(50, 50, 50) duration: 3000 durationVariation: 1000 }
La valeur par défaut est (0, 0, 0) (aucune variation).
Voir aussi Node::position et shape.
positionsAmount : int
Cette propriété définit la quantité de positions possibles stockées dans la forme de l'attracteur. Par défaut, la quantité est égale au nombre de particules, mais une quantité inférieure peut être utilisée pour un cache plus petit. Une valeur plus élevée peut être utilisée pour une randomisation supplémentaire.
shape : ParticleAbstractShape3D
Cette propriété définit une ParticleAbstractShape3D pour l'attraction des particules. Chaque particule sera attirée vers une position aléatoire à l'intérieur de cette forme. Il s'agit d'une alternative à la définition de position et positionVariation. Voici un exemple de la manière dont les particules sont attirées vers un point aléatoire à l'intérieur de la sphère par la fin des particules lifeSpan:
Attractor3D { position: Qt.vector3d(100, 0, 0) shape: ParticleShape3D { type: ParticleShape3D.Sphere fill: true } }
Voir aussi Node::position et positionVariation.
useCachedPositions : bool
Cette propriété définit si l'attracteur met en cache les positions possibles à l'intérieur de sa forme. Les positions mises en cache donnent des résultats moins aléatoires mais sont plus performantes.
La valeur par défaut est true.
© 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.