| 15 | | The selected [Concepts/Object objects] are drawn in a different style. |
| 16 | | |
| 17 | | Holding and dragging the left mouse button draws a selection rectangle. |
| 18 | | When the left mouse button is released, all [Concepts/Object objects] within the rectangle get |
| 19 | | selected. |
| 20 | | |
| 21 | | When the left mouse button is released while the right mouse button pressed, |
| 22 | | nothing happens (the selection rectangle will be cleared, however). |
| 23 | | |
| 24 | | When the mouse button is released and either **{{{Alt}}}**, **{{{Shift}}}** or **{{{Ctrl}}}** is held, following selection is made: |
| 25 | | |
| 26 | | * **{{{Alt}}}** : select all [Concepts/Object objects] that are touched by the selection rectangle. |
| 27 | | * If the **{{{Alt}}}** is not held, select only those [Concepts/Object objects] completly within (e.g. for [[Image(source:trunk/images/data/way.png)]] [Concepts/Object#Ways ways] this means: only if all [[Image(source:trunk/images/data/node.png)]] [Concepts/Object#Nodes nodes] of the [[Image(source:trunk/images/data/way.png)]] [Concepts/Object#Ways way] are within). |
| 28 | | * **{{{Shift}}}** : the [Concepts/Object objects] are added to the current selection. |
| 29 | | * If **{{{Shift}}}** is not held, the current selection get replaced. |
| 30 | | * **{{{Ctrl}}}** : remove all [Concepts/Object objects] under the current rectangle from the active selection (if there were any). Nothing is added to the current selection. |
| 31 | | |
| 32 | | **{{{Alt}}}** can be combined with **{{{Ctrl}}}** or **{{{Shift}}}**. |
| 33 | | |
| 34 | | The user can also only click on the map. All total movements of 2 or less pixel are considered "only click". If that happens, the nearest [[Image(source:trunk/images/data/node.png)]] [Concepts/Object#Nodes node] will be selected if there is any within 10 pixel range. If there is no [[Image(source:trunk/images/data/node.png)]] [Concepts/Object#Nodes node] within 10 pixel, the nearest [[Image(source:trunk/images/data/way.png)]] [Concepts/Object#Ways way] within 10 pixel range is selected. If there is no [[Image(source:trunk/images/data/way.png)]] [Concepts/Object#Ways way] within 10 pixel and the user clicked in or 10 pixel away from an [[Image(source:trunk/images/data/closedway.png)]] [Concepts/Object#ClosedWays area], this [[Image(source:trunk/images/data/closedway.png)]] [Concepts/Object#ClosedWays area] is selected. If there is even no [[Image(source:trunk/images/data/closedway.png)]] [Concepts/Object#ClosedWays area], nothing is selected. {{{Shift}}} and {{{Ctrl}}} apply to this as usual. |
| 35 | | |
| 36 | | This tool has two different modes. Pressing {{{Shift-M}}} toggles between the different modes. |
| 37 | | |
| 38 | | {{{ |
| 39 | | #!comment |
| 40 | | FIXME: Is this still up to date ? |
| 41 | | }}} |
| 42 | | |
| 43 | | === Unselecting === |
| 44 | | |
| 45 | | To unselect everything you can either click on an empty area of the screen, or press **{{{U}}}** or **{{{Esc}}}** on the keyboard. |
| 46 | | |
| 47 | | If you have more than one [Concepts/Object object] selected, and just want to deselect one particular [Concepts/Object object], them click it with the 'Setect tool' while holding down **{{{Ctrl}}}**. |
| | 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. || |
| 64 | | == Scale == |
| 65 | | You can scale selected [[Image(source:trunk/images/data/way.png)]] [Concepts/Object#Ways ways] while the cursor is near one of them by holding down the **{{{Ctrl+Alt}}}** + left mouse button and moving the cursor. |
| | 44 | === Selection rectangle === #Selectrectangle |
| | 45 | |
| | 46 | ==== Select multiple objects using selection rectangle ==== |
| | 47 | Cursor: [[JOSMImage(cursor/modifier/selection)]] |
| | 48 | |
| | 49 | Activation steps: hold and drag the `Left mouse button` around objects |
| | 50 | |
| | 51 | Actions: |
| | 52 | * Release the `Left mouse button` - to select all [wikitr:/Help/Concepts/Object objects] within the rectangle, more precisely: |
| | 53 | * all nodes within the rectangle and |
| | 54 | * any ways which are **entirely within the rectangle** will be selected |
| | 55 | * ''previously selected object(s)'' will be **replaced with new object(s)** and displayed in [wikitr:/Help/Dialog/SelectionList selection list panel] |
| | 56 | * Hold the `Right mouse button` when releasing the left mouse button - cancel the selection rectangle |
| | 57 | |
| | 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 |
