Attracteurs (Attractors)

En plus des émetteurs, un système de particules peut également comprendre des attracteurs (attractors). Un attracteur attire les particules (ou les repousse). Un système de particules peut avoir plusieurs attracteurs. Il est cependant recommandé d'en utiliser un petit nombre afin de ne pas trop ralentir le traitement des particules. Un attracteur posséde les propriétés suivantes :

• x, y Indique la position de l'attracteur.
• force Indique la force d'attraction de l'attracteur. La manière dont agit la force sur les particules dépend des paramétres suivants.
• dist Indique la distance maximale à partir de laquelle l'attracteur cesse d'avoir des effets. Seules les particules inférieures à cette distance de l'attracteur seront attirées.
• kind Indique le type d'attracteur. Les valeurs suivantes existent :
• ps_force_constant Indique si la force doit être constante indépendamment de la distance.
• ps_force_linear Indique une force augmentant de manière linéaire. A la distance maximale, la force sera de 0 alors qu'à la position de l'attracteur, la force atteindra la valeur maximale indiquée.
• ps_force_quadratic Indique que la force augmentera de façon quadratique.
• additive Indique si la force doit être ajoutée à la vitesse et à la direction à chaque step (true) ou si elle doit être appliquée à la position de la particule (false). Dans le cas de l'ajout, la particule accélérera en direction de l'attracteur tandis que dans le cas d'une force non-additive, la particule se déplacera à une vitesse constante.

Les fonctions suivantes existent pour définir les attracteurs. Veuillez noter que chacune de ces fonctions demande l'index du système de particules comme premier argument.

part_attractor_create(ps) Crée un nouvel attracteur dans le système de particules ps. Cette fonction retourne l'index de l'attracteur. Cet index sera à utiliser dans tous les appels de fonctions ci-dessous afin de paramétrer les propriétés de l'émetteur.
part_attractor_destroy(ps, ind) Détruit l'attracteur ind du système de particules ps. Appelez cette fonction si vous n'avez plus besoin de l'attracteur afin d'économiser de l'espace mémoire.
part_attractor_destroy_all(ps) Détruit tous les attracteurs du système de particules ps qui ont été créés.
part_attractor_exists(ps, ind) Indique si l'attracteur ind existe dans le système de particules ps.
part_attractor_clear(ps, ind) Réinitialise l'attracteur ind à ses valeurs par défaut.
part_attractor_position(ps, ind, x, y) Fixe la position de l'attracteur ind à la position (x,y).
part_attractor_force(ps, ind, force, dist, kind, aditive) Régle les paramètres de la force de l'attracteur ind.

<< Traduction française par Philippe Ragni - (2005) >>