org.ascape.view.vis
Class Overhead2DContinuousView

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JPanel
                  org.ascape.view.vis.PanelView
                      org.ascape.view.vis.BufferView
                          org.ascape.view.vis.AgentView
                              org.ascape.view.vis.Overhead2DContinuousView

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Externalizable, java.io.Serializable, java.lang.Cloneable, java.util.EventListener, java.util.Observer, javax.accessibility.Accessible, ScapeListener, HasName, ComponentView

public class Overhead2DContinuousView
extends AgentView
implements java.io.Serializable

The Class Overhead2DContinuousView.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JPanel

javax.swing.JPanel.AccessibleJPanel

Nested classes/interfaces inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

DrawFeature	agents_fill_draw_feature Draws the provided object, assumed to be a agent, by filling it using the agent color feature.
DrawFeature	agents_fill_draw_inset_feature Draws the provided object, assumed to be a agent, by filling it using the agent color feature.
DrawFeature	agents_image_cells_draw_feature Draws the provided object, assumed to be a cell with an occupant, by filling the cell using the cell color feature interpretation, and filling an oval using the agent color feature on the occupant.

Fields inherited from class org.ascape.view.vis.AgentView

agentCustomizer, clearBackgroundAutomatically, drawSelection, updateAllRequested

Fields inherited from class org.ascape.view.vis.BufferView

bufferedGraphics, bufferedImage

Fields inherited from class org.ascape.view.vis.PanelView

delegate, iterationsPerRedraw, name, scape

Fields inherited from class javax.swing.JComponent

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Overhead2DContinuousView()
Constructs a BaseAgentView, adding a listener to present a settings frame when the user double-clicks on the view.

Overhead2DContinuousView(java.lang.String name)
Instantiates a new overhead2 D continuous view.

Method Summary

void	addNotify() Override addNotify to build buffer.
void	build() Builds the view.
void	drawAgentAt(LocatedAgent agent, int x, int y, DrawFeature feature) Draw agent at.
void	drawAgentAtIfUpdate(LocatedAgent agent, int x, int y) Draw agent at if update.
void	drawSelectedAgent(java.awt.Graphics g, LocatedAgent a) Draws a marker for the provided selected agent.
Agent	getAgentAtPixel(int pixelX, int pixelY) Returns the agent at the given pixel in this view.
ColorFeature	getAgentColorFeature() Returns the color feature that will be used for determining agent color.
ImageFeature	getAgentImageFeature() Returns the image feature that will be used for determining agent color.
Coordinate	getCoordinateAtPixel(int pixelX, int pixelY) Returns the agent at the given pixel in this view.
int	getNominalAgentSize() Gets the nominal agent size.
java.awt.Dimension	getPreferredSize()
java.awt.Dimension	getPreferredSizeWithin(java.awt.Dimension d) Default behavior for a component.
ColorFeature	getPrimaryAgentColorFeature() Returns the color feature that will be used for determining agent color.
boolean	isDrawSelectedNeighbors() Checks if is draw selected neighbors.
void	scapeAdded(ScapeEvent scapeEvent) Notifies the view that the scape has removed it.
void	scapeRemoved(ScapeEvent scapeEvent) Notifies the view that the scape has removed it.
void	setAgentColorFeature(ColorFeature agentColorFeature) Set the color feature that will be used for determining agent color.
void	setAgentImageFeature(ImageFeature agentImageFeature) Set the image feature that will be used for determining agent color.
void	setBounds(int x, int y, int width, int height)
void	setDrawSelectedNeighbors(boolean drawSelectedNeighbors) Sets the draw selected neighbors.
void	setNominalAgentSize(int nominalAgentSize) Sets the nominal agent size.
void	setPreferredSize(java.awt.Dimension preferredSize)
void	setPrimaryAgentColorFeature(ColorFeature agentColorFeature) Set the color feature that will be used for determining agent color.
void	updateScapeGraphics() On notification of a scape update, draws the actual overhead view.

