ea

Class Kamera

java.lang.Object

ea.Kamera

public class Kamera
extends java.lang.Object

Die Kamera "blickt" auf die Zeichenebene, das was sie sieht beschreibt den Teil der Zeichenebene; das, was im Fenster dargestellt wird.
Sie kann ein Objekt fokussieren und ihm so folgen. Hierbei besteht auch die Moeglichkeit, diesen Fokus in Grenzen zu halten. Und zwar durch die Fokus-Bounds. Diese 4 Grenzwerte koennen individuell verstellt und aktiviert werden. auch kann man den von der Kamera darzustellenden Bereich durch eine einzige Methode definieren, in dem man den Bereich als BoundingRechteck beschreibt.



BoundingRechteck grenzen = new BoundingRechteck(0, 0, 1500, 1000);
meineCam.boundsSetzen(grenzen);



Hierdurch wird automatisch der gesamte Fokusapparat (auf den Bereich zwischen den Punkten (0|0) und (1500|1000) ) eingestellt. Bei spezielleren Fokuswuenschen laesst sich dies ebenfalls arrangieren durch die einzelnen Methoden, mit denen alle vier Bounds (N, S, O, W) einzeln verstellt und (de)aktiviert werden koennen.
!!Achtung!!
Bei den Fokuseinstellungen sollte immer ein Bereich gewaehlt werden, der die Groesse des Anzeigefensters (oder Vollbildes) bei weitem uebersteigt.
Allgemein wirken diese Bounds auch ohne aktivierten Fokus. jedoch ist dies meist weniger sinnvoll.

Author:

Michael Andonie

Constructor Summary

Constructors

Constructor and Description
Kamera(int sizeX, int sizeY, Zeichenebene z) Konstruktor fuer Objekte der Klasse Kamera

Method Summary

Modifier and Type	Method and Description
void	boundsSetzen(BoundingRechteck r) Mit dieser Methode kann man direkt saemtliche Kamera-Bounds-Einstellungen machen. Ein Bounding-Rechteck gibt die Begrenzung an, die die Kameraperspektive, solange die Bounds nicht deaktiviert werden (ueber die Methode hatBoundsSetzen moeglich), niemals uebertreten wird.
void	fokusLoeschen() Loescht den Fokus. Die Kamera bleibt in ihrer letzten Position zurueck bis entweder ein neuer Fokus gesetzt wird oder sie einfach nur verschoben wird. Diese Methode macht das selbe wie loescheFokus, und ist wegen einer einheitlichen Schreibweise eingeführt.
void	fokusSetzen(Raum r) Setze einen Fokus der Kamera auf ein Objekt. Dieses Objekt ist ab dann im 'Zentrum' der Kamera. Die Art des Fokus (vorne, hinten, oben, unten, mittig etc...) kann ueber die Methode setzeFokusArt() geaendert werden. Soll das Fokusverhalten beendet werden, muss die paramterlose Methode loescheFokus() ausgefuehrt werden; dann bleibt die Kamera bis auf weiteres in der letzten Position. Diese Methode wrappt lediglich setzeFokus(Raum), wurde daher zur verhinderung des Orientierungsverlustes geschrieben.
void	fokusVerzugSetzen(Vektor v) Setzt einen Fokus-Verzug.
int	getX()
int	getY()
void	hatBoundsSetzen(boolean b) Setzt, ob das Fokusverhalten durch Bounds begrenzt wird.
boolean	hatFokus()
void	loescheFokus() Loescht den Fokus. Die Kamera bleibt in ihrer letzten Position zurueck.
BoundingRechteck	position() Die aktuelle Position der Kamera wird zurueckgegeben.
void	positionSetzen(float x, float y) Setzt die Position der linken oberen Ecke der Kameraperspektive.
void	positionSetzen(Punkt p) Setzt die Position der linken oberen Ecke der Kameraperspektive.
void	setzeFokus(Raum r) Setze einen Fokus der Kamera auf ein Objekt. Dieses Objekt ist ab dann im 'Zentrum' der Kamera. Die Art des Fokus (vorne, hinten, oben, unten, mittig etc...) kann ueber die Methode setzeFokusArt() geaendert werden. Soll das Fokusverhalten beendet werden, muss die paramterlose Methode loescheFokus() ausgefuehrt werden; dann bleibt die Kamera bis auf weiteres in der letzten Position.
void	verschieben(int x, int y) Verschiebt die Kamera um einen bestimmten Wert in X- und Y-Richtung. Alternative Methode fuer diejenigen, denen ein Vektor zu umstaendlich ist.
void	verschieben(Vektor v) Verschiebt die Kamera um einen bestimmten Wert in X- und Y-Richtung.
Knoten	wurzel()
void	zeichne(java.awt.Graphics2D g) Zeichnet alle Objekte neu, die sich auf der Zeichenebene und im Blickfeld der Kamera befinden.
void	zentrumSetzen(int x, int y) Setzt das Zentrum der Kamera.
void	zentrumSetzen(Punkt zentrum) Setzt das Zentrum der Kamera.

