ea

Class Game

java.lang.Object

ea.Game

All Implemented Interfaces:

TastenReagierbar

Direct Known Subclasses:

FensterE, Spiegel

public abstract class Game
extends java.lang.Object
implements TastenReagierbar

Diese Klasse ist für die sofortige, einfache Verwendung der Engine verantwortlich.
Aus ihr sollte die Klasse abgleitet werden, die die Spielorganisation beinhaltet.

Author:

Michael Andonie

Field Summary

Fields

Modifier and Type	Field and Description
AnimationsManager	animationsManager Der Animations-Manager.
Kamera	cam Die Kamera des Spiels. Dieser kann ueber setzeFokus(Raum m) ein bestimmtes Raum-Objekt immer im Zentrum zeigen.
Manager	manager Der Tickermanager.
java.lang.String	pfadtrenner Dieser String ist immer das korrekte, Systemabhaengige Pfadtrenner-Literal, das ganz einfach bei Pfadangaben verwendet werden kann: String verzeichnis = "meinOrdner" + "meinDarinLiegenderUnterordner" + "meineDatei.eaf";
Knoten	statischeWurzel Die statische Wurzel. Objekte, die an diesem Knoten angemeldet werden, werden ebenfalls gezeichnet, jedoch mit einem essentiellen Unterschied bei Verschiebung der Kamera werden diese nicht verschoben gezeichnet, sondern bleiben weiter (statisch) auf ihrer festen Position.
Knoten	wurzel Der Wurzel-Knoten.

Constructor Summary

Constructors

Constructor and Description
Game() Parameterloser Alternativkonstruktor. Hierbei wird automatisch ein Spielfenster der Groesse 500 auf 500 (kein Vollbild) erstellt, das bei Tastendruck auf "Escape" beendet wird.
Game(int x, int y) Vereinfachter Konstruktor. Hierbei gilt automatisch, dass das Fenster beim Tastendruck auf "Escape" beendet wird, sowie dass kein Vollbild aktiviert wird. Ist dies nicht gewuenscht, so muss der komplexere Konstruktor aufgerufen werden.
Game(int x, int y, boolean vollbild) Erstellt ein Spiel, bei dem automatisch beim Drücken von ESC alles beendet wird und ohne Titel.
Game(int x, int y, java.lang.String titel) Vereinfachter Konstruktor. Hierbei gilt automatisch, dass das Fenster beim Tastendruck auf "Escape" beendet wird, sowie dass kein Vollbild aktiviert wird. Ist dies nicht gewuenscht, so muss der komplexere Konstruktor aufgerufen werden.
Game(int x, int y, java.lang.String titel, boolean vollbild) Etwas vereinfachter Konstruktor. Hierbei gilt automatisch, dass das Fenster beim Tastendruck auf "Escape" beendet wird. Ist dies nicht gewuenscht, so muss der komplexere Konstruktor aufgerufen werden.
Game(int x, int y, java.lang.String titel, boolean vollbild, boolean exitOnEsc) Konstruktor fuer Objekte der Klasse Game.
Game(int x, int y, java.lang.String titel, boolean vollbild, boolean exitOnEsc, int fensterX, int fensterY) Groesster Konstruktor fuer Objekte der Klasse Game.

Method Summary

