ea.internal.phy

Class Passivator

java.lang.Object

ea.internal.phy.PhysikClient

ea.internal.phy.Passivator

public class Passivator
extends PhysikClient

Ein Passivator ueberwacht und steuert ein passives Objekt in der Physik.

Author:

Michael Andonie

Field Summary

Fields inherited from class ea.internal.phy.PhysikClient

ziel

Constructor Summary

Constructors

Constructor and Description
Passivator(Raum ziel) Konstruktor.

Method Summary

Modifier and Type	Method and Description
void	aufloesen() Diese Methode wird immer dann aufgerufen, wenn ein Client nicht weiter benoetigt wird, und er alle seine Funktionen beenden soll, um die von ihm belegten Ressourcen freizugeben.
void	beeinflussbarSetzen(boolean beeinflussbar) Setzt, ob das Objekt ab sofort beeinflussbar sein soll.
boolean	bewegen(Vektor v) Realisiert das Bewegen
void	einfluesseZuruecksetzen() Setzt alle Einfluesse auf das Client-Objekt zurück.
void	fallReagierbarAnmelden(FallReagierbar f, int tiefe) In dieser Methode wird der FallReagierbar-Listener angemeldet. Aber hierin wird nur eine Fehlermeldung ausgegeben, da bei dieser Klasse ein passives Objekt vorliegt, das keine kritische Falltiefe haben kann.
void	geschwindigkeitHinzunehmen(Vektor geschwindigkeit) Addiert eine Geschwindigkeit v' zur aktuellen Geschwindigkeit v.
void	geschwindigkeitSetzen(Vektor geschwindigkeit) Setzt hart die Geschwindigkeit des Client-Objekts.
Vektor	getForce()
float	getLuftwiderstandskoeffizient()
float	getMasse()
void	impulsHinzunehmen(Vektor impuls) Berechnet einen neuen Impuls auf das Client-Objekt.
boolean	in(BoundingRechteck r) Prueft, ob ein BoundingRechteck sich mit dem Zielobjekt schneidet
boolean	istBeeinflussbar()
void	kraftAnwenden(Vektor kraft, float t_kraftuebertrag) Wendet eine Kraft für einen bestimmten Zeitraum auf das Client-Objekt an.
void	kraftSetzen(Vektor kraft) Setzt hart die konstante Kraft, die auf das Client-Objekt wirkt.
void	kritischeTiefeSetzen(int tiefe) Diese Methode setzt die kritische Tiefe eines Aktiv-Objektes.
void	luftwiderstandskoeffizientSetzen(float luftwiderstandskoeffizient) Setzt den Luftwiderstandskoeffizienten für das Client-Objekt.
void	masseSetzen(float masse) Setzt die Masse des Clien-Objekts neu.
void	schwerkraftAktivSetzen(boolean aktiv) Diese Methode soll setzen, ob Schwerkraft aktiv ist.
void	schwerkraftSetzen(int schwerkraft) Setzt die Schwerkraft fuer dieses Objekt. Da dies jedoch bei einem passiven Objekt nicht moeglich ist, gibt es eine Fehlermeldung.
boolean	sprung(int kraft) Die ueberschriebene Sprung-Methode.
void	stehReagierbarAnmelden(StehReagierbar s) In diese Methode wird ein StehReagierbar-Listener angemeldet. Aber in dieser Klasse wird nur eine Fehlermeldung ausgegeben, da das zu ueberwachende Objekt passiv und nicht aktiv ist.
boolean	steht() Soll testen, ob das Ziel-Objekt steht.
void	xVersch(int dX) Vollfuehrt die einzelen Schritte fuer die Y-Verschiebung.
void	yVersch(int dY) Vollfuehrt die einzelnen Schritte fuer die Y-Verschiebung.

Methods inherited from class ea.internal.phy.PhysikClient

ziel

Methods inherited from class java.lang.Object

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

Constructor Detail

Passivator

public Passivator(Raum ziel)

Konstruktor.

Parameters:

ziel - zu überwachendes Raum-Objekt

Method Detail

bewegen

public boolean bewegen(Vektor v)

Realisiert das Bewegen

Specified by:

bewegen in class PhysikClient

Parameters:

v - Die Bewegung als Vektor.

Returns:

true, da die Bewegung eines Passiv-Objektes immer in vollem Masse moeglich ist.

aufloesen

public void aufloesen()

Diese Methode wird immer dann aufgerufen, wenn ein Client nicht weiter benoetigt wird, und er alle seine Funktionen beenden soll, um die von ihm belegten Ressourcen freizugeben.

Specified by:

aufloesen in class PhysikClient

sprung

public boolean sprung(int kraft)

Die ueberschriebene Sprung-Methode. Da sie nicht benoetigt wird, wird hierbei eine Fehlermeldung ausgegeben. Denn es wurde ein oassives Objekt zum Sprung gebracht.

Specified by:

sprung in class PhysikClient

Parameters:

kraft - Die (theoretische) Sprungkraft.

Returns:

true, wenn erfolgreich gesprungen wurde. In allen anderen Faellen false.