Methods inherited from class org.ascape.view.vis.AgentView

addDrawFeature, createAgentCustomizer, createAgentCustomizerPanel, displayAgentCustomizer, displayCustomizer, drawSelectedAgent, getAgentCustomizer, getDrawFeatures, getDrawFeaturesObservable, getDrawSelection, isClearBackground, paintComponent, readExternal, removeAgentCustomizer, removeCustomizer, removeDrawFeature, requestUpdateAll, scapeStarted, setAgentCustomizer, setClearBackground, setCustomizeAgent, update, writeExternal

Methods inherited from class org.ascape.view.vis.BufferView

buildGraphicsBuffer, finalize, getBufferedImage, imageUpdate, setBufferedImage

Methods inherited from class org.ascape.view.vis.PanelView

clone, environmentQuiting, forceScapeNotify, getDelegate, getIcon, getIterationsPerRedraw, getName, getScape, getViewFrame, iconUpdated, isGraphic, isLifeOfScape, notifyScapeUpdated, onChangeIterationsPerRedraw, scapeClosing, scapeDeserialized, scapeInitialized, scapeIterated, scapeNotification, scapeSetup, scapeStopped, setDelegate, setIterationsPerRedraw, setMovieRecorder, setName, setViewFrame, toString

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setSize, setSize, show, show, size, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Detail

agents_fill_draw_feature

public final DrawFeature agents_fill_draw_feature

Draws the provided object, assumed to be a agent, by filling it using the agent color feature.

agents_fill_draw_inset_feature

public final DrawFeature agents_fill_draw_inset_feature

Draws the provided object, assumed to be a agent, by filling it using the agent color feature.

agents_image_cells_draw_feature

public final DrawFeature agents_image_cells_draw_feature

Draws the provided object, assumed to be a cell with an occupant, by filling the cell using the cell color feature interpretation, and filling an oval using the agent color feature on the occupant.

Constructor Detail

Overhead2DContinuousView

public Overhead2DContinuousView()

Constructs a BaseAgentView, adding a listener to present a settings frame when the user double-clicks on the view.

Overhead2DContinuousView

public Overhead2DContinuousView(java.lang.String name)

Instantiates a new overhead2 D continuous view.

Parameters:

name - the name

Method Detail

build

public void build()

Builds the view. Sets the color feature defaults, adds the default oval and fill draw features, and selects the draw agents as ovals feature.

Specified by:

build in interface ComponentView

Overrides:

build in class AgentView

updateScapeGraphics

public void updateScapeGraphics()

On notification of a scape update, draws the actual overhead view.

Specified by:

updateScapeGraphics in interface ComponentView

Overrides:

updateScapeGraphics in class AgentView

drawAgentAt

public void drawAgentAt(LocatedAgent agent,
                        int x,
                        int y,
                        DrawFeature feature)

Draw agent at.

Parameters:

agent - the agent

x - the x

y - the y

feature - the feature

drawAgentAtIfUpdate

public void drawAgentAtIfUpdate(LocatedAgent agent,
                                int x,
                                int y)

Draw agent at if update.

Parameters:

agent - the agent

x - the x

y - the y

getCoordinateAtPixel

public Coordinate getCoordinateAtPixel(int pixelX,
                                       int pixelY)

Returns the agent at the given pixel in this view.

Parameters:

pixelX - the horizontal pixel location

pixelY - the vertical pixel location

Returns:

the coordinate at pixel

getAgentAtPixel

public Agent getAgentAtPixel(int pixelX,
                             int pixelY)

Returns the agent at the given pixel in this view.

Overrides:

getAgentAtPixel in class AgentView

Parameters:

pixelX - the horizontal pixel location

pixelY - the vertical pixel location

Returns:

the agent at pixel

addNotify

public void addNotify()

Override addNotify to build buffer.

Overrides:

addNotify in class BufferView

getPreferredSizeWithin

public java.awt.Dimension getPreferredSizeWithin(java.awt.Dimension d)

