Media

Class TurtleDisplayer

java.lang.Object

Media.TurtleDisplayer

All Implemented Interfaces:

java.util.Observer

public class TurtleDisplayer
extends java.lang.Object
implements java.util.Observer

TurtleDisplayer provides a quick way of getting a turtle to draw on the screen by creating a BasicForm with a Canvas and additional components that give feedback on the turtle's status.

Version:

1.00 (07/7/22), 2.0 (09/05/04)

Author:

Andrew Cheesman, David Hughes

Constructor Summary

Constructors

Constructor and Description
TurtleDisplayer() Creates a form with a Canvas of size 300x300, accompanied by other components giving feedback on the turtle's status
TurtleDisplayer(Turtle t) Creats a form with the specified Turtle on a Canvas of size 300x300, accompanied by other componentsgiving feedback on the turtle's status
TurtleDisplayer(Turtle t, int width, int height) Creates a TurtleDisplayer with a Canvas for a Turtle with the specified width and height.

Method Summary

Modifier and Type	Method and Description
void	close() Closes the TurtleDisplayer and frees resources when the user presses Close.
void	hide() Makes the TurtleDisplayer invisible, so that it can not be seen on the desktop.
void	placeTurtle(Turtle t) Puts a turtle onto the canvas on the form.
void	setTurtle(Turtle t) Deprecated. use placeTurtle(Turtle t) instead
void	show() Makes the TurtleDisplayer visible, so that it can be seen on the desktop.
void	update(java.util.Observable o, java.lang.Object arg) This method is only used by Observerable classes, ie Turtle.
void	waitForUser() Waits for the user to finish using the TurtleDisplayer and press OK.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TurtleDisplayer

public TurtleDisplayer(Turtle t,
                       int width,
                       int height)

Creates a TurtleDisplayer with a Canvas for a Turtle with the specified width and height. It includes other components on the form which give additional information on the Turtle's status.

Parameters:

t - the turtle associated with this TurtleDisplayer

width - the width of the canvas on this form

height - the height of the canvas on this form

TurtleDisplayer

public TurtleDisplayer(Turtle t)

Creats a form with the specified Turtle on a Canvas of size 300x300, accompanied by other componentsgiving feedback on the turtle's status

Parameters:

t - A turtle that will go onto the canvas

See Also:

TurtleDisplayer(Turtle t, int width, int height)

TurtleDisplayer

public TurtleDisplayer()

Creates a form with a Canvas of size 300x300, accompanied by other components giving feedback on the turtle's status

See Also:

TurtleDisplayer(Turtle t, int width, int height)

Method Detail

setTurtle

public void setTurtle(Turtle t)

Deprecated. use placeTurtle(Turtle t) instead

Puts a turtle onto the canvas on the form. From this point on any drawing operations the turtle performs will be visible on the TurtleDisplayer's canvas.

Parameters:

t - the turtle to be place into the turtle canvas.

placeTurtle

public void placeTurtle(Turtle t)

Puts a turtle onto the canvas on the form. From this point on any drawing operations the turtle performs will be visible on the TurtleDisplayer's canvas.

Parameters:

t - the turtle to be place into the turtle canvas.

show

public void show()

Makes the TurtleDisplayer visible, so that it can be seen on the desktop.

hide

public void hide()

Makes the TurtleDisplayer invisible, so that it can not be seen on the desktop.

waitForUser

public void waitForUser()

Waits for the user to finish using the TurtleDisplayer and press OK.

close

public void close()

Closes the TurtleDisplayer and frees resources when the user presses Close. The TurtleDisplayer should not be used thereafter.

update

public void update(java.util.Observable o,
                   java.lang.Object arg)

This method is only used by Observerable classes, ie Turtle. A turtle will call this method to let TurtleDisplayer know when a turtle has performed an action, so that it may update the data on the form.

Specified by:

update in interface java.util.Observer