Methods inherited from class java.lang.Object

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

Constructor Detail

Kamera

public Kamera(int sizeX,
              int sizeY,
              Zeichenebene z)

Konstruktor fuer Objekte der Klasse Kamera

Parameters:

sizeX - Die X-Laenge des Fensters

sizeY - Die Y-Laenge des Fensters

Method Detail

fokusSetzen

public void fokusSetzen(Raum r)

Setze einen Fokus der Kamera auf ein Objekt.
Dieses Objekt ist ab dann im 'Zentrum' der Kamera.
Die Art des Fokus (vorne, hinten, oben, unten, mittig etc...) kann ueber die Methode setzeFokusArt() geaendert werden.
Soll das Fokusverhalten beendet werden, muss die paramterlose Methode loescheFokus() ausgefuehrt werden; dann bleibt die Kamera bis auf weiteres in der letzten Position.
Diese Methode wrappt lediglich setzeFokus(Raum), wurde daher zur verhinderung des Orientierungsverlustes geschrieben.

Parameters:

r - Der Fokuspunkt.

See Also:

setzeFokus(Raum)

setzeFokus

public void setzeFokus(Raum r)

Setze einen Fokus der Kamera auf ein Objekt.
Dieses Objekt ist ab dann im 'Zentrum' der Kamera.
Die Art des Fokus (vorne, hinten, oben, unten, mittig etc...) kann ueber die Methode setzeFokusArt() geaendert werden.
Soll das Fokusverhalten beendet werden, muss die paramterlose Methode loescheFokus() ausgefuehrt werden; dann bleibt die Kamera bis auf weiteres in der letzten Position.

Parameters:

r - Der Fokuspunkt.

fokusVerzugSetzen

public void fokusVerzugSetzen(Vektor v)

Setzt einen Fokus-Verzug. Der Standartwert hierfuer ist (0|0).
Der Fokusverzug ist ein Vektor, um den das Bild, das den Fokus exakt im Zentrum hat, verschoben wird.
Das heisst, dass eine FIgur im Fokus um 100 Pixel tiefer als im Absoluten Bildzentrum liegt, wenn der Fokusverzug mit folgender Methode gesetzt wurde:

