10.7 Weitere Eigenschaften von Graphics *

10.7.1 Eine Kopie von Graphics erstellen

Das Zeichensystem übergibt an die paintXXX()-Methoden ein Graphics-Objekt, das wir zum Zeichnen oft verändern, etwa um eine Farbe für nachfolgende Operationen zu setzen. Stehen eigene Zeichenmethoden jedoch nicht am Ende der Zeichenfolge, ist es wichtig, den Grafikkontext so zu restaurieren, wie er am Anfang war, um nachfolgende Zeichenoperationen nicht zu beeinflussen. Wichtig ist dies etwa bei Swing-Komponenten, wo paint() der Reihe nach die Methoden

• protected void paintComponent(Graphics g)
• protected void paintBorder(Graphics g)
• protected void paintChildren(Graphics g)

aufruft. Nun lässt sich leicht ausmalen, was passiert, wenn unsere Methode paintComponent() ein verhunztes Graphics-Objekt hinterlässt.

Die erste Lösung ist, sich die alten Zustände zu merken und später das Objekt auf diese zurückzusetzen:

Color oldColor = g.getColor();
g.setColor( newColor );
...
g.setColor( oldColor );        // Farbe zurücksetzen

Bei wenigen Eigenschaften funktioniert das gut, doch werden es mehr, ist es sinnvoller, eine Kopie aller Zustände des Grafikkontextes vorzunehmen. Dazu dient die Methode create(). Von großer Wichtigkeit ist hier, diesen temporären Kontext auf jeden Fall mit dispose() wieder freizugeben, um keinen Speicherplatz zu blockieren:

@Override protected void paintComponent( Graphics g )
Graphics gcopy = g.create();   // Kopie erfragen
try
{
  gcopy.draw...                // Alle Zeichenoperationen über gcopy
}
finally
{
  gcopy.dispose();             // Kopie freigeben
}

Ist definitiv keine Ausnahme zu erwarten, kann der try-Block entfallen; er ist aber ein gutes Sicherheitsnetz.

10.7.2 Koordinatensystem verschieben

Standardmäßig liegt der Koordinatenursprung bei (0,0), also in der oberen linken Ecke. Zum Verschieben des Ursprungs an eine neue Position dient die Graphics-Methode translate(int x, int y). Alle nachfolgenden Zeichenoperationen werden dann relativ zu x, y sein, was auch den Vorteil hat, dass negative Koordinaten bei Zeichenmethoden möglich sind. Soll etwa ein Graph in ein Rechteck x = [-10...+10], y = [-10...10] gezeichnet werden, so ist es viel praktischer, den Koordinatenursprung in die Mitte zu legen.

Da Graphics2D vor dem Zeichnen beliebige affine Transformationen anwenden kann, kommen unter Graphics2D noch einige Methoden hinzu:

• rotate(double theta)
• rotate(double theta, double x, double y)
• scale(double sx, double sy)
• setTransform(AffineTransform Tx)
• shear(double shx, double shy)
• transform(AffineTransform Tx)
• translate(double tx, double ty)

10.7.3 Beschnitt (Clipping)

Alle primitiven Zeichenoperationen wirken sich auf den gesamten Bildschirm aus und sind nicht auf bestimmte Bereiche eingeschränkt. Wenn wir Letzteres erreichen wollen, setzen wir einen sogenannten Clipping-Bereich, außerhalb dessen nicht mehr gezeichnet wird. Der Beschnittbereich lässt sich mit zwei Methoden des aktuellen Graphic-Objekts modifizieren beziehungsweise einschränken:

abstract class java.awt.Graphics

• abstract void setClip(int x, int y, int width, int height)
  Setzt den neuen Beschnittbereich, sodass gezeichnete Zeilen außerhalb des Bereichs nicht sichtbar sind.
• abstract void clipRect(int x, int y, int width, int height)
  Verkleinert den Beschnittbereich, indem der aktuelle Bereich (getClip()) mit dem übergebenen Rechteck geschnitten wird. Wurde vorher kein Beschnittbereich festgelegt – getClip() lieferte null –, ist clipRect() mit setClip() identisch.

Das folgende Programm setzt den ersten Clipping-Bereich mit setClip(100, 100, 100, 200). Das Füllen eines sehr großen Bereichs wird dann lokal nur im Beschnittbereich ausgeführt. Anschließend verkleinert clipRect(0, 200, 150, 50) den Bereich, doch obwohl x bei 0 beginnt, hat schon setClip() ihn bei 100 gesetzt, sodass die Verbindung der beiden Bereiche (100, 100, 100, 200) geschnitten (0, 200, 150, 50) = (100, 200, 50, 50) ergibt:

Listing 10.24: com/tutego/insel/ui/graphics/ClipDemo.java

package com.tutego.insel.ui.graphics;

