BoundingRechteck (Engine Alpha)

java.lang.Object
- ea.BoundingRechteck

All Implemented Interfaces:

java.io.Serializable
```
public final class BoundingRechteck
extends java.lang.Object
implements java.io.Serializable
```
Ein nicht grafisches Rechteck auf der Zeichenebene, das eine allgemeine Fläche beschreibt.

Author:

Michael Andonie

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`float`	`breite` Reelle Breite des Rechtecks
`float`	`hoehe` Reelle Höhe des Rechtecks
`float`	`x` Reelle `x`-Position des Rechtecks
`float`	`y` Reelle `y`-Position des Rechtecks

Constructor Summary

Constructors
Constructor and Description
`BoundingRechteck(float x, float y, float dX, float dY)` Konstruktor für Objekte der Klasse `BoundingRechteck` mit reellen Werten.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`BoundingRechteck`	`anPosition(float realX, float realY)` Gibt ein neues BoundingRechteck mit selber Höhe und Breite, jedoch einer bestimmten, zu definierenden Position. Diese Position ist die der linken oberen Ecke des BoundingRechtecks.
`Rechteck`	`ausDiesem()` Berechnet aus diesem rein aus Zahlen bestehenden Rahmen ein Rechteck, das in der Zeichenebene darstellbar ist.
`float`	`getRealBreite()` Gibt die reelle Breite aus.
`float`	`getRealHoehe()` Gibt die reelle Hoehe aus.
`float`	`getRealX()` Gibt die reelle X-Koordinate der oberen linken Ecke aus.
`float`	`getRealY()` Gibt die reelle Y-Koordinate der oberen linken Ecke aus.
`float`	`hoehenUnterschied(BoundingRechteck r)` Berechnet den Höhenunterschied zwischen dem Fuß des höheren und dem Kopf des tieferen BoundingRechtecks.
`BoundingRechteck`	`in(BoundingRechteck aussen)` Sollte dieses Bounding-Rechteck nicht voll innerhalb eines bestimmten anderen, äußeren Rechtecks liegen, so wird versucht, dieses Bounding-Rechteck in das andere mit möglichst wenig Verschiebung zu bringen.
`boolean`	`istIn(Punkt p)` Testet, ob ein Punkt sich in dem BoundingRechteck befindet.
`BoundingRechteck`	`klon()` Erstellt einen Klon von diesem BoundingRechteck.
`boolean`	`linksVon(BoundingRechteck r)` Berechnet, ob dieses BoundingRechteck links von einem zweiten ist
`BoundingRechteck`	`linksVon(int grenzeRechts)` Berechnet, ob dieses Rechteck links von einer bestimmten Grenze liegt, und wenn nicht, dann berechnet es eines, das gerade so an der rechten Extremgrenze liegt.
`BoundingRechteck`	`mittenAngleichInstanz(BoundingRechteck r)` Ein Mittenangleich mit einem anderen BoundingRechteck
`BoundingRechteck`	`mittenAngleichInstanz(Punkt p)` Gibt ein neues BoundingRechteck zurück, das seinen Punkt genau im angegebenen Zentrum hat.
`Punkt`	`position()` Gibt die exakte Position der linken oberen Ecke dieses Bounding-Rechtecks aus.
`Punkt[]`	`punkte()` Berechnet die vier Eckpunkte des umfassenden `BoundingRechteck`s
`BoundingRechteck`	`rechtsVon(int grenzeLinks)` Berechnet, ob dieses Rechteck rechts von einer bestimmten Grenze liegt, und wenn nicht, dann berechnet es eines, das gerade so an der linken Extremgrenze liegt.
`boolean`	`schneidet(Dreieck d)` Testet, ob sich ein Dreieck in dem BoundingRechteck befindet. Hierbei wird zuerst getestet, ob ein Punkt des Dreiecks im Rechteck ist, dann, falls nötig ob ein Punkt des Rechtecks im Dreieck ist.
`boolean`	`schneidetBasic(BoundingRechteck fig)` Testet, ob ein anderes BoundingRechteck dieses schneidet. Schneiden bedeutet folgendes im Sinne der Engine Alpha: Beide Rechtecke teilen sich mindestens einen (aber meistens mehrere) Punkte auf der Zeichenebene.
`boolean`	`stehtAuf(BoundingRechteck r)` Berechnet, ob dieses BoundingRechteck auf einem zweiten "steht".
`BoundingRechteck`	`summe(BoundingRechteck r)` Berechnet aus diesem und einem weiteren BoundingRechteck ein neues, dass die beiden genau fasst.
`java.lang.String`	`toString()` Gibt eine String-Repräsentation dieses Objektes aus.
`boolean`	`ueber(BoundingRechteck r)` Berechnet, ob dieses BoundingRechteck ueber einem zweiten ist
`BoundingRechteck`	`ueber(int untergrenze)` Berechnet, ob dieses Rechteck über einer Grenze liegt und wenn nicht, dann berechnet es eines, das gerade so an der Untergrenze liegt.
`KreisCollider`	`umschliessenderKreis()` Gibt einen `BoundingKreis` aus, der das Rechteck minimal, aber voll umschließt.
`boolean`	`umschliesst(BoundingRechteck innen)` Diese Methoden prüft, ob dieses Bounding-Rechteck ein zweites vollkommen umschliesst. Gemeinsame Ränder zählen AUCH* als umschliessen!*
`BoundingRechteck`	`unter(int obergrenze)` Berechnet, ob dieses Rechteck unter einer Grenze liegt, und wenn nicht, dann berechnet es eines, das gerade so an der Obergrenze liegt.
`BoundingRechteck`	`verschErhoeht(Vektor v, int dHoehe)` Transformiert dieses Boudning-Rechteck auf 2 Weisen: Einmal in der Postion und zusätzlich in seiner Höhe.
`float`	`verschiebenX(BoundingRechteck r)` Berechnet, wie weit man waagrecht ein BoundingRechteck verschieben müsste, damit es dieses nicht mehr berührt.
`float`	`verschiebenY(BoundingRechteck r)` Berechnet, wie weit man senkrecht ein BoundingRechteck verschieben müsste, damit es dieses nicht mehr berührt.
`BoundingRechteck`	`verschobeneInstanz(Vektor v)` Berechnet ein neues BoundingRechteck mit denselben Maßen wie dieses, jedoch um einen bestimmten Vektor verschoben.
`Punkt`	`zentrum()` Berechnet den Mittelpunkt dieses BoundingRechtecks in der Zeichenebene.

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

