ea.internal.collision

Class Collider

java.lang.Object

ea.internal.collision.Collider

All Implemented Interfaces:

java.lang.Cloneable

Direct Known Subclasses:

BoxCollider, ColliderGroup, NullCollider, SphereCollider

public abstract class Collider
extends java.lang.Object
implements java.lang.Cloneable

Ein Collider ist die abstrakte Form einer Umgebung in der Zeichenebene. Durch das Vergleichen von verschiedenen Collidern l�sst sich eine effektive Collision Detection erm�glichen, also das Pr�fen auf Kollisionen zweier #ea.Raum-Objekte.

Author:

Andonie

Field Summary

Fields

Modifier and Type	Field and Description
protected Vektor	offset Der Offset dieses Colliders.

Constructor Summary

Constructors

Constructor and Description
Collider()

Method Summary

Modifier and Type	Method and Description
static boolean	boxboxCollision(BoxCollider b1, BoxCollider b2, Punkt p1, Punkt p2) Logische Abfrage für die Kollision zweier Boxen.
abstract Collider	clone() Überschriebene Clone-Methode für effizientes, tiefgehendes klonen von Collidern.
abstract boolean	istNullCollider() Gibt zurück, ob dieser Collider ein NullCollider ist, also nur false zur�ckgeben kann.
Vektor	offset() Gibt den Offset dieses Vektors relativ zum zugehörigen Raum an.
void	offsetSetzen(Vektor os) Setzt den Offset dieses Colliders neu.
static boolean	sphereboxCollision(SphereCollider sphere, BoxCollider box, Punkt ps, Punkt pb) Logische Abfrage für die Kollision eines Kreises mit einer Box.
static boolean	spheresphereCollision(SphereCollider s1, SphereCollider s2, Punkt p1, Punkt p2) Logische Abfrage für die Kollision zweier Kreise.
abstract boolean	verursachtCollision(Punkt positionThis, Punkt positionOther, Collider other) Prüft, ob dieser Collider sich mit einem weiteren Collider schneidet.
abstract Raum	visualize(Punkt p, Farbe color) Gibt eine visuelle Interpretation dieses Colliders als Raum-Objekt aus.

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

offset

protected Vektor offset

Der Offset dieses Colliders. Die Verwendung des Offsets hängt von den implementierenden Subklassen ab.

See Also:

offsetSetzen(ea.Vektor)

Constructor Detail

Collider

public Collider()

Method Detail

boxboxCollision

public static boolean boxboxCollision(BoxCollider b1,
                                      BoxCollider b2,
                                      Punkt p1,
                                      Punkt p2)

Logische Abfrage für die Kollision zweier Boxen.

Parameters:

b1 - Box 1

b2 - Box 2

p1 - Position von Box 1 auf der Zeichenebene

p2 - Position von Box 2 auf der Zeichenebene

Returns:

true, wenn sich beide Boxen bei aktueller Belegung schneiden, sonst false.

spheresphereCollision

public static boolean spheresphereCollision(SphereCollider s1,
                                            SphereCollider s2,
                                            Punkt p1,
                                            Punkt p2)

Logische Abfrage für die Kollision zweier Kreise.

Parameters:

s1 - Kreis 1

s2 - Kreis 2

p1 - Position von Kreis 1 auf der Zeichenebene

p2 - Position von Kreis 2 auf der Zeichenebene

Returns:

true, wenn sich beide Kreise bei aktueller Belegung schneiden, sonst false.

sphereboxCollision

public static boolean sphereboxCollision(SphereCollider sphere,
                                         BoxCollider box,
                                         Punkt ps,
                                         Punkt pb)

Logische Abfrage für die Kollision eines Kreises mit einer Box.

Parameters:

sphere - Der Kreis

box - Die Box

ps - Position von Sphere

pb - Position von Box

Returns:

true, wenn sich Kreis und Box schneiden, sonst false.

offsetSetzen

public final void offsetSetzen(Vektor os)

Setzt den Offset dieses Colliders neu.
Erläuterung
Zunächst liegen Position vom Raum-Objekt und dem Collider direkt aufeinander. Der Offset wird also relativ zur aktuellen Position des Raum-Objektes in der Zeichenebene hinzugerechnet, um die endgültige Position des Colliders für die Kollisionsabfragen festzulegen.

Parameters:

os - Der neue Offset für diesen Collider.

See Also:

offset()

offset

public final Vektor offset()

Gibt den Offset dieses Vektors relativ zum zugehörigen Raum an.

Returns:

Der Offset dieses Vektors relativ zum zugehörigen Raum an.

verursachtCollision

public abstract boolean verursachtCollision(Punkt positionThis,
                                            Punkt positionOther,
                                            Collider other)

Prüft, ob dieser Collider sich mit einem weiteren Collider schneidet.

Parameters:

other - Ein zweiter Collider.

Returns:

true, falls sich dieser Collider mit dem zweiten Collider schneidet. Schneiden sich dieser Collider und der zweite Collider nicht, so gibt diese Funktion false zurück.

istNullCollider

public abstract boolean istNullCollider()

Gibt zurück, ob dieser Collider ein NullCollider ist, also nur false zur�ckgeben kann.

Returns:

true, falls dieser Collider ein Null-Collider ist, sonst false.

visualize

public abstract Raum visualize(Punkt p,
                               Farbe color)

Gibt eine visuelle Interpretation dieses Colliders als Raum-Objekt aus.

Parameters:

color - Die (Füll)Farbe, in der das grafische Objekt ggf. dargestellt werden soll.

p - Der Punkt, an dem das zugehörige Objekt derzeit ist.

Returns:

Ein-Raum-Objekt, das den Collider ideal annähert in Form, Position und Größe. Das ausgegebene Objekt ist nicht an der Wurzel angemeldet und wird damit nicht ohne Weiteres grafisch dargestellt.

clone

public abstract Collider clone()

Überschriebene Clone-Methode für effizientes, tiefgehendes klonen von Collidern. Das bedeutet, dass auch tiefer liegende Referenzen frisch geklont werden, bis in die tiefste Referenzebene.

Overrides:

clone in class java.lang.Object