import java.awt.*;
import javax.swing.*;

public class ClipDemo extends JPanel
{
  private static final long serialVersionUID = 3020598670163407618L;
  @Override protected void paintComponent( Graphics g )
  {
    super.paintComponent( g );

    Graphics gcopy = g.create();

    // Set first clipping region. clipRect() is also possible.
    g.setClip( 100, 100, 100, 200 );            // setClip()

    g.setColor( Color.ORANGE );
    g.fillRect( 0, 0, getWidth(), getHeight() );
    g.setColor( Color.BLACK );
    g.drawOval( 150, 100, 100, 100 );

    // Second clipping region.
    g.clipRect( 0, 200, 150, 50 );              // clipRect()

    g.setColor( Color.BLUE );
    g.fillRect( 0, 0, 5000, 5000 );

    // With gcopy we are working with original settings.

    gcopy.setColor( Color.GREEN );
    gcopy.fillRect( 50, 50, 20, 50 );

    gcopy.dispose();
  }

  public static void main( String[] args )
  {
    JFrame f = new JFrame();
    f.setDefaultCloseOperation( JFrame.EXIT_ON_CLOSE );
    f.setSize( 400, 400 );
    f.add( new ClipDemo() );
    f.setVisible( true );
  }
}

Abbildung 10.27: Screenshot der Anwendung zeigt Clipping-Bereiche

Alternative Formen

Durch setClip() können alternativ zu den rechteckigen Formen auch beliebige Shape-Objekte die Clipping-Form vorgeben. Die folgende paintComponent()-Methode benutzt als Beschnitt ein Dreieck:

Listing 10.25: com/tutego/insel/ui/graphics/ClipTri.java, Ausschnitt

@Override protected void paintComponent( Graphics g )
{
  super.paintComponent( g );

  Rectangle r = g.getClipBounds();

  System.out.println( r );

  Polygon p = new Polygon(            // Dreieck
      new int[] { 200, 100, 300 },
      new int[] { 100, 300, 300},
      3 );

  g.setClip( p );

  g.setColor( Color.ORANGE );
  g.fillRect( 0, 0, 500, 500 );
}

Verdeckte Bereiche und schnelles Bildschirm-Erneuern

Clipping-Bereiche sind nicht nur zum Einschränken der Primitiv-Operationen sinnvoll. Bei Bereichsüberdeckungen in Fenstern liefern sie wertvolle Informationen über den neu zu zeichnenden Bereich. Bei einer guten Applikation wird nur der Teil wirklich neu gezeichnet, der auch überdeckt wurde. So lässt sich Rechenzeit sparen.

@Override public void paint( Graphics g )
{
  Rectangle r = g.getClipBounds();
  System.out.println( r );
}

java.awt.Rectangle[x=4,y=23,width=392,height=373]
java.awt.Rectangle[x=104,y=87,width=292,height=309]
java.awt.Rectangle[x=104,y=87,width=286,height=211]
java.awt.Rectangle[x=104,y=87,width=243,height=196]
java.awt.Rectangle[x=104,y=87,width=221,height=219]
java.awt.Rectangle[x=101,y=89,width=221,height=219]
...

Die Rectangle-Informationen geben Aufschluss über die Größe der neu zu zeichnenden Bereiche. Haben wir schon daran gedacht, die Information in einem Image-Objekt abzulegen, lässt sich wunderbar drawImage(Image img, int dx1, int dy1, int dx2, int dy2, int sx1, int sy1, int sx2, int sy2, ImageObserver observer) nutzen. Hier müssen wir die Werte aus dem Rectangle auslesen und in drawImage() übertragen. getClipBounds() liefert ein Rectangle-Objekt, dessen Werte für drawImage() nötig sind. Da jedoch auch beliebige Formen möglich sind, liefert getClip() ein Shape-Objekt. getClipRect() ist die veraltete Methode zu getClipBounds(), sonst aber identisch. Die Methode getClipBounds(Rectangle) – eine der wenigen nicht abstrakten Methoden in Graphics – legt die Informationen im übergebenen Rectangle-Objekt ab, das auch zurückgeliefert wird. Sie ruft nur getClipBounds() auf und überträgt die vier Attribute in das Rechteck.

Im Übrigen: In der paint()-Methode ist es oft klug, mit clipRect() den Bereich einzuschränken, anstatt ihn mit setClip() zu setzen, denn er könnte schon relativ klein sein; setClip() könnte den Beschnittbereich größer machen und unnötige Zeichenoperationen erzwingen.

10.7.4 Zeichenhinweise durch RenderingHints

Bisher haben wir stillschweigend eine Zeile eingefügt, die das Antialiasing (eine Art Weichzeichnen) einschaltet. Dadurch erscheinen die Bildpunkte weicher nebeneinander, sind aber etwas dicker, weil in der Nachbarschaft Pixel eingefügt werden.