- Field Detail
  - x
```
public final float x
```
    Reelle x-Position des Rechtecks
  - y
```
public final float y
```
    Reelle y-Position des Rechtecks
  - breite
```
public final float breite
```
    Reelle Breite des Rechtecks
  - hoehe
```
public final float hoehe
```
    Reelle Höhe des Rechtecks
- Constructor Detail
  - BoundingRechteck
```
public BoundingRechteck(float x,
                        float y,
                        float dX,
                        float dY)
```
    Konstruktor für Objekte der Klasse BoundingRechteck mit reellen Werten.
    
    Parameters:
    
    x - Die x-Koordinate der oberen linken Ecke des Rechtecks
    
    y - Die y-Koordinate der oberen linken Ecke des Rechtecks
    
    dX - Die Breite des Bounding-Rechtecks
    
    dY - Die Höhe des Bounding-Rechtecks
- Method Detail
  - ausDiesem
```
public Rechteck ausDiesem()
```
    Berechnet aus diesem rein aus Zahlen bestehenden Rahmen ein Rechteck, das in der Zeichenebene darstellbar ist.
    
    Returns:
    
    Ein neues Rechteck-Objekt, das genau dieses BoundingRechteck abdeckt
  - mittenAngleichInstanz
```
public BoundingRechteck mittenAngleichInstanz(BoundingRechteck r)
```
    Ein Mittenangleich mit einem anderen BoundingRechteck
    
    Parameters:
    
    r - Das BoundingRechteck, an dessen Mitte auch die dieses Rechtecks sein soll.
  - mittenAngleichInstanz
```
public BoundingRechteck mittenAngleichInstanz(Punkt p)
```
    Gibt ein neues BoundingRechteck zurück, das seinen Punkt genau im angegebenen Zentrum hat.
    
    Parameters:
    
    p - Das Zentrum des zurückzugebenden BoundingRechtecks.
    
    Returns:
    
    Ein BoundingRechteck mit der gleichen Höhe und Breite wie dieses, jedoch so verschoben, dass es mit seiner Mitte im angegebenen Zentrum liegt.
  - zentrum
