Article : Swing Graphics

Swing Graphics

---

Introduction

To do custom graphics in an applet or application, you will almost always write a new class that extends theJPanelclass. In that class, you override the definition of thepaintComponent()method. This method should have the following form.

    public void paintComponent(Graphics g) {
      super.paintComponent(g);
      drawing messages sent to g
    }
    

The kinds of messages that you can send togare described in the next section.

In addition, if the drawings need to be updated while the applet or application is running then you need to invoke the following method.

• void repaint()

This method can be invoked from within the JPanel subclass or from another object.

Colorcolor)

void setFont(Fontfont)

void drawString(Stringtext, int x, int y)

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

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

void drawRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight)

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

void drawArc(int x, int y, int width, int height, int startAngle, int angularExtent)

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

void fillRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight)

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

void fillArc(int x, int y, int width, int height, int startAngle, int angularExtent)

The meanings of the parameters is most easily understood by working with theGraphics Demoapplet.

A Custom Graphics Template

Here is a template for a custom graphics JPanel subclass.

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

    public class ClassName
    extends JPanel {

      instance variable declarations

      helper methods

      public constructors

      public methods for communication

      public void paintComponent(Graphics g) {
        super.paintComponent(g);
        drawing messages sent to g
      }

    }
    

Java 2D Graphics

The graphics that you can do with a Graphics object is primitive. You cannot use real number coordinates. You cannot draw dotted or dashed lines or lines with varying widths. You cannot easily draw complex curves or draw or fill complex shapes. You cannot use textures or gradient colors for filling shapes.

To address these limitations, Sun introduced the Graphics2D class into its class libraries. This class extends the Graphics class, so all of the Graphics methods can be used with a Graphics2D object.

Sun also modified the implementation of its graphical user interface components so that they used a Graphics2D object instead of a Graphics object. To maintain compatibility with existing code, the paint methods are still declared with a Graphics parameter, but a Graphics2D object is actually passed.

To use the Graphics2D capabilities in a JPanel subclass, you need to have a variable of type Graphics2D. This can be obtained by coercing the paint method parameter. For example, you can modify thepaintComponent()method in the above template as follows.

    public void paintComponent(Graphics g) {
	super.paintComponent(g);
	Graphics2D g2d = (Graphics2D)g;
	drawing messages sent to g2d
    }
    

In this code,gandg2dactually refer to the same object, which is an instance of the Graphics2D class. They differ only in the variable types, which determines the operations allowed by a Java compiler. A compiler will allow asetStroke()(see the next section) message to be sent tog2d, but not tog. The reason is thatsetStroke()is a Graphics2D method but not a Graphics method.

Strokestrk)

Stroke is an inteface defined in the java.awt package. Since it is an interface, you cannot directly construct one. Instead, you construct an instance of a class that implements the Stroke interface. The only direct implementing class is the BasicStoke class, which is described in the next section.

PaintingandWorking with Graphics. For more information on Java 2D graphics, see2D Graphics. You can also check the documentation for the Java APIs for thejava.awtandjava.awt.geompackages.