ea

Class ActionFigur

java.lang.Object

ea.Raum

ea.ActionFigur

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<Raum>

public class ActionFigur
extends Raum

Eine Actionfigur ist eine besondere Figur. Diese hat verschiedene Zustände und kann verschiedene Aktionen durchführen. Das bedeutet: Jeder Zustand und jede Aktion werden von einem eigenen Figur-Objekt dargestellt.

Die Figur des aktuellen Zustandes wird normalerweise dargestellt.

Wird eine Aktion ausgeführt, so wird die dazugehoerige Figur einmal durchanimiert. Anschliessend kehrt die Figur in ihren Zustand zurück.

WICHTIG:
Damit eine Actionfigur immer ordnungsgemäß funktioniert (Spiegelungen), sollten alle Figuren die selben Masße ("Pixel"-Hoehe/-Breite) haben.

Es müssen nicht alle Felder ausgefüllt sein, damit Kollisionstests etc. immer funktionieren. Es sei denn, die rechenintensive Arbeit wurde durch die Klasse Game ausgeschaltet (Game.rechenintensiveArbeitSetzen(boolean)).

Author:

Michael Andonie

See Also:

Serialized Form

Field Summary

Fields inherited from class ea.Raum

farbzyklus, position, roh

Constructor Summary

Constructors

Constructor and Description
ActionFigur(Figur zustand, java.lang.String name) Konstruktor.

Method Summary

Modifier and Type	Method and Description
void	aktionSetzen(java.lang.String name) Versetzt diese Actionfigur in eine bestimmte Aktion.
Figur	aktuelleFigur() Gibt die aktuelle Figur zurück.
java.lang.String	aktuellesVerhalten() Gibt den aktuellen Zustand dieser Action-Figur als String aus.
BoundingRechteck	dimension() Berechnet ein minimales BoundingRechteck, das das Objekt voll einschließt.
void	einfaerben(Farbe farbe) Färbt alle Figuren dieser Action-Figur in eine Farbe ein.
void	einfaerben(java.lang.String farbe) Färbt alle Figuren dieser Action-Figur in eine Farbe ein.
Collider	erzeugeCollider() Erzeugt einen neuen Collider für dieses Objekt.
void	faktorSetzen(int faktor) Setzt den Größenfaktor aller anliegender Einzelfiguren dieser Action-Figur neu.
BoundingRechteck[]	flaechen() Berechnet exakt die derzeitig von dieser Figur okkupierten Flächen auf der Zeichenebene.
void	hatAktionSetzen(boolean action) Setzt, ob diese Figur zur Zeit eine Aktion hat.
void	neueAktion(Figur action, java.lang.String name) Meldet eine neue Aktion für diese Figur an.
void	neuerZustand(Figur zustand, java.lang.String name) Meldet einen neuen Zustand für diese Figur an.
void	spiegelXSetzen(boolean spiegel) Spiegelt alle Figuren der Zustände und Aktionen dieser Figur an der X-Achse.
void	spiegelYSetzen(boolean spiegel) Spiegelt alle Figuren der Zustände und Aktionen dieser Figur an der Y-Achse.
void	verschieben(Vektor v) Verschiebt die Actionfigur.
boolean	vollfuehrtAktion() Gibt zurück, ob diese Action-Figur gerade eine Aktion ausführt.
void	zeichnen(java.awt.Graphics2D g, BoundingRechteck r) Zeichnet das Objekt.
void	zustandSetzen(java.lang.String name) Versetzt diese Actionfigur in einen bestimmten Zustand.

Methods inherited from class ea.Raum

afterRender, aktivMachen, aktuellerCollider, beeinflussbarSetzen, beforeRender, beinhaltet, bewegen, bewegen, boundsUebernehmen, colliderSetzen, compareTo, drehenAbsolut, drehenRelativ, einfluesseZuruecksetzen, erzeugeLazyCollider, fallReagierbarAnmelden, geschwindigkeitHinzunehmen, geschwindigkeitSetzen, getBreite, getForce, getHoehe, getMasse, getOpacity, getX, getY, gibDrehung, halbesAlpha, heavyComputingSetzen, hoehenUnterschied, impulsHinzunehmen, inFlaeche, istBeeinflussbar, konstanteKraftSetzen, kraftAnwenden, kritischeTiefeSetzen, leuchterAbmelden, leuchterAnmelden, loeschen, luftwiderstandskoeffizient, luftwiderstandskoeffizientSetzen, masseSetzen, mittelPunkt, mittelpunktSetzen, mittelpunktSetzen, neutralMachen, newtonschMachen, passivMachen, position, positionSetzen, positionSetzen, positionX, positionY, problem, schneidet, schwerkraftAktivSetzen, schwerkraftSetzen, setOpacity, setX, setY, setzeMeterProPixel, sichtbar, sichtbarSetzen, sprung, stehReagierbarAnmelden, steht, stehtAuf, verschieben, zeichnenBasic, zentrum, zIndex, zuFarbeKonvertieren

