cse1030.drawing

Class Turtle

java.lang.Object

cse1030.drawing.Turtle

public class Turtle
extends Object

A class that supports turtle graphics. The turtle is limited to moving in only four directions: left, right, up, and down. The turtle is also limited to moving in the rectangle with bottom left corner located at coordinates (-10, -8) and the top left corner located at coordinates (10, 8).

Author:

CSE1030_F_13_14

Constructor Summary

Constructors

Constructor and Description
Turtle() Construct a turtle located at coordinates (0, 0) and facing towards the right.
Turtle(IPoint2D position, Color penColor) Construct a turtle located at the given coordinates, facing towards the right, using the given pen color to draw with.
Turtle(Turtle other) Construct a copy of another turtle.

Method Summary

Methods

Modifier and Type	Method and Description
int	getAngle() Gets the direction that the turtle is facing in measured as an angle in degrees from the positive x axis.
Color	getPenColor() Gets the color of the pen that the turtle is currently using to draw with.
IPoint2D	getPosition() Gets the current position of the turtle.
void	move(double distance) Moves the turtle the specified distance in the direction that the turtle is currently facing; a line is drawn in the current pen color as the turtle moves.
void	setPenColor(Color penColor) Sets the color of the pen that the turtle is currently using to draw with.
String	toString() Returns a string representation of the object.
void	turnLeft() Changes the direction that the turtle is facing in by turning the turtle 90 degrees to its left.
void	turnRight() Changes the direction that the turtle is facing in by turning the turtle 90 degrees to its right.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Turtle

public Turtle()

Construct a turtle located at coordinates (0, 0) and facing towards the right. The pen color is Color.BLACK.

Turtle

public Turtle(IPoint2D position,
      Color penColor)

Construct a turtle located at the given coordinates, facing towards the right, using the given pen color to draw with. If penColor == null then the turtle's pen color will be set to Color.BLACK.

Throws:

IllegalArgumentException - if the starting position is outside of the grid that the turtle can move on

Parameters:

position - the desired starting position of the turtle

penColor - the desired pen color that the turtle will use to draw with

Turtle

public Turtle(Turtle other)

Construct a copy of another turtle.

Parameters:

other - the turtle to copy

Method Detail

move

public void move(double distance)

Moves the turtle the specified distance in the direction that the turtle is currently facing; a line is drawn in the current pen color as the turtle moves.

The turtle will never move outside the rectangle with bottom left corner located at coordinates (-10, -8) and the top left corner located at coordinates (10, 8); it will always stop at the border of the rectangle.

Parameters:

distance - the distance to move the turtle

turnLeft

public void turnLeft()

Changes the direction that the turtle is facing in by turning the turtle 90 degrees to its left.

turnRight

public void turnRight()

Changes the direction that the turtle is facing in by turning the turtle 90 degrees to its right.

getPosition

public IPoint2D getPosition()

Gets the current position of the turtle. The position will never be outside the rectangle with bottom left corner located at coordinates (-10, -8) and the top left corner located at coordinates (10, 8).

Returns:

the current position of the turtle

getAngle

public int getAngle()

Gets the direction that the turtle is facing in measured as an angle in degrees from the positive x axis. The angle returned is always in the range 0 <= angle < 360.

Returns:

the angle in degrees between the positive x axis and the direction that the turtle is facing in

getPenColor

public Color getPenColor()

Gets the color of the pen that the turtle is currently using to draw with.

Returns:

the current pen color

setPenColor

public void setPenColor(Color penColor)

Sets the color of the pen that the turtle is currently using to draw with. If penColor == null then the current pen color remains unchanged.

Parameters:

penColor - the new pen color

toString

public String toString()

Returns a string representation of the object. The string returned is simply the position followed by the angle followed by the pen color, where the individual fields are separated by a comma and space. The string representation of the position and pen color are identical to those generated by cse1030.drawing.IPoint2D.toString() and java.awt.Color.toString(), respectively. The string representation of the angle is identical to the string representation of an integer value.

Overrides:

toString in class Object

See Also:

Object.toString()

Returns:

a string representation of the turtle