g2.setRenderingHint( RenderingHints.KEY_ANTIALIASING,
                     RenderingHints.VALUE_ANTIALIAS_ON );

In der Programmzeile nutzen wir die setRenderingHint()-Methode der Klasse Graphics2D. Die Methode nimmt immer einen Schlüssel (daher beginnen die Konstanten mit KEY_XXX) und einen Wert (VALUE_XXX).

abstract class java.awt.Graphics2D
extends Graphics

• abstract void setRenderingHint(RenderingHints.Key hintKey, Object hintValue)
  Setzt eine Eigenschaft des Rendering-Algorithmus.

Im Beispiel setzen wir den Hinweis auf das ANTIALIASING. Da durch das Weichzeichnen mehr Rechenaufwand nötig ist, empfiehlt es sich, für eine schnelle Grafikausgabe auf das Antialiasing zu verzichten. Um dies zu erreichen, übergeben wir den Schlüssel ANTIALIAS_OFF als zweites Argument. Weitere Hinweise sind etwa:

• KEY_ALPHA_INTERPOLATION, KEY_COLOR_RENDERING, KEY_DITHERING, KEY_FRACTIONALMETRICS, KEY_INTERPOLATION, KEY_RENDERING, KEY_TEXT_ANTIALIASING

Mit dem RENDERING-Schlüssel können wir zum Beispiel die Geschwindigkeit bestimmen, die direkt mit der Qualität der Ausgabe korreliert.

10.7.5 Transformationen mit einem AffineTransform-Objekt

Eine affine Transformation eines Objekts ist entweder eine Translation (Verschiebung), Rotation, Skalierung oder Scherung[85](Ein Objekt wird geschert, wenn es entlang einer Koordinatenachse verzogen wird. Im Zweidimensionalen gibt es zwei Scherungsarten: entlang der x-Achse und entlang der y-Achse.). Bei diesen Transformationen bleiben parallele Linien nach der Transformation auch parallel. Um diese Operationen durchzuführen, existiert eine Klasse AffineTransform. Transformationen kommen an unterschiedlichen Stellen in der Grafik-Bibliothek zum Einsatz, unter anderem hier:

• Einem Graphics2D-Kontext weist setTransform() eine Transformation zu. Jede anschließend mit drawXXX() oder fillXXX() dargestellte Form wird vor dem Zeichnen über die Transformationsangaben angepasst.
• Zum Zeichnen von Grafiken kann bei drawImage() ein AffineTransform-Objekt übergeben werden; die Transformation gilt dann ausschließlich für das Bild.
• Bei der Methode deriveFont() bestimmt ein übergebenes AffineTransform-Objekt die Eigenschaften eines neuen Fonts.

Translation, Rotation, Skalierung oder Scherung

Die zweidimensionalen Objekte können durch die Operationen Translation, Rotation, Skalierung oder Scherung verändert werden. Diese Operationen sind durch eine 3×3-Matrix gekennzeichnet. Die Klasse AffineTransform bietet nun Methoden an, damit wir diese Matrix selbst erzeugen können, sowie Hilfsmethoden, die uns die Arbeit abnehmen:

AffineTransform trans = new AffineTransform();
trans.rotate( 0.1 );
g2.setTransform( trans );
g2.fill( new Rectangle2D.Float( 150, 100, 60, 60 ) );

Konstruktoren der Klasse AffineTransform

Die Klasse AffineTransform besitzt sechs Konstruktoren: zunächst einen Standard-Konstruktor und einen Konstruktor mit einem schon vorhandenen AffineTransform-Objekt, dann jeweils einen Konstruktor für eine Matrix mit dem Datentyp float und mit dem Datentyp double sowie zwei Konstruktoren mit allen sechs Werten der Matrix für float und double. Eine eigene Matrix ist nur dann sinnvoll, wenn wir mehrere Operationen hintereinander ausführen lassen wollen. So nutzen wir in der Regel den Standard-Konstruktor wie oben und ändern die Form durch die Methoden rotate(), scale(), shear() oder translate(). Wird nach dem Erzeugen des AffineTransform-Objekts direkt eine der Methoden aufgerufen, geht dies auch einfacher über die statischen Erzeugungsmethoden getRotateInstance(), getScaledInstance(), getShearInstance() und getTranslateInstance(). Sie füllen dann die Matrix mit den passenden Einträgen. Ein Transformationsobjekt kann mit setToIdentity() wieder initialisiert werden, sodass AffineTransform wieder verwendbar ist.

Abbildung 10.28: UML-Diagramm für die AffineTransform

Ihr Kommentar

Wie hat Ihnen das <openbook> gefallen? Wir freuen uns immer über Ihre freundlichen und kritischen Rückmeldungen.