Bezeichnung
PlayAnim -- spielt eine Animation ab
Übersicht
[handle] = PlayAnim(id[, x, y, table])
Beschreibung
Dieser Befehl beginnt, eine zuvor geladene und durch id angegebene Animation abzuspielen. Optional können Sie die X- und Y-Koordinaten der Ausgabe angeben.

Wenn Ebenen aktiviert sind, wird dieser Befehl eine neue Ebene des Typs #ANIM dem Ebenenstapel hinzuzufügen.

Ab Hollywood 4.0 akzeptiert PlayAnim() eine zusätzliches optionales Tabellenargument, das verwendet werden kann, um mehrere weitere Wiedergabeoptionen zu konfigurieren:

Speed:
Legt die Wiedergabegeschwindigkeit für die Animation fest. Je höher die Zahl, desto langsamer ist die Wiedergabegeschwindigkeit. Sie können auch eine Konstante für die Geschwindigkeit (#SLOWSPEED, #NORMALSPEED oder #FASTSPEED) angeben. Neu in Hollywood 4.5: Sie können hier die neue Konstante #DEFAULTSPEED angeben. Wenn Sie #DEFAULTSPEED verwenden, wird Hollywood die Geschwindigkeit verwenden, wie sie in der Animationsdatei definiert ist. Beachten Sie, dass nicht alle Animationen eine solche Geschwindigkeit definieren. Daher kann die Wiedergabe falsch aussehen.

Times:
Gibt an, wie oft die Animation gespielt wird (Standard: 1, spielt die Animation nur einmal). Wenn Sie die Animation als Endlosschleife wollen, geben Sie hier 0 ein.

Async:
Sie können diesen Tag verwenden, um ein asynchrones Zeichnungsobjekt für diese Wiedergabe zu erstellen. Wenn Sie hier True angeben, wird PlayAnim() sofort verlassen und es wird ein Handler für das asynchrone Zeichnungsobjekt kreiert, den Sie dann mit dem Befehl AsyncDrawFrame() verwenden können. Siehe AsyncDrawFrame für weitere Informationen über asynchrone Zeichnungsobjekte.

Eingaben
id
ID der abzuspielenden Animation
x
optional: X-Position bei der Wiedergabe (voreingestellt: 0)
y
optional: Y-Position bei der Wiedergabe (voreingestellt: 0)
table
optional: weitere Konfigurationen für das Abspielen der Anim
Rückgabewerte
handle
optional: Handler auf ein asynchrones Zeichnungsobjekt; wird nur zurückgegeben, wenn Async auf True gesetzt wurde (siehe oben)
Beispiel
PlayAnim(1)
Spielt die Animation 1 ab.

Navigation zeigen