ea.edu

Class SPIEL

java.lang.Object

ea.edu.SPIEL

public class SPIEL
extends java.lang.Object

Die Klasse SPIEL ist ein Template, das so wie es ist an Schueler ausgegeben werden kann. (Einzige Voraussetzung ist, dass die engine-alpha-Bibliothek im Suchpfad erreichbar ist.) Es startet alles Notwendige fuer ein Spiel.

Beim Konstruktor ohne Parameter gibt es keine Punkte-Anzeigen und auch keine Maus-Interaktion. Die Methoden tick() und tasteReagieren() werden immer automatisch aufgerufen.

Beim Konstruktor mit Parametern koennen die linken und rechten Punkte-Anzeigen sowie die Interaktion mit der Maus ein- bzw. ausgeschaltet werden.

Author:

Michael Andonie (nach Idee von Bendikt Lindemann und Mike Ganshorn), Niklas Keller

Constructor Summary

Constructors

Constructor and Description
SPIEL() Erstellt ein einfaches Spiel ohne Anzeige und Maus. Das Spiel hat somit Ticker und Tastatureingaben.
SPIEL(int breite, int hoehe, boolean punkteLinks, boolean punkteRechts, boolean maus) Erstellt ein Spiel.
SPIEL(int breite, int hoehe, boolean punkteLinks, boolean punkteRechts, boolean maus, boolean tickerAnmelden) Erstellt ein Spiel.

Method Summary

Modifier and Type	Method and Description
void	allePunkteSichtbar() Sorgt dafuer, dass sowohl der rechte als auch der linke Punktestand sichtbar ist.
void	allePunkteUnsichtbar() Sorgt dafuer, dass weder der rechte noch der linke Punktestand sichtbar ist.
void	hintergrundgrafikSetzen(java.lang.String pfad) Setzt eine Hintergrundgrafik fuer das Spiel.
void	klickReagieren(int x, int y) Wird bei jedem Mausklick (Linksklick) automatisch aufgerufen.
void	mausIconSetzen(java.lang.String pfad, int hotspotX, int hotspotY) Setzt ein neues Maus-Icon.
void	nurLinkePunkteSichtbar() Sorgt dafuer, dass nur der rechte Punktestand sichtbar ist.
void	nurRechtePunkteSichtbar() Sorgt dafuer, dass nur der linke Punktestand sichtbar ist.
void	punkteLinksSetzen(int pl) Setzt den linken Punktestand.
void	punkteRechtsSetzen(int pr) Setzt den rechten Punktestand.
void	setzeFarbePunktestand(java.lang.String farbe)
void	tasteReagieren(int tastenkuerzel) Wird bei jedem Tastendruck automatisch aufgerufen.
void	tick() Wird regelmäßig aufgerufen.
void	tickerIntervallSetzen(int ms) Setzt das Ticker-Intervall.
void	tickerNeuStarten(int ms) Startet den Ticker neu.
void	tickerStarten()
void	tickerStarten(int ms)
void	tickerStoppen() Stoppt die Ticker-Funktion.
int	zufallszahlVonBis(int von, int bis) Gibt eine Zufallszahl aus.

Methods inherited from class java.lang.Object

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

Constructor Detail

SPIEL

@API
public SPIEL()

Erstellt ein einfaches Spiel ohne Anzeige und Maus.
Das Spiel hat somit Ticker und Tastatureingaben.

SPIEL

@API
public SPIEL(int breite,
                  int hoehe,
                  boolean punkteLinks,
                  boolean punkteRechts,
                  boolean maus)

Erstellt ein Spiel. Startet die Anzeige.

Parameters:

punkteLinks - ist dieser Wert true, so sieht man links eine Punkteanzeige. Ist er false sieht man keine.

punkteRechts - ist dieser Wert true, so sieht man rechts eine Punkteanzeige. Ist er false sieht man keine.

maus - ist dieser Wert true, wird eine Maus im Spiel angezeigt und verwendet. Ist er false, gibt es keine Maus.

SPIEL

@API
public SPIEL(int breite,
                  int hoehe,
                  boolean punkteLinks,
                  boolean punkteRechts,
                  boolean maus,
                  boolean tickerAnmelden)

Erstellt ein Spiel. Startet die Anzeige.

Parameters:

punkteLinks - ist dieser Wert true, so sieht man links eine Punkteanzeige. Ist er false sieht man keine.

punkteRechts - ist dieser Wert true, so sieht man rechts eine Punkteanzeige. Ist er false sieht man keine.

