PhysikClient (Engine Alpha)

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

Direct Known Subclasses:

Gravitator, MechanikClient, NullClient, Passivator
```
public abstract class PhysikClient
extends java.lang.Object
```
Ein Physik-Client ueberwacht ganz generell ein Raum-Objekt in der Physik.
Es ist die Ausgangsklasse fuer Gravitatoren und Passivatoren - aber auch fuer die NullClient-Klasse. Diese ist die Standart-Physikklasse fuer nicht an der Physik beteiligte, neutrale Objekte.

Author:

Michael Andonie

Field Summary

Fields
Modifier and Type Field and Description

protected Raum ziel
Das Raum-Objekt, das ueberwacht wird

Fields
Modifier and Type	Field and Description
`protected Raum`	`ziel` Das Raum-Objekt, das ueberwacht wird

Constructor Summary

Constructors
Modifier Constructor and Description

protected PhysikClient(Raum ziel)
Konstruktor.

Constructors
Modifier	Constructor and Description
`protected`	`PhysikClient(Raum ziel)` Konstruktor.

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`abstract 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.
`abstract void`	`beeinflussbarSetzen(boolean beeinflussbar)` Setzt, ob das Objekt ab sofort beeinflussbar sein soll.
`abstract boolean`	`bewegen(Vektor v)` Bewegt das ziel-Objekt innerhalb der kuenstlichen Physik.
`abstract void`	`einfluesseZuruecksetzen()` Setzt alle Einfluesse auf das Client-Objekt zurück.
`abstract 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.
`abstract void`	`geschwindigkeitHinzunehmen(Vektor geschwindigkeit)` Addiert eine Geschwindigkeit v' zur aktuellen Geschwindigkeit v.
`abstract void`	`geschwindigkeitSetzen(Vektor geschwindigkeit)` Setzt hart die Geschwindigkeit des Client-Objekts.
`abstract Vektor`	`getForce()`
`abstract float`	`getLuftwiderstandskoeffizient()`
`abstract float`	`getMasse()`
`abstract void`	`impulsHinzunehmen(Vektor impuls)` Berechnet einen neuen Impuls auf das Client-Objekt.
`abstract boolean`	`istBeeinflussbar()`
`abstract void`	`kraftAnwenden(Vektor kraft, float t_kraftuebertrag)` Wendet eine Kraft für einen bestimmten Zeitraum auf das Client-Objekt an.
`abstract void`	`kraftSetzen(Vektor kraft)` Setzt hart die konstante Kraft, die auf das Client-Objekt wirkt.
`abstract void`	`kritischeTiefeSetzen(int tiefe)` Diese Methode setzt die kritische Tiefe eines Aktiv-Objektes.
`abstract void`	`luftwiderstandskoeffizientSetzen(float luftwiderstandskoeffizient)` Setzt den Luftwiderstandskoeffizienten für das Client-Objekt.
`abstract void`	`masseSetzen(float masse)` Setzt die Masse des Clien-Objekts neu.
`abstract void`	`schwerkraftAktivSetzen(boolean aktiv)` Setzt, ob das Ziel-Objekt von Schwerkraft beeinflusst wird. Der Aufruf dieser Methode ist nur bei Gravitatoren sinnvoll.
`abstract 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...
`abstract boolean`	`sprung(int kraft)` Laesst das anliegende Objekt einen Sprung vollfuehren, wenn es ein Aktiv-Objekt ist.
`abstract 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.
`abstract boolean`	`steht()` Gibt an, ob das Ziel-`Raum`-Objekt auf einem Passiv-Objekt steht oder nicht.
`Raum`	`ziel()` Gibt das Ziel-Objekt aus.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - ziel
```
protected final Raum ziel
```
    Das Raum-Objekt, das ueberwacht wird
- Constructor Detail
  - PhysikClient
```
protected PhysikClient(Raum ziel)
```
    Konstruktor.
    
    Parameters:
    
    ziel - Das zu ueberwachende Ziel
- Method Detail
  - bewegen
```
public abstract boolean bewegen(Vektor v)
```
    Bewegt das ziel-Objekt innerhalb der kuenstlichen Physik.
    
    Parameters:
    
    v - Der die Bewegung beschreibende Vektor.
    
    Returns:
    
    true, wenn die Bewegung in vollem Masse moeglich war, sonst false.
  - aufloesen
