Package Map

Class SimpleMap

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

Map.SimpleMap

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible, PamSettings, SettingsNameProvider, PamObserver, PamScrollObserver, UserDisplayComponent

public class SimpleMap
extends JPanel
implements PamObserver, PamScrollObserver, PamSettings, UserDisplayComponent

Mainly a container for map objects, holding the main MapPanel and the right hand control items.
Originally written by Dave McLaren. Modified by Doug Gillespie to incorporate controls onto main panel to increase overall visible size.

See Also:

• Serialized Form

Nested Class Summary

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

JPanel.AccessibleJPanel

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field	Description
protected ClipboardCopier	clipboardCopier
protected PamDataBlock	effortDataBlock
protected MapDetectionsManager	mapDetectionsManager
protected MapParameters	mapParameters

Fields inherited from class javax.swing.JComponent

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

accessibleContext, 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

Constructors

Constructor	Description
SimpleMap(MapController mapController, boolean isMainTab)
SimpleMap(MapController mapController, boolean isMainTab, MapPanel mapPanel)

Method Summary

Modifier and Type	Method	Description
void	addData(PamObservable o, PamDataUnit arg)	Informs the PamObserver that new data have been added to the Observable class
void	addMouseAdapterToMapPanel(MouseAdapter mouseAdapter)
protected void	checkViewerData()	In viewer mode, check the right data are loaded.
void	closeComponent()	Called when the component is removed from the display.
JMenu	createDisplayMenu(Frame parentFrame)
protected void	createMapComment(int x, int y)
Component	getComponent()
ArrayList<PamDataBlock>	getDataBlocks()
String	getFrameTitle()	Get a title for the frame the component will be added to.
protected GPSControl	getGpsControl()
protected GPSDataBlock	getGpsDataBlock()
protected GridbaseControl	getGridBaseControl()
Integer	getHiddenSliderTime()
LatLong	getLastClickedMouseLatLong()
MapDetectionsManager	getMapDetectionsManager()
Map.SimpleMap.MapOverlayMarker	getMapMarker()
MapPanel	getMapPanel()
MapParameters	getMapParameters()
long	getMapTime()	Get the time for the map (used when deciding what to plot)
PamDataUnit	getMousedDataUnit()	Gets a data unit currently hovered by the mouse.
Map.SimpleMap.MapMouseMotionAdapter	getMouseMotion()
String	getObserverName()
PamObserver	getObserverObject()
JMenuItem	getOptionsMenuItem(Frame parentFrame)
JComponent	getPanel()
long	getRequiredDataHistory(PamObservable o, Object arg)
String	getSelectorName()	Name for data selectors and data filters.
Serializable	getSettingsReference()
long	getSettingsVersion()
String	getUniqueName()
String	getUnitName()
String	getUnitType()	Settings manager for when there are multiple maps in user displays.
JPanel	getViewerControls()
PamScrollSlider	getViewerScroller()
void	initMapPanel()
void	mapCanScroll(boolean b)
void	masterClockUpdate(long milliSeconds, long sampleNumber)
protected void	newViewTime()	Notification that the viewer slider has moved.
protected void	newViewTimes()	Notification of new viewer times
void	noteNewSettings()
void	notifyModelChanged(int changeType)	Pick up model changed notifications from a parent user display.
void	openComponent()	Called when the component is first displayed.
protected void	paintComponent(Graphics arg0)
void	receiveSourceNotification(int type, Object object)	Receive a notification from the data source - typically a change in DAQ status.
void	refreshDetectorList()
void	removeObservable(PamObservable o)	called when an Observable (PamDataBlock) is removed from the system
boolean	restoreSettings(PamControlledUnitSettings pamControlledUnitSettings)
void	scrollRangeChanged(AbstractPamScroller absPamScroller)	Notification sent when a scroller or slider changes it's data range
void	scrollValueChanged(AbstractPamScroller abstractPamScroller)	Notification sent when a scroller or slider changes it's position
void	setHiddenSliderTime(Integer hiddenSliderTime)
void	setSampleRate(float sampleRate, boolean notify)	New sample rate
void	setUniqueName(String uniqueName)	Set a unique name for every display.
boolean	shouldPlot(PamDataBlock pamDataBlock)	ShouldPlot function for a datablock, moved here from mappanel so that we can override for a special map for Target motion (and other) dialogs
boolean	shouldPlot(PamDataUnit pamDataUnit, MapDetectionData mapDetectionData, long earliestToPlot, long now, DataSelector ds)	Shouldplot function for individual data units.
void	showMapObjects()
boolean	showParametersDialog(Window parentFrame)
boolean	subscribeViewerBlocks()	Subscribes a variety of data blocks to the scroll bar.
void	updateData(PamObservable observable, PamDataUnit pamDataUnit)	Informs the PamObserver that existing data have been updated

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, 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, setPreferredSize, 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, 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, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, 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, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Details

