ea

Class AnimationsManager

java.lang.Object

ea.Manager

ea.AnimationsManager

All Implemented Interfaces:

AnimationsEndeReagierbar

public class AnimationsManager
extends Manager
implements AnimationsEndeReagierbar

Der Animationsmanager handelt benutzerfreundlich einfache Animationen.

Er arbeitet intern mit unterschiedlichen Objekten der Klasse Animierer.
Es können theoretisch problemlos auch mehrere Animationen gekoppelt werden. Denn diese arbeitet nicht mit Raum.positionSetzen(Punkt) sondern mit relativen Verschiebungen über die Methode Raum.verschieben(Vektor).

Author:

Michael Andonie

See Also:

Animierer

Field Summary

Fields inherited from class ea.Manager

fontNamen, standard

Method Summary

Modifier and Type	Method and Description
void	animationBeendenVon(Raum raum) Beendet alle Animationen von einem Raum-Objekt. Gibt es keine Animation von diesem, so passiert gar nichts.
void	endeReagieren(Animierer an) Die implementierte endeReagieren-Methode.
void	geradenAnimation(Raum ziel, Punkt orientierung) Noch staerker vereinfachte Variante der geradenAnimation()-Methode. Der Weg bis zum orientierung-Punkt wird in einer Sekunde abgegangen, und die Animation selbst dauert 2 Sekunden.
void	geradenAnimation(Raum ziel, Punkt orientierung, int zielGeschwindigkeit) Vereinfachte Variante der geradenAnimation()-Methode. HIer wird bereits voreingestellt, das die Animation andauert, bis das Objekt den Orientierungspunkt erreicht hat und noch einmal die selbe Strecke abgegangen ist (sprich, doppelt so lange laufzeit wie die als Argument mitgegebene zielGeschwindigkeit.
void	geradenAnimation(Raum ziel, Punkt orientierung, int zielGeschwindigkeit, int dauerInMS) Animiert ein Objekt auf einer einfachen Halbgerade. Die Animation endet nach dem Ablauf ihrer ihr zugesprochenen Dauer (in Millisekunden). Ein Beispiel: //Das zu animierende, instanziierte Raum-Objekt Raum raum; //Der AnimationsManager.
static AnimationsManager	getAnimationsManager() Diese Methode gibt den einen und einzigen existierenden Animationsmanager aus. Dies ist ein realisiserter Singleton.
static float	intervall(float z) Berechnet eine Zahl, die entweder die Eingabe selbst oder 1 ist, sofern die Eingabe kleiner als 1 ist.
void	kreisAnimation(Raum ziel) Bis ins Lächerliche vereinfachte Methode zum zum Kreisanimieren. Hierbei wird nicht nur die gesamte Bewegung automatisch wiederholt und die Umlaufzeit auf 1,5 Sekunden voreingestellt, sondern auch noch der Mittelpunkt der Kreisbewegung automatisch ermittelt.
void	kreisAnimation(Raum ziel, Punkt zentrum) Extrem vereinfachte Methode zum zum Kreisanimieren. Hierbei wird nicht nur die gesamte Bewegung automatisch wiederholt, sondern auch die Umlaufzeit auf 1,5 Sekunden voreingestellt.
void	kreisAnimation(Raum ziel, Punkt zentrum, boolean loop, int umlaufzeit) Animiert ein Raum-Objekt auf einer Kreisbahn.
void	kreisAnimation(Raum ziel, Punkt zentrum, boolean loop, int umlaufzeit, boolean uhrzeigersinn) Animiert ein Raum-Objekt auf einer Kreisbahn.
void	kreisAnimation(Raum ziel, Punkt zentrum, int umlaufzeit) Vereinfachte Methode zum Kreisanimieren. Hierbei wird die gesamte Bewegung automatisch wiederholt.
static void	neutralize() Beendet sämtliche laufenden Animationen
void	streckenAnimation(Raum ziel, int laufDauer, boolean wiederholen, boolean geschlossen, Punkt... strecke) Animiert ein Raum-Objekt auf einer Strecke aus einer bestimmten Zahl linearer Teilstrecken.
void	streckenAnimation(Raum ziel, int laufDauer, boolean wiederholen, Punkt... strecke) Leicht vereinfachte Form der Streckanimationsmethode. Hierbei wird, sofern wiederholt wird, automatisch in einem Kreislauf animiert.
void	streckenAnimation(Raum ziel, int laufDauer, Punkt... strecke) Vereinfachte Form der Streckanimationsmethode. Hierbei wird automatisch in einem geschlossenen Kreislauf wiederholt.
void	streckenAnimation(Raum ziel, Punkt... strecke) Stark vereinfachte Form der Streckanimationsmethode. Hierbei wird die Animation automatisch in einem geschlossenen Kreislauf wiederholt und die Zeit fuer die Bewegung zwischen den einzelnen Punkten betraegt jeweils eine Sekunde.

Methods inherited from class ea.Manager

abmelden, alleAbmelden, anhalten, anmelden, anmelden, fontExistiert, hatAktiveTicker, istAngemeldet, kill, starten

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

neutralize

@API
public static void neutralize()

Beendet sämtliche laufenden Animationen

getAnimationsManager

@API
public static AnimationsManager getAnimationsManager()

Diese Methode gibt den einen und einzigen existierenden Animationsmanager aus.
Dies ist ein realisiserter Singleton.

Returns:

Der eine aktive Animationsmanager.

kreisAnimation

@API
public void kreisAnimation(Raum ziel)

Bis ins Lächerliche vereinfachte Methode zum zum Kreisanimieren.
Hierbei wird nicht nur die gesamte Bewegung automatisch wiederholt und die Umlaufzeit auf 1,5 Sekunden voreingestellt, sondern auch noch der Mittelpunkt der Kreisbewegung automatisch ermittelt. Er wird sich 150 Koordinatenpunkte unterhalb des Mittelpunktes des zu animierenden Raum-Objektes befinden.

Parameters:

ziel - Das zu animierende Raum-Objekt. Hierbei ist dessen Zentrum auf der Kreisbahn.

See Also:

kreisAnimation(Raum, Punkt, boolean, int), kreisAnimation(Raum, Punkt, int), kreisAnimation(Raum, Punkt)

kreisAnimation

@API
public void kreisAnimation(Raum ziel,
                                Punkt zentrum)

Extrem vereinfachte Methode zum zum Kreisanimieren.
Hierbei wird nicht nur die gesamte Bewegung automatisch wiederholt, sondern auch die Umlaufzeit auf 1,5 Sekunden voreingestellt.

Parameters:

ziel - Das zu animierende Raum-Objekt. Hierbei ist dessen Zentrum auf der Kreisbahn.

zentrum - Das Zentrum des Animationskreises

See Also:

kreisAnimation(Raum, Punkt, boolean, int), kreisAnimation(Raum, Punkt, int)

kreisAnimation

@API
public void kreisAnimation(Raum ziel,
                                Punkt zentrum,
                                int umlaufzeit)

Vereinfachte Methode zum Kreisanimieren.
Hierbei wird die gesamte Bewegung automatisch wiederholt.

Parameters:

ziel - Das zu animierende Raum-Objekt. Hierbei ist dessen Zentrum auf der Kreisbahn.

zentrum - Das Zentrum des Animationskreises

umlaufzeit - Gibt in Millisekunden an, wie lange eine Umdrehung um das Zentrum dauern soll.
ACHTUNG:
Dieser Wert muss groesser sein als 200, da intern eine Umdrehung 200 Einzelschritte hat.

See Also:

kreisAnimation(Raum, Punkt, boolean, int)

kreisAnimation

@API
public void kreisAnimation(Raum ziel,
                                Punkt zentrum,
                                boolean loop,
                                int umlaufzeit)

Animiert ein Raum-Objekt auf einer Kreisbahn.

Parameters:

ziel - Das zu animierende Raum-Objekt. Hierbei ist dessen Zentrum auf der Kreisbahn.

zentrum - Das Zentrum des Animationskreises

loop - Gibt an, ob die Animation einfach ist oder nicht.

umlaufzeit - Gibt in Millisekunden an, wie lange eine Umdrehung um das Zentrum dauern soll.
ACHTUNG:
Dieser Wert muss groesser sein als 200, da intern eine Umdrehung 200 Einzelschritte hat.

kreisAnimation

@API
public void kreisAnimation(Raum ziel,
                                Punkt zentrum,
                                boolean loop,
                                int umlaufzeit,
                                boolean uhrzeigersinn)

Animiert ein Raum-Objekt auf einer Kreisbahn.

Parameters:

ziel - Das zu animierende Raum-Objekt. Hierbei ist dessen Zentrum auf der Kreisbahn.

zentrum - Das Zentrum des Animationskreises

loop - Gibt an, ob die Animation einfach ist oder nicht.

umlaufzeit - Gibt in Millisekunden an, wie lange eine Umdrehung um das Zentrum dauern soll.
ACHTUNG:
Dieser Wert muss groesser sein als 200, da intern eine Umdrehung 200 Einzelschritte hat.

intervall

@NoExternalUse
public static float intervall(float z)

Berechnet eine Zahl, die entweder die Eingabe selbst oder 1 ist, sofern die Eingabe kleiner als 1 ist.

Parameters:

z - Die einzugebende Zahl

Returns:

1, wenn z < 1, sonst z.

streckenAnimation

@API
public void streckenAnimation(Raum ziel,
                                   int laufDauer,
                                   boolean wiederholen,
                                   Punkt... strecke)

Leicht vereinfachte Form der Streckanimationsmethode.
Hierbei wird, sofern wiederholt wird, automatisch in einem Kreislauf animiert.

Parameters:

ziel - Das zu animierende Raum-Objekt. Sein Zentrum (ueber die Methode zentrum()) wird die Strecke abwandern (und natuerlich mit ihm die ganze Figur).

laufDauer - Die Zeit in Millisekunden, die vergeht, bis die Bewegung dieser Animation alle "Ettapen"-Punkte einmal abgegangen ist.

wiederholen - Gibt an, ob diese Animation in Dauerschleife wiederholt werden soll, oder ob sie nur einmal bis zum letzten Punkt sich abspielen soll, und anschliessend sich automatisch selbst beenden soll.

strecke - Eine beliebige Anzahl von "Ettappen"-Punkten. Das Zielobjekt wird sich zwischen diesen bewegen, wobei die Bewegung zwischen 2 Punkten immer gleich lang ist, unnabhaengig von ihrer Entfernung zueinander!
Die Erste Ettappe ist das aktuelle Zentrum des Zielobjekts.

See Also:

streckenAnimation(Raum, int, boolean, boolean, Punkt...)

streckenAnimation

@API
public void streckenAnimation(Raum ziel,
                                   int laufDauer,
                                   boolean wiederholen,
                                   boolean geschlossen,
                                   Punkt... strecke)

Animiert ein Raum-Objekt auf einer Strecke aus einer bestimmten Zahl linearer Teilstrecken.

Ein Anwendungsbeispiel:

//Instanziiertes, nicht null-wertiges Raum-Objekt.
Raum objekt;

//Erstellen eines Managers. In der Klasse "Game" wird bereits einer bereitgestellt (Muss also dort nicht extra instanziiert werden!!)
AnimationsManager manager = new AnimationsManager();

//Ausführen der Methode des Managers
manager.streckenAnimation(objekt, 4000, true, true, new Punkt(100, 100), new Punkt(200, 100), new Punkt(200, 200));

Hierbei wird das Objekt auf der Strecke zwischen
- Seinem Mittelpunkt
- Dem Punkt (100|100)
- Dem Punkt (200|100)
- Und dem Punkt (200|200)
bewegt und anschliessend wieder zurueck zu seinem alten Mittelpunkt, da sowohl wiederholen als auch geschlossen true ist.
Diese Bewegung ("einmal den Kreislauf") dauert 4 Sekunden (= 4000 Millisekunden).

Parameters:

ziel - Das zu animierende Raum-Objekt. Sein Zentrum (ueber die Methode zentrum()) wird die Strecke abwandern (und natuerlich mit ihm die ganze Figur).

laufDauer - Die Zeit in Millisekunden, die vergeht, bis die Bewegung dieser Animation alle "Ettapen"-Punkte einmal abgegangen ist.

wiederholen - Gibt an, ob diese Animation in Dauerschleife wiederholt werden soll, oder ob sie nur einmal bis zum letzten Punkt sich abspielen soll, und anschliessend sich automatisch selbst beenden soll.

geschlossen - Gibt an, ob bei Wiederholung die Animation vom letzten wieder zum ersten Punkt laufen soll oder ob sie vom letzten zum vorletzten (usw) rueckwaerts weiterlaufen soll, bis zum Anfang und anschliessend wieder wechseln soll, also sozusagen immer wieder hin und her pendeln soll.
Natuerlich ist dieser Parameter irrelevant, wenn wiederholen false ist.

strecke - Eine beliebige Anzahl von "Ettappen"-Punkten. Das Zielobjekt wird sich zwischen diesen bewegen, wobei die Bewegung zwischen 2 Punkten immer gleich lang ist, unnabhaengig von ihrer Entfernung zueinander!
Die Erste Ettappe ist das aktuelle Zentrum des Zielobjekts.

streckenAnimation

@API
public void streckenAnimation(Raum ziel,
                                   int laufDauer,
                                   Punkt... strecke)

Vereinfachte Form der Streckanimationsmethode.
Hierbei wird automatisch in einem geschlossenen Kreislauf wiederholt.

Parameters:

ziel - Das zu animierende Raum-Objekt. Sein Zentrum (ueber die Methode zentrum()) wird die Strecke abwandern (und natuerlich mit ihm die ganze Figur).

laufDauer - Die Zeit in Millisekunden, die vergeht, bis die Bewegung dieser Animation alle "Ettapen"-Punkte einmal abgegangen ist.

strecke - Eine beliebige Anzahl von "Ettappen"-Punkten. Das Zielobjekt wird sich zwischen diesen bewegen, wobei die Bewegung zwischen 2 Punkten immer gleich lang ist, unnabhaengig von ihrer Entfernung zueinander!
Die Erste Ettappe ist das aktuelle Zentrum des Zielobjekts.

See Also:

streckenAnimation(Raum, int, boolean, boolean, Punkt...), streckenAnimation(Raum, int, boolean, Punkt...)

streckenAnimation

@API
public void streckenAnimation(Raum ziel,
                                   Punkt... strecke)

Stark vereinfachte Form der Streckanimationsmethode.
Hierbei wird die Animation automatisch in einem geschlossenen Kreislauf wiederholt und die Zeit fuer die Bewegung zwischen den einzelnen Punkten betraegt jeweils eine Sekunde.

Parameters:

ziel - Das zu animierende Raum-Objekt. Sein Zentrum (ueber die Methode zentrum()) wird die Strecke abwandern (und natuerlich mit ihm die ganze Figur).

strecke - Eine beliebige Anzahl von "Ettappen"-Punkten. Das Zielobjekt wird sich zwischen diesen bewegen, wobei die Bewegung zwischen 2 Punkten immer gleich lang ist, unnabhaengig von ihrer Entfernung zueinander!
Die Erste Ettappe ist das aktuelle Zentrum des Zielobjekts.

See Also:

streckenAnimation(Raum, int, boolean, boolean, Punkt...), streckenAnimation(Raum, int, boolean, Punkt...), streckenAnimation(Raum, int, Punkt...)

geradenAnimation

@API
public void geradenAnimation(Raum ziel,
                                  Punkt orientierung)

Noch staerker vereinfachte Variante der geradenAnimation()-Methode.
Der Weg bis zum orientierung-Punkt wird in einer Sekunde abgegangen, und die Animation selbst dauert 2 Sekunden.

Parameters:

ziel - Das zu animierende Raum-Objekt

orientierung - Der Punkt, durch den die Animationslinie verlaeuft.

See Also:

geradenAnimation(Raum, Punkt, int, int), geradenAnimation(Raum, Punkt, int)

geradenAnimation

@API
public void geradenAnimation(Raum ziel,
                                  Punkt orientierung,
                                  int zielGeschwindigkeit)

Vereinfachte Variante der geradenAnimation()-Methode.
HIer wird bereits voreingestellt, das die Animation andauert, bis das Objekt den Orientierungspunkt erreicht hat und noch einmal die selbe Strecke abgegangen ist (sprich, doppelt so lange laufzeit wie die als Argument mitgegebene zielGeschwindigkeit.

Parameters:

ziel - Das zu animierende Raum-Objekt

orientierung - Der Punkt, durch den die Animationslinie verlaeuft.

zielGeschwindigkeit - Die Zeit, die vergeht (in millisekunden), bis die Animation den Zielpunkt erreicht.

See Also:

geradenAnimation(Raum, Punkt, int, int)

geradenAnimation

@API
public void geradenAnimation(Raum ziel,
                                  Punkt orientierung,
                                  int zielGeschwindigkeit,
                                  int dauerInMS)

Animiert ein Objekt auf einer einfachen Halbgerade.
Die Animation endet nach dem Ablauf ihrer ihr zugesprochenen Dauer (in Millisekunden).

Ein Beispiel:

//Das zu animierende, instanziierte Raum-Objekt
Raum raum;

//Der AnimationsManager. (Im Zweifelsfall bereits in der Klasse Game als Variable Vorhanden)
AnimationsManager manager;

//Die Animation einleiten
manager.geradenAnimation(raum, new Punkt(300, 200), 1000, 3000);

Dies erstellt eine Geraden-Animation mit konstanter Geschwindigkeit, die:
- Vom Mittelpunkt des raum-Animationsobjekts anfaengt
- Durch den Punkt (300|200) verlaeuft
- Diesen Punkt nach 1000 Millisekunden (= 1 Sekunde) erreicht und
- 3000 Millisekunden (= 3 Sekunden) andauert, und dann automatisch beendet wird.

Diese Methode hat den Vorteil, das sie nie dauerhaft Speicherressourcen verbraucht, da keine dieser Animationen (im Gegensatz zu zB einer Kreis-Animation) unbegrenzt lange laufen kann.

Parameters:

ziel - Das zu animierende Raum-Objekt

orientierung - Der Punkt, durch den die Animationslinie verlaeuft.

zielGeschwindigkeit - Die Zeit, die vergeht (in millisekunden), bis die Animation den Zielpunkt erreicht.

dauerInMS - Die Dauer in Millisekunden, bis die Animation beendet wird. ISt diese geringer als die zielGeschwindigkeit, so erreicht die Animation nicht den Orientierungspunkt (der Eingabeparamter orientierung)

animationBeendenVon

@API
public void animationBeendenVon(Raum raum)

Beendet alle Animationen von einem Raum-Objekt.
Gibt es keine Animation von diesem, so passiert gar nichts.

Parameters:

raum - Das Raum-Objekt, dessen Animation(en) von diesem Manager beendet werden soll(en)

endeReagieren

public void endeReagieren(Animierer an)

Die implementierte endeReagieren-Methode.

Hierin wird jede Referenz auf die beendete Animation gelöscht.

Specified by:

endeReagieren in interface AnimationsEndeReagierbar

Parameters:

an - Die gerade geendetet Animation