| 18 | | When the left mouse button is released while the right mouse button pressed, |
| 19 | | nothing happens (the selection rectangle will be cleared, however). |
| 20 | | |
| 21 | | When the mouse button is released and one of the following keys is held: |
| 22 | | |
| 23 | | * alt-key: select all objects that are touched by the selection rectangle. If the alt key is not held, select only those objects completly within (e.g. for ways mean: only if all nodes of the way are within). |
| 24 | | |
| 25 | | * shift-key: the objects are added to the current selection. If Shift key is not held, the current selection get replaced. |
| 26 | | |
| 27 | | * ctrl-key: remove all objects under the current rectangle from the active selection (if there were any). Nothing is added to the current selection. |
| 28 | | |
| 29 | | Alt can be combined with Ctrl or Shift. |
| 30 | | |
| 31 | | The user can also only click on the map. All total movements of 2 or less |
| 32 | | pixel are considered "only click". If that happens, the nearest Node will |
| 33 | | be selected if there is any within 10 pixel range. If there is no Node within |
| 34 | | 10 pixel, the nearest Way within 10 pixel range is selected. If there is no Way within 10 pixel |
| 35 | | and the user clicked in or 10 pixel away from an area, this area is selected. |
| 36 | | If there is even no area, nothing is selected. Shift and Ctrl key applies to |
| 37 | | this as usual. |
| 38 | | |
| 39 | | This tool has two different modes. Pressing shift-m toggles between the different modes. |
| 40 | | |
| 41 | | === Unselecting === |
| 42 | | |
| 43 | | To unselect everything you can either click on an empty area of the screen, or press 'U' on the keyboard. |
| 44 | | |
| 45 | | If you have more than one item selected, and just want to deselect one particular item, them click it with the 'Setect tool' while holding down the CTRL key. |
| | 19 | === Select the single object === #Selectsingle |
| | 20 | The cursor changes depending on the object. In the table below, the icon on the top is the default, the icon(s) in the middle for a [[JOSMImage(data/node)]] node and the icon(s) on the bottom for a [[JOSMImage(data/way)]] way. |
| | 21 | ||= **Name** =||= **Activation steps** =||= **Cursor** =||= **Description** =|| |
| | 22 | || **Select** || **`Left mouse click`** || [[JOSMImage(cursor/modifier/selection)]] \\ [[JOSMImage(cursor/modifier/select_node)]] \\ [[JOSMImage(cursor/modifier/select_way)]] || Select a node or way under mouse cursor. More precisely, ''previously selected object(s)'' will be **replaced** with new object and displayed in [wikitr:/Help/Dialog/SelectionList selection list]. || |
| | 23 | || **Add** || **`Shift + Left mouse click`** || [[JOSMImage(cursor/modifier/select_add)]] \\ [[JOSMImage(cursor/modifier/select_node_add)]] \\ [[JOSMImage(cursor/modifier/select_way_add)]] || Add a node or way under mouse cursor to the selection. || |
| | 24 | || **Toggle** || **`Ctrl + Left mouse click`** (Windows/Linux) \\ **`Cmd + Left mouse click`** (Mac) || [[JOSMImage(cursor/modifier/select_remove)]] \\ [[JOSMImage(cursor/modifier/select_node_add)]] [[JOSMImage(cursor/modifier/select_node_remove)]] \\ [[JOSMImage(cursor/modifier/select_way_add)]] [[JOSMImage(cursor/modifier/select_way_remove)]] || The selection of a node or way will be **toggled**. More precisely, previously unselected object will be added to the selection and previously selected object will be removed from the selection. || |
| | 25 | || **Select surrounding** || **`Double left mouse click`** || ''default'' || Select the surrounding object ([[JOSMImage(data/closedway)]] [wikitr:/Help/Concepts/Object#Areas area] or [[JOSMImage(data/multipolygon)]] [wikitr:/Help/Concepts/Object#Relations multipolygon]). \\ \\ Can be used in combination with `Shift` or `Ctrl` but `Ctrl` only removes the surrounding object from the selection in this use case. || |
| 65 | | Back to [wiki:Help Main Help] |
| | 58 | ==== Hold right mouse to move rectangle ==== |
| | 59 | You can move defined rectangle as many times as you want: simply hold right mouse button and move mouse cursor around. |
| | 60 | |
| | 61 | Pay attention that in order to select elements, you should release right mouse button first, then left mouse button. |
| | 62 | |
| | 63 | ==== Modifiers ==== #Modifiers |
| | 64 | When the mouse button is released and either **`Alt`**, **`Shift`**, **`Ctrl`** or **`Cmd`** is held, action will change: |
| | 65 | |
| | 66 | ||= **Name** =||= **Key** =||= **Cursor** =||= **Description** =|| |
| | 67 | || **Extended way selection** || **`Alt`** || ''default'' || In addition to the normal behavior, select all ways that have at least one node within selection rectangle || |
| | 68 | || **Add** || **`Shift`** || [[JOSMImage(cursor/modifier/select_add)]] || The [wikitr:/Help/Concepts/Object objects] are added to the current selection || |
| | 69 | || **Unselect** || **`Ctrl`** (Windows/Linux) or **`Cmd`** (Mac) || [[JOSMImage(cursor/modifier/select_remove)]] || Remove all [wikitr:/Help/Concepts/Object objects] in current rectangle from selection (if there were any). \\Nothing is added to the current selection. || |
| | 70 | |
| | 71 | * `Alt` can be combined with `Shift` |
| | 72 | * `Alt` can't be combined with `Ctrl` or `Cmd` - as this is used for the **scale** command described [#Scale below] |
| | 73 | * `Ctrl` or `Cmd` combined with `Shift` makes no sense |
| | 74 | |
| | 75 | === Unselect all === |
| | 76 | You can unselect all by: |
| | 77 | * `Esc` key **or** |
| | 78 | * `Left mouse click` into empty map area **or** |
| | 79 | * [wikitr:/Help/Action/UnselectAll Selection > Unselect All] |
| | 80 | |
| | 81 | == Move == #Move |
| | 82 | You can move the whole selection by moving the pointer close to a selected object, click and drag the pointer. |
| | 83 | |
| | 84 | Moving is also possible with **`Shift + Arrow keys`**. |
| | 85 | |
| | 86 | [[JOSMImage(mapmode/improvewayaccuracy)]] [wikitr:/Help/Action/ImproveWayAccuracy Improve Way Accuracy] - over time many mappers switch to this tools instead of manually selecting-and-moving each node |
| | 87 | |
| | 88 | === Aligned move of selection === |
| | 89 | If the last-added way in the selection consists of exactly two nodes, then the whole move can be aligned to its direction by pressing and holding `Ctrl` (Windows/Linux) or `Cmd` (Mac) while dragging. |
| | 90 | |
| | 91 | After mousebutton-down you can toggle `Ctrl` (resp. `Cmd`) arbitrarily often to switch between free and aligned move. The constrain offers four directions defined by the last-selected way (move within its direction, against it, and 90° rotations of these; vaguely comparable to the cardinal directions of a compass). To end an aligned move, it is recommended to release the mouse button before keyboard modifier key. |
| | 92 | |
| | 93 | === Drag a Midpoint creates New Node === |
| | 94 | Activation steps: ''clicking and dragging'' a yellow cross in the middle of a segment; at any point in time, there N mid points to drag where N is number of segments. |
| | 95 | |
| | 96 | Action: will insert a new node at the location of the cross |
| | 97 | |
| | 98 | == Merge nodes == #Mergenodes |
| | 99 | Cursor: [[JOSMImage(cursor/modifier/joinnode)]] |
| | 100 | |
| | 101 | Activation steps: hold down `Ctrl` (Windows/Linux) or `Cmd` (Mac) and drag one selected node onto an unselected one |
| | 102 | |
| | 103 | Action: merge selected nodes with another; internally it will simply use [wikitr:/Help/Action/MergeNodes Merge Nodes] - please read more details there. |
| | 104 | |
| | 105 | == Rotate == #Rotate |
| | 106 | Cursor: [[JOSMImage(cursor/rotate)]] |
| | 107 | |
| | 108 | Activation steps: `Shift + Ctrl + left mouse button` (Windows/Linux) or `Shift + Cmd + left mouse button` (Mac) and moving mouse up and down |
| | 109 | |
| | 110 | Action: rotate selected nodes and ways around their geometrical center. |
| | 111 | |
| | 112 | The rotation angle is displayed in the [wikitr:/Help/StatusBar Status Bar]. |
| | 113 | |
| | 114 | Rotation at defined angles is possible via the [osmwiki:JOSM/Plugins/ShapeTools ShapeTools Plugin]. |
| | 115 | |
| | 116 | == Scale == #Scale |
| | 117 | Cursor: [[JOSMImage(cursor/scale)]] |
| | 118 | |
| | 119 | Activation steps: `Ctrl + Alt + left mouse button` (Windows/Linux) or `Cmd + Alt + left mouse button` (Mac) and moving mouse up and down |
| | 120 | |
| | 121 | Action: |
| | 122 | * scale selected nodes and ways around their geometrical center. Proportions will be kept. |
| | 123 | * if used only on 2 nodes, it will move them from or to their mid point (depending on mouse move) |
| | 124 | |
| | 125 | The scaling factor is displayed in the [wikitr:/Help/StatusBar Status Bar]. |
| | 126 | |
| | 127 | == Advanced details ==#Advanceddetails |
| | 128 | Whether a mouse action is considered a selection or a move depends on some settings, to prevent objects from being moved when a simple selection was intended; this is particularly important on devices such as tablets that are touch sensitive or use a stylus. |
| | 129 | If the pointer is moved between pressing and releasing the left mouse button, the object will only be moved if the pointer moved more than 5 pixels or was held down for more than 0.2 seconds, otherwise the object will simply be selected. |
| | 130 | These two settings can be changed with the [wikitr:/Help/Preferences/Advanced advanced preferences] `edit.initial-move-threshold` (pixels) and `edit.initial-move-delay` (milliseconds). |
| | 131 | |
| | 132 | == See also == |
| | 133 | * [wikitr:/Shortcuts#Altkey] - if `Alt` doesn't work |
| | 134 | * [wikitr:/Help/Plugin/UtilsPlugin2 UtilsPlugin2] contains additional selection functionality |
| | 135 | |
| | 136 | ---- |
| | 137 | Back to [wikitr:/Help/Menu/Mode Mode menu] \\ |
| | 138 | Back to [wikitr:/Help Main Help] |