clipboardCopier

protected ClipboardCopier clipboardCopier

mapParameters

protected MapParameters mapParameters

mapDetectionsManager

protected MapDetectionsManager mapDetectionsManager

effortDataBlock

protected PamDataBlock effortDataBlock

Constructor Details

SimpleMap

public SimpleMap(MapController mapController,
 boolean isMainTab,
 MapPanel mapPanel)

SimpleMap

public SimpleMap(MapController mapController,
 boolean isMainTab)

Method Details

getSelectorName

public String getSelectorName()

Name for data selectors and data filters.

Returns:

getUnitName

public String getUnitName()

Specified by:

getUnitName in interface SettingsNameProvider

Returns:

A Name specific to this instance of the particular class, e.g. Sperm whale detector, Beaked whale detector, etc.

getUnitType

public String getUnitType()

Settings manager for when there are multiple maps in user displays.

Specified by:

getUnitType in interface PamSettings

Returns:

A Name specific to the type, e.g. Click detector

getSettingsReference

public Serializable getSettingsReference()

Specified by:

getSettingsReference in interface PamSettings

Returns:

The serialisable object that will be stored

getSettingsVersion

public long getSettingsVersion()

Specified by:

getSettingsVersion in interface PamSettings

Returns:

An integer version number for the settings

restoreSettings

public boolean restoreSettings(PamControlledUnitSettings pamControlledUnitSettings)

Specified by:

restoreSettings in interface PamSettings

Parameters:

pamControlledUnitSettings -

Returns:

true if successful The object performs final checks (if needed) and then casts the settings data pamcontrolledunitSettings.settings into the correct type and uses as required

getObserverObject

public PamObserver getObserverObject()

Specified by:

getObserverObject in interface PamObserver

Returns:

the actual observer. In most cases concrete classes will just return 'this' in response. The exception is the Threaded observer, which will return the single thread observer.

getMapTime

public long getMapTime()

Get the time for the map (used when deciding what to plot)

Returns:

time from either the pamguard clock or the scroll bar.

shouldPlot

public boolean shouldPlot(PamDataBlock pamDataBlock)

ShouldPlot function for a datablock, moved here from mappanel so that we can override for a special map for Target motion (and other) dialogs

Parameters:

pamDataBlock -

Returns:

true if anything in that datablock should be displayed.

shouldPlot

public boolean shouldPlot(PamDataUnit pamDataUnit,
 MapDetectionData mapDetectionData,
 long earliestToPlot,
 long now,
 DataSelector ds)

Shouldplot function for individual data units.

Parameters:

pamDataUnit -

mapDetectionData -

earliestToPlot -

now -

ds -

Returns:

getMapParameters

public MapParameters getMapParameters()

Returns:

The map parameters object.

showMapObjects

public void showMapObjects()

initMapPanel

public void initMapPanel()

getMapPanel

public MapPanel getMapPanel()

addData

public void addData(PamObservable o,
 PamDataUnit arg)

Description copied from interface: PamObserver

Informs the PamObserver that new data have been added to the Observable class

Specified by:

addData in interface PamObserver

updateData

public void updateData(PamObservable observable,
 PamDataUnit pamDataUnit)

Description copied from interface: PamObserver

Informs the PamObserver that existing data have been updated

Specified by:

updateData in interface PamObserver

getObserverName

public String getObserverName()

Specified by:

getObserverName in interface PamObserver

noteNewSettings

public void noteNewSettings()

Specified by:

noteNewSettings in interface PamObserver

setSampleRate

public void setSampleRate(float sampleRate,
 boolean notify)

Description copied from interface: PamObserver

New sample rate

Specified by:

setSampleRate in interface PamObserver

Parameters:

sampleRate -

notify - Notify other PamObservers and PamObservables in the chain.

masterClockUpdate

public void masterClockUpdate(long milliSeconds,
 long sampleNumber)

Specified by:

masterClockUpdate in interface PamObserver

getRequiredDataHistory

public long getRequiredDataHistory(PamObservable o,
 Object arg)

Specified by:

getRequiredDataHistory in interface PamObserver

Parameters:

arg - optional argument from PamObservable

Returns:

time in milliseconds required by data held in PamObservable

receiveSourceNotification

public void receiveSourceNotification(int type,
 Object object)

Description copied from interface: PamObserver

Receive a notification from the data source - typically a change in DAQ status. See the constants listed in AcquisitionProcess for potential change types.

Specified by:

receiveSourceNotification in interface PamObserver

Parameters:

type - the type of change

object - generic object added here so that we can include anything in the future

getDataBlocks

public ArrayList<PamDataBlock> getDataBlocks()

