StopAnimation

Kategorie: Animationen
Ab Engineversion: 1.0 OC

Beschreibung

Stoppt die Animation mit der angegeben Nummer (wie sie von PlayAnimation zurückgegeben wird) und entfernt die Animation aus dem zugehörigen Slot im Animations-Stack. Gehört ein Kombinationsknoten zur Nummer, so werden beide Animationen entfernt die kombiniert werden; wenn eine oder beide davon wieder Kombinationen sind werden auch deren Animationen entfernt, und so weiter. Wird die gestoppte Animation mit einer anderen kombiniert, so wird auch der zugehörige Kombinationsknoten entfernt, da es nun nichts mehr zu kombinieren gibt. Gibt true zurück wenn die Animation entfernt wurde, oder false wenn dies nicht möglich war (zum Beispiel wenn es keine Animation zur gegebenen Nummer gibt, oder die Animation zu Slot 0 gehört).

Syntax

bool StopAnimation(int animation_number, int attach_number);

Parameter

animation_number:
Nummer der zu stoppenden Animation.
attach_number:
[opt] If given, refers to the number of the attached mesh to use instead of the object's main mesh.

Anmerkung

Siehe die Animations-Dokumentation für eine Beschreibung des Animationssystems.

Beispiel

StopAnimation(GetRootAnimation(5));
Entfernt alle Animationen aus Slot 5 so dass dieser im Anschluss keine Animationen mehr enthält.
Siehe auch: PlayAnimation
Clonk-Karl, 2010-01