Gravitator (Engine Alpha)

java.lang.Object
- ea.internal.phy.PhysikClient
- - ea.internal.phy.Gravitator

```
public class Gravitator
extends PhysikClient
```
Ein Gravitator sorgt fuer das Verhalten eines Aktiv-Raum-Objektes in der Physik.

Author:

Michael Andonie

Field Summary
- Fields inherited from class ea.internal.phy.PhysikClient
  ziel

Constructor Summary

Constructors
Constructor and Description

Gravitator(Raum ziel)
Konstruktor.

Constructors
Constructor and Description
`Gravitator(Raum ziel)` Konstruktor.

Method Summary

All Methods Instance Methods Concrete Methods
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)` Bewegt das Raum-Objekt mithilfe des Gravitators.
`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. Dieser wird ab sofort immer wieder informiert, solange das Ziel-`Raum`-Objekt unterhalb der Toleranzgrenze liegt.
`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`	`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)` Setzt, ob das Ziel-Objekt von der Schwerkraft beeinflusst wird und somit fallen, aber auch springen kann.
`void`	`schwerkraftSetzen(int schwerkraft)` Setzt die Schwerkraft fuer dieses Objekt. Achtung: Standardwert: 4 Groesserer Wert = langsamer Fallen Kleinerer Wert = schneller Fallen Negativer Wert : Moege Gott uns allen gnaedig sein...
`boolean`	`sprung(int kraft)` Laesst das anliegende Raum-Objekt springen.
`void`	`stehReagierbarAnmelden(StehReagierbar s)` In dieser Methode wird der `StehReagierbar`-Listener angemeldet. Dieser wird ab sofort immer dann einmalig informiert, wenn das Ziel-`Raum`-Objekt nach einem Sprung/Fall wieder auf einem Passiv-Objekt steht.
`boolean`	`steht()` Testet, ob das hieran anliegende Ziel-Objekt steht.
`void`	`tick(int runde)` Methode zur Weitergabe eines Rechenschrittes
`boolean`	`xVersch(float dX)` Vollfuehrt portionsweises (in Pixelschritten) Verschieben auf der X-Richtung.
`boolean`	`yVersch(float dY)` Vollfuehrt portionsweises (in Pixelschritten) Verschieben auf der Y-Richtung unter beruecksichtung von SChwerkrafteigenschaften.

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
  - Gravitator
```
public Gravitator(Raum ziel)
```
    Konstruktor.
    
    Parameters:
    
    ziel - Ziel des Gravitators: Dieses Objekt wird von ihm überwacht
- Method Detail
  - tick
```
public void tick(int runde)
```
    Methode zur Weitergabe eines Rechenschrittes
    
    Parameters:
    
    runde - Die Runde (1 - 10)
  - bewegen
```
public boolean bewegen(Vektor v)
```
    Bewegt das Raum-Objekt mithilfe des Gravitators.
    
    Specified by:
    
    bewegen in class PhysikClient
    
    Parameters:
    
    v - Die Bewegung beschrieben durch einen Vektor.
    
    Returns:
    
    true, sollte die Bewegung vollfuehrt worden sein, ohne, dass man passiv geblockt wurde. Wurde man in der vollen Ausfuehrung der Bewegung gehindert, ist die Rueckgabe false.
  - 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)
```
    Laesst das anliegende Raum-Objekt springen. Dies ist nur dann möglich, wenn das anliegende Raum-Objekt "steht". Also, wenn es auf einemm Passiv-Objekt steht.
    
    Specified by:
    
    sprung in class PhysikClient
    
    Parameters:
    
    kraft - Die Sprungkraft.
    
    Returns:
    
    true, wenn erfolgreich gesprungen wurde. In allen anderen Faellen false.
  - schwerkraftAktivSetzen
```
public void schwerkraftAktivSetzen(boolean aktiv)
```
    Setzt, ob das Ziel-Objekt von der Schwerkraft beeinflusst wird und somit fallen, aber auch springen kann.
    
    Specified by:
    
    schwerkraftAktivSetzen in class PhysikClient
    
    Parameters:
    
    aktiv - Ist dieser Wert true, so wird das Ziel-Objekt von Schwerkraft beeinflusst. Ist er false, dann nicht.
  - kritischeTiefeSetzen
```
public void kritischeTiefeSetzen(int tiefe)
```
    Diese Methode setzt die kritische Tiefe eines Aktiv-Objektes. Ab dieser wird das entsprechende FallReagierbar-Inteface, das angemeldet wurde, ueber den Fall informiert.
    
    Specified by:
    
    kritischeTiefeSetzen in class PhysikClient
    
    Parameters:
    
    tiefe - Die Tiefe, ab der das anliegende FallReagierbar-Interface informiert werden soll. Als Y-Koordinate.
    
    See Also:
    
    fallReagierbarAnmelden(FallReagierbar, int)
  - fallReagierbarAnmelden
```
public void fallReagierbarAnmelden(FallReagierbar f,
                                   int tiefe)