```
public abstract 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.
  - sprung
```
public abstract boolean sprung(int kraft)
```
    Laesst das anliegende Objekt einen Sprung vollfuehren, wenn es ein Aktiv-Objekt ist. Sonst ist dieser Methodenaufruf wirkungslos.
    
    Parameters:
    
    kraft - Die Sprungkraft.
    
    Returns:
    
    true, wenn erfolgreich gesprungen wurde. In allen anderen Faellen false.
  - schwerkraftAktivSetzen
```
public abstract void schwerkraftAktivSetzen(boolean aktiv)
```
    Setzt, ob das Ziel-Objekt von Schwerkraft beeinflusst wird.
    Der Aufruf dieser Methode ist nur bei Gravitatoren sinnvoll. Bei allen anderen PhysikClient-Klassen wird hierbei eine Fehlermeldung ausgegeben.
    
    Parameters:
    
    aktiv - Ist dieser Wert true, so wird dieses Objekt von Schwerkraft beeinflusst. Ist er false, dann nicht.
  - kritischeTiefeSetzen
```
public abstract 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.
    
    Parameters:
    
    tiefe - Die Tiefe, ab der das anliegende FallReagierbar-Interface informiert werden soll.
    
    See Also:
    
    fallReagierbarAnmelden(FallReagierbar, int)
  - fallReagierbarAnmelden
```
public abstract 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.
    
    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 abstract 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.
    
    Parameters:
    
    s - Das StehReagierbar-Objekt, das ab sofort immer einmalig informiert wird, wenn das Ziel-Objekt zum Stehen kommt.
  - steht
```
public abstract boolean steht()
```
    Gibt an, ob das Ziel-Raum-Objekt auf einem Passiv-Objekt steht oder nicht.
    
    Returns:
    
    true, wenn das Ziel-Raum-Objekt auf einem Passiv-Objekt steht, sonst false.
  - ziel
```
public Raum ziel()
```
    Gibt das Ziel-Objekt aus.
    
    Returns:
    
    Das Ziel dieses Physik-Clients.
  - schwerkraftSetzen
```
public abstract 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...
    
    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 abstract void impulsHinzunehmen(Vektor impuls)
```
    Berechnet einen neuen Impuls auf das Client-Objekt.
    
    Parameters:
    
    impuls - der neue Impuls, der auf das Objekt wirken soll. (in [kg* (m / s)])
  - geschwindigkeitHinzunehmen
```
public abstract void geschwindigkeitHinzunehmen(Vektor geschwindigkeit)
```
    Addiert eine Geschwindigkeit v' zur aktuellen Geschwindigkeit v. Die neue Geschwindigkeit des Client-Objekts ist damit:
    v_neu = v + v'
    
    Parameters:
    
    geschwindigkeit - Die neue Geschwindigkeit v', die zur aktuellen Geschwindigkeit v hinzuaddiert werden soll.(in [m / s])
  - getLuftwiderstandskoeffizient
```
public abstract float getLuftwiderstandskoeffizient()
```
    Returns:
    
    Der Luftwiderstandskoeffizient
  - istBeeinflussbar
```
public abstract boolean istBeeinflussbar()
```
    Returns:
    
    ob das Objekt beeinflussbar ist.
  - getMasse
```
public abstract float getMasse()
```
    Returns:
    
    Die Masse des Objekts.
  - getForce
```
public abstract Vektor getForce()
```
    Returns:
    
    Die aktuelle Kraft, die auf das Objekt wirkt.
  - luftwiderstandskoeffizientSetzen
```
public abstract 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.
    
    Parameters:
    
    luftwiderstandskoeffizient - Der Luftwiderstandskoeffizient. Darf nicht kleiner als 0 sein!
  - beeinflussbarSetzen
```
public abstract 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.
    Parameters:
    
    beeinflussbar - ist dieser Wert true, ist das Objekt ab sofort beeinflussbar. Sonst ist es nicht beeinflussbar.
  - masseSetzen
```
public abstract 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.
    
    Parameters:
    
    masse - die neue Masse des Client-Objekts.(in [kg])
  - kraftSetzen
```
public abstract 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.
    
    Parameters:
    
    kraft - Die neue Kraft, die auf das Client-Objekt wirken soll.(in [m / s^2] = [N])
  - geschwindigkeitSetzen
```
public abstract 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.
    
    Parameters:
    
    geschwindigkeit - Die neue Geschwindigkeit für das Client-Objekt. (in [m / s])
  - einfluesseZuruecksetzen
```
public abstract 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.
  - kraftAnwenden
```
public abstract 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.
    
    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)])

Class PhysikClient

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

ziel

Constructor Detail

PhysikClient

Method Detail

bewegen

aufloesen

sprung

schwerkraftAktivSetzen

kritischeTiefeSetzen

fallReagierbarAnmelden

stehReagierbarAnmelden

steht

ziel

schwerkraftSetzen

impulsHinzunehmen

geschwindigkeitHinzunehmen

getLuftwiderstandskoeffizient

istBeeinflussbar

getMasse

getForce

luftwiderstandskoeffizientSetzen

beeinflussbarSetzen

masseSetzen

kraftSetzen

geschwindigkeitSetzen

einfluesseZuruecksetzen

kraftAnwenden