galapagos
Class TurtleDrawingWindow

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.Window
                    |
                    +--java.awt.Frame
                          |
                          +--galapagos.TurtleDrawingWindow

public class TurtleDrawingWindow

extends java.awt.Frame

A simple window for allowing turtles to draw. You can add multiple turtles to this window. With the current implementation, drawing becomes jaggy when you add multiple turtles. This performance problem will be addressed in the next release.

See Also:

Serialized Form

Fields inherited from class java.awt.Frame

CROSSHAIR_CURSOR, DEFAULT_CURSOR, E_RESIZE_CURSOR, HAND_CURSOR, ICONIFIED, MOVE_CURSOR, N_RESIZE_CURSOR, NE_RESIZE_CURSOR, NORMAL, NW_RESIZE_CURSOR, S_RESIZE_CURSOR, SE_RESIZE_CURSOR, SW_RESIZE_CURSOR, TEXT_CURSOR, W_RESIZE_CURSOR, WAIT_CURSOR

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Constructor Summary

TurtleDrawingWindow()
A default constructor that creates an instance of the PlottingCanvas class.

Method Summary

void	add(galapagos.DrawingController owner) A mutator method that adds another DrawingController that will draw its trajectory on this canvas.
void	clear() Erases the current contents of the PlottingCanvas by painting the whole canvas with the background color.
void	setGrid(boolean showGrid) A mutator method that sets the flag for drawing the grid lines.
void	setOrigin(int x, int y) A mutator method that sets the origin point.
void	setUnit(double pixelsPerUnit) A mutator method that sets the scaling factor.
void	setVisible(boolean visible) Overrides the inherited method so the canvas is set up correctly.

Methods inherited from class java.awt.Frame

addNotify, finalize, getCursorType, getFrames, getIconImage, getMenuBar, getState, getTitle, isResizable, paramString, remove, removeNotify, setCursor, setIconImage, setMenuBar, setResizable, setState, setTitle

Methods inherited from class java.awt.Window

addWindowListener, applyResourceBundle, applyResourceBundle, dispose, getFocusOwner, getInputContext, getLocale, getOwnedWindows, getOwner, getToolkit, getWarningString, hide, isShowing, pack, postEvent, processEvent, processWindowEvent, removeWindowListener, setCursor, show, toBack, toFront

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getInsets, getLayout, getMaximumSize, getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, setFont, setLayout, update, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addPropertyChangeListener, addPropertyChangeListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, getBackground, getBounds, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getInputMethodRequests, getLocation, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isDisplayable, isDoubleBuffered, isEnabled, isFocusTraversable, isLightweight, isOpaque, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, removeComponentListener, removeFocusListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setDropTarget, setEnabled, setForeground, setLocale, setLocation, setLocation, setName, setSize, setSize, show, size, toString, transferFocus

Methods inherited from class java.lang.Object

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

Constructor Detail

TurtleDrawingWindow

public TurtleDrawingWindow()

A default constructor that creates an instance of the PlottingCanvas class. No grid lines are drawn, the center position of the canvas is set to (0,0) of the logical (user) coordinate, and the scaling unit is set to the default size defined by the constance DEFAULT_UNIT.

Method Detail

add

public void add(galapagos.DrawingController owner)

A mutator method that adds another DrawingController that will draw its trajectory on this canvas.

Parameters:

owner - A DrawingController that will draw its trajectory on this canvas.

clear

public void clear()

Erases the current contents of the PlottingCanvas by painting the whole canvas with the background color.

setGrid

public void setGrid(boolean showGrid)

A mutator method that sets the flag for drawing the grid lines. Passing true will make the grid lines to appear.

Parameters:

showGrid - Pass 'true' to show the grid lines.

setOrigin

public void setOrigin(int x,
                      int y)

A mutator method that sets the origin point. The parameter (x,y) specifies the point in the logical coordinate system that corresponds to the physical center position of the canvas. By default, the center of the canvas represents the point (0,0) of the logical coordinate system. For example, if you pass 100 and 200 for the x and y parameters, the logical coordinate center point is shifted 100 units to the left and 200 units down.

Parameters:

x - The x-coordinate of a logical point that corresponds to the center of the canvas.

y - The y-coordinate of a logical point that corresponds to the center of the canvas.

setUnit

public void setUnit(double pixelsPerUnit)

A mutator method that sets the scaling factor. The default scaling is 2 pixels per single logical unit. Increase the number for a more zoomed view and decrease the number for a more zoomed out view.

Parameters:

pixelsPerUnit - The scaling unit.

setVisible

public void setVisible(boolean visible)

Overrides the inherited method so the canvas is set up correctly.

Overrides:

setVisible in class java.awt.Component