ObjectSetAction

Kategorie: Objekte / Aktivität
Ab Engineversion: 4.6.5.0 CP (erweitert ab 4.9.5.0 CE)

Beschreibung

Setzt die Aktivität des angegebenen Objekts. Siehe auch ActMap.txt.

Syntax

bool ObjectSetAction (object pObj, string szAction, object pTarget1, object pTarget2, bool fDirect);

Parameter

pObj:
Objekt, dessen Aktivität geändert werden soll. Achtung: Anders als bei vielen anderen Funktionen, darf dieser Parameter nicht ausgelassen werden, um die Aktivität des aufrufenden Objekts zu ändern. Dafür sollte stattdessen SetAction verwendet werden.
szAction:
Neue Aktivität. "ActIdle" oder "Idle" löscht die Aktivität.
pTarget1:
[opt] Erstes Zielobjekt für die Aktivität
pTarget2:
[opt] Zweites Zielobjekt für die Aktivität
fDirect:
[opt] Wenn gesetzt, wird die Aktivität direkt, ohne Start/AbortCalls und unter Umgehung des NoOtherAction-Flags gesetzt. Ab CE.

Anmerkung

Wird pTarget1 bzw. pTarget2 nicht angegeben bzw. 0 übergeben, so bleibt das jeweiligen Action Target der vorigen Aktion erhalten. Um die Action Targets zu löschen sollte SetActionTargets benutzt werden. Ist fDirect ungleich 0, werden die angegebenen Actiontargets allerdings auch dann gesetzt, wenn sie 0 sind.

Beispiel

ObjectSetAction(GetCursor(), "Dead");
Der ausgewählte Clonk des ersten Spielers wird scheintot.
Siehe auch: GetAction, GetActionTarget, SetAction, SetDir, SetPhase
Sven2, Juni 2003