```
    In dieser Methode wird der FallReagierbar-Listener angemeldet.
    Dieser wird ab sofort immer wieder informiert, solange das Ziel-Raum-Objekt unterhalb der Toleranzgrenze liegt.
    
    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 tiefe)
  - stehReagierbarAnmelden
```
public void stehReagierbarAnmelden(StehReagierbar s)
```
    In dieser Methode wird der StehReagierbar-Listener angemeldet.
    Dieser wird ab sofort immer dann einmalig informiert, wenn das Ziel-Raum-Objekt nach einem Sprung/Fall wieder auf einem Passiv-Objekt steht.
    
    Specified by:
    
    stehReagierbarAnmelden in class PhysikClient
    
    Parameters:
    
    s - Das StehReagierbar-Objekt, das ab sofort immer einmalig informiert wird, wenn das Ziel-Objekt zum Stehen kommt.
  - steht
```
public boolean steht()
```
    Testet, ob das hieran anliegende Ziel-Objekt steht.
    
    Specified by:
    
    steht in class PhysikClient
    
    Returns:
    
    true, wenn das Ziel-Objekt auf einem Passiv-Objekt steht und somit nicht faellt oder steigt, sonst false.
    Bewegung nach Rechts/Links wird hier nicht beruecksichtigt.
  - schwerkraftSetzen
```
public void schwerkraftSetzen(int schwerkraft)
```
    Setzt die Schwerkraft fuer dieses Objekt.
    Achtung: Standardwert: 4
    Groesserer Wert = langsamer Fallen
    Kleinerer Wert = schneller Fallen
    Negativer Wert : Moege Gott uns allen gnaedig sein...
    
    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 boolean xVersch(float dX)
```
    Vollfuehrt portionsweises (in Pixelschritten) Verschieben auf der X-Richtung.
    
    Parameters:
    
    dX - Die x-Änderung (Delta-X)
    
    Returns:
    
    true, wenn die Bewegung in X-Richtung ohne Passiv-Block moeglich war, sonst false.
  - yVersch
```
public boolean yVersch(float dY)
```
    Vollfuehrt portionsweises (in Pixelschritten) Verschieben auf der Y-Richtung unter beruecksichtung von SChwerkrafteigenschaften.
    
    Parameters:
    
    dY - Die y-Änderung (Delta-Y)
    
    Returns:
    
    true, wenn die Bewegung in Y-Richtung ohne Passiv-Block moeglich war, sonst false.

Class Gravitator

Field Summary

Fields inherited from class ea.internal.phy.PhysikClient

Constructor Summary

Method Summary

Methods inherited from class ea.internal.phy.PhysikClient

Methods inherited from class java.lang.Object

Constructor Detail

Gravitator

Method Detail

tick

bewegen

aufloesen

sprung

schwerkraftAktivSetzen

kritischeTiefeSetzen

fallReagierbarAnmelden

stehReagierbarAnmelden

steht

schwerkraftSetzen

impulsHinzunehmen

geschwindigkeitHinzunehmen

getLuftwiderstandskoeffizient

istBeeinflussbar

getMasse

getForce

luftwiderstandskoeffizientSetzen

beeinflussbarSetzen

masseSetzen

kraftSetzen

geschwindigkeitSetzen

einfluesseZuruecksetzen

kraftAnwenden

xVersch

yVersch