theater
Class TheaterIcon

java.lang.Object
  extended by theater.TheaterImage
      extended by 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