Physik

java.lang.Object
- ea.Manager
- - ea.internal.phy.Physik

All Implemented Interfaces:

Ticker, java.io.Serializable
```
public class Physik
extends Manager
implements Ticker
```
Ein Objekt der Klasse Physik behandelt eigenstaendig verschiedene Raum-Objekte als Physik-Engine.
Grundlegend behandelt sie Trefferkollisionen eigenstaendig, also bietet es sich an, diese Eigenschaft zu nutzen, und zwar in dem Interface KollisionsReagierbar.

Weiterhin - und dies ist eine essentielle Aufgabe fuer viele 2D-Spiele - kann diese Maschine
- An gewuenschtren Raum-Objekten Schwerkraft erzeugen
- Aktive Raum-Objekte (Aktivobjekte, zum Beispiel Spielfiguren) so beeinlfussen, dass es fuer sie nicht moeglich ist, passive Raum-Objekte (PassivObjekte, zum Beispiel Mauer, Waende, Boeden) zu schneiden.

Diese beiden Eigenschaften in Kombination erzeugen die Moeglichkeit, sehr einfach eine funktionierende Spielewelt zu programmieren, in der bereits ein funktionierendes System zum Fallen und Grenzen abstecken existiert.

Author:

Michael Andonie

See Also:

Serialized Form

Field Summary
- Fields inherited from class ea.Manager
  fontNamen, standard

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`aktivAbmelden(Gravitator g)` Meldet einen Gravitator wieder ab - Vorausgesetzt er war auch angemeldet.
`void`	`aktivAnmelden(Gravitator g)` Meldet einen Gravitator fuer Aktiv-Objekte an.
`void`	`alleAktivenEinsetzen(Knoten k, BoundingRechteck b)` Setzt alle Aktiv-Objekte, die eine bestimmte Flaeche uebertreten, in einen Knoten.
`void`	`alleAktivenTestenUndEinsetzen(Knoten k, BoundingRechteck b, Vektor v)` Setzt alle Aktiv-Objekte, die eine bestimmte Flaeche uebertreten, nicht jedoch nach der Verschiebung ein Passiv-Objekt schneiden, in einen Knoten.
`void`	`alleAktivenTestenUndEinsetzenOhne(Knoten k, BoundingRechteck b, Vektor v, Passivator p)` Setzt alle Aktiv-Objekte, die eine bestimmte Flaeche uebertreten, nicht jedoch nach der Verschiebung ein Passiv-Objekt schneiden - mit einer bestimmten Ausnahme - in einen Knoten.
`void`	`anmelden(KollisionsReagierbar k, Raum r1, Raum r2)` Vereinfachte Form der anmelden()-Methode fuer Kollisionstests. Hierbei wird immer der Code code = 0 bei der `reagieren()`-Methode mitgegeben, somit ist beim Aufruf dieser Methode keine Fallunterscheidung innerhalb eines `FallReagierbar`-Objektes moeglich!
`void`	`anmelden(KollisionsReagierbar k, Raum r1, Raum r2, int code)` Meldet ein KollisionsReagierbar-Interface bei der Physik an.
`Vektor`	`entblocken(BoundingRechteck r)` Gibt die Verschiebung zurueck, die noetig waere um das geblockte Bounding-Rechteck aus seinem Zustand des Passiv-Blockiertseins zu loesen.
`void`	`entfernen(KollisionsReagierbar k)` Sorgt dafuer, das saemtliche Kollsiionsueberwachungsauftraege eines `KollisionsReagierbar`-Interfaces nicht mehr ausgefuehrt werden.
`static Physik`	`getPhysik()` Realisierung eines Singleton.
`boolean`	`inPassivem(BoundingRechteck r)` Prueft, ob eine Flaeche ein Passiv-Objekt schneidet.
`boolean`	`inPassivemAusser(BoundingRechteck r, Passivator aus)` Prueft, ob eine Flaeche ein Passiv-Objekt - bis auf eine Ausnahme schneidet.
`static void`	`neutralize()` Neutralisiert die aktuelle Physik und macht Platz fuer eine neue.
`void`	`passivAbmelden(Passivator p)` Meldet einen Passivator wieder ab - Vorausgesetzt er war auch angemeldet.
`void`	`passivAnmelden(Passivator p)` Meldet einen Passivator an.
`void`	`tick()` In diesem Tick findet ein DELTA-t der Physik statt (= 1ms).