/*Irgendwo in der spielsteuernden Klasse* /
cam.fokusVerzugSetzen(new Vektor(0, -100));



Parameters:

v - Der Vektor, um den ab sofort die Kamera vom Zentrum des Fokus verschoben wird.

boundsSetzen

public void boundsSetzen(BoundingRechteck r)

Mit dieser Methode kann man direkt saemtliche Kamera-Bounds-Einstellungen machen.
Ein Bounding-Rechteck gibt die Begrenzung an, die die Kameraperspektive, solange die Bounds nicht deaktiviert werden (ueber die Methode hatBoundsSetzen moeglich), niemals uebertreten wird.

Parameters:

r - Das BoundingRechteck, das die Begrenzung des Raumes angibt

See Also:

hatBoundsSetzen(boolean)

hatBoundsSetzen

public void hatBoundsSetzen(boolean b)

Setzt, ob das Fokusverhalten durch Bounds begrenzt wird.

Parameters:

b - Ob die gesetzten Minimum- und Maximum-Werte auch aktiviert werden sollen.

See Also:

boundsSetzen(BoundingRechteck)

fokusLoeschen

public void fokusLoeschen()

Loescht den Fokus.
Die Kamera bleibt in ihrer letzten Position zurueck bis entweder ein neuer Fokus gesetzt wird oder sie einfach nur verschoben wird.
Diese Methode macht das selbe wie loescheFokus, und ist wegen einer einheitlichen Schreibweise eingeführt.

See Also:

loescheFokus()

loescheFokus

public void loescheFokus()

Loescht den Fokus.
Die Kamera bleibt in ihrer letzten Position zurueck.

verschieben

public void verschieben(int x,
                        int y)

Verschiebt die Kamera um einen bestimmten Wert in X- und Y-Richtung.
Alternative Methode fuer diejenigen, denen ein Vektor zu umstaendlich ist.

Parameters:

x - Die Verschiebung in X-Richtung

y - Die Verschiebung in Y-Richtung

See Also:

verschieben(Vektor)

verschieben

public void verschieben(Vektor v)

Verschiebt die Kamera um einen bestimmten Wert in X- und Y-Richtung.

Parameters:

v - Der die Bewegung beschreibende Vektor.

See Also:

verschieben(int, int)

zentrumSetzen

public void zentrumSetzen(int x,
                          int y)

Setzt das Zentrum der Kamera. Von nun an ist der Punkt mit den eingegebenen Koordinaten im Zentrum des Bildes.

Parameters:

x - Die X-Koordinate des Zentrums des Bildes

y - Die Y-Koordinate des Zentrums des Bildes

See Also:

zentrumSetzen(Punkt)

zentrumSetzen

public void zentrumSetzen(Punkt zentrum)

Setzt das Zentrum der Kamera. Von nun an ist der Eingegebene Punkt im Zentrum des Bildes.

Parameters:

zentrum - Das neue Zentrum der Kamera

See Also:

zentrumSetzen(int, int)

positionSetzen

public void positionSetzen(Punkt p)

Setzt die Position der linken oberen Ecke der Kameraperspektive.

Parameters:

p - Der Punkt der linken oberen Ecke der Kameraperspektive

See Also:

positionSetzen(float, float)

positionSetzen

public void positionSetzen(float x,
                           float y)

Setzt die Position der linken oberen Ecke der Kameraperspektive.

Parameters:

x - Die X-Koordinate der linken oberen Ecke der Kameraperspektive

y - Die Y-Koordinate der linken oberen Ecke der Kameraperspektive

See Also:

positionSetzen(Punkt)

wurzel

public Knoten wurzel()

Returns:

Der Knoten, an dem jedes Raum-Objekt liegen muss, um gezeichnet zu werden.

position

public BoundingRechteck position()

Die aktuelle Position der Kamera wird zurueckgegeben.

Returns:

Das aktuelle BoundingRechteck, dass die aktuelle Fensterdarstellung beschreibt.

getX

public int getX()

Returns:

Der Verzug in Richtung X, den die Kamera bis jetzt vom Urspruenglichen Standort (0, 0) hat.

getY

public int getY()

Returns:

Der Verzug in Richtung Y, den die Kamera bis jetzt vom Urspruenglichen Standort (0, 0) hat.

zeichne

public void zeichne(java.awt.Graphics2D g)

Zeichnet alle Objekte neu, die sich auf der Zeichenebene und im Blickfeld der Kamera befinden.

hatFokus

public boolean hatFokus()

Returns:

Ob die Kamera steif ist, oder sich mit einem Fokuspunkt mitbewegt.