Methods inherited from class java.lang.Object

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

Constructor Detail

ActionFigur

public ActionFigur(Figur zustand,
                   java.lang.String name)

Konstruktor.

Parameters:

zustand - Der erste Zustand der Figur. Weitere Zustände können über die Methode neuerZustand(Figur, String) angemeldet werden.

name - Der Name des ersten Zustandes. Weitere Zustände können über die Methode neuerZustand(Figur, String) angemeldet werden.

Beim Namen wird die Groß- / Kleinschreibung ignoriert.

Method Detail

neuerZustand

@API
public void neuerZustand(Figur zustand,
                              java.lang.String name)

Meldet einen neuen Zustand für diese Figur an.

Parameters:

zustand - Die Figur, die diesen Zustand beschreibt.

name - Der Name, unter dem dieser Zustand aufgerufen wird.

Beim Namen wird die Groß- / Kleinschreibung ignoriert.

See Also:

neueAktion(Figur, String)

aktuelleFigur

public Figur aktuelleFigur()

Gibt die aktuelle Figur zurück.

Returns:

Die Figur, die gerade von dieser ActionFigur zu sehen ist.

neueAktion

@API
public void neueAktion(Figur action,
                            java.lang.String name)

Meldet eine neue Aktion für diese Figur an.

Parameters:

action - Die Figur, die diese Aktion beschreibt.

name - Der Name, unter dem diese Aktion aufgerufen wird.

Beim Namen wird die Groß- / Kleinschreibung ignoriert.

See Also:

neuerZustand(Figur, String)

zustandSetzen

@API
public void zustandSetzen(java.lang.String name)

Versetzt diese Actionfigur in einen bestimmten Zustand.

Vollführt die Figur jedoch gerade eine Aktion, so ist der neue Zustand erst danach sichtbar.

Parameters:

name - Der Name des Zustandes, in den die Figur versetzt werden soll. Dies ist der Name, der beim Anmelden des Zustandes mitgegeben wurde.

Beim Namen wird die Groß- / Kleinschreibung ignoriert.

See Also:

aktionSetzen(String)

aktionSetzen

@API
public void aktionSetzen(java.lang.String name)

Versetzt diese Actionfigur in eine bestimmte Aktion.

Parameters:

name - Der Name der Aktion, die die Figur ausführen soll. Dies ist der Name, der beim Anmelden der Aktion mitgegeben wurde.

Beim Namen wird die Groß- / Kleinschreibung ignoriert.

See Also:

zustandSetzen(String)

hatAktionSetzen

@NoExternalUse
public void hatAktionSetzen(boolean action)

Setzt, ob diese Figur zur Zeit eine Aktion hat.

Diese Methode sollte nicht von außen aktiviert werden. Hierfuer gibt es:
zustandSetzen(String) und aktionSetzen(String).

Parameters:

action - Ob diese Figur gerade eine Aktion ausführt.

aktuellesVerhalten

@API
public java.lang.String aktuellesVerhalten()

Gibt den aktuellen Zustand dieser Action-Figur als String aus.

Returns:

Der Name des aktuellen Zustandes. Ist die Figur zur Zeit in einem Zustand, so ist dies der Name des aktuellen Zustandes, vollführt die Figur zur Zeit eine Aktion, so ist dies der Name der aktuellen Aktion.

spiegelXSetzen

@API
public void spiegelXSetzen(boolean spiegel)

Spiegelt alle Figuren der Zustände und Aktionen dieser Figur an der X-Achse.

ACHTUNG!

Damit diese Methode nicht zu ungewollten Missverständnissen führt, sollte folgendes beachtet werden:
Sämtliche Figuren, die an dieser Action-Figur angemeldet sind, sollten dieselben Maße haben. Sie sollten also alle aus derselben Anzahl an "Unterquadraten" (gleiche Höhe und Breite) bestehen!

Ansonsten würde ein ungewolltes "Verschieben" der verschiedenen Action-Figur-Verhalten passieren.

Parameters:

spiegel - Ob alle angelegten Figuren (der Zustände und Aktionen) an der X-Achse gespiegelt werden sollen.

See Also:

Figur.spiegelXSetzen(boolean)

spiegelYSetzen

@API
public void spiegelYSetzen(boolean spiegel)

Spiegelt alle Figuren der Zustände und Aktionen dieser Figur an der Y-Achse.

ACHTUNG!

Damit diese Methode nicht zu ungewollten Missverständnissen führt, sollte folgendes beachtet werden:
Sämtliche einzelnen Figuren, die an dieser Action-Figur angemeldet sind, sollten dieselben Maße haben. Sie sollten also alle aus derselben Anzahl an "Unterquadraten" (gleiche Höhe und Breite) bestehen!

Ansonsten würde ein ungewolltes "Verschieben" der verschiedenen Action-Figur-Verhalten passieren.

Parameters:

spiegel - Ob alle angelegten Figuren (der Zustände und Aktionen) an der Y-Achse gespiegelt werden sollen.

See Also:

Figur.spiegelYSetzen(boolean)

einfaerben

@API
public void einfaerben(java.lang.String farbe)

Färbt alle Figuren dieser Action-Figur in eine Farbe ein.

Parameters:

farbe - Die Farbe, die alle Felder aller Figuren annehmen werden. Als Standardfarben-String.

See Also:

Figur.einfaerben(Farbe), einfaerben(Farbe)

einfaerben

@API
public void einfaerben(Farbe farbe)

Färbt alle Figuren dieser Action-Figur in eine Farbe ein.

Parameters:

farbe - Die Farbe, die alle Felder aller Figuren annehmen werden.

See Also:

Figur.einfaerben(Farbe), einfaerben(String)

faktorSetzen

@API
public void faktorSetzen(int faktor)

Setzt den Größenfaktor aller anliegender Einzelfiguren dieser Action-Figur neu. Sowohl die einzelnen Zustände als auch die einzelnen Aktionen.

Parameters:

faktor - Der neue Größenfaktor

See Also:

Figur.faktorSetzen(int)

vollfuehrtAktion

@API
public boolean vollfuehrtAktion()

Gibt zurück, ob diese Action-Figur gerade eine Aktion ausführt.

Eine Aktion ausführen ist ein sehr kurzlebiger Zustand, daher ist dies nie dauerhaft gegeben, es sei denn, der Befehl hierzu wird dauerhaft aufgerufen.

Returns:

true, wenn diese Action-Figur gerade eine Aktion ausführt, sonst false.

zeichnen

public void zeichnen(java.awt.Graphics2D g,
                     BoundingRechteck r)

Zeichnet das Objekt.

Specified by:

zeichnen in class Raum

Parameters:

g - Das zeichnende Graphics-Objekt

r - Das BoundingRechteck, das die Kameraperspektive repräsentiert.

Hierbei soll zunächst getestet werden, ob das Objekt innerhalb der Kamera liegt, und erst dann gezeichnet werden.

dimension

@API
public BoundingRechteck dimension()

Berechnet ein minimales BoundingRechteck, das das Objekt voll einschließt.

Specified by:

dimension in class Raum

Returns:

Ein BoundingRechteck mit dem minimal nötigen Umfang, um das Objekt voll einzuschließen.

See Also:

Raum.dimension()

verschieben

@API
public void verschieben(Vektor v)

Verschiebt die Actionfigur.

Overrides:

verschieben in class Raum

Parameters:

v - Die Verschiebung als Objekt der Klasse Vektor

See Also:

Vektor, Raum.verschieben(float, float), Raum.bewegen(Vektor), Raum.bewegen(float, float)

erzeugeCollider

public Collider erzeugeCollider()

Erzeugt einen neuen Collider für dieses Objekt. Diese Methode approximiert für das Objekt der jeweils implementierenden Raum-Klasse einen möglichst "guten" Collider; also einen solchen, der das tatsächliche Objekt möglichst genau umfängt, aber auch möglichst wenig Rechenarbeit beansprucht.

Specified by:

erzeugeCollider in class Raum

Returns:

Ein möglichst optimaler Collider für dieses Raum-Objekt.

See Also:

Raum.colliderSetzen(Collider)

flaechen

public BoundingRechteck[] flaechen()

Berechnet exakt die derzeitig von dieser Figur okkupierten Flächen auf der Zeichenebene.

Overrides:

flaechen in class Raum

Returns:

Ein Array aus allen Flächen, die von dieser Figur exakt ausgefüllt werden.

See Also:

Knoten