Methods inherited from class ea.Manager
abmelden, alleAbmelden, anhalten, anmelden, anmelden, fontExistiert, hatAktiveTicker, intervallSetzen, istAngemeldet, kill, starten

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

- Method Detail
  - neutralize
```
public static void neutralize()
```
    Neutralisiert die aktuelle Physik und macht Platz fuer eine neue.
  - getPhysik
```
public static final Physik getPhysik()
```
    Realisierung eines Singleton. Da es nur eine Physik pro Anwendung gibt, garantiert diese statische Methode, dass es nur ein Physik Objekt gibt, da keine Physik-Objekte erstellt werden koennen.
    
    Returns:
    
    Das aktive Physik-Objekt.
  - passivAnmelden
```
public void passivAnmelden(Passivator p)
```
    Meldet einen Passivator an.
    
    Parameters:
    
    p - Der Passivator, der anzumelden ist.
  - passivAbmelden
```
public void passivAbmelden(Passivator p)
```
    Meldet einen Passivator wieder ab - Vorausgesetzt er war auch angemeldet.
    
    Parameters:
    
    p - Der abzumeldende Passivator
  - aktivAnmelden
```
public void aktivAnmelden(Gravitator g)
```
    Meldet einen Gravitator fuer Aktiv-Objekte an.
    
    Parameters:
    
    g - Der anzumeldende Gravitator
  - aktivAbmelden
```
public void aktivAbmelden(Gravitator g)
```
    Meldet einen Gravitator wieder ab - Vorausgesetzt er war auch angemeldet.
    
    Parameters:
    
    g - Der abzumeldende Gravitator
  - alleAktivenEinsetzen
```
public void alleAktivenEinsetzen(Knoten k,
                                 BoundingRechteck b)
```
    Setzt alle Aktiv-Objekte, die eine bestimmte Flaeche uebertreten, in einen Knoten.
    
    Parameters:
    
    k - In diesen Knoten werden alle Aktiv-Objekte, die die Flaeche betreten eingefuegt.
    
    b - Dieses BoundingRechteck beschreibt die kritische Flaeche.
  - alleAktivenTestenUndEinsetzen
```
public void alleAktivenTestenUndEinsetzen(Knoten k,
                                          BoundingRechteck b,
                                          Vektor v)
```
    Setzt alle Aktiv-Objekte, die eine bestimmte Flaeche uebertreten, nicht jedoch nach der Verschiebung ein Passiv-Objekt schneiden, in einen Knoten.
    
    Parameters:
    
    k - In diesen Knoten werden alle Aktiv-Objekte, die die Flaeche betreten, nicht jedoch nach der Verschiebung problematisch waeren eingefuegt.
    
    b - Dieses BoundingRechteck beschreibt die kritische Flaeche.
    
    v - Die kritische Verschiebung.
  - inPassivem
```
public boolean inPassivem(BoundingRechteck r)
```
    Prueft, ob eine Flaeche ein Passiv-Objekt schneidet.
    
    Parameters:
    
    r - Die Flaeche der Ueberprueftung, als BoundingRechteck
    
    Returns:
    
    true, wenn diese Flaeche ein Passivobjekt schneidet, sonst false.
  - alleAktivenTestenUndEinsetzenOhne
```
public void alleAktivenTestenUndEinsetzenOhne(Knoten k,
                                              BoundingRechteck b,
                                              Vektor v,
                                              Passivator p)
```
    Setzt alle Aktiv-Objekte, die eine bestimmte Flaeche uebertreten, nicht jedoch nach der Verschiebung ein Passiv-Objekt schneiden - mit einer bestimmten Ausnahme - in einen Knoten.
    
    Parameters:
    
    k - In diesen Knoten werden alle Aktiv-Objekte, die die Flaeche betreten, nicht jedoch nach der Verschiebung problematisch waeren eingefuegt.
    
    b - Dieses BoundingRechteck beschreibt die kritische Flaeche.
    
    v - Die kritische Verschiebung.
    
    p - Die eine Ausnahme als Passivator
  - inPassivemAusser
```
public boolean inPassivemAusser(BoundingRechteck r,
                                Passivator aus)
```
    Prueft, ob eine Flaeche ein Passiv-Objekt - bis auf eine Ausnahme schneidet.
    
    Parameters:
    
    r - Die Flaeche der Ueberprueftung, als BoundingRechteck
    
    aus - Die eine Ausnahme, die bei den Kollisionstests nicht beruecksichtigt wird.
    
    Returns:
    
    true, wenn diese Flaeche ein Passivobjekt - ausser der einen Ausnahme - schneidet, sonst false.
  - entblocken
