ea.internal.phy

Class 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

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, 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