Aegidius
 Plüss   Aplulogo
     
 www.aplu.ch      Print Text 
© 2021, V10.4
 
  JGameGrid
 
  The source code of all examples is included in the JGameGrid distribution.

 

JGameGrid's GGPanel Graphics

The JGameGrid framework is dedicated to gaming but it's frame window may also be used to display simple graphics with a friendly user definable double coordinate system similar to the GPanel class in the ch.aplu.util package. Such graphics tools are frequently used in introductory programming courses because they hides the tedious code for creating and managing the GUI window. In JGameGrid the GPanel class becomes GGPanel (with the GG prefix like most other framework classes). The documentation shows that GGPanel is a thin but comfortable layer on the Graphics2D Java API class. Animation is supported because GGPanel uses a double-buffered concept: all drawing methods actually draw into a background buffer and the whole buffer is rendered on the screen by calling refresh(). If not disabled by setRefreshEnabled(false), refresh() is automatically called by each graphics method so the drawing appears incrementally. The double-buffering also avoids flickering.

In typical situations you proceed as follows:

  • Create a GameGrid instance with a one pixel grid and given horizontal and vertical size
  • Select the background color different to black by calling setBgColor()
  • Call show() to make the window visible
  • Get a GGPanel reference by calling GameGrid's getPanel() method
  • Call GGPanel's window(xmin, xmax, ymin, ymax) to define the double coordinate system (keep in mind that the parameters are coordinate system x-y spans and not the upper-left/lower-right vertex coordinates)
  • Use this reference to draw into the GameGrid window

In the first example we draw (once again) the famous Moiré pattern. To prolongate the pleasure we slow down the execution by waiting a moment after drawing each line.

import ch.aplu.jgamegrid.*;
import java.awt.*;

public class Moire extends GameGrid
{
  private GGPanel p;

  public Moire()
  {
    super(500, 500);
    setBgColor(Color.white);
    show();
    p = getPanel();
    p.window(0, 10, 0, 10);
    p.color(Color.black);
    for (int i = 0; i <= 10; i++)
    {
      for (int k = 0; k <= 10; k++)
      {
        p.line(i, 0, k, 10);
        delay(100);
      }
    }

    for (int i = 0; i <= 10; i++)
    {
      for (int k = 0; k <= 10; k++)
      {
        p.line(0, i, 10, k);
        delay(100);
      }
    }
  }

  public static void main(String[] args)
  {
    new Moire();
  }
}

Execute the program locally using WebStart.

Moire

 

The next example demonstrates how easy you draw a chessboard. Try it.

import ch.aplu.jgamegrid.*;

public class Chessboard extends GameGrid
{
  public Chessboard()
  {
    super(500500);
    show();
    GGPanel p = getPanel();
    p.window(0808);

    for (int i = 0; i < 8; i++)
      for (int j = 0; j < 8; j++)
        if ((+ j) % 2 == 0)
          p.rectangle(i, j, i + 1, j + 1true);
    p.line(0888);
  }

  public static void main(String[] args)
  {
    new Chessboard();
  }
}

Execute the program locally using WebStart.

Chessboard

 

Fractals are not only a subject of mathematical research but provide a great motivation and lot of fun for many computer programming courses. Fractals also enriches computer courses because of their great aesthetic appeal. Most of them use complex numbers which is unfortunately not a built-in data type in Java. So we use the Complex class of the package ch.aplu.util. The following example shows the creation of a fern leave.

import ch.aplu.jgamegrid.*;
import java.awt.*;
import java.util.*;
import ch.aplu.util.Complex;

public class Fern extends GameGrid
{
  private GGPanel p;

  public Fern()
  {
    super(400600);
    p = getPanel();
    show();
    fern(20000);
  }

  private void fern(int nbIterations)
  {
    setTitle("Creating Fern...");
    p.window(-3.53.5010);
    Complex z = new Complex(00);
    int it = 0;
    Random rnd = new Random();

    while (it <= nbIterations)
    {
      delay(5);
      if (it % 1000 == 0)
        p.color(Color.WHITE);
      double r = rnd.nextDouble();
      Color color = Color.BLACK;

      if (< 0.01)
      {
        color = Color.ORANGE;
        z = f(z, 0000.1600)// Stem
      }
      else
      {
        if (< 0.86)
        {
          color = Color.GREEN;
          z = f(z, 0.850.04-0.040.8501.60)// symmetry
        }
        else
        {
          if (>= 0.86 && r < 0.93)
          {
            color = Color.RED;
            z = f(z, 0.20-0.260.230.2201.60)// left leaves
          }
          else
          {
            if (>= 0.93)
            {
              color = Color.BLUE;
              z = f(z, -0.150.280.260.2401.44)// right leaves
            }
          }
        }
      }
      p.color(color);
      p.point(z.real, z.img);
      it++;
    }
    setTitle("Creating Fern...Done.");
  }