```
public Vektor entblocken(BoundingRechteck r)
```
    Gibt die Verschiebung zurueck, die noetig waere um das geblockte Bounding-Rechteck aus seinem Zustand des Passiv-Blockiertseins zu loesen.
    
    Parameters:
    
    r - Das zu entblockende BoundingRechteck
    
    Returns:
    
    Die Verschiebung, die noetig waere, um das BoundingRechteck aus dem Passiv-Geblocktsein zu Loesen. Hat die Werte (0|0) fuer den Fall, dass das Bounding-Rechteck gar nicht passiv blockiert ist.
  - anmelden
```
public void anmelden(KollisionsReagierbar k,
                     Raum r1,
                     Raum r2)
```
    Vereinfachte Form der anmelden()-Methode fuer Kollisionstests.
    Hierbei wird immer der Code code = 0 bei der reagieren()-Methode mitgegeben, somit ist beim Aufruf dieser Methode keine Fallunterscheidung innerhalb eines FallReagierbar-Objektes moeglich!
    
    Parameters:
    
    k - Das KollisionsReagierbar-Objekt, das benachrichtigt wird, wenn beide Objekte kollidieren
    
    r1 - Der erste Raum-Teil. Kollidieren beide, so wird das KollisionsReagierbar-Objekt benachrichtigt
    
    r2 - Der zweite Raum-Teil. Kollidieren beide, so wird das KollisionsReagierbar-Objekt benachrichtigt
    
    See Also:
    
    anmelden(KollisionsReagierbar, Raum, Raum, int)
  - anmelden
```
public void anmelden(KollisionsReagierbar k,
                     Raum r1,
                     Raum r2,
                     int code)
```
    Meldet ein KollisionsReagierbar-Interface bei der Physik an. Zusammen mit den 2 auf Kollision zu ueberwachenden Raum-Objekten sowie dem Code, der bei dem Aufruf beim Treffer zwischen den beiden mitgegeben werden soll.
    
    Die kollision(int code)-Methode des anzumeldenden KollisionsReagierbar-Interfaces wird ab sofort immer dann aufgerufen wenn:
    1. beide Raum-Objekte schneiden
    und 2. beide Raum-Objekte sichtbar sind
    
    Diese Methode wird solange immer wieder aufgerufen, wie die Kollision besteht! Wird also in der kollision(int code)-Methode nicht dafuer gesorgt, dass sich die Objekte nicht mehr schneiden, so wird diese Methode wieder und wieder aufgerufen!
    
    ACHTUNG
    Es sollten niemals 2 Knoten oder Geometrie (oder ein Knoten und ein Geometrie) - Objekte gleichzeitig angemeldet werden. Ist dies der Fall, ist der Kollisionstest nicht so genau, wie er seien koennte.
    
    Parameters:
    
    k - Das KollisionsReagierbar-Objekt, das benachrichtigt wird, wenn beide Objekte kollidieren
    
    r1 - Der erste Raum-Teil. Kollidieren beide, so wird das KollisionsReagierbar-Objekt benachrichtigt
    
    r2 - Der zweite Raum-Teil. Kollidieren beide, so wird das KollisionsReagierbar-Objekt benachrichtigt
    
    code - Der Code, der dem KollisionsReagierbar-Objekt als Parameter in seiner reagieren()-Methode mitgegeben werden soll.
  - entfernen
```
public void entfernen(KollisionsReagierbar k)
```
    Sorgt dafuer, das saemtliche Kollsiionsueberwachungsauftraege eines KollisionsReagierbar-Interfaces nicht mehr ausgefuehrt werden.
    
    Parameters:
    
    k - Das Interface, an dem jede Ueberwachung von Raum-Objekten abgebrochen werden soll.
  - tick
```
public void tick()
```
    In diesem Tick findet ein DELTA-t der Physik statt (= 1ms).
    
    Specified by:
    
    tick in interface Ticker

Class Physik

Field Summary

Fields inherited from class ea.Manager

Method Summary

Methods inherited from class ea.Manager

Methods inherited from class java.lang.Object

Method Detail

neutralize

getPhysik

passivAnmelden

passivAbmelden

aktivAnmelden

aktivAbmelden

alleAktivenEinsetzen

alleAktivenTestenUndEinsetzen

inPassivem

alleAktivenTestenUndEinsetzenOhne

inPassivemAusser

entblocken

anmelden

anmelden

entfernen

tick