schwerkraftAktivSetzen

public void schwerkraftAktivSetzen(boolean aktiv)

Diese Methode soll setzen, ob Schwerkraft aktiv ist. Dies macht jedoch bei einem Passiv-Objekt keinen Sinn.
Daher wird nur eine Fehlermeldung ausgegeben.

Specified by:

schwerkraftAktivSetzen in class PhysikClient

Parameters:

aktiv - Ob die Schwerkraft aktiv sein soll. Ist jedoch hier absolut irrelevant.

kritischeTiefeSetzen

public void kritischeTiefeSetzen(int tiefe)

Diese Methode setzt die kritische Tiefe eines Aktiv-Objektes. Aber hierin wird nur eine Fehlermeldung ausgegeben, da bei dieser Klasse ein passives Objekt vorliegt, das keine kritische Falltiefe haben kann

Specified by:

kritischeTiefeSetzen in class PhysikClient

Parameters:

tiefe - Die Tiefe, ab der das anliegende FallReagierbar-Interface informiert werden soll.

See Also:

fallReagierbarAnmelden(FallReagierbar, int)

fallReagierbarAnmelden

public void fallReagierbarAnmelden(FallReagierbar f,
                                   int tiefe)

In dieser Methode wird der FallReagierbar-Listener angemeldet.
Aber hierin wird nur eine Fehlermeldung ausgegeben, da bei dieser Klasse ein passives Objekt vorliegt, das keine kritische Falltiefe haben kann.

Specified by:

fallReagierbarAnmelden in class PhysikClient

Parameters:

f - Das FallReagierbar-Objekt, das ab sofort im Grenzfall informiert wird.

tiefe - Die kritische Tiefe, ab der das Interface informiert wird.

See Also:

kritischeTiefeSetzen(int)

stehReagierbarAnmelden

public void stehReagierbarAnmelden(StehReagierbar s)

In diese Methode wird ein StehReagierbar-Listener angemeldet.
Aber in dieser Klasse wird nur eine Fehlermeldung ausgegeben, da das zu ueberwachende Objekt passiv und nicht aktiv ist.

Specified by:

stehReagierbarAnmelden in class PhysikClient

Parameters:

s - Der theoretisch anzumeldende Listener.

steht

public boolean steht()

Soll testen, ob das Ziel-Objekt steht.
Gibt jedoch eine Fehlermeldung aus, da das Ziel-Objekt kein Aktiv-Objekt ist und damit nicht Stehen/Fallen kann.

Specified by:

steht in class PhysikClient

Returns:

Immer false, da die Eigenschaft stehen in diesem Fall nicht konsistent definierbar ist.

schwerkraftSetzen

public void schwerkraftSetzen(int schwerkraft)

Setzt die Schwerkraft fuer dieses Objekt.
Da dies jedoch bei einem passiven Objekt nicht moeglich ist, gibt es eine Fehlermeldung.

Specified by:

schwerkraftSetzen in class PhysikClient

Parameters:

schwerkraft - Der Wert fuer die Schwerkraft der Physik.
Wichtig: Dies repraesentiert keinen Wert fuer die (Erd-) Beschleunigungszahl "g" aus der Physik. Schon allein deshalb, weil die Zahl umgekehrt wirkt (s. oben).

See Also:

Raum.aktivMachen()

impulsHinzunehmen

public void impulsHinzunehmen(Vektor impuls)

Berechnet einen neuen Impuls auf das Client-Objekt.

Specified by:

impulsHinzunehmen in class PhysikClient

Parameters:

impuls - der neue Impuls, der auf das Objekt wirken soll. (in [kg* (m / s)])

geschwindigkeitHinzunehmen

public void geschwindigkeitHinzunehmen(Vektor geschwindigkeit)

Addiert eine Geschwindigkeit v' zur aktuellen Geschwindigkeit v. Die neue Geschwindigkeit des Client-Objekts ist damit:
v_neu = v + v'

Specified by:

geschwindigkeitHinzunehmen in class PhysikClient

Parameters:

geschwindigkeit - Die neue Geschwindigkeit v', die zur aktuellen Geschwindigkeit v hinzuaddiert werden soll.(in [m / s])

getLuftwiderstandskoeffizient

public float getLuftwiderstandskoeffizient()

Specified by:

getLuftwiderstandskoeffizient in class PhysikClient

Returns:

Der Luftwiderstandskoeffizient

istBeeinflussbar

public boolean istBeeinflussbar()

Specified by:

istBeeinflussbar in class PhysikClient

Returns:

ob das Objekt beeinflussbar ist.

getMasse

public float getMasse()

Specified by:

getMasse in class PhysikClient

Returns:

Die Masse des Objekts.

getForce

public Vektor getForce()

Specified by:

getForce in class PhysikClient

Returns:

Die aktuelle Kraft, die auf das Objekt wirkt.

luftwiderstandskoeffizientSetzen

public void luftwiderstandskoeffizientSetzen(float luftwiderstandskoeffizient)

