Attractor3D QML Type

Attire les particules vers une position ou une forme. En savoir plus…

• Liste de tous les membres, y compris les membres hérités

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 située à 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 par les paramètres « position » et « positionVariation », soit par « shape ». Si les deux sont définis, c'est « shape » qui est utilisé.

Documentation sur les propriétés

duration : int

Cette propriété définit, en millisecondes, le temps nécessaire aux particules pour atteindre la position d'attraction. Lorsque la valeur est -1, la durée de vie de la particule (lifeSpan) est utilisée comme durée.

La valeur par défaut est « -1 ».

durationVariation : int

Cette propriété définit la variation de durée en millisecondes. La durée réelle nécessaire pour atteindre l'attracteur est comprise entre duration - durationVariation et duration + durationVariation.

La valeur par défaut est 0 (aucune 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 permet d'éviter que les particules ne soient attirées vers un seul point, mais plutôt de manière aléatoire vers une zone plus étendue. Voici un exemple montrant comment attirer des particules vers un point aléatoire à l'intérieur d'un cube de dimensions (50, 50, 50) situé à la position (100, 0, 0) en 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 également « Node::position » et « shape ».

positionsAmount : int

Cette propriété définit le nombre de positions possibles stockées dans la forme de l'attracteur. Par défaut, ce nombre est égal au nombre de particules, mais il est possible d'utiliser une valeur inférieure pour réduire la taille du cache. Une valeur supérieure peut être utilisée pour accroître le caractère aléatoire.

shape : ParticleAbstractShape3D

Cette propriété définit une forme ( 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 aux propriétés « position » et « positionVariation ». Voici un exemple montrant comment attirer les particules vers un point aléatoire à l'intérieur d'une sphère en fonction de la longueur des particules ( lifeSpan) :

Attractor3D {
    position: Qt.vector3d(100, 0, 0)
    shape: ParticleShape3D {
        type: ParticleShape3D.Sphere
        fill: true
    }
}

Voir également Node::position et positionVariation.

useCachedPositions : bool

Cette propriété détermine 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 améliorent les performances.

La valeur par défaut est « true ».