Package ch.aplu.turtle

The Java Turtle Package provides functionality for LOGO-like Java-Programs (including multiple turtles).

See:
Description

Interface Summary

TurtleContainer

Implement this interface if you define your own top-level container which contains turtles.

Class Summary

LineRenderer	This class is responsible for drawing the turtle's lines.
Pen	The Pen class provides anything used for drawing the lines, such as line width, pen color, end caps, dashed lines, etc.
Playground	A Playground is the Turtle's home, i.e. the Turtle lives and moves in the Playground.
Turtle	The core class for Turtles.
TurtleFactory	This class provides functionality for generating images (java.awt.Image) of a Turtle for any angle, color (java.awt.Color) and size.
TurtleFrame	This class is used for a Turtle Application.
TurtleRenderer	This class is responsible for creating and choosing the correct Turtle picture.

Package ch.aplu.turtle Description

The Java Turtle Package provides functionality for LOGO-like Java-Programs (including multiple turtles). It is written for educational purposes by Regula Hoefer-Isenegger for the AHL at the University of Berne under the supervision of Prof. Dr. Aegidius Plüss.
The Java Turtle Package comes under the GNU GENERAL PUBLIC LICENSE, Version 2, June 1991 (which you can find in the COPYING file which comes along with this package) and is copyrighted by the author.

Here's a simple sample program which shows how to use the Java Turtle Package:

import ch.aplu.turtle.*;
import java.awt.Color;

public class Example
{
  public static void main (String[] args) {
    Turtle joe = new Turtle(Color.green); // Create a green turtle in her 
                                          //own window.
    joe.setPos(-100,100);                 // Place joe to the Point(-100,100).
    for (int i=0; i < 4; i++) {
      joe.rt(90).fd(200);                 // turn 90 degrees to the right, then 
                                          // move forward 200 pixels.
    }
    joe.setPenColor(Color.red);           // set the pen color to red.
    joe.pu();                             // lifts the pen off the canvas
    joe.bk(50).lt(90).bk(50).rt(90).pd();
    for (int i=0; i < 4; i++) {
      joe.rt(90).fd(100);
    }
    Turtle anne = new Turtle(joe);        // Create a new Turtle (named anne)
                                          // in the same window as joe
    anne.speed(1000).fd(150).lt(90);      // sets the speed to 1000 pixels/sec,
                                          // then do some moves.
    anne.ht().fd(150).lt(90).stampTurtle(); // ht(): hide the turtle
    anne.fd(300);
    anne.st();                            // lets the turtle reappear on the 
                                          // screen
    anne.wrap();                          // Tells anne to wrap around the edges
    anne.setPos(200,200);
    for (int i=0; i < 4; i++) {
      anne.rt(90).fd(400);
    }
    anne.reinit();                        // Resets anne to her standard settings,
                                          // e.g. home position,facing north 
    Turtle filly = new Turtle(joe, Color.yellow); // yellow Turtle in joe's
                                          // Playground.
    filly.setPos(75,75);
    filly.setFillColor(Color.black);      // Sets the fill color to black.
    filly.fill();                         // fills the region bounded by any 
                                          // non-background colored pixel, 
					  // containing filly's position.
    filly.setPos(175,175);
    filly.setFillColor(Color.orange);
    filly.fill();

    Turtle texter = new Turtle(joe, Color.magenta);
    texter.ht().label("Hello Turtle");
  } 
}

If you only want to play with the turtles, you probably need not know anything about the classes Playground, TurtleFrame or the interface TurtleContainer. Just have a look at the Turtle class, take the example above as a starting point and enjoy it!

The JavaTurtlePackage requires J2SE, version 1.4.1. This means that it possibly won't work correctly under any previous release.

Version:

0.1.1

Author:

Regula Hoefer-Isenegger