CreateParticle

Kategorie: Partikel
Ab Engineversion: 5.1 OC

Beschreibung

Erzeugt ein Partikel. Das Partikel muss unter dem angegebenen Namen geladen sein. Für weitere Informationen siehe Partikeldokumentation.

Syntax

bool CreateParticle(string szName, int x, int y, int xdir, int ydir, int a, int b, object target, bool behind_target);

Parameter

szName:
Name des Partikels
x:
X-Position des Partikels. Relative Koordinaten bei lokalem Aufruf.
y:
Y-Position des Partikels. Relative Koordinaten bei lokalem Aufruf.
xdir:
Horizontale Anfangsgeschwindigkeit des Partikels
ydir:
Vertikale Anfangsgeschwindigkeit des Partikels
a:
Zusatzparameter. Dies ist normalerweise die Größe des Partikels in 1/5-Pixeln.
b:
Zweiter Zusatzparameter. Dies ist normalerweise die Farbmodulation des Partikels.
target:
[opt] Zielobjekt für objektlokale Partikel. Objektlokale Partikel werden direkt über den jeweiligen Objekten gezeichnet, und beim Entfernen des Objekts gelöscht.
behind_target:
[opt] Wenn angegeben und nicht false, wird der Partikel hinter dem Zielobjekt gezeichnet.

Anmerkung

Diese Funktion gibt false zurück wenn die Partikeldefinition unter dem Namen nicht geladen wurde. Ansonsten immer true. Es gibt also keine Möglichkeit, herauszufinden, ob ein Partikel wirklich erzeugt wurde. Dies muss aus Gründen der Netzwerksynchronisation so sein, und Partikel sollten darum nur für kurzzeitige Effekte verwendet werden. Wer mehr Kontolle benötigt, sollte stattdessen auf Objekte zurückgreifen.

Beispiel

CreateParticle("Blast", 0,0, 0,0, 100, RGB(128,128,255));
Erzeugt eine bläuliche Explosionsgrafik an der Position des aufrufenden Objekts.
Siehe auch: ClearParticles, PushParticles
Sven2, 2002-04