Setzt den Luftwiderstandskoeffizienten für das Client-Objekt. Dieser bestimmt, wie intensiv der Luftwiderstand das Objekt beeinträchtigt. Je höher dieser Wert ist, desto stärker ist der Luftwiderstand. Ist er 0, gibt es keinen Luftwiderstand.

Specified by:

luftwiderstandskoeffizientSetzen in class PhysikClient

Parameters:

luftwiderstandskoeffizient - Der Luftwiderstandskoeffizient. Darf nicht kleiner als 0 sein!

beeinflussbarSetzen

public void beeinflussbarSetzen(boolean beeinflussbar)

Setzt, ob das Objekt ab sofort beeinflussbar sein soll.
Das bedeutet:

• Beeinflussbare Objekte lassen sich verschieben.
• Unbeeinflussbare Objekte werden von Impulsen nicht beeindruckt und geben ihn so wie er ist zurück.
• Unbeeinflussbare Objekte sind, Wände, Decken, Ebenen, beeinflussbare sind meist Spielfiguren.
• Auch unbeeinflussbare Objekte sind bewegbar und man kann Kräfte/Impulse auf sie Auswirken.
• Kollidiert ein beeinflussbares Objekt mit einem nicht beeinflussbaren Objekt, so blockiert das unbeeinflussbare Objekt das beeinflussbare Objekt. Letzteres prallt evtl. leicht ab.
• Kollidieren 2 beeinflussbare Objekte, so prallen sie voneinander ab.
• Kollidieren 2 unbeeinflussbare Objekte, so passiert gar nichts. Ggf. durchschneiden sie sich gegenseitig.

Specified by:

beeinflussbarSetzen in class PhysikClient

Parameters:

beeinflussbar - ist dieser Wert true, ist das Objekt ab sofort beeinflussbar. Sonst ist es nicht beeinflussbar.

masseSetzen

public void masseSetzen(float masse)

Setzt die Masse des Clien-Objekts neu. Das kann auch mitten im Spiel geändert werden. Die Masse bestimmt zum Beispiel, wie sich das Objekt bei Kollisionen oder einem neuen Impuls verhält.

Specified by:

masseSetzen in class PhysikClient

Parameters:

masse - die neue Masse des Client-Objekts.(in [kg])

kraftSetzen

public void kraftSetzen(Vektor kraft)

Setzt hart die konstante Kraft, die auf das Client-Objekt wirkt. Das bedeutet, dass die vorher gegoltene Kraft gelöscht wird ohne Rücksicht auf mögliche Implikationen/Probleme.

Specified by:

kraftSetzen in class PhysikClient

Parameters:

kraft - Die neue Kraft, die auf das Client-Objekt wirken soll.(in [m / s^2] = [N])

geschwindigkeitSetzen

public void geschwindigkeitSetzen(Vektor geschwindigkeit)

Setzt hart die Geschwindigkeit des Client-Objekts. Das bedeutet, dass die vorher gegoltene Geschwindikeit gelöscht wird ohne Rücksicht auf mögliche Implikationen/Probleme.

Specified by:

geschwindigkeitSetzen in class PhysikClient

Parameters:

geschwindigkeit - Die neue Geschwindigkeit für das Client-Objekt. (in [m / s])

einfluesseZuruecksetzen

public void einfluesseZuruecksetzen()

Setzt alle Einfluesse auf das Client-Objekt zurück. Dies sind:

• Die Kraft F, die gerade auf das Objekt wirkt.
• Die Geschwindigkeit v, die das Objekt gerade hat.

Specified by:

einfluesseZuruecksetzen in class PhysikClient

kraftAnwenden

public void kraftAnwenden(Vektor kraft,
                          float t_kraftuebertrag)

Wendet eine Kraft für einen bestimmten Zeitraum auf das Client-Objekt an. Hierdurch entsteht ein neuer Impuls auf das Objekt, der dessen Geschwindigkeit (und Richtung) ändern kann.
Wichtig: Dies ist eine Heuristik: Die Dauer sein genügend klein und die Kraft konstant, solange sie wirkt. Die rein physikalische Rechnung wäre wesentlich rechenintensiver.

Specified by:

kraftAnwenden in class PhysikClient

Parameters:

kraft - Die Kraft, die auf das Objekt anliegen soll. (in [kg* (m / s^2)] = [N])

t_kraftuebertrag - Die Dauer, für die die Kraft auf das Objekt wirkt. (in [s)])

xVersch

public void xVersch(int dX)

Vollfuehrt die einzelen Schritte fuer die Y-Verschiebung.

Parameters:

dX - Die X-Aenderung

yVersch

public void yVersch(int dY)

Vollfuehrt die einzelnen Schritte fuer die Y-Verschiebung.

Parameters:

dY - Die Y-Aenderung

in

public boolean in(BoundingRechteck r)

Prueft, ob ein BoundingRechteck sich mit dem Zielobjekt schneidet

Parameters:

r - Das Pruef-Rechteck

Returns:

true, wenn sich das Ziel mit dem Argument schneidet, sonst false.