MechanikClient (Engine Alpha)

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

All Implemented Interfaces:

Ticker, java.io.Serializable
```
public class MechanikClient
extends PhysikClient
implements Ticker
```
Ein Physik-Client, der eine rudimentäre Implementierung Newton'scher Mechanik implementieren soll. Physik-Objekte, die von einem solchen Client betreut werden, zeichnen sich durch folgende Eigenschaften aus:
- Sie haben eine aktuelle Geschwindigkeit.
- Es wirkt eine Kraft (ggf. stellvertretend als Summe mehrerer Kräfte) auf sie.
- Sie haben eine Masse.
- Die Kraft wirkt eine Beschleunigung - also eine Änderung der Geschwindigkeit auf sie aus. Die Beschleunigung hängt ausserdem von der Masse des Objekts ab.
- Es wirkt konstant Reibung. In diesem Modell bedeutet dies eine dynamische Verminderung der aktuellen Geschwindigkeit. Die Verminderung ist stärker, je höher die Geschwindigkeit ist. Ihre generelle Intensität lässt sich jedoch ändern.
- Neue Kräfte können atomar (also "von jetzt auf gleich", nicht über einen Zeitraum (z.B. 100 ms)) auf Objekte angewendet werden. Das ist Vergleichbar mit einem schnellen Stoß in eine bestimmte Richtung. Dies lässt sich durch einen Impuls realisieren, aber auch über direkte Eingabe einer Geschwindigkeitsänderung.
- Es können Kräfte dauerhaft auf ein Objekt wirken, wie zum Beispiel die Schwerkraft.
- Mehrere Objekte können kollidieren. Dann prallen sie elastisch voneinander ab. Dies funktioniert intern über Impulsrechnung.
Author:

Michael Andonie

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type Field and Description

static Manager MECH_TIMER
Der Timer, der sich aller Mechanik-Clients annimmt.
- Fields inherited from class ea.internal.phy.PhysikClient
  ziel

Fields
Modifier and Type	Field and Description
`static Manager`	`MECH_TIMER` Der Timer, der sich aller Mechanik-Clients annimmt.

Constructor Summary

Constructors
Constructor and Description

MechanikClient(Raum ziel)
Konstruktor erstellt einen neuen Mechanik-Client.

