org.openstreetmap.josm.actions

Class DownloadAlongAction

java.lang.Object

javax.swing.AbstractAction

org.openstreetmap.josm.actions.JosmAction

org.openstreetmap.josm.actions.DownloadAlongAction

All Implemented Interfaces:

ActionListener, Serializable, Cloneable, EventListener, Action, Destroyable

Direct Known Subclasses:

DownloadAlongTrackAction

public abstract class DownloadAlongAction
extends JosmAction

Abstract superclass of DownloadAlongTrackAction and DownloadAlongWayAction

Since:

6054

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.openstreetmap.josm.actions.JosmAction

JosmAction.LayerChangeAdapter, JosmAction.SelectionChangeAdapter

Field Summary

Fields inherited from class org.openstreetmap.josm.actions.JosmAction

sc

Fields inherited from class javax.swing.AbstractAction

changeSupport, enabled

Fields inherited from interface javax.swing.Action

ACCELERATOR_KEY, ACTION_COMMAND_KEY, DEFAULT, DISPLAYED_MNEMONIC_INDEX_KEY, LARGE_ICON_KEY, LONG_DESCRIPTION, MNEMONIC_KEY, NAME, SELECTED_KEY, SHORT_DESCRIPTION, SMALL_ICON

Constructor Summary

Constructors

Constructor and Description
DownloadAlongAction(String name, String iconName, String tooltip, Shortcut shortcut, boolean registerInToolbar) Constructs a new DownloadAlongAction

Method Summary

Modifier and Type	Method and Description
protected static void	addToDownload(Area a, Rectangle2D r, Collection<Rectangle2D> results, double maxArea)
protected static void	confirmAndDownloadAreas(Area a, double maxArea, boolean osmDownload, boolean gpxDownload, String title, ProgressMonitor progressMonitor) Area "a" contains the hull that we would like to download data for.

Methods inherited from class org.openstreetmap.josm.actions.JosmAction

destroy, getCurrentDataSet, getEditLayer, getShortcut, initEnabledState, installAdapters, setTooltip, updateEnabledState, updateEnabledState

Methods inherited from class javax.swing.AbstractAction

addPropertyChangeListener, clone, firePropertyChange, getKeys, getPropertyChangeListeners, getValue, isEnabled, putValue, removePropertyChangeListener, setEnabled

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.awt.event.ActionListener

actionPerformed

Constructor Detail

DownloadAlongAction

public DownloadAlongAction(String name,
                           String iconName,
                           String tooltip,
                           Shortcut shortcut,
                           boolean registerInToolbar)

Constructs a new DownloadAlongAction

Parameters:

name - the action's text as displayed in the menu

iconName - the filename of the icon to use

tooltip - a longer description of the action that will be displayed in the tooltip. Please note that html is not supported for menu actions on some platforms.

shortcut - a ready-created shortcut object or null if you don't want a shortcut. But you always do want a shortcut, remember you can always register it with group=none, so you won't be assigned a shortcut unless the user configures one. If you pass null here, the user CANNOT configure a shortcut for your action.

registerInToolbar - register this action for the toolbar preferences?

Method Detail

addToDownload

protected static void addToDownload(Area a,
                                    Rectangle2D r,
                                    Collection<Rectangle2D> results,
                                    double maxArea)

confirmAndDownloadAreas

protected static void confirmAndDownloadAreas(Area a,
                                              double maxArea,
                                              boolean osmDownload,
                                              boolean gpxDownload,
                                              String title,
                                              ProgressMonitor progressMonitor)

Area "a" contains the hull that we would like to download data for. however we can only download rectangles, so the following is an attempt at finding a number of rectangles to download. The idea is simply: Start out with the full bounding box. If it is too large, then split it in half and repeat recursively for each half until you arrive at something small enough to download. The algorithm is improved by always using the intersection between the rectangle and the actual desired area. For example, if you have a track that goes like this: +----+ | /| | / | | / | |/ | +----+ then we would first look at downloading the whole rectangle (assume it's too big), after that we split it in half (upper and lower half), but we donot request the full upper and lower rectangle, only the part of the upper/lower rectangle that actually has something in it. This functions calculates the rectangles, asks the user to continue and downloads the areas if applicable.

Parameters:

a - download area hull

maxArea - maximum area size for a single download

osmDownload - Set to true if OSM data should be downloaded

gpxDownload - Set to true if GPX data should be downloaded

title - the title string for the confirmation dialog

progressMonitor - the progress monitor