ParallelWayAction (JOSM)

java.lang.Object
- javax.swing.AbstractAction
- - org.openstreetmap.josm.actions.JosmAction
  - - org.openstreetmap.josm.actions.mapmode.MapMode
    - - org.openstreetmap.josm.actions.mapmode.ParallelWayAction

All Implemented Interfaces:

java.awt.event.ActionListener, java.awt.event.MouseListener, java.awt.event.MouseMotionListener, java.io.Serializable, java.lang.Cloneable, java.util.EventListener, javax.swing.Action, ModifierExListener, PreferenceChangedListener, Destroyable
```
public class ParallelWayAction
extends MapMode
implements ModifierExListener
```
MapMode for making parallel ways. All calculations are done in projected coordinates. TODO: == Functionality == 1. Use selected nodes as split points for the selected ways. The ways containing the selected nodes will be split and only the "inner" parts will be copied 2. Enter exact offset 3. Improve snapping 4. Visual cues could be better 5. (long term) Parallelize and adjust offsets of existing ways == Code quality == a) The mode, flags, and modifiers might be updated more than necessary. Not a performance problem, but better if they where more centralized b) Extract generic MapMode services into a super class and/or utility class c) Maybe better to simply draw our own source way highlighting? Current code doesn't not take into account that ways might been highlighted by other than us. Don't think that situation should ever happen though.

See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`private static class`	`ParallelWayAction.KeyboardModifiersProperty` A property that holds the keyboard modifiers.
`(package private) static class`	`ParallelWayAction.Mode`
`(package private) static class`	`ParallelWayAction.Modifier`
`private class`	`ParallelWayAction.ParallelWayLayer`

Nested classes/interfaces inherited from class org.openstreetmap.josm.actions.JosmAction
JosmAction.ActiveLayerChangeAdapter, JosmAction.LayerChangeAdapter, JosmAction.SelectionChangeAdapter

Field Summary

Fields
Modifier and Type	Field and Description
`private static CachingProperty<java.util.Map<ParallelWayAction.Modifier,java.lang.Boolean>>`	`ADD_TO_SELECTION_MODIFIER_COMBO`
`private static CachingProperty<java.lang.Boolean>`	`COPY_TAGS_DEFAULT`
`private static CachingProperty<java.util.Map<ParallelWayAction.Modifier,java.lang.Boolean>>`	`COPY_TAGS_MODIFIER_COMBO`
`private boolean`	`copyTags`
`private static CachingProperty<java.awt.BasicStroke>`	`HELPER_LINE_STROKE`
`private EastNorth`	`helperLineEnd`
`private EastNorth`	`helperLineStart`
`private static CachingProperty<java.lang.Integer>`	`INITIAL_MOVE_DELAY`
`private static CachingProperty<java.awt.Color>`	`MAIN_COLOR`
`private ParallelWayAction.Mode`	`mode`
`private boolean`	`mouseHasBeenDragged`
`private boolean`	`mouseIsDown`
`private java.awt.Point`	`mousePressedPos`
`private long`	`mousePressedTime`
`private MapView`	`mv`
`private ParallelWays`	`pWays`
`private static CachingProperty<java.awt.BasicStroke>`	`REF_LINE_STROKE`
`private WaySegment`	`referenceSegment`
`private static CachingProperty<java.util.Map<ParallelWayAction.Modifier,java.lang.Boolean>>`	`SET_SELECTED_MODIFIER_COMBO`
`private boolean`	`snap`
`private static CachingProperty<java.lang.Boolean>`	`SNAP_DEFAULT`
`private static CachingProperty<java.lang.Double>`	`SNAP_DISTANCE_CHINESE`
`private static CachingProperty<java.lang.Double>`	`SNAP_DISTANCE_IMPERIAL`
`private static CachingProperty<java.lang.Double>`	`SNAP_DISTANCE_METRIC`
`private static CachingProperty<java.lang.Double>`	`SNAP_DISTANCE_NAUTICAL`
`private static CachingProperty<java.util.Map<ParallelWayAction.Modifier,java.lang.Boolean>>`	`SNAP_MODIFIER_COMBO`
`private static CachingProperty<java.lang.Double>`	`SNAP_THRESHOLD`
`private java.util.Set<Way>`	`sourceWays`
`private ParallelWayAction.ParallelWayLayer`	`temporaryLayer`
`private static CachingProperty<java.util.Map<ParallelWayAction.Modifier,java.lang.Boolean>>`	`TOGGLE_SELECTED_MODIFIER_COMBO`