```
public Punkt zentrum()
```
    Berechnet den Mittelpunkt dieses BoundingRechtecks in der Zeichenebene.
    
    Returns:
    
    Der Punkt mit den Koordinaten, der im Zentrum des Rechtecks liegt (bei ungeraden Koordinaten mit Abrundung)
  - verschobeneInstanz
```
public BoundingRechteck verschobeneInstanz(Vektor v)
```
    Berechnet ein neues BoundingRechteck mit denselben Maßen wie dieses, jedoch um einen bestimmten Vektor verschoben.
    
    Parameters:
    
    v - Der Vektor, der die Verschiebung des neuen Objektes von diesem beschreibt.
    
    Returns:
    
    Ein neues BoundingRechteck-Objekt, das die selbe Maße wie dieses hat, jedoch um die entsprechende Verschiebung verschoben ist.
  - summe
```
public BoundingRechteck summe(BoundingRechteck r)
```
    Berechnet aus diesem und einem weiteren BoundingRechteck ein neues, dass die beiden genau fasst.
    
    Parameters:
    
    r - Das zweite Rechteck fuer die Berechnung
    
    Returns:
    
    Ein neues BoundingRechteck, dass die beiden Rechtecke genau umfasst.
  - ueber
```
public BoundingRechteck ueber(int untergrenze)
```
    Berechnet, ob dieses Rechteck über einer Grenze liegt und wenn nicht, dann berechnet es eines, das gerade so an der Untergrenze liegt.
    
    Parameters:
    
    untergrenze - Die Grenze, auf der das Ergebnis maximal liegen darf.
    
    Returns:
    
    Ein BoundingRechteck derselben Höhe und Breite wie dieses, das in jedem Fall über, oder auf der Grenze liegt, wenn es passt, ist es this.
  - unter
```
public BoundingRechteck unter(int obergrenze)
```
    Berechnet, ob dieses Rechteck unter einer Grenze liegt, und wenn nicht, dann berechnet es eines, das gerade so an der Obergrenze liegt.
    
    Parameters:
    
    obergrenze - Die Grenze, auf der das Ergebnis maximal liegen darf.
    
    Returns:
    
    Ein BoundingRechteck derselben Hoehe und Breite wie dieses, das in jedem Fall unter, oder auf der Grenze liegt, wenn es passt, ist es this.
  - rechtsVon
```
public BoundingRechteck rechtsVon(int grenzeLinks)
```
    Berechnet, ob dieses Rechteck rechts von einer bestimmten Grenze liegt, und wenn nicht, dann berechnet es eines, das gerade so an der linken Extremgrenze liegt.
    
    Parameters:
    
    grenzeLinks - Der Wert, den das Ergebnisrechteck maximal links sein darf
    
    Returns:
    
    Ein BoundingRechteck derselben Höhe und Breite, das in jedem rechts jenseits oder auf der Grenze liegt.
    Wenn diese Eigenschaften bereits von diesem Objekt erfüllt werden, so wird this zurückgegeben.
  - linksVon
```
public BoundingRechteck linksVon(int grenzeRechts)
```
    Berechnet, ob dieses Rechteck links von einer bestimmten Grenze liegt, und wenn nicht, dann berechnet es eines, das gerade so an der rechten Extremgrenze liegt.
    
    Parameters:
    
    grenzeRechts - Der Wert, den das Ergebnisrechteck maximal rechts sein darf
    
    Returns:
    
    Ein BoundingRechteck derselben Höhe und Breite, das in jedem Fall links jenseits oder auf der Grenze liegt.
    Wenn diese Eigenschaften bereits von diesem Objekt erfüllt werden, so wird this zurückgegeben.
  - anPosition
```
public BoundingRechteck anPosition(float realX,
                                   float realY)
```
    Gibt ein neues BoundingRechteck mit selber Höhe und Breite, jedoch einer bestimmten, zu definierenden Position.
    Diese Position ist die der linken oberen Ecke des BoundingRechtecks.
    
    Parameters:
    
    realX - Die X-Koordinate der linken oberen Ecke des BoundingRechtecks
    
    realY - Die Y-Koordinate der linken oberen Ecke des BoundingRechtecks
    
    Returns:
    
    Ein neues BoundingRechteck mit der eingegebenen Position und derselben Breite und Höhe.
  - umschliessenderKreis
```
public KreisCollider umschliessenderKreis()
```
    Gibt einen BoundingKreis aus, der das Rechteck minimal, aber voll umschließt.
    
    Returns:
    
    der BoundingKreis aus, der das Rechteck minimal, aber voll umschließt. Die Ecken des Rechtecks liegen alle auf dem Kreis.
  - schneidet
