ChangeEffect

Kategorie: Effekte
Ab Engineversion: 4.9.5.0 CE

Beschreibung

Ändert den Namen eines Effektes, und damit auch die aufgerufenen Callback-Funktionen.

Syntax

bool ChangeEffect (string szEffectName, object pTarget, int iIndex, string szNewEffectName, int iNewTimer);

Parameter

szEffectName:
[opt] Name des Effektes ohne vorangestelltes Fx. Es können '*' und '?' als Suchmaske verwendet werden.
pTarget:
[opt] Zielobjekt, in dem Effekte geändert werden sollen. Bei 0 wird die globale Effektliste durchsucht.
iIndex:
[opt] Effektindex. Bei angegebenem szEffectName gibt dies bei mehreren, der Suchmaske entsprechenden Effekten den indizierten Effekt in der Liste der passenden Effekte an. Ist szEffectName nicht angegeben, wird dagegen der Effekt mit der entsprechenden Effektnummer geändert. Im Gegensatz zu Effektnummern ist bei Indizes stets sichergestellt, dass beim Hochzählen von 0 bis zur Effektzahl alle Effekte erfasst werden.
szNewEffectName:
[opt] Neuer Effektname ohne vorangestelltes Fx
iNewTimer:
[opt] Neues Timer-Intervall. Bei -1 wird der alte Wert beibehalten; ansonsten wird bei diesem Aufruf auch die Effektzeit zurückgesetzt.

Beispiele

ChangeEffect("MeinEffekt", 0, 0, "AndererEffekt");
Ändert den globalen Effekt "MeinEffekt" auf "AndererEffekt", wenn er existierte.
var obj, i, iEffect;
while ((i=0) || obj=FindObject(0, 0,0,0,0, 0, 0,0, 0, obj))
  while (iEffect = GetEffect("*Fire*", obj, i))
    ChangeEffect(0, obj, i++, GetEffect(0, obj, iIndex, 1), 2);
Schaltet alle Feuer in den Zeitraffer.
Siehe auch: AddEffect, CheckEffect, EffectCall, EffectVar, Effekte-Dokumentation, GetEffect, GetEffectCount, RemoveEffect
Sven2, März 2004