Fields inherited from class org.openstreetmap.josm.actions.mapmode.MapMode
alt, ctrl, cursor, shift

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

ParallelWayAction(MapFrame mapFrame)
Constructs a new ParallelWayAction.

Constructors
Constructor and Description
`ParallelWayAction(MapFrame mapFrame)` Constructs a new `ParallelWayAction`.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`private void`	`addSourceWay(Way w)`
`private void`	`clearSourceWays()`
`void`	`enterMode()` Makes this map mode active.
`void`	`exitMode()` Makes this map mode inactive.
`java.lang.String`	`getModeHelpText()` Returns a short translated help message describing how this map mode can be used, to be displayed in status line.
`private boolean`	`initParallelWays(java.awt.Point p, boolean copyTags)`
`private boolean`	`isModifiersValidForDragMode()`
`boolean`	`layerIsSupported(Layer l)` Determines if layer `l` is supported by this map mode.
`private boolean`	`matchesCurrentModifiers(CachingProperty<java.util.Map<ParallelWayAction.Modifier,java.lang.Boolean>> spec)`
`private boolean`	`matchesCurrentModifiers(java.util.Map<ParallelWayAction.Modifier,java.lang.Boolean> spec)`
`void`	`modifiersExChanged(int modifiers)` Called when the extended modifiers are changed
`void`	`mouseDragged(java.awt.event.MouseEvent e)`
`void`	`mousePressed(java.awt.event.MouseEvent e)`
`void`	`mouseReleased(java.awt.event.MouseEvent e)`
`private static java.lang.String`	`prefKey(java.lang.String subKey)`
`private void`	`removeSourceWay(Way w)`
`private static void`	`removeWayHighlighting(java.util.Collection<Way> ways)`
`private void`	`resetMouseTrackingState()`
`private boolean`	`sanityCheck()`
`private void`	`setMode(ParallelWayAction.Mode mode)`
`private void`	`updateCursor()`
`private void`	`updateFlagsChangeableAlways()`
`private void`	`updateFlagsOnlyChangeableOnPress()`
`private boolean`	`updateModifiersState(int modifiers)`

Methods inherited from class org.openstreetmap.josm.actions.mapmode.MapMode
actionPerformed, isEditableDataLayer, mouseClicked, mouseEntered, mouseExited, mouseMoved, preferenceChanged, readPreferences, requestFocusInMapView, updateKeyModifiers, updateKeyModifiers, updateKeyModifiers, updateKeyModifiersEx, updateStatusLine

Methods inherited from class org.openstreetmap.josm.actions.JosmAction
buildActiveLayerChangeAdapter, buildLayerChangeAdapter, checkAndConfirmOutlyingOperation, destroy, getLayerManager, getShortcut, initEnabledState, installAdapters, listenToLayerChange, listenToSelectionChange, setHelpId, setTooltip, updateEnabledState, updateEnabledState, updateEnabledStateOnCurrentSelection, updateEnabledStateOnCurrentSelection, updateEnabledStateOnModifiableSelection, waitFuture

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

Field Detail

HELPER_LINE_STROKE

private static final CachingProperty<java.awt.BasicStroke> HELPER_LINE_STROKE

REF_LINE_STROKE

private static final CachingProperty<java.awt.BasicStroke> REF_LINE_STROKE

SNAP_THRESHOLD

private static final CachingProperty<java.lang.Double> SNAP_THRESHOLD

SNAP_DEFAULT

private static final CachingProperty<java.lang.Boolean> SNAP_DEFAULT

COPY_TAGS_DEFAULT

private static final CachingProperty<java.lang.Boolean> COPY_TAGS_DEFAULT

INITIAL_MOVE_DELAY

private static final CachingProperty<java.lang.Integer> INITIAL_MOVE_DELAY

SNAP_DISTANCE_METRIC