```
public boolean schneidet(Dreieck d)
```
    Testet, ob sich ein Dreieck in dem BoundingRechteck befindet.
    Hierbei wird zuerst getestet, ob ein Punkt des Dreiecks im Rechteck ist, dann, falls nötig ob ein Punkt des Rechtecks im Dreieck ist.
  - istIn
```
public boolean istIn(Punkt p)
```
    Testet, ob ein Punkt sich in dem BoundingRechteck befindet.
    
    Parameters:
    
    p - Der Punkt, der getestet werden soll
    
    Returns:
    
    true, wenn der Punkt in dem BoundingRechteck ist
  - punkte
```
public Punkt[] punkte()
```
    Berechnet die vier Eckpunkte des umfassenden BoundingRechtecks
    
    Returns:
    
    Array mit den vier Eckpunkten des umfassenden BoundingRechtecks
  - umschliesst
```
public boolean umschliesst(BoundingRechteck innen)
```
    Diese Methoden prüft, ob dieses Bounding-Rechteck ein zweites vollkommen umschliesst.
    Gemeinsame Ränder zählen AUCH als umschliessen!
    
    Parameters:
    
    innen - Das Innere Bounding-Rechteck. Es soll geprüft werden, ob dieses Vollkommen von dem die Methode ausführenden Rechteck umschlossen wird.
    
    Returns:
    
    true, wenn das ausfuehrende Bounding-Rechteck das als Argument übergebene BoundingRechteck voll umschliesst, sonst false.
  - stehtAuf
```
public boolean stehtAuf(BoundingRechteck r)
```
    Berechnet, ob dieses BoundingRechteck auf einem zweiten "steht".
    
    Parameters:
    
    r - Das BoundingRechteck, auf dem dieses stehen koennte
    
    Returns:
    
    true, wenn dies so ist, sonst false.
  - verschiebenX
```
public float verschiebenX(BoundingRechteck r)
```
    Berechnet, wie weit man waagrecht ein BoundingRechteck verschieben müsste, damit es dieses nicht mehr berührt.
    
    Parameters:
    
    r - Das BoundingRechteck, das eventuell verschoben werden müsste.
    
    Returns:
    
    Die Zahl, die angibt, wie weit man es verschieben muesste, oder 0 wenn sich die beiden nicht berühren.
  - schneidetBasic
```
public boolean schneidetBasic(BoundingRechteck fig)
```
    Testet, ob ein anderes BoundingRechteck dieses schneidet.
    Schneiden bedeutet folgendes im Sinne der Engine Alpha:
    Beide Rechtecke teilen sich mindestens einen (aber meistens mehrere) Punkte auf der Zeichenebene.
    
    Parameters:
    
    fig - Das zweite zu testende BoundingRechteck
    
    Returns:
    
    true, wenn sich die beiden schneiden, sonst false.
  - linksVon
```
public boolean linksVon(BoundingRechteck r)
```
    Berechnet, ob dieses BoundingRechteck links von einem zweiten ist
    
    Parameters:
    
    r - Das Rechteck, bei dem dies getestet werden soll
    
    Returns:
    
    true, wenn dieses Rechteck rechts von dem anderen ist, sonst false.
  - verschiebenY
```
public float verschiebenY(BoundingRechteck r)
```
    Berechnet, wie weit man senkrecht ein BoundingRechteck verschieben müsste, damit es dieses nicht mehr berührt.
    
    Parameters:
    
    r - Das BoundingRechteck, das eventuell verschoben werden müsste.
    
    Returns:
    
    Die Zahl, die angibt, wie weit man es verschieben müsste, oder 0 wenn sich die beiden nicht berühren.
  - ueber
```
public boolean ueber(BoundingRechteck r)
```
    Berechnet, ob dieses BoundingRechteck ueber einem zweiten ist
    
    Parameters:
    
    r - Das Rechteck, bei dem dies getestet werden soll
    
    Returns:
    
    true, wenn dieses Rechteck rechts von dem anderen ist, sonst false.
  - hoehenUnterschied