getMousedDataUnit

public PamDataUnit getMousedDataUnit()

Gets a data unit currently hovered by the mouse. This only gets set if the mouse actually hovers and is then clicked.

Returns:

hovered data unit.

paintComponent

protected void paintComponent(Graphics arg0)

Overrides:

paintComponent in class JComponent

removeObservable

public void removeObservable(PamObservable o)

Description copied from interface: PamObserver

called when an Observable (PamDataBlock) is removed from the system

Specified by:

removeObservable in interface PamObserver

getLastClickedMouseLatLong

public LatLong getLastClickedMouseLatLong()

createMapComment

protected void createMapComment(int x,
 int y)

getMouseMotion

public Map.SimpleMap.MapMouseMotionAdapter getMouseMotion()

getPanel

public JComponent getPanel()

addMouseAdapterToMapPanel

public void addMouseAdapterToMapPanel(MouseAdapter mouseAdapter)

mapCanScroll

public void mapCanScroll(boolean b)

refreshDetectorList

public void refreshDetectorList()

newViewTimes

protected void newViewTimes()

Notification of new viewer times

newViewTime

protected void newViewTime()

Notification that the viewer slider has moved.

scrollRangeChanged

public void scrollRangeChanged(AbstractPamScroller absPamScroller)

Description copied from interface: PamScrollObserver

Notification sent when a scroller or slider changes it's data range

If data were loaded in a worker thread, this notification is sent after the new data have loaded.

Specified by:

scrollRangeChanged in interface PamScrollObserver

Parameters:

absPamScroller - reference to moved scroller.

scrollValueChanged

public void scrollValueChanged(AbstractPamScroller abstractPamScroller)

Description copied from interface: PamScrollObserver

Notification sent when a scroller or slider changes it's position

Specified by:

scrollValueChanged in interface PamScrollObserver

Parameters:

abstractPamScroller - reference to moved scroller

subscribeViewerBlocks

public boolean subscribeViewerBlocks()

Subscribes a variety of data blocks to the scroll bar.

Returns:

returns true if the list has changes, indicating that it's probably necessary to call loadData in the scroll manager to get new data.

getViewerScroller

public PamScrollSlider getViewerScroller()

createDisplayMenu

public JMenu createDisplayMenu(Frame parentFrame)

getOptionsMenuItem

public JMenuItem getOptionsMenuItem(Frame parentFrame)

showParametersDialog

public boolean showParametersDialog(Window parentFrame)

checkViewerData

protected void checkViewerData()

In viewer mode, check the right data are loaded.

getComponent

public Component getComponent()

Specified by:

getComponent in interface UserDisplayComponent

Returns:

The Swing component to add to the frame

openComponent

public void openComponent()

Description copied from interface: UserDisplayComponent

Called when the component is first displayed.

Specified by:

openComponent in interface UserDisplayComponent

closeComponent

public void closeComponent()

Description copied from interface: UserDisplayComponent

Called when the component is removed from the display.

Specified by:

closeComponent in interface UserDisplayComponent

notifyModelChanged

public void notifyModelChanged(int changeType)

Description copied from interface: UserDisplayComponent

Pick up model changed notifications from a parent user display.

Specified by:

notifyModelChanged in interface UserDisplayComponent

Parameters:

changeType -

getHiddenSliderTime

public Integer getHiddenSliderTime()

Returns:

the hiddenSliderTime

setHiddenSliderTime

public void setHiddenSliderTime(Integer hiddenSliderTime)

Parameters:

hiddenSliderTime - the hiddenSliderTime to set

getGpsDataBlock

protected GPSDataBlock getGpsDataBlock()

Returns:

the gpsDataBlock

getGpsControl

protected GPSControl getGpsControl()

Returns:

the gpsControl

getFrameTitle

public String getFrameTitle()

Description copied from interface: UserDisplayComponent

Get a title for the frame the component will be added to.

Specified by:

getFrameTitle in interface UserDisplayComponent

Returns:

a title for the components frame.

getUniqueName

public String getUniqueName()

Specified by:

getUniqueName in interface UserDisplayComponent

Returns:

a unique name (across all of PAMGuard) which will be used for mark overlays and settings storage.

setUniqueName

public void setUniqueName(String uniqueName)

Description copied from interface: UserDisplayComponent

Set a unique name for every display. This is important for saving settings and for managing things that need a unique name such as overlay marks and markers.

Specified by:

setUniqueName in interface UserDisplayComponent

getGridBaseControl

protected GridbaseControl getGridBaseControl()

Returns:

the gridBaseControl

getMapDetectionsManager

public MapDetectionsManager getMapDetectionsManager()

getViewerControls

public JPanel getViewerControls()

getMapMarker

public Map.SimpleMap.MapOverlayMarker getMapMarker()