Constructors
Constructor and Description
`MechanikClient(Raum ziel)` Konstruktor erstellt einen neuen Mechanik-Client.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated 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 ziel-Objekt innerhalb der kuenstlichen Physik.
`KreisCollider`	`collider()` Gibt den Collider zurück.
`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.
`float`	`getElastizitaet()`
`Vektor`	`getForce()`
`float`	`getLuftwiderstandskoeffizient()`
`float`	`getMasse()`
`Vektor`	`getVelocity()`
`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)` Deprecated.
`void`	`schwerkraftSetzen(int schwerkraft)` Deprecated.
`void`	`setElastizitaet(float elastizitaet)` Setzt die Elastizität für dieses Objekt neu.
`static void`	`setzeMeterProPixel(float meterpropixel)` Setzt, wie viele Meter auf einen Pixel im Spielfenster gehen.
`boolean`	`sprung(int kraft)` Deprecated.
`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()` Gibt an, ob das Ziel-`Raum`-Objekt auf einem Passiv-Objekt steht oder nicht.
`void`	`tick()` In der `tick()`-Methode des Mechanik-Clients wird die diskrete Weiterrechnung der verschiedenen Parameter realisiert sowie die Anwendung der Geschwindigkeit auf die aktuelle Position des Client-Objekts.
`static void`	`tresholdSetzen(float threshold)` Setzt einen neuen Threshold d.

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

- Field Detail
  - MECH_TIMER
```
public static Manager MECH_TIMER
```
    Der Timer, der sich aller Mechanik-Clients annimmt.
- Constructor Detail
  - MechanikClient
```
public MechanikClient(Raum ziel)
```
    Konstruktor erstellt einen neuen Mechanik-Client.
    
    Parameters:
    
    ziel - das Ziel-Objekt für diesen Client.
- Method Detail
  - tresholdSetzen
```
public static void tresholdSetzen(float threshold)
```
    Setzt einen neuen Threshold d. Ein Objekt, dass sich mit |v| < d bewegt, wird angehalten (die Engine sorgt also manuell für v' = 0)
    
    Parameters:
    
    threshold - Der Threshold d (in px), ab dem die Engine Geschwindigkeitsvektoren auf 0 setzt.
  - setzeMeterProPixel
```
public static void setzeMeterProPixel(float meterpropixel)
```
    Setzt, wie viele Meter auf einen Pixel im Spielfenster gehen.
    Parameters:
    meterpropixel - Die Anzahl an Metern, die auf einen Pixel fallen.
    Beispiele:
    
    10(.0f) => Auf einen Pixel fallen 10 Meter. => Ein Meter = 0,1 Pixel
    
    0.1f => Auf einen Pixel fallen 0,1 Meter. => Ein Meter = 10 Pixel
  - getVelocity
```
public Vektor getVelocity()
```
    Returns:
    
    the velocity
  - tick
```
public void tick()
```
    In der tick()-Methode des Mechanik-Clients wird die diskrete Weiterrechnung der verschiedenen Parameter realisiert sowie die Anwendung der Geschwindigkeit auf die aktuelle Position des Client-Objekts. Dies ist vergleichbar mit der Methode der kleinen Schritte aus der Physik.
    
    Specified by:
    
    tick in interface Ticker
  - bewegen
```
public boolean bewegen(Vektor v)
```
    Bewegt das ziel-Objekt innerhalb der kuenstlichen Physik.
    
    Specified by:
    
    bewegen in class PhysikClient
    
    Parameters:
    
    v - Der die Bewegung beschreibende Vektor.
    
    Returns:
    
    true, wenn die Bewegung in vollem Masse moeglich war, sonst 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
```
@Deprecated
public boolean sprung(int kraft)
```
    Deprecated.
    
    Laesst das anliegende Objekt einen Sprung vollfuehren, wenn es ein Aktiv-Objekt ist. Sonst ist dieser Methodenaufruf wirkungslos. Löst einen Impulssprung aus. Nur aus Kompatibilitätsgründen vorhanden.
    
    Specified by:
    
    sprung in class PhysikClient
    
    Parameters:
    
    kraft - Die Sprungkraft.
    
    Returns:
    
    always true.
  - schwerkraftAktivSetzen
```
@Deprecated
public void schwerkraftAktivSetzen(boolean aktiv)
```
    Deprecated.
    
    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. Aktiviert / Deaktiviert eine Standardschwerkraft. Nur aus Kompatibilitätsgründen vorhanden.
    
    Specified by:
    
    schwerkraftAktivSetzen in class PhysikClient
    
    Parameters:
    
    aktiv - Ist dieser Wert true, so wird dieses 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.
    
    See Also:
    
    PhysikClient.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:
    
    PhysikClient.kritischeTiefeSetzen(int)
  - 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()
```
    Gibt an, ob das Ziel-Raum-Objekt auf einem Passiv-Objekt steht oder nicht.
    
    Specified by:
    
    steht in class PhysikClient
    
    Returns:
    
    true, wenn das Ziel-Raum-Objekt auf einem Passiv-Objekt steht, sonst false.
  - schwerkraftSetzen
```
@Deprecated
public void schwerkraftSetzen(int schwerkraft)
```
    Deprecated.
    
    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.
  - getElastizitaet
```
public float getElastizitaet()
```
    Returns:
    
    Die Elastizitaet des Objekts.
  - setElastizitaet
```
public void setElastizitaet(float elastizitaet)
```
    Setzt die Elastizität für dieses Objekt neu. Hat nur einen Effekt, wenn dieses Objekt nicht beeinflussbar ist.
    
    Parameters:
    
    elastizitaet - Die Elastizität dieses Objekts in %. 1 = Voller Energieerhalt --- 0 = Voller Energieverlust
  - 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)])
  - collider
```
public KreisCollider collider()
```
    Gibt den Collider zurück.
    
    Returns:
    
    Der Collider des Elements.

Class MechanikClient

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

Field Detail

MECH_TIMER

Constructor Detail

MechanikClient

Method Detail

tresholdSetzen

setzeMeterProPixel

getVelocity

tick

bewegen

aufloesen

sprung

schwerkraftAktivSetzen

kritischeTiefeSetzen

fallReagierbarAnmelden

stehReagierbarAnmelden

steht

schwerkraftSetzen

impulsHinzunehmen

geschwindigkeitHinzunehmen

getLuftwiderstandskoeffizient

istBeeinflussbar

getMasse

getForce

getElastizitaet

setElastizitaet

luftwiderstandskoeffizientSetzen

beeinflussbarSetzen

masseSetzen

kraftSetzen

geschwindigkeitSetzen

einfluesseZuruecksetzen

kraftAnwenden

collider