```
public float hoehenUnterschied(BoundingRechteck r)
```
    Berechnet den Höhenunterschied zwischen dem Fuß des höheren und dem Kopf des tieferen BoundingRechtecks.
    
    Parameters:
    
    r - Das BoundingRechteck, dessen Höhenunterschied zu diesem gefunden werden soll
    
    Returns:
    
    Der absolute (also niemals negative) Unterschied in der Höhe zwischen den beiden Objekten. Überlagern sie sich, so ist der Rückgabewert 0!
  - verschErhoeht
```
public BoundingRechteck verschErhoeht(Vektor v,
                                      int dHoehe)
```
    Transformiert dieses Boudning-Rechteck auf 2 Weisen: Einmal in der Postion und zusätzlich in seiner Höhe.
    
    Parameters:
    
    v - Der Vektor, der die Verschiebung beschreibt.
    
    dHoehe - Die Höhenänderung.
    
    Returns:
    
    Ein neues BoundingRechteck, das verschoben und in seiner Höhe geändert ist.
  - in
```
public BoundingRechteck in(BoundingRechteck aussen)
```
    Sollte dieses Bounding-Rechteck nicht voll innerhalb eines bestimmten anderen, äußeren Rechtecks liegen, so wird versucht, dieses Bounding-Rechteck in das andere mit möglichst wenig Verschiebung zu bringen. Diese Methode wird intern für die Beschränkung des Kamera-Bereiches genutzt.
    
    Achtung: Voraussetzung dafuer, dass dieser Algorithmus Sinn macht ist, dass das äußere Rechteck ausreichend größer als dieses ist!
    
    Parameters:
    
    aussen - Das äußere Rechteck, innerhalb dessen sich das Ergebnis-Rechteck befinden wird (sollte das äußere ausreichend groß sein).
    
    Returns:
    
    Das Ergebnis-Rechteck, das sich im äußeren Rechteck befinden wird.
  - klon
```
public BoundingRechteck klon()
```
    Erstellt einen Klon von diesem BoundingRechteck.
    
    Returns:
    
    Ein neues BoundingRechteck mit genau demselben Zustand wie dieses.
  - toString
```
public java.lang.String toString()
```
    Gibt eine String-Repräsentation dieses Objektes aus.
    
    Overrides:
    
    toString in class java.lang.Object
    
    Returns:
    
    Die String-Repräsentation dieses Objektes. Hierin wird Auskunft über alle 4 ausschlaggebenden Zahlen (x, y, dX und dY gemacht)
  - getRealX
```
public float getRealX()
```
    Gibt die reelle X-Koordinate der oberen linken Ecke aus.
    
    Returns:
    
    Die reelle X-Koordinate der oberen linken Ecke dieses BoundingRechtecks.
    
    See Also:
    
    getRealY(), getRealBreite(), getRealHoehe()
  - getRealY
```
public float getRealY()
```
    Gibt die reelle Y-Koordinate der oberen linken Ecke aus.
    
    Returns:
    
    Die reelle Y-Koordinate der oberen linken Ecke dieses BoundingRechtecks.
    
    See Also:
    
    getRealX(), getRealBreite(), getRealHoehe()
  - getRealBreite
```
public float getRealBreite()
```
    Gibt die reelle Breite aus.
    
    Returns:
    
    Die reelle Breite dieses BoundingRechtecks.
    
    See Also:
    
    getRealX(), getRealY(), getRealHoehe()
  - getRealHoehe
```
public float getRealHoehe()
```
    Gibt die reelle Hoehe aus.
    
    Returns:
    
    Die reelle Hoehe dieses BoundingRechtecks.
    
    See Also:
    
    getRealX(), getRealY(), getRealBreite()
  - position
```
public Punkt position()
```
    Gibt die exakte Position der linken oberen Ecke dieses Bounding-Rechtecks aus.
    
    Returns:
    
    die Position des BoundingRechtecks, beschrieben durch den Punkt der linken oberen Ecke dieses Objekts.

Class BoundingRechteck

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

x

y

breite

hoehe

Constructor Detail

BoundingRechteck

Method Detail

ausDiesem

mittenAngleichInstanz

mittenAngleichInstanz

zentrum

verschobeneInstanz

summe

ueber

unter

rechtsVon

linksVon

anPosition

umschliessenderKreis

schneidet

istIn

punkte

umschliesst

stehtAuf

verschiebenX

schneidetBasic

linksVon

verschiebenY

ueber

hoehenUnterschied

verschErhoeht

in

klon

toString

getRealX

getRealY

getRealBreite

getRealHoehe

position