jwo.landserf.gui
Class GPSImportBox

java.lang.Object
  java.awt.Component
      java.awt.Container
          java.awt.Window
              java.awt.Dialog
                  javax.swing.JDialog
                      jwo.utils.gui.JWDialogue
                          jwo.landserf.gui.GPSImportBox

All Implemented Interfaces:

ActionListener, ImageObserver, MenuContainer, Serializable, Runnable, EventListener, Accessible, RootPaneContainer, WindowConstants, GPSRouteListener, GPSTrackListener, GPSTransferListener, GPSWaypointListener

public class GPSImportBox
extends JWDialogue
implements ActionListener, GPSWaypointListener, GPSTrackListener, GPSRouteListener, Runnable

Allows GPS waypoint, route and track data to be imported into LandSerf as vector objects.

Version:

2.3, 6th October, 2007.

Author:

Jo Wood.

See Also:

Serialized Form

Nested Class Summary

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

JDialog.AccessibleJDialog

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

Dialog.AccessibleAWTDialog

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

Window.AccessibleAWTWindow

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

Container.AccessibleAWTContainer

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

Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields inherited from class jwo.utils.gui.JWDialogue

DIALOGUE, MONOLOGUE

Fields inherited from class javax.swing.JDialog

accessibleContext, rootPane, rootPaneCheckingEnabled

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface javax.swing.WindowConstants

DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

GPSImportBox(GPS gps, GISFrame gisFrame)
Displays available datasets from the given GPS for download.

Method Summary

void	actionPerformed(ActionEvent event) Responds to a button press by downloading the requested data or by setting/clearing the waypoint checkboxes.
void	closedown() Removes all GPS listeners before closing window.
VectorMap	getSelectedGPSData() Returns a Vector map containing all the selected GPS objects (waypoints, routes and tracks).
void	routeReceived(GPSRoute route) Handles the receipt of a route header from the GPS.
void	run() Starts the GPS download as a threaded process.
void	trackReceived(GPSTrack track) Handles the receipt of a track packet from the GPS.
void	transferComplete(int commandID) Called when the transfer to/from GPS is complete.
void	transferStarted(int number) Called when a transfer to/from GPS is initiated.
void	waypointReceived(GPSWaypoint wp) Handles the receipt of a waypoint from the GPS.

Methods inherited from class jwo.utils.gui.JWDialogue

addDialogueListener, checkInput, getContentPane, isChanged, removeDialogueListener, setFullBackground

Methods inherited from class javax.swing.JDialog

addImpl, createRootPane, dialogInit, getAccessibleContext, getDefaultCloseOperation, getGlassPane, getJMenuBar, getLayeredPane, getRootPane, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, update

Methods inherited from class java.awt.Dialog

addNotify, getTitle, hide, isModal, isResizable, isUndecorated, setModal, setResizable, setTitle, setUndecorated, show

Methods inherited from class java.awt.Window

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, finalize, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getMostRecentFocusOwner, getOwnedWindows, getOwner, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindowStateListeners, isActive, isAlwaysOnTop, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, pack, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, setAlwaysOnTop, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setLocationByPlatform, setLocationRelativeTo, toBack, toFront

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, 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, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Constructor Detail

GPSImportBox

public GPSImportBox(GPS gps,
                    GISFrame gisFrame)

Displays available datasets from the given GPS for download.

Parameters:

gps - GPS from which data will be extracted. A connection to this GPS must have previously been established, most probably though the GPSConfigBox.

gisFrame - Frame from which dialogue was called.

See Also:

GPSConfigBox

Method Detail

closedown

public void closedown()

Removes all GPS listeners before closing window.

Overrides:

closedown in class JWDialogue

run

public void run()

Starts the GPS download as a threaded process.

Specified by:

run in interface Runnable

waypointReceived

public void waypointReceived(GPSWaypoint wp)

Handles the receipt of a waypoint from the GPS. This might be a single waypoint, or a waypoint stored as part of a route.

Specified by:

waypointReceived in interface GPSWaypointListener

Parameters:

wp - Waypoint information from the GPS.

trackReceived

public void trackReceived(GPSTrack track)

Handles the receipt of a track packet from the GPS. A track packet should contain a time stamped spatial location (latitude, longitude, elevation and time) and an indication of whether it is the first point in a track or not.

Specified by:

trackReceived in interface GPSTrackListener

Parameters:

track - Track packet from the GPS.

routeReceived

public void routeReceived(GPSRoute route)

Handles the receipt of a route header from the GPS.

Specified by:

routeReceived in interface GPSRouteListener

Parameters:

route - Route information from the GPS.

transferStarted

public void transferStarted(int number)

Called when a transfer to/from GPS is initiated.

Specified by:

transferStarted in interface GPSTransferListener

Parameters:

number - The of data packets that are about be transferred, e.g. the number of waypoints. If it is not possible to tell how many data packets will be transferred, -1 is returned.

transferComplete

public void transferComplete(int commandID)

Called when the transfer to/from GPS is complete.

Specified by:

transferComplete in interface GPSTransferListener

Parameters:

commandID - ID of command that has been completed.

actionPerformed

public void actionPerformed(ActionEvent event)

Responds to a button press by downloading the requested data or by setting/clearing the waypoint checkboxes.

Specified by:

actionPerformed in interface ActionListener

Parameters:

event - Action event representing button press.

getSelectedGPSData

public VectorMap getSelectedGPSData()

Returns a Vector map containing all the selected GPS objects (waypoints, routes and tracks). Will use the coordinate system selected via the GUI. This method will reproject the data so should not be called unnecessarily.

Returns:

Selected GPS data as a vector map.