Description copied from class: PanelView

Default behavior for a component. Simply returns same size.

Specified by:

getPreferredSizeWithin in interface ComponentView

Overrides:

getPreferredSizeWithin in class PanelView

Parameters:

d - the d

Returns:

the preferred size within

setBounds

public void setBounds(int x,
                      int y,
                      int width,
                      int height)

Overrides:

setBounds in class BufferView

scapeAdded

public void scapeAdded(ScapeEvent scapeEvent)
                throws java.util.TooManyListenersException

Notifies the view that the scape has removed it. Removes the customizer.

Specified by:

scapeAdded in interface ScapeListener

Overrides:

scapeAdded in class AgentView

Parameters:

scapeEvent - the scape removed notification event

Throws:

java.util.TooManyListenersException - the too many listeners exception

scapeRemoved

public void scapeRemoved(ScapeEvent scapeEvent)

Notifies the view that the scape has removed it. Removes the customizer.

Specified by:

scapeRemoved in interface ScapeListener

Overrides:

scapeRemoved in class PanelView

Parameters:

scapeEvent - the scape removed notification event

See Also:

scapeAdded

getPreferredSize

public java.awt.Dimension getPreferredSize()

Overrides:

getPreferredSize in class javax.swing.JComponent

setPreferredSize

public void setPreferredSize(java.awt.Dimension preferredSize)

Overrides:

setPreferredSize in class javax.swing.JComponent

getNominalAgentSize

public int getNominalAgentSize()

Gets the nominal agent size.

Returns:

the nominal agent size

setNominalAgentSize

public void setNominalAgentSize(int nominalAgentSize)

Sets the nominal agent size.

Parameters:

nominalAgentSize - the new nominal agent size

getPrimaryAgentColorFeature

public ColorFeature getPrimaryAgentColorFeature()

Returns the color feature that will be used for determining agent color. The default color feature is simply the getColor() method of the agent.

Returns:

the primary agent color feature

setPrimaryAgentColorFeature

public void setPrimaryAgentColorFeature(ColorFeature agentColorFeature)

Set the color feature that will be used for determining agent color. The default color feature is simply the getColor() method of the agent.

Parameters:

agentColorFeature - the color feature, whose object is assumed to be a agent populating this lattice

getAgentColorFeature

public ColorFeature getAgentColorFeature()

Returns the color feature that will be used for determining agent color. The default color feature is simply the getColor() method of the agent.

Overrides:

getAgentColorFeature in class AgentView

Returns:

the agent color feature

setAgentColorFeature

public void setAgentColorFeature(ColorFeature agentColorFeature)

Set the color feature that will be used for determining agent color. The default color feature is simply the getColor() method of the agent.

Overrides:

setAgentColorFeature in class AgentView

Parameters:

agentColorFeature - the color feature, whose object is assumed to be a agent populating this lattice

getAgentImageFeature

public ImageFeature getAgentImageFeature()

Returns the image feature that will be used for determining agent color.

Returns:

the agent image feature

setAgentImageFeature

public void setAgentImageFeature(ImageFeature agentImageFeature)

Set the image feature that will be used for determining agent color. The default image feature is simply the getColor() method of the agent.

Parameters:

agentImageFeature - the color feature, whose object is assumed to be a agent populating this lattice

drawSelectedAgent

public void drawSelectedAgent(java.awt.Graphics g,
                              LocatedAgent a)

Description copied from class: AgentView

Draws a marker for the provided selected agent.

Overrides:

drawSelectedAgent in class AgentView

Parameters:

g - the graphics context to draw to

a - the agent to draw

isDrawSelectedNeighbors

public boolean isDrawSelectedNeighbors()

Checks if is draw selected neighbors.

Returns:

true, if is draw selected neighbors

setDrawSelectedNeighbors

public void setDrawSelectedNeighbors(boolean drawSelectedNeighbors)

Sets the draw selected neighbors.

Parameters:

drawSelectedNeighbors - the new draw selected neighbors