Emetteurs (Emitters)

Les émetteurs (emitters) crée des particules. Ils peuvent soit créer un flux continu de particules, soit projeter par intermittence un certain nombre de particules en utilisant la fonction appropriée. Un système de particules peut avoir un nombre arbitraire d'émetteurs. Un émetteur présente les propriétés suivantes :

• xmin, xmax, ymin, ymax Indique l'étendue de la région dans laquelle les particules seront générées.
• shape Indique la forme de la région. Elle peut avoir les valeurs suivantes :
• ps_shape_rectangle
• ps_shape_ellipse
• ps_shape_diamond
• ps_shape_line
• distribution Indique la distribution utilisée pour générer les particules. La distribution peut prendre les valeurs suivantes :
• ps_distr_linear Indique une distribution linéaire, ce qui signifie que la distribution est régulière quelque soit la zone de la région.
• ps_distr_gaussian Indique une distribution Gaussienne dans laquelle la plupart des particules seront générées au centre plutôt que sur les côtés de la région.
• particle type Indique le type de particules devant être généré.
• number Indique le nombre de particules générées à chaque step. Si cette valeur est inférieure à 0, une particule sera générée à chaque step avec une chance de -1/number. Ainsi, par exemple, une valeur de -5 indiquera qu'une particule sera générée en moyenne tous les 5 steps.

Les fonctions suivantes sont disponibles pour paramétrer les émetteurs et leur permettre ainsi de créer des particules. Veuillez noter que chacune d'entre elles demande l'index du système de particules comme premier argument.

part_emitter_create(ps) Crée un nouvel émetteur pour le système de particules indiqué ps. Elle retourne l'index de l'émetteur. Cet index devra être utilisé dans tous les appels de fonctions ci-dessous afin de régler les propriétés de l'émetteur.
part_emitter_destroy(ps, ind) Détruit l'émetteur ind du système de particules ps. Invoquez cette fonction si vous ne souhaitez plus utiliser l'émetteur afin de gagner de l'espace mémoire.
part_emitter_destroy_all(ps) Détruit tous les émetteurs du système de particules ps qui ont été créés.
part_emitter_exists(ps, ind) Retourne si l'émetteur indiqué ind existe dans le système de particules ps.
part_emitter_clear(ps, ind) Réinitialise l'émetteur ind à ses valeurs par défaut.
part_emitter_region(ps, ind, xmin, xmax, ymin, ymax, shape, distribution) Détermine la région et la distribution pour l'émetteur ind.
part_emitter_burst(ps, ind, parttype, number) Projette en une seule fois number particules du type indiqué parttype à partir de l'émetteur ind.
part_emitter_stream(ps, ind, parttype, number) A partir de ce moment désormais, crée number particules du type indiqué parttype avec l'émetteur ind à chaque step. Si vous indiquez un nombre inférieur à 0, une particule sera générée à chaque step avec une chance de -1/number. Par exemple, une valeur de -5 générera en moyenne une particule tous les 5 steps.

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