theater
Class TheaterIcon

java.lang.Object
  theater.TheaterImage
      theater.TheaterIcon

All Implemented Interfaces:

java.io.Serializable

public class TheaterIcon
extends TheaterImage

TheaterIcon ist eine von der Theater-Klasse TheaterImage abgeleitete Klasse, die die Verwendung von Animated-GIF-Ikons ermöglicht.

Achtung: Die meisten Methoden dieser Klasse überschreiben die von der Klasse TheaterImage geerbten Methoden als leere Methoden, da Animated-GIFs nicht manipuliert werden können!

Version:

1.0 (03.11.2009)

Author:

Dietrich Boles, Universität Oldenburg, Germany

See Also:

Serialized Form

Field Summary

Fields inherited from class theater.TheaterImage

transparency

Constructor Summary

TheaterIcon(java.lang.String filename)
Konstruktor zum Initialisieren eines TheaterIcons mit einem Bild aus einer Datei.

Method Summary

void	clear() Löscht ein TheaterImage.
void	drawImage(TheaterIcon image, int x, int y) Zeichnet ein existierendes TheaterImage an einer bestimmten Stelle in das aufgerufene TheaterImage
void	drawLine(int x1, int y1, int x2, int y2) Zeichnet im TheaterImage eine Linie in der aktuellen Zeichenfarbe.
void	drawOval(int x, int y, int width, int height) Zeichnet im TheaterImage ein Oval in der aktuellen Zeichenfarbe.
void	drawPolygon(int[] xPoints, int[] yPoints, int nPoints) Zeichnet im TheaterImage ein Polygon in der aktuellen Zeichenfarbe.
void	drawRect(int x, int y, int width, int height) Zeichnet im TheaterImage ein Rechteck in der aktuellen Zeichenfarbe.
void	drawString(java.lang.String string, int x, int y) Zeichnet im TheaterImage einen Text im aktuell gesetzten Font.
void	fill() Füllt das gesamte TheaterImage in der aktuellen Zeichenfarbe.
void	fillOval(int x, int y, int width, int height) Zeichnet im TheaterImage ein gefülltes Oval in der aktuellen Zeichenfarbe.
void	fillPolygon(int[] xPoints, int[] yPoints, int nPoints) Zeichnet im TheaterImage ein gefülltes Polygon in der aktuellen Zeichenfarbe.
void	fillRect(int x, int y, int width, int height) Zeichnet im TheaterImage ein gefülltes Rechteck in der aktuellen Zeichenfarbe.
java.awt.Image	getAwtImage() Intern wird ein TheaterIcon durch ein Image-Objekt realisiert.
java.awt.Color	getColor() Liefert die aktuelle Zeichenfarbe des TheaterImages.
java.awt.Color	getColorAt(int x, int y) Liefert die Farbe eines bestimmten Pixels des TheaterImages.
java.awt.Font	getFont() Liefert den aktuellen Font des TheaterImages.
int	getHeight() Liefert die Höhe des TheaterImages in Pixeln.
int	getWidth() Liefert die Breite des TheaterImages in Pixeln.
void	mirrorHorizontally() Spiegelt das TheaterImage horizontal.
void	mirrorVertically() Spiegelt das TheaterImage vertikal.
void	rotate(int degrees) Dreht das TheaterImage um eine bestimmte Gradzahl.
void	scale(int width, int height) Skaliert das TheaterImage auf eine bestimmte Größe.
void	setColor(java.awt.Color color) Ordnet dem TheaterImage eine Farbe zu, in der bei Aufruf der draw- bzw.
void	setColorAt(int x, int y, java.awt.Color color) Setzt ein bestimmtes Pixel des TheaterImages auf eine bestimmte Farbe.
void	setFont(java.awt.Font f) Setzt den Font, in dem Texte durch nachfolgende Aufrufe der drawString-Methode in dem TheaterImage gezeichnet werden sollen.

Methods inherited from class theater.TheaterImage

drawImage, getTransparency, setTransparency

Methods inherited from class java.lang.Object

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

Constructor Detail

TheaterIcon

public TheaterIcon(java.lang.String filename)
            throws java.lang.IllegalArgumentException

Konstruktor zum Initialisieren eines TheaterIcons mit einem Bild aus einer Datei. Erlaubte Bildformate sind gif, jpq und png.

Parameters:

filename - Name der Bilddatei; die Datei muss sich im Unterverzeichnis "images" des Theaterstücks befinden

Throws:

java.lang.IllegalArgumentException - wird geworfen, wenn die Datei nicht existiert, keine gültige Bilddatei ist oder nicht lesbar ist

Method Detail

clear

public void clear()

Löscht ein TheaterImage.

Overrides:

clear in class TheaterImage

drawImage

public void drawImage(TheaterIcon image,
                      int x,
                      int y)

Zeichnet ein existierendes TheaterImage an einer bestimmten Stelle in das aufgerufene TheaterImage

Parameters:

image - das TheaterImage, das gezeichnet werden soll (darf nicht null sein)

x - x-Koordinate, an der das Image gezeichnet werden soll

y - y-Koordinate, an der das Image gezeichnet werden soll

drawLine

public void drawLine(int x1,
                     int y1,
                     int x2,
                     int y2)

Zeichnet im TheaterImage eine Linie in der aktuellen Zeichenfarbe.

Overrides:

drawLine in class TheaterImage

Parameters:

x1 - x-Koordinate, von der aus die Linie gezeichnet werden soll

y1 - y-Koordinate, von der aus die Linie gezeichnet werden soll

x2 - x-Koordinate, bis wohin die Linie gezeichnet werden soll

y2 - y-Koordinate, bis wohin die Linie gezeichnet werden soll

drawOval

public void drawOval(int x,
                     int y,
                     int width,
                     int height)

Zeichnet im TheaterImage ein Oval in der aktuellen Zeichenfarbe.

Overrides:

drawOval in class TheaterImage

Parameters:

x - x-Koordinate der linken oberen Ecke des Ovals

y - y-Koordinate der linken oberen Ecke des Ovals

width - Breite des Ovals in Pixeln

height - Höhe des Ovals in Pixeln

drawPolygon

public void drawPolygon(int[] xPoints,
                        int[] yPoints,
                        int nPoints)

Zeichnet im TheaterImage ein Polygon in der aktuellen Zeichenfarbe. Es wird automatisch ein Linie hinzugefügt, die das Polygon schließt.

Overrides:

drawPolygon in class TheaterImage

Parameters:

xPoints - x-Koordinaten der Linien

yPoints - y-Koordinaten der Linien

nPoints - Anzahl der Liniensegmente

drawRect

public void drawRect(int x,
                     int y,
                     int width,
                     int height)

Zeichnet im TheaterImage ein Rechteck in der aktuellen Zeichenfarbe.

Overrides:

drawRect in class TheaterImage

Parameters:

x - x-Koordinate der linken oberen Ecke des Rechtecks

y - y-Koordinate der linken oberen Ecke des Rechtecks

width - Breite des Rechtecks (in Pixeln)

height - Höhe des Rechtecks (in Pixeln)

drawString

public void drawString(java.lang.String string,
                       int x,
                       int y)

Zeichnet im TheaterImage einen Text im aktuell gesetzten Font.

Overrides:

drawString in class TheaterImage

Parameters:

string - der zu zeichnende Text

x - x-Koordinate, an der der Text beginnen soll

y - y-Koordinate, an der der Text beginnen soll

fill

public void fill()

Füllt das gesamte TheaterImage in der aktuellen Zeichenfarbe.

Overrides:

fill in class TheaterImage

fillOval

public void fillOval(int x,
                     int y,
                     int width,
                     int height)

Zeichnet im TheaterImage ein gefülltes Oval in der aktuellen Zeichenfarbe.

Overrides:

fillOval in class TheaterImage

Parameters:

x - x-Koordinate der linken oberen Ecke des Ovals

y - y-Koordinate der linken oberen Ecke des Ovals

width - Breite des Ovals in Pixeln

height - Höhe des Ovals in Pixeln

fillPolygon

public void fillPolygon(int[] xPoints,
                        int[] yPoints,
                        int nPoints)

Zeichnet im TheaterImage ein gefülltes Polygon in der aktuellen Zeichenfarbe. Es wird automatisch ein Linie hinzugefügt, die das Polygon schließt.

Overrides:

fillPolygon in class TheaterImage

Parameters:

xPoints - x-Koordinaten der Linien

yPoints - y-Koordinaten der Linien

nPoints - Anzahl der Liniensegmente

fillRect

public void fillRect(int x,
                     int y,
                     int width,
                     int height)

Zeichnet im TheaterImage ein gefülltes Rechteck in der aktuellen Zeichenfarbe.

Overrides:

fillRect in class TheaterImage

Parameters:

x - x-Koordinate der linken oberen Ecke des Rechtecks

y - y-Koordinate der linken oberen Ecke des Rechtecks

width - Breite des Rechtecks (in Pixeln)

height - Höhe des Rechtecks (in Pixeln)

getAwtImage

public java.awt.Image getAwtImage()

Intern wird ein TheaterIcon durch ein Image-Objekt realisiert. Diese Methode liefert das entsprechende Objekt.

Overrides:

getAwtImage in class TheaterImage

Returns:

das aktuelle interne Image-Objekt

getColor

public java.awt.Color getColor()

Liefert die aktuelle Zeichenfarbe des TheaterImages.

Overrides:

getColor in class TheaterImage

Returns:

die aktuelle Zeichenfarbe des TheaterImages

getColorAt

public java.awt.Color getColorAt(int x,
                                 int y)

Liefert die Farbe eines bestimmten Pixels des TheaterImages.

Overrides:

getColorAt in class TheaterImage

Parameters:

x - x-Koordinate des Pixels

y - y-Koordinate des Pixels

Returns:

die Farbe eines bestimmten Pixels des TheaterImages

getFont

public java.awt.Font getFont()

Liefert den aktuellen Font des TheaterImages.

Overrides:

getFont in class TheaterImage

Returns:

der aktuelle Font des TheaterImages

getHeight

public int getHeight()

Liefert die Höhe des TheaterImages in Pixeln.

Overrides:

getHeight in class TheaterImage

Returns:

die Höhe des TheaterImages in Pixeln

getWidth

public int getWidth()

Liefert die Breite des TheaterImages in Pixeln.

Overrides:

getWidth in class TheaterImage

Returns:

die Breite des TheaterImages in Pixeln

mirrorHorizontally

public void mirrorHorizontally()

Spiegelt das TheaterImage horizontal. Achtung: Die Größe des Bildes wird dabei nicht verändert!

Overrides:

mirrorHorizontally in class TheaterImage

mirrorVertically

public void mirrorVertically()

Spiegelt das TheaterImage vertikal. Achtung: Die Größe des Bildes wird dabei nicht verändert!

Overrides:

mirrorVertically in class TheaterImage

rotate

public void rotate(int degrees)

Dreht das TheaterImage um eine bestimmte Gradzahl. Achtung: Die Größe des Bildes wird dabei nicht verändert!

Overrides:

rotate in class TheaterImage

Parameters:

degrees - Gradzahl der Drehung

scale

public void scale(int width,
                  int height)

Skaliert das TheaterImage auf eine bestimmte Größe.

Overrides:

scale in class TheaterImage

Parameters:

width - die neue Breite des TheaterImages

height - die neue Höhe des TheaterImages

setColor

public void setColor(java.awt.Color color)

Ordnet dem TheaterImage eine Farbe zu, in der bei Aufruf der draw- bzw. fill-Methoden die entsprechenden Graphik-Primitiven gezeichnet werden.

Overrides:

setColor in class TheaterImage

Parameters:

color - die neue Zeichenfarbe

setColorAt

public void setColorAt(int x,
                       int y,
                       java.awt.Color color)

Setzt ein bestimmtes Pixel des TheaterImages auf eine bestimmte Farbe.

Overrides:

setColorAt in class TheaterImage

Parameters:

x - x-Koordinate des Pixels

y - y-Koordinate des Pixels

color - neue Farbe des Pixels

setFont

public void setFont(java.awt.Font f)

Setzt den Font, in dem Texte durch nachfolgende Aufrufe der drawString-Methode in dem TheaterImage gezeichnet werden sollen.

Overrides:

setFont in class TheaterImage

Parameters:

f - der neue Font