maus - ist dieser Wert true, wird eine Maus im Spiel angezeigt und verwendet. Ist er false, gibt es keine Maus.

Method Detail

tick

public void tick()

Wird regelmäßig aufgerufen. So kommt Bewegung ins Spiel!

klickReagieren

public void klickReagieren(int x,
                           int y)

Wird bei jedem Mausklick (Linksklick) automatisch aufgerufen.

Parameters:

x - Die X-Koordinate des Klicks

y - Die Y-Koordinate des Klicks

tasteReagieren

public void tasteReagieren(int tastenkuerzel)

Wird bei jedem Tastendruck automatisch aufgerufen.

Parameters:

tastenkuerzel - Der int-Wert, der fuer die gedrueckte Taste steht. Details koennen in der Tabelle aller Tastaturkuerzel abgelesen werden.

tickerIntervallSetzen

@API
public void tickerIntervallSetzen(int ms)

Setzt das Ticker-Intervall.

Parameters:

ms - Die Zeit in Millisekunden zwischen zwei Aufrufen der tick()-Methode.

tickerStoppen

@API
public void tickerStoppen()

Stoppt die Ticker-Funktion. Die tick()-Methode wird nicht weiter aufgerufen. Der automatische Aufruf der tick()-Methode kann durch die Methode tickerNeuStarten(int ms) wiedergestartet werden.

See Also:

tickerNeuStarten(int)

tickerNeuStarten

@API
public void tickerNeuStarten(int ms)

Startet den Ticker neu.

Parameters:

ms - Die Zeit in Millisekunden zwischen zwei Aufrufen der tick()-Methode.

tickerStarten

@API
public void tickerStarten()

tickerStarten

@API
public void tickerStarten(int ms)

mausIconSetzen

@API
public void mausIconSetzen(java.lang.String pfad,
                                int hotspotX,
                                int hotspotY)

Setzt ein neues Maus-Icon.

Parameters:

pfad - Der Pfad zu dem Bild (jpg, bmp, png), das das neue Maus-Icon werden soll. ZB: "mausicon.png"

hotspotX - Die X-Koordinate des Hotspots fuer das neue Maus-Icon. (relativ im Icon)

hotspotY - Die Y-Koordinate des Hotspots fuer das neue Maus-Icon. (relativ im Icon)

allePunkteSichtbar

@API
public void allePunkteSichtbar()

Sorgt dafuer, dass sowohl der rechte als auch der linke Punktestand sichtbar ist.

nurRechtePunkteSichtbar

@API
public void nurRechtePunkteSichtbar()

Sorgt dafuer, dass nur der linke Punktestand sichtbar ist.

nurLinkePunkteSichtbar

@API
public void nurLinkePunkteSichtbar()

Sorgt dafuer, dass nur der rechte Punktestand sichtbar ist.

allePunkteUnsichtbar

@API
public void allePunkteUnsichtbar()

Sorgt dafuer, dass weder der rechte noch der linke Punktestand sichtbar ist.

punkteLinksSetzen

@API
public void punkteLinksSetzen(int pl)

Setzt den linken Punktestand. Aenderungen sind nur sichtbar, wenn auch der linke Punktestand sichtbar ist.

Parameters:

pl - Der neue linke Punktestand.

punkteRechtsSetzen

@API
public void punkteRechtsSetzen(int pr)

Setzt den rechten Punktestand. Aenderungen sind nur sichtbar, wenn auch der rechte Punktestand sichtbar ist.

Parameters:

pr - Der neue rechte Punktestand.

setzeFarbePunktestand

public void setzeFarbePunktestand(java.lang.String farbe)

Parameters:

farbe - Die neue Farbe der Punkteanzeige

zufallszahlVonBis

@API
public int zufallszahlVonBis(int von,
                                  int bis)

Gibt eine Zufallszahl aus.

Parameters:

von - Die Untergrenze der Zufallszahl (INKLUSIVE)

bis - Die Obergrenze der Zufallszahl (INKLUSIVE)

Returns:

Eine Zufallszahl z mit: von <= z <= bis

hintergrundgrafikSetzen

@API
public void hintergrundgrafikSetzen(java.lang.String pfad)

Setzt eine Hintergrundgrafik fuer das Spiel.

Parameters:

pfad - Der Pfad der Bilddatei (jpg, bmp, png) des Bildes, das benutzt werden soll. ZB: "hintergrund.jpg"