  private Complex f(Complex z,
    double a, double b, double c, double d, double e, double f)
  {
    double re = a * z.real + b * z.img + e;
    double im = c * z.real + d * z.img + f;
    return new Complex(re, im);
  }
  
  public static void main(String[] args)
  {
    new Fern();
  }
}

Execute the program locally using WebStart.

Fern

 

Another famous fractal is the Mandelbrot set where f(z) = z * z + c is iterated in every grid point of the complex plane until the magnitude exceeds a certain limit. Then the color of that particular point is drawn depending on the number of iterations. One of the fractal's property is self-similarity that is shown in the following example where a part of the fractal image can be selected by a mouse drag and is same algorithm is applied to the selected area (not to be mistaken for a simple zoom operation).

import ch.aplu.jgamegrid.*;
import ch.aplu.util.*;
import java.awt.Color;
import java.awt.event.*;

public class Mandelbrot extends GameGrid
  implements MouseListenerMouseMotionListener
{
  private final int maxIterations = 50;
  private final double res = 800;
  private GGPanel p;
  private double xStart;
  private double yStart;
  private double xEnd;
  private double yEnd;
  private boolean isDrawing = false;

  public Mandelbrot()
  {
    super(500500);
    show();
    p = getPanel();
    p.setRefreshEnabled(false);
    addMouseListener(this);
    addMouseMotionListener(this);

    draw(-22-22);
    while (true)
    {
      Monitor.putSleep();
      p.clear();
      refresh();
      double xmin = Math.min(xStart, xEnd);
      double xmax = Math.max(xStart, xEnd);
      double ymin = Math.min(yStart, yEnd);
      double ymax = Math.max(yStart, yEnd);
      draw(xmin, xmax, ymin, ymax);
    }
  }

  private void draw(double xmin, double xmax, double ymin, double ymax)
  {
    isDrawing = true;
    setTitle("Working. Please wait...");
    p.window(xmin, xmax, ymin, ymax);
    double span = xmax - xmin;
    Complex vector = new Complex(xmin, ymin);
    for (double i = 0; i < res; i++)
    {
      for (double j = 0; j < res; j++)
      {
        Complex c = new Complex(span / res * i, span / res * j);
        c.add(vector);
        Complex z = new Complex(00);
        int k = 0;
        while (z.modulus() < 2 && k < maxIterations)
        {
          // z = z * z + c
          z.multiply(z);
          z.add(c);
          k++;
        }
        putPixel(c, new Color((30 * k) % 256(4 * k) % 256,
          255 - (30 * k) % 256));
      }
      refresh();
    }
    isDrawing = false;
    setTitle("Done. Select zoom area!");
  }

  public void mousePressed(MouseEvent evt)
  {
    if (isDrawing)
      return;
    xStart = xEnd = p.toUserX(evt.getX());
    yStart = yEnd = p.toUserY(evt.getY());
    p.setXORMode(Color.white);
  }

  public void mouseDragged(MouseEvent evt)
  {
    if (isDrawing)
      return;
    p.color(Color.red);
    drawRectangle(true);
    xEnd = p.toUserX(evt.getX());
    yEnd = p.toUserY(evt.getY());
    drawRectangle(false);
    refresh();
  }

  public void mouseReleased(MouseEvent evt)
  {
    if (isDrawing)
      return;
    drawRectangle(true);
    p.setPaintMode();
    refresh();
    if (!(xStart == xEnd && yStart == yEnd))
      Monitor.wakeUp();
  }

  private void drawRectangle(boolean erase)
  {
    if (!erase)
    {
      double dx = xEnd - xStart;
      double dy = yEnd - yStart;
      double s = Math.min(Math.abs(dx)Math.abs(dy))// Side of square
      double dxx = Math.signum(dx) * s;
      double dyy = Math.signum(dy) * s;
      xEnd = xStart + dxx;
      yEnd = yStart + dyy;
    }
    if (!(xStart == xEnd && yStart == yEnd))
      p.rectangle(xStart, yStart, xEnd, yEnd, false);
  }

  private void putPixel(Complex z, Color c)
  {
    p.color(c);
    p.point(z.getReal(), z.getImg());
  }

  public void mouseEntered(MouseEvent e)
  {
  }

  public void mouseExited(MouseEvent e)
  {
  }

  public void mouseMoved(MouseEvent e)
  {
  }

  public void mouseClicked(MouseEvent e)
  {
  }

  public static void main(String[] args)
  {
    new Mandelbrot();
  }
}

Execute the program locally using WebStart.

Mandelbrot Mandelbrot