Modifier and Type	Method and Description
void	beenden() Diese Methode beendet das Spiel gaenzlich. Das heisst, dass das Fenster geschlossen, alle belegten Ressourcen freigegeben und auch die virtuelle Maschine von JAVA beendet wird. Also beendet diese Methode die gesamte Applikation!
java.lang.String	eingabeFordern(java.lang.String nachricht) Fordert vom Benutzer eine Texteingabe (maximal 40 Zeichen) durch ein neues Fenster. Dieses Fenster muss erst wieder geschlossen werden, damit das Spielfenster wieder in den Vordergrund ruecken kann.
void	fensterFontSetzen(java.lang.String fontname) Setzt den Font, der ab sofort von den Fenstern standartmaessig verwendet wird mit einer Standartgroesse von 12.
void	fensterFontSetzen(java.lang.String fontname, int schriftgroesse) Setzt den Font, der ab sofort von den Fenstern standartmaessig verwendet wird.
BoundingRechteck	fensterGroesse() Gibt ein BoundingRechteck zurueck, dass die Masse des Fensters beschreibt. Die Hoehe und Breite geben die Hoehe und Breite des Fensters wieder.
void	fensterMaximieren() Maximiert das Fenster. Dadurch wird es - sofern es sich in der Taskleiste minimiert befindet - wieder maximiert.
void	fensterMinimieren() Minimiert das Fenster. Dadurch wird es in die Taskleiste hinein minimiert.
boolean	frage(java.lang.String frage) Stellt eine einfache Frage, also eine Frage, auf die mit "Ja" oder "Nein" geantwortet werden kann, in einem neuen Fenster. Dieses Fenster muss erst wieder geschlossen werden, damit das Spielfenster wieder in den Vordergrund ruecken kann.
void	highscoreAnzeigen(java.lang.String[] namen, int[] punkte) Öffnet ein titelloses Fenster, das die Highscores des Spiels anzeigt.
void	highscoreAnzeigen(java.lang.String[] namen, int[] punkte, java.lang.String fenstertitel) Öffnet ein Fenster, das die Highscores des Spiels anzeigt.
void	hintergrundSetzen(Raum m) Setzt einen Hintergrund fuer das Spiel. Das kann ein beliebiges Raum-Objekt sein, vorwiegend bieten sich jedoch Bilder an. Dieses Objekt wird dann immer im absoluten Hintergrund sein und wird auch weiter entfernt wirken, wenn Bewegungen stattfinden.
void	iconSetzen(Bild icon) Setzt das übergebene Bild als Icon des Fensters
void	kollisionsReagierbarAnmelden(KollisionsReagierbar reagierbar, Raum r1, Raum r2, int code) Meldet ein KollisionsReagierbar-Interface an.
boolean	kopieren(java.lang.String von, java.lang.String nach, java.lang.String nameNeu) Diese Methode kopiert eine beliebige Datei von einem Pfad in einen neuen.
void	mausAnmelden(Maus maus) Meldet ein Mausobjekt an. Ab sofort wird die anzumeldende Maus im Fenster dargestellt und Klicks werden auf die Maus uebertragen.
void	mausAnmelden(Maus maus, boolean listenerUebernehmen) Meldet ein Mausobjekt an. Ab sofort wird die anzumeldende Maus im Fenster dargestellt und Klicks werden auf die Maus uebertragen.
void	nachrichtSchicken(java.lang.String nachricht) Schickt eine einfache Nachricht in einem Fenster nach draussen. Dieses Fenster muss erst wieder geschlossen werden, damit das Spielfenster wieder in den Vordergrund ruecken kann.
java.lang.String	pfadAuswaehlen(java.lang.String... akzeptierteEndungen) Öffnet einen Such-Dialog, der die Auswahl eines Pfades ermöglicht.
void	reagieren(int code) Die aus TastenReagierbar implemetierte Methode zum Reagieren auf einen einfachen, einmaligen Tastendruck.
void	rechenintensiveArbeitSetzen(boolean rechenintensiv) Setzt, ob die gesamte Engine Alpha rechenintensiv, oder ressourcensparsam arbeiten soll.
void	schliessen() Beendet dieses Game auf softe weise: - Das Fenster wird geschlossen - Die Physik wird beendet (alle bestehenden Raum-Objekte werden automatisch neutral - Alle Animationen werden beendet - Der ABER: -> Die virtuelle Maschine wird nicht beendet.
void	screenshot(java.lang.String pfad) Macht vom aktuell sichtbaren Bereich (also dem von der Kamera derzeit erfassten Bereich) einen Screenshot.
void	screenshot(java.lang.String pfad, BoundingRechteck ausschnitt) Macht einen Screenshot von einem bestimmten Bildbereich und speichert diesen ab.
void	screenshot(java.lang.String pfad, int x, int y, int breite, int hoehe) Macht einen Screenshot von einem bestimmten Bildbereich und speichert diesen ab,
boolean	sicherheitsFrage(java.lang.String frage) Stellt eine Sicherheitsfrage, also eine Frage auf die mit "OK" oder "Abbrechen" geantwortet werden kann, in einem neuen Fenster. Dieses Fenster muss erst wieder geschlossen werden, damit das Spielfenster wieder in den Vordergrund ruecken kann.
boolean	tasteGedrueckt(int code) Prüft, ob eine bestimmte Taste gerade jetzt heruntergedrückt wird.
void	tastenLosgelassenReagierbarAnmelden(TastenLosgelassenReagierbar g) Meldet ein TastenLosgelassenReagierbar-Objekt an.
void	tastenReagierbarAnmelden(TastenReagierbar g) Meldet ein "TastenReagierbar"-Objekt an.
abstract void	tasteReagieren(int code) Diese Methode wird von der Klasse automatisch aufgerufen, sobald eine Taste einfach gedrueckt wurde. Sie wird dann erst wieder aufgerufen, wenn die Taste erst losgelassen und dann wieder gedreuckt wurde. Sollte allerdings eine Methode vonnoeten sein, die immer wieder in Regelmaessigen abstaenden aufgerufen wird, solange die Taste heruntergedrueckt ist, so bietet sich dies im Interface TasteGedruecktReagierbar an.
void	tickerAbmelden(Ticker ticker) Meldet einen (aktiven) Ticker ab.
void	tickerAnmelden(Ticker ticker, int intervall) Meldet einen Ticker an.
void	ueberblendeSetzen(boolean aktiv) Setzt, ob das Spiel eine allueberstehende Ueberblende ausfuehren soll, die bis zum widerruf alles ueberdeckt. Diese ist niemals gaenzlich durchsichtig, da sie nur ueberblendet und nicht ueberdeckt.
void	ueberblendeSetzen(boolean aktiv, Farbe farbe) Setzt, ob das Spiel eine allueberstehende Ueberblende ausfuehren soll, die bis zum widerruf alles ueberdeckt. Diese ist niemals gaenzlich durchsichtig, da sie nur ueberblendet und nicht ueberdeckt.
void	warten(int millisekunden) Dieser Methodenaufruf dauert eine bestimmte Zeit.
boolean	zufallsBoolean() Gibt ein zufälliges boolean-Attribut zurück. Mit relativ zuverlässiger Sicherheit sind die Wahrscheinlichkeiten für false und true gleich groß.
int	zufallsZahl(int obergrenze) Gibt ein zufälliges int-Attribut zwischen 0 und einer festgelegten Obergrenze zurück. Mit relativ zuverlässiger Sicherheit sind die Wahrscheinlichkeiten für die Werte zwischen 0 und der Obergrenze gleich groß.

Methods inherited from class java.lang.Object

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

Field Detail

manager

public final Manager manager

Der Tickermanager. An ihm werden die Ticker angemeldet.

animationsManager

public final AnimationsManager animationsManager

Der Animations-Manager. Er kann Animationen organisieren.

wurzel

public final Knoten wurzel

Der Wurzel-Knoten. An ihm muessen direkt oder indirekt (ueber weitere Knoten) alle Raum-Objekte angemeldet werden, die auch (normal) gezeichnet werden sollen.

statischeWurzel

public final Knoten statischeWurzel

Die statische Wurzel.
Objekte, die an diesem Knoten angemeldet werden, werden ebenfalls gezeichnet, jedoch mit einem essentiellen Unterschied bei Verschiebung der Kamera werden diese nicht verschoben gezeichnet, sondern bleiben weiter (statisch) auf ihrer festen Position. Dies bietet sich zum Beispiel fuer eine Punkte-Anzeige etc an.

cam

public final Kamera cam

Die Kamera des Spiels.
Dieser kann ueber setzeFokus(Raum m) ein bestimmtes Raum-Objekt immer im Zentrum zeigen. Es gibt auch weitere interessante Methoden dieser Klasse.
Hierzu siehe Handbuch oder Doku.

pfadtrenner

public final java.lang.String pfadtrenner

Dieser String ist immer das korrekte, Systemabhaengige Pfadtrenner-Literal, das ganz einfach bei Pfadangaben verwendet werden kann:

String verzeichnis = "meinOrdner" + "meinDarinLiegenderUnterordner" + "meineDatei.eaf";

Constructor Detail

Game

public Game(int x,
            int y,
            boolean vollbild)

Erstellt ein Spiel, bei dem automatisch beim Drücken von ESC alles beendet wird und ohne Titel.

Parameters:

x - Die Breite des Fensters

y - Die Hoehe des Fensters

vollbild - Ob das Fenster ein echtes Vollbild sein soll.
Manche Computer unterstuetzen kein Vollbild, in diesem Fall wird ein moeglichst grosses Fenster erzeugt.
Im Vollbildmodus nimmt das Fenster den gesamten Bildschirm ein, die Eingabeparameter x und y beschreiben dann die Masse dieses Fensters, der Bildschirm wird also an die gewuenschte X-Y-Groesse angepasst!!!

Game

public Game(int x,
            int y,
            java.lang.String titel,
            boolean vollbild,
            boolean exitOnEsc)

Konstruktor fuer Objekte der Klasse Game. Erstellt unter anderem ein Fenster, das harmonisch im Spielbildschirm liegt.

Parameters:

x - Die Breite des Fensters

y - Die Hoehe des Fensters

titel - Der Titel des Spielfensters

vollbild - Ob das Fenster ein echtes Vollbild sein soll.
Manche Computer unterstuetzen kein Vollbild, in diesem Fall wird ein moeglichst grosses Fenster erzeugt.
Im Vollbildmodus nimmt das Fenster den gesamten Bildschirm ein, die Eingabeparameter x und y beschreiben dann die Masse dieses Fensters, der Bildschirm wird also an die gewuenschte X-Y-Groesse angepasst!!!

exitOnEsc - Ist dieser Wert true, so wird das Spiel automatisch beendet, wenn die "Escape"-Taste gedrueckt wurde. Dies bietet sich vor allem an, wenn das Spiel ein Vollbild ist oder die Maus aufgrund der Verwendung einer Maus im Spiel nicht auf das "X"-Symbol des Fensters geklickt werden kann, wodurch der Benutzer im Spiel "gefangen" waere und dies ist etwas unbeschreiblich aergerliches fuer den Spielbenutzer!!!!!!!!!!!

Game

public Game(int x,
            int y,
            java.lang.String titel,
            boolean vollbild,
            boolean exitOnEsc,
            int fensterX,
            int fensterY)

Groesster Konstruktor fuer Objekte der Klasse Game.

Parameters:

x - Die Breite des Fensters

y - Die Hoehe des Fensters

titel - Der Titel des Spielfensters

vollbild - Ob das Fenster ein echtes Vollbild sein soll.
Manche Computer unterstuetzen kein Vollbild, in diesem Fall wird ein moeglichst grosses Fenster erzeugt.
Im Vollbildmodus nimmt das Fenster den gesamten Bildschirm ein, die Eingabeparameter x und y beschreiben dann die Masse dieses Fensters, der Bildschirm wird also an die gewuenschte X-Y-Groesse angepasst!!!

exitOnEsc - Ist dieser Wert true, so wird das Spiel automatisch beendet, wenn die "Escape"-Taste gedrueckt wurde. Dies bietet sich vor allem an, wenn das Spiel ein Vollbild ist oder die Maus aufgrund der Verwendung einer Maus im Spiel nicht auf das "X"-Symbol des Fensters geklickt werden kann, wodurch der Benutzer im Spiel "gefangen" waere und dies ist etwas unbeschreiblich aergerliches fuer den Spielbenutzer!!!!!!!!!!!

fensterX - Die X-Koordinate der linken oberen Ecke des Fensters auf dem Computerbildschirm

fensterY - Die Y-Koordinate der linken oberen Ecke des Fensters auf dem Computerbildschirm

Game

public Game(int x,
            int y)

Vereinfachter Konstruktor.
Hierbei gilt automatisch, dass das Fenster beim Tastendruck auf "Escape" beendet wird, sowie dass kein Vollbild aktiviert wird.
Ist dies nicht gewuenscht, so muss der komplexere Konstruktor aufgerufen werden. Es wird kein Fenstertitel erstellt.

Parameters:

x - Die Breite des Fensters

y - Die Hoehe des Fenstsers

Game

public Game(int x,
            int y,
            java.lang.String titel)

Vereinfachter Konstruktor.
Hierbei gilt automatisch, dass das Fenster beim Tastendruck auf "Escape" beendet wird, sowie dass kein Vollbild aktiviert wird.
Ist dies nicht gewuenscht, so muss der komplexere Konstruktor aufgerufen werden.

Parameters:

x - Die Breite des Fensters

y - Die Hoehe des Fenstsers

titel - Der Titel des Spielfensters

Game

public Game()

Parameterloser Alternativkonstruktor.
Hierbei wird automatisch ein Spielfenster der Groesse 500 auf 500 (kein Vollbild) erstellt, das bei Tastendruck auf "Escape" beendet wird.

Game

public Game(int x,
            int y,
            java.lang.String titel,
            boolean vollbild)

Etwas vereinfachter Konstruktor.
Hierbei gilt automatisch, dass das Fenster beim Tastendruck auf "Escape" beendet wird.
Ist dies nicht gewuenscht, so muss der komplexere Konstruktor aufgerufen werden.

Parameters:

x - Die Breite des Fensters

y - Die Hoehe des Fenstsers

titel - Der Titel des Spielfensters

vollbild - Ob das Fenster ein echtes Vollbild sein soll.
Manche Computer unterstuetzen kein Vollbild, in diesem Fall wird ein moeglichst grosses Fenster erzeugt.
Im Vollbildmodus nimmt das Fenster den gesamten Bildschirm ein, die Eingabeparameter x und y beschreiben dann die Masse dieses Fensters, der Bildschirm wird also an die gewuenschte X-Y-Groesse angepasst!!!

Method Detail

iconSetzen

public void iconSetzen(Bild icon)

Setzt das übergebene Bild als Icon des Fensters

Parameters:

icon - zu setzendes Icon

reagieren

public void reagieren(int code)

Die aus TastenReagierbar implemetierte Methode zum Reagieren auf einen einfachen, einmaligen Tastendruck.

Specified by:

reagieren in interface TastenReagierbar

Parameters:

code - Der Code dieser Taste zu den Codes:
Siehe http://engine-alpha.org/wiki/Tastaturtabelle für eine vollständige Tabelle

See Also:

Taste

beenden

public void beenden()

Diese Methode beendet das Spiel gaenzlich.
Das heisst, dass das Fenster geschlossen, alle belegten Ressourcen freigegeben und auch die virtuelle Maschine von JAVA beendet wird.
Also beendet diese Methode die gesamte Applikation!

See Also:

schliessen()

tasteReagieren

public abstract void tasteReagieren(int code)

Diese Methode wird von der Klasse automatisch aufgerufen, sobald eine Taste einfach gedrueckt wurde.
Sie wird dann erst wieder aufgerufen, wenn die Taste erst losgelassen und dann wieder gedreuckt wurde.
Sollte allerdings eine Methode vonnoeten sein, die immer wieder in Regelmaessigen abstaenden aufgerufen wird, solange die Taste heruntergedrueckt ist, so bietet sich dies im Interface TasteGedruecktReagierbar an.

Parameters:

code - Code der gedrückten Taste
Siehe http://engine-alpha.org/wiki/Tastaturtabelle für eine vollständige Tabelle

See Also:

TastenReagierbar

eingabeFordern

public java.lang.String eingabeFordern(java.lang.String nachricht)

Fordert vom Benutzer eine Texteingabe (maximal 40 Zeichen) durch ein neues Fenster.
Dieses Fenster muss erst wieder geschlossen werden, damit das Spielfenster wieder in den Vordergrund ruecken kann. Diese Methode ist auch erst dann zu ende, wenn das Fenster geschlossen wurde.

Achtung:
Bei dem Einsatz zusaetzlicher Fenster sollte vor dem Oeffnen eines solchen der Spielbetrieb angehalten werden, da das Fenster nunmehr den Vordergrund abdeckt und die Aufmerksamkeit und den Einfluss (Tastatur, Maus) auf das Spiel wegnimmt.

Parameters:

nachricht - Ein Text, der ebenfalls angezeigt wird und erlaeutern sollte, wozu die Eingabe dient, und was die Eingabe sein sollte.

Returns:

Die Eingabe vom Benutzer.
Wurde das Fenster ueber den "X"-Knopf "gewaltsam" geschlossen, so ist die Rueckgabe null.

sicherheitsFrage

public boolean sicherheitsFrage(java.lang.String frage)

Stellt eine Sicherheitsfrage, also eine Frage auf die mit "OK" oder "Abbrechen" geantwortet werden kann, in einem neuen Fenster.
Dieses Fenster muss erst wieder geschlossen werden, damit das Spielfenster wieder in den Vordergrund ruecken kann. Diese Methode ist auch erst dann zu ende, wenn das Fenster geschlossen wurde.

Achtung:
Bei dem Einsatz zusaetzlicher Fenster sollte vor dem Oeffnen eines solchen der Spielbetrieb angehalten werden, da das Fenster nunmehr den Vordergrund abdeckt und die Aufmerksamkeit und den Einfluss (Tastatur, Maus) auf das Spiel wegnimmt.

Parameters:

frage - Die Frage, die im Fenster angezeigt wird.

Returns:

true, wenn die Frage mit "OK" beantwortet wurde; false, wenn die Frage mit "Abbrechen" beantwortet oder das Fenster geschlossen wurde.

frage

public boolean frage(java.lang.String frage)

Stellt eine einfache Frage, also eine Frage, auf die mit "Ja" oder "Nein" geantwortet werden kann, in einem neuen Fenster.
Dieses Fenster muss erst wieder geschlossen werden, damit das Spielfenster wieder in den Vordergrund ruecken kann. Diese Methode ist auch erst dann zu ende, wenn das Fenster geschlossen wurde.

Achtung:
Bei dem Einsatz zusaetzlicher Fenster sollte vor dem Oeffnen eines solchen der Spielbetrieb angehalten werden, da das Fenster nunmehr den Vordergrund abdeckt und die Aufmerksamkeit und den Einfluss (Tastatur, Maus) auf das Spiel wegnimmt.

Parameters:

frage - Die Frage, die im Fenster angezeigt wird.

Returns:

true, wenn die Frage mit "Ja" beantwortet wurde; false, wenn die Frage mit "Nein" beantwortet oder das Fenster geschlossen wurde.

nachrichtSchicken

public void nachrichtSchicken(java.lang.String nachricht)

Schickt eine einfache Nachricht in einem Fenster nach draussen.
Dieses Fenster muss erst wieder geschlossen werden, damit das Spielfenster wieder in den Vordergrund ruecken kann. Diese Methode ist auch erst dann zu ende, wenn das Fenster geschlossen wurde.

Achtung:
Bei dem Einsatz zusaetzlicher Fenster sollte vor dem Oeffnen eines solchen der Spielbetrieb angehalten werden, da das Fenster nunmehr den Vordergrund abdeckt und die Aufmerksamkeit und den Einfluss (Tastatur, Maus) auf das Spiel wegnimmt.

Parameters:

nachricht - Die Nachricht, die Angezeigt werden soll

highscoreAnzeigen

public void highscoreAnzeigen(java.lang.String[] namen,
                              int[] punkte)

Öffnet ein titelloses Fenster, das die Highscores des Spiels anzeigt.

Parameters:

namen - Die Namen der Liste als Array. Von Index 0 als dem besten bis zum schlechtesten auf der Liste

punkte - Die Punktestaende der Liste als Array. Von Index 0 als dem besten bis zum schlechtesten auf der Liste

See Also:

highscoreAnzeigen(String[], int[])

highscoreAnzeigen

public void highscoreAnzeigen(java.lang.String[] namen,
                              int[] punkte,
                              java.lang.String fenstertitel)

Öffnet ein Fenster, das die Highscores des Spiels anzeigt.

Parameters:

namen - Die Namen der Liste als Array. Von Index 0 als dem besten bis zum schlechtesten auf der Liste

punkte - Die Punktestaende der Liste als Array. Von Index 0 als dem besten bis zum schlechtesten auf der Liste

fenstertitel - Der Titel des sich oeffnenden Fensters. Dieser Parameter kann weggelassen werden, hierfuer gibt es eine alternative Methode, die diesen Titel nicht erwartet.

zufallsBoolean

public boolean zufallsBoolean()

Gibt ein zufälliges boolean-Attribut zurück.
Mit relativ zuverlässiger Sicherheit sind die Wahrscheinlichkeiten für false und true gleich groß.

Returns:

false oder true, mit gleich hoher Wahrscheinlichkeit.

zufallsZahl

public int zufallsZahl(int obergrenze)

Gibt ein zufälliges int-Attribut zwischen 0 und einer festgelegten Obergrenze zurück.
Mit relativ zuverlässiger Sicherheit sind die Wahrscheinlichkeiten für die Werte zwischen 0 und der Obergrenze gleich groß.

Parameters:

obergrenze - Die höchste Zahl, die vorkommen kann.
Die Zahl kann also ebenfalls Ergebnis der Rückgabe sein!

Returns:

Eine Zahl zwischen 0 (inklusiv) und der Obergrenze (inklusiv).
Bei Eingabe einer negativen Zahl ist das Ergebnis 0.

schliessen

public void schliessen()

Beendet dieses Game auf softe weise:
- Das Fenster wird geschlossen
- Die Physik wird beendet (alle bestehenden Raum-Objekte werden automatisch neutral
- Alle Animationen werden beendet
- Der ABER:
-> Die virtuelle Maschine wird nicht beendet.

warten

public void warten(int millisekunden)

Dieser Methodenaufruf dauert eine bestimmte Zeit. So kann man sozusagen eine gewisse Zeit "Pause machen" und warten.

ACHTUNG!
Der Aufruf dieser Methode haelt technisch gesehen diesen Thread an, das bedeutet zum Beispiel, dass - sollte dies in einer Tick-Methode ausgefuehrt werden, alle anderen Ticker nicht aufgerufen werden, bevonr diese Methode beendet ist.

Daher sollte diese Methode nur mit Bedacht verwendet werden!

Parameters:

millisekunden - Die Anzahl an Millisekunden, die dieser Methodenaufruf dauert. So lange "wartet" man also durch den Aufruf dieser Methode.

fensterFontSetzen

public void fensterFontSetzen(java.lang.String fontname)

Setzt den Font, der ab sofort von den Fenstern standartmaessig verwendet wird mit einer Standartgroesse von 12.

Parameters:

fontname - Der Name des zu verwendenden Fonts.
Ein Blick auf das Fontprotokoll (in der Klasse Text ist empfehlenswert!

See Also:

Text

fensterFontSetzen

public void fensterFontSetzen(java.lang.String fontname,
                              int schriftgroesse)

Setzt den Font, der ab sofort von den Fenstern standartmaessig verwendet wird.

Parameters:

fontname - Der Name des zu verwendenden Fonts.
Ein Blick auf das Fontprotokoll (in der Klasse Text ist empfehlenswert!

schriftgroesse - Die Schriftgroesse, in der die texte dargestellt werden sollen.

See Also:

Text

fensterMinimieren

public void fensterMinimieren()

Minimiert das Fenster.
Dadurch wird es in die Taskleiste hinein minimiert.

fensterMaximieren

public void fensterMaximieren()

Maximiert das Fenster.
Dadurch wird es - sofern es sich in der Taskleiste minimiert befindet - wieder maximiert.

tastenReagierbarAnmelden

public void tastenReagierbarAnmelden(TastenReagierbar g)

Meldet ein "TastenReagierbar"-Objekt an. Ab diesem Moment wird seine "reagieren"-Methode immer dann aufgerufen, wenn eine Taste heruntergedrueckt wird.

Parameters:

g - Das anzumeldende TastenReagierbar-Objekt

tasteGedrueckt

public boolean tasteGedrueckt(int code)

Prüft, ob eine bestimmte Taste gerade jetzt heruntergedrückt wird.

Parameters:

code - der Code der zu prüfenden Taste.

Returns:

true, falls die gewählte Taste gerade jetzt heruntergedrückt wird. Sonst false.

tastenLosgelassenReagierbarAnmelden

public void tastenLosgelassenReagierbarAnmelden(TastenLosgelassenReagierbar g)

Meldet ein TastenLosgelassenReagierbar-Objekt an. Ab diesem Moment wird seine "tasteGedrueckt"-Methode immer aufgerufen, wenn eine Taste losgelassen wird.

Parameters:

g - Das anzumeldende TastenLosgelassenReagierbar-Objekt.

tickerAnmelden

public void tickerAnmelden(Ticker ticker,
                           int intervall)

Meldet einen Ticker an. Nach Ausführung dieser Methode wird die tick-Methode dieses Tickers regelmäßig und unerlässlich im angegebenen Intervall ausgeführt.

Parameters:

ticker - Der Ticker, dessen tick-Methode ab sofort regelmäßig ausgeführt werden soll.

intervall - Das Intervall (in Millisekunden), in dem die tick-Methode des angegebenen Tickers ausgeführt werden soll. Zwischen zwei tick-Aufrufen vergehen intervall Millisekunden.

See Also:

tickerAbmelden(Ticker), Ticker

tickerAbmelden

public void tickerAbmelden(Ticker ticker)

Meldet einen (aktiven) Ticker ab. Nach ausführen dieser Methode wird die tick-Methode des übergebenen Ticker-Objekts nicht mehr ausgeführt, bis der Ticker erneut angemeldet wird.

Parameters:

ticker - Der Ticker, dessen tick-Methode ab sofort nicht mehr ausgeführt werden soll. Ist dieser Ticker noch gar nicht angemeldet, wird eine Fehlermeldung ausgegeben.

See Also:

tickerAnmelden(Ticker, int), Ticker

kollisionsReagierbarAnmelden

public void kollisionsReagierbarAnmelden(KollisionsReagierbar reagierbar,
                                         Raum r1,
                                         Raum r2,
                                         int code)

Meldet ein KollisionsReagierbar-Interface an. Ab sofort wird es mit dem spezifizierten code aufgerufen, sollten sich die Raum-Objekte r1 und r2 schneiden.

Parameters:

reagierbar - Das anzumeldende KollisionsReagierbar-Interface, das ab sofort von Kollisionen von r1 und r2 informiert werden soll.

r1 - Ein Raum-Objekt

r2 - Ein zweites Raum-Objekt

code - Ein beliebiger Code. Dieser kann verwendet werden, um mit einem Interface mehrere Kollisionen unterscheidbar zu behandeln. Er wird im Aufruf der kollision(int) als Parameter übergeben.

mausAnmelden

public void mausAnmelden(Maus maus)

Meldet ein Mausobjekt an.
Ab sofort wird die anzumeldende Maus im Fenster dargestellt und Klicks werden auf die Maus uebertragen.

Parameters:

maus - Die anzumeldende Maus

See Also:

Maus

mausAnmelden

public void mausAnmelden(Maus maus,
                         boolean listenerUebernehmen)

Meldet ein Mausobjekt an.
Ab sofort wird die anzumeldende Maus im Fenster dargestellt und Klicks werden auf die Maus uebertragen.

Parameters:

maus - Die anzumeldende Maus

listenerUebernehmen - Ist dieser Wert true, so uebernimmt die neue Maus alle Listener der alten Maus

See Also:

Maus

fensterGroesse

public BoundingRechteck fensterGroesse()

Gibt ein BoundingRechteck zurueck, dass die Masse des Fensters beschreibt.
Die Hoehe und Breite geben die Hoehe und Breite des Fensters wieder. Die Position ist immer (0|0), da dies nicht relevant ist fuer die Masse des Fensters.

Returns:

Das besagte BoundingRechteck mit den Fenstermassen.

hintergrundSetzen

public void hintergrundSetzen(Raum m)

Setzt einen Hintergrund fuer das Spiel.
Das kann ein beliebiges Raum-Objekt sein, vorwiegend bieten sich jedoch Bilder an.
Dieses Objekt wird dann immer im absoluten Hintergrund sein und wird auch weiter entfernt wirken, wenn Bewegungen stattfinden. Daher sollte dieses Objekt nicht in Berechnungen, wie Kollisionstests oder den Physik-Modus, eingebunden werden!



Soll der Hintergrund etwas besonderes sein, das aus vielen Objekten besteht, so bietet es sich an, all diese an einem Knoten zu binden und diesen Knoten hier anzumelden.

Parameters:

m - Das Raum-Objekt, das ab jetzt der Hintergrund sein wird.

ueberblendeSetzen

public void ueberblendeSetzen(boolean aktiv,
                              Farbe farbe)

Setzt, ob das Spiel eine allueberstehende Ueberblende ausfuehren soll, die bis zum widerruf alles ueberdeckt.
Diese ist niemals gaenzlich durchsichtig, da sie nur ueberblendet und nicht ueberdeckt.

Parameters:

aktiv - ob die Blende aktiviert oder deaktiviert werden soll

farbe - Die neue Farbe der Blende

See Also:

ueberblendeSetzen(boolean)

ueberblendeSetzen

public void ueberblendeSetzen(boolean aktiv)

Setzt, ob das Spiel eine allueberstehende Ueberblende ausfuehren soll, die bis zum widerruf alles ueberdeckt.
Diese ist niemals gaenzlich durchsichtig, da sie nur ueberblendet und nicht ueberdeckt.

Parameters:

aktiv - ob die Blende aktiviert oder deaktiviert werden soll

rechenintensiveArbeitSetzen

public void rechenintensiveArbeitSetzen(boolean rechenintensiv)

Setzt, ob die gesamte Engine Alpha rechenintensiv, oder ressourcensparsam arbeiten soll.

IM REGELFALL GILT FOLGENDES:

Die Engine arbeitet auf einem Niveau, das laufzeittechnisch bei normalen Computern standardmäßig funktioniert. Sollte es jedoch Probleme mit der Laufzeit geben (haengender Bildschirm; Zeitverzögerungen, die klar an der Engine und nicht am eigenen Projekt liegen usw.), so sollte mit dieser Methode die rechenintensive Arbeit ausgeschaltet werden.

Standardmaessig ist die Arbeit rechenintensiv.

Parameters:

rechenintensiv - Ist dieser Wert true (Standard), so ist die Arbeit der Engine exakt und rechenintensiv. Ist dieser Wert false (fuer langsame Computer zu empfehlen - aber immer erst testen!!!!), so ist die Arbeit ressourcensparender und ungenauer.

screenshot

public void screenshot(java.lang.String pfad)

Macht vom aktuell sichtbaren Bereich (also dem von der Kamera derzeit erfassten Bereich) einen Screenshot.

Parameters:

pfad - Der Pfad, in dem das Bild gespeichert werden soll. Ein Wert wie screenshot.jpg speichert den Screenshot im Projektordner. Für eingabeabhängige Pfade kann pfadAuswaehlen(String[]) benutzt werden.

ACHTUNG!!
Als Endung wird bisher nur ".jpg" und ".png" unterstützt!

screenshot

public void screenshot(java.lang.String pfad,
                       BoundingRechteck ausschnitt)

Macht einen Screenshot von einem bestimmten Bildbereich und speichert diesen ab.

Parameters:

pfad - Der Pfad, in dem das Bild gespeichert werden soll. Ein Wert wie screenshot.jpg speichert den Screenshot im Projektordner. Für eingabeabhängige Pfade kann pfadAuswaehlen(String[]) benutzt werden.

ACHTUNG!!
Als Endung wird bisher nur ".jpg" und ".png" unterstützt!

ausschnitt - Der Ausschnitt aus der Zeichenebene, der als Bild gespeichert werden soll als BoundingRechteck.

See Also:

pfadAuswaehlen(java.lang.String[]), screenshot(java.lang.String, int, int, int, int)

screenshot

public void screenshot(java.lang.String pfad,
                       int x,
                       int y,
                       int breite,
                       int hoehe)

Macht einen Screenshot von einem bestimmten Bildbereich und speichert diesen ab,

Parameters:

pfad - Der Pfad, in dem das Bild gespeichert werden soll. Ein Wert wie screenshot.jpg speichert den Screenshot im Projektordner. Für eingabeabhängige Pfade kann pfadAuswaehlen(String[]) benutzt werden.

ACHTUNG!!
Als Endung wird bisher nur ".jpg" und ".png" unterstützt!

x - Die X-Koordinate der oberen linken Ecke des Bildausschnitts.

y - Die Y-Koordinate der oberen linken Ecke des Bildausschnitts.

breite - Die gewuenschte Breite des Bildes

hoehe - Die gewuenschte Laenge des Bildes

See Also:

pfadAuswaehlen(java.lang.String[]), screenshot(java.lang.String, ea.BoundingRechteck)

pfadAuswaehlen

public java.lang.String pfadAuswaehlen(java.lang.String... akzeptierteEndungen)

Öffnet einen Such-Dialog, der die Auswahl eines Pfades ermöglicht.

Parameters:

akzeptierteEndungen - Eine Reihe beliebig vieler akzeptierter Endungen (Gross/Kleinschreibung vollkommen egal)
z.B. : pfadAuswaehlen("jpg", "bmp", "gif");
Wird null als Parameter gegeben, so sind saemtliche Dateien waehlbar.
z.B. : pfadAuswaehlen(null);

Returns:

Der Pfad der ausgewaehlten Datei als String. Ist "null", wenn kein Pfad ausgewaehlt wurde, sondern das Fenster manuell geschlossen wurde

kopieren

public boolean kopieren(java.lang.String von,
                        java.lang.String nach,
                        java.lang.String nameNeu)

Diese Methode kopiert eine beliebige Datei von einem Pfad in einen neuen.

Parameters:

von - Das Verzeichnis der Datei, die kopiert werden soll

nach - Das Verzeichnis, in das die Datei kopiert werden soll

nameNeu - Der Name der neuen Datei, die entstehen soll (z.B. "neuedatei.pdf")

Returns:

true, wenn das kopieren vollends erfolgreich war, sonst false.