private static final CachingProperty<java.lang.Double> SNAP_DISTANCE_METRIC

SNAP_DISTANCE_IMPERIAL

private static final CachingProperty<java.lang.Double> SNAP_DISTANCE_IMPERIAL

SNAP_DISTANCE_CHINESE

private static final CachingProperty<java.lang.Double> SNAP_DISTANCE_CHINESE

SNAP_DISTANCE_NAUTICAL

private static final CachingProperty<java.lang.Double> SNAP_DISTANCE_NAUTICAL

MAIN_COLOR

private static final CachingProperty<java.awt.Color> MAIN_COLOR

SNAP_MODIFIER_COMBO

private static final CachingProperty<java.util.Map<ParallelWayAction.Modifier,java.lang.Boolean>> SNAP_MODIFIER_COMBO

COPY_TAGS_MODIFIER_COMBO

private static final CachingProperty<java.util.Map<ParallelWayAction.Modifier,java.lang.Boolean>> COPY_TAGS_MODIFIER_COMBO

ADD_TO_SELECTION_MODIFIER_COMBO

private static final CachingProperty<java.util.Map<ParallelWayAction.Modifier,java.lang.Boolean>> ADD_TO_SELECTION_MODIFIER_COMBO

TOGGLE_SELECTED_MODIFIER_COMBO

private static final CachingProperty<java.util.Map<ParallelWayAction.Modifier,java.lang.Boolean>> TOGGLE_SELECTED_MODIFIER_COMBO

SET_SELECTED_MODIFIER_COMBO

private static final CachingProperty<java.util.Map<ParallelWayAction.Modifier,java.lang.Boolean>> SET_SELECTED_MODIFIER_COMBO

mode
```
private ParallelWayAction.Mode mode
```

copyTags
```
private boolean copyTags
```

snap
```
private boolean snap
```

mv
```
private final MapView mv
```

mousePressedPos
```
private java.awt.Point mousePressedPos
```

mouseIsDown
```
private boolean mouseIsDown
```

mousePressedTime
```
private long mousePressedTime
```

mouseHasBeenDragged
```
private boolean mouseHasBeenDragged
```

referenceSegment

private transient WaySegment referenceSegment

pWays
```
private transient ParallelWays pWays
```

sourceWays

private transient java.util.Set<Way> sourceWays

helperLineStart
```
private EastNorth helperLineStart
```

helperLineEnd
```
private EastNorth helperLineEnd
```

temporaryLayer

private final ParallelWayAction.ParallelWayLayer temporaryLayer

Constructor Detail
- ParallelWayAction
```
public ParallelWayAction(MapFrame mapFrame)
```
  Constructs a new ParallelWayAction.
  
  Parameters:
  
  mapFrame - Map frame

Method Detail
- enterMode
```
public void enterMode()
```
  Description copied from class: MapMode
  
  Makes this map mode active.
  
  Overrides:
  
  enterMode in class MapMode
- exitMode
```
public void exitMode()
```
  Description copied from class: MapMode
  
  Makes this map mode inactive.
  
  Overrides:
  
  exitMode in class MapMode
- getModeHelpText
```
public java.lang.String getModeHelpText()
```
  Description copied from class: MapMode
  
  Returns a short translated help message describing how this map mode can be used, to be displayed in status line.
  
  Overrides:
  
  getModeHelpText in class MapMode
  
  Returns:
  
  a short translated help message describing how this map mode can be used
- layerIsSupported
```
public boolean layerIsSupported(Layer l)
```
  Description copied from class: MapMode
  
  Determines if layer l is supported by this map mode. By default, all tools will work with all layers. Can be overwritten to require a special type of layer
  
  Overrides:
  
  layerIsSupported in class MapMode
  
  Parameters:
  
  l - layer
  
  Returns:
  
  true if the layer is supported by this map mode
- modifiersExChanged
```
public void modifiersExChanged(int modifiers)
```
  Description copied from interface: ModifierExListener
  
  Called when the extended modifiers are changed
  
  Specified by:
  
  modifiersExChanged in interface ModifierExListener
  
  Parameters:
  
  modifiers - The new extended modifiers
- updateModifiersState
```
private boolean updateModifiersState(int modifiers)
```
- updateCursor
```
private void updateCursor()
```
- setMode
```
private void setMode(ParallelWayAction.Mode mode)
```
- sanityCheck
```
private boolean sanityCheck()
```
- mousePressed
```
public void mousePressed(java.awt.event.MouseEvent e)
```
  Specified by:
  
  mousePressed in interface java.awt.event.MouseListener
  
  Overrides:
  
  mousePressed in class MapMode
- mouseReleased
```
public void mouseReleased(java.awt.event.MouseEvent e)
```
  Specified by:
  
  mouseReleased in interface java.awt.event.MouseListener
  
  Overrides:
  
  mouseReleased in class MapMode
- removeWayHighlighting
```
private static void removeWayHighlighting(java.util.Collection<Way> ways)
```
- mouseDragged
```
public void mouseDragged(java.awt.event.MouseEvent e)
```
  Specified by:
  
  mouseDragged in interface java.awt.event.MouseMotionListener
  
  Overrides:
  
  mouseDragged in class MapMode
- matchesCurrentModifiers
```
private boolean matchesCurrentModifiers(CachingProperty<java.util.Map<ParallelWayAction.Modifier,java.lang.Boolean>> spec)
```
- matchesCurrentModifiers
```
private boolean matchesCurrentModifiers(java.util.Map<ParallelWayAction.Modifier,java.lang.Boolean> spec)
```
- isModifiersValidForDragMode
```
private boolean isModifiersValidForDragMode()
```
- updateFlagsOnlyChangeableOnPress
```
private void updateFlagsOnlyChangeableOnPress()
```
- updateFlagsChangeableAlways
```
private void updateFlagsChangeableAlways()
```
- addSourceWay
```
private void addSourceWay(Way w)
```
- removeSourceWay
```
private void removeSourceWay(Way w)
```
- clearSourceWays
```
private void clearSourceWays()
```
- resetMouseTrackingState
```
private void resetMouseTrackingState()
```
- initParallelWays
```
private boolean initParallelWays(java.awt.Point p,
                                 boolean copyTags)
```
- prefKey
```
private static java.lang.String prefKey(java.lang.String subKey)
```

Class ParallelWayAction

Nested Class Summary

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

Field Summary

Fields inherited from class org.openstreetmap.josm.actions.mapmode.MapMode

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

Fields inherited from class javax.swing.AbstractAction

Fields inherited from interface javax.swing.Action

Constructor Summary

Method Summary

Methods inherited from class org.openstreetmap.josm.actions.mapmode.MapMode

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

Methods inherited from class javax.swing.AbstractAction

Methods inherited from class java.lang.Object

Field Detail

HELPER_LINE_STROKE

REF_LINE_STROKE

SNAP_THRESHOLD

SNAP_DEFAULT

COPY_TAGS_DEFAULT

INITIAL_MOVE_DELAY

SNAP_DISTANCE_METRIC

SNAP_DISTANCE_IMPERIAL

SNAP_DISTANCE_CHINESE

SNAP_DISTANCE_NAUTICAL

MAIN_COLOR

SNAP_MODIFIER_COMBO

COPY_TAGS_MODIFIER_COMBO

ADD_TO_SELECTION_MODIFIER_COMBO

TOGGLE_SELECTED_MODIFIER_COMBO

SET_SELECTED_MODIFIER_COMBO

mode

copyTags

snap

mv

mousePressedPos

mouseIsDown

mousePressedTime

mouseHasBeenDragged

referenceSegment

pWays

sourceWays

helperLineStart

helperLineEnd

temporaryLayer

Constructor Detail

ParallelWayAction

Method Detail

enterMode

exitMode

getModeHelpText

layerIsSupported

modifiersExChanged

updateModifiersState

updateCursor

setMode

sanityCheck

mousePressed

mouseReleased

removeWayHighlighting

mouseDragged

matchesCurrentModifiers

matchesCurrentModifiers

isModifiersValidForDragMode

updateFlagsOnlyChangeableOnPress

updateFlagsChangeableAlways

addSourceWay

removeSourceWay

clearSourceWays

resetMouseTrackingState

initParallelWays

prefKey