Changes between Version 34 and Version 116 of Help/Action/Select


Ignore:
Timestamp:
(multiple changes)
Author:
(multiple changes)
Comment:
(multiple changes)

Legend:

Unmodified
Added
Removed
Modified

  • Help/Action/Select

    v34 v116  
    11[[TranslatedPages]]
     2[[PageOutline(2-10,Table of Contents)]]
    23
    3 = Select, Move and Rotate Objects =
     4= Select mode =
    45
    5 [[Image(source:trunk/images/mapmode/move/move.png)]] ''Keyboard shortcut:'' **{{{S}}}**
     6[[JOSMImage(mapmode/move/move,link=,48,middle,margin-right=20)]] ''Keyboard shortcut:'' **`S`** (press `S` again to toggle between [[JOSMImage(mapmode/rope)]] [wikitr:/Help/Action/LassoMode Lasso mode] and this Select mode) — is one of the [wikitr:/Help/Menu/Mode#Workingmode working modes]
    67
    7 **This tool has four possible modes:**
     8**[#Selecttool Select], [#Move move], [#Scale scale] and [#Rotate rotate] [wikitr:/Help/Concepts/Object objects].** \\
     9Despite its name this mode provides some actions. \\
     10The only difference between Select mode and [[JOSMImage(mapmode/rope)]] [wikitr:/Help/Action/LassoMode Lasso mode] is the area selection mode. All other selection modes and actions are identical.
    811
    9 [[PageOutline(2-3,Table of Contents)]]
     12== Select mode == #Selecttool
     13This mode is to change the selection of [wikitr:/Help/Concepts/Object objects] on the map.
    1014
    11 == Select tool ==
     15The selected objects are drawn in a different style (red color by default); depending on [wikitr:/Help/Preferences/Display preferences] and the [wikitr:/Help/Dialog/MapPaint active styles]. They are listed in the [wikitr:/Help/Dialog/SelectionList selection list].
    1216
    13 === Hotkeys ===
    14 || Click || Selects one object. Click in an empty area and drag selects more objects.
    15 || Click || Clicking and dragging a red cross in the middle of a segment will insert a new node at the location of the cross.
    16 || Click-MiddleMouse || Cycle through the different objects under the mouse cursor (for duplicated nodes or ways sharing the same nodes). Holding "Ctrl" afterwards to directly select an object.
    17 || Shift-Click || Holding the "Shift" key when in ''select mode'' adds new element to existing selection.
    18 || Ctrl-Click || Holding the "Ctrl" key toggles element selection.
    19 || Ctrl-Area || Using area selection with "Ctrl" removes elements in area from selection.
    20 || Alt-Click || Cycle through the different objects under the mouse cursor (without popup).
     17The cursor icon will also change depending on the selection mode.
    2118
    22 This MapMode enables the user to make selections of different [Concepts/Object objects]. The selected objects are drawn in a different style, depending on [Help/Preferences/Display display preferences] and the [Help/Dialog/MapPaint active styles]. The cursor icon will also change depending on the selection mode.
     19=== Select the single object === #Selectsingle
     20The 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. ||
    2326
    24 === Selecting single objects ===
    25 **Left-click** to select the node [[Image(source:trunk/images/cursor/modifier/select_node.png)]] or way [[Image(source:trunk/images/cursor/modifier/select_way.png)]] nearest to the pointer. The node or way that would be selected is highlighted as a hint.
    2627
    27 If multiple objects overlap or are very close to each other, there are several ways to select a specific object.
    28 * **Middle-click** to show a pop-up window of nearby objects and to cycle through them.
    29 * **Left-click** while holding the **{{{Alt}}}** (or **{{{AltGr}}}**) key to cycle through nearby objects without showing a pop-up window. To make this type of selection the default, and thus not require the use of the **{{{Alt}}}** key, change the [Help/Preferences/Advanced advanced preference] {{{selectaction.cycles.multiple.matches}}} to true.
     28==== Cycle in dense or overlapping objects ====
     29Cursor: none
    3030
    31 Hold the **{{{Shift}}}** key while **left-clicking** to add the node [[Image(source:trunk/images/cursor/modifier/select_node_add.png)]] or way [[Image(source:trunk/images/cursor/modifier/select_way_add.png)]] to the current selection. Hold the **{{{Ctrl}}}** key while **left-clicking** to toggle the selection of the object (if the object is already selected, remove it from the selection, otherwise add it to the selection).
     31Activation steps:
     32* `Middle mouse click` to cycle objects with small pop-up (see also some information about middle click on [wikitr:/Shortcuts#MacOS Mac OS]).
     33* `Left mouse click` while holding the `Alt` (or `AltGr`) key to cycle through nearby objects **without showing a pop-up window**.
    3234
    33 **Double click** to select the surrounding area (closed way or multipolygon).
     35This is useful when:
    3436
    35 === Selecting multiple objects ===
    36 To select all objects, press **{{{Ctrl+A}}}**.
     37* certain way which **shares common nodes** with one or more other ways
     38* multiple **objects overlap**
     39* multiple **objects very close to each other**
     40* selecting between multiple nodes if they appear as single node (multiple dots appear as one)
    3741
    38 **Hold and drag the left mouse button** to draw a selection rectangle [[Image(source:trunk/images/cursor/modifier/selection.png)]].
     42Action: it will show a pop-up window of nearby objects and to cycle through them. To make this type of selection the default, and thus not require the use of the **`Alt`** key, change the [wikitr:/Help/Preferences/Advanced advanced preference] `selectaction.cycles.multiple.matches` to true. Holding `Ctrl` (Windows/Linux) or `Cmd` (Mac) afterwards to directly select an object.
    3943
    40 * **Release** the left mouse button to select all [Concepts/Object objects] within the rectangle. All nodes within the rectangle and any ways which are entirely within the rectangle will be selected.
    41 * To cancel the selection rectangle, **hold the right mouse button** when releasing the left mouse button.
     44=== Selection rectangle === #Selectrectangle
    4245
    43 When the mouse button is released and either **{{{Alt}}}**, **{{{Shift}}}** or **{{{Ctrl}}}** is held, following selection is made:
     46==== Select multiple objects using selection rectangle ====
     47Cursor: [[JOSMImage(cursor/modifier/selection)]]
    4448
    45 * **{{{Alt}}}** : in addition to the normal behavior, select all ways that have at least one node within selection rectangle.
    46 * **{{{Shift}}}** [[Image(source:trunk/images/cursor/modifier/select_add.png)]]: the [Concepts/Object objects] are added to the current selection.
    47 * **{{{Ctrl}}}** [[Image(source:trunk/images/cursor/modifier/select_remove.png)]]: remove all [Concepts/Object objects] under the current rectangle from the active selection (if there were any). Nothing is added to the current selection.
     49Activation steps: hold and drag the `Left mouse button` around objects
    4850
    49 **{{{Alt}}}** can be combined with **{{{Shift}}}**, but cannot be combined with **{{{Ctrl}}}**, as this is used for the **[#Scale scale]** command.
     51Actions:
     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
    5057
    51 === Unselecting ===
    52 To unselect everything you can either click on an empty area of the screen, or press **{{{Esc}}}** on the keyboard.
     58==== Hold right mouse to move rectangle ====
     59You can move defined rectangle as many times as you want: simply hold right mouse button and move mouse cursor around.
    5360
    54 If you have more than one [Concepts/Object object] selected, and just want to unselect one particular **object**, then click it with the 'Select tool' while holding down **{{{Ctrl}}}** [[Image(source:trunk/images/cursor/modifier/select_node_remove.png)]] [[Image(source:trunk/images/cursor/modifier/select_way_remove.png)]].
     61Pay attention that in order to select elements, you should release right mouse button first, then left mouse button.
    5562
    56 === Selecting particular ways ===
     63==== Modifiers ==== #Modifiers
     64When the mouse button is released and either **`Alt`**, **`Shift`**, **`Ctrl`** or **`Cmd`** is held, action will change:
    5765
    58 For help on selecting a certain way which **shares common nodes** with one or more other ways see [wiki:/HowTo here].
     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. ||
    5970
    60 == Move ==
     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
    6174
    62 You can move selected [[Image(source:trunk/images/data/node.png)]] [Concepts/Object#Nodes nodes] and [[Image(source:trunk/images/data/way.png)]] [Concepts/Object#Ways ways] in the main window, by moving the mouse cursor close to one of the selected objects and then left clicking while dragging the mouse.
    63 * If the mouse cursor is **near a node** when performing the move action, then **just this node** is moved.
    64  * If you move a node very close to another node and hold **{{{Ctrl}}}** when releasing the left mouse button the moved **node** will be merged with the other **node**.
    65 * If the mouse cursor is **near a way** when performing the move action, then **this way**, together with its associated **nodes**, is moved.
     75=== Unselect all ===
     76You 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]
    6680
    67 Moving objects is also possible with **{{{shift + arrow keys}}}**.
     81== Move == #Move
     82You can move the whole selection by moving the pointer close to a selected object, click and drag the pointer.
    6883
    69 === Merge nodes ===
    70 [[Image(source:trunk/images/cursor/modifier/joinnode.png,left,margin-right=20)]]
     84Moving is also possible with **`Shift + Arrow keys`**.
    7185
    72 You can merge selected nodes with another one by holding down **{{{Ctrl}}}** and dragging one selected node onto the unselected one.
     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
    7387
    74 == Rotate ==
    75 [[Image(source:trunk/images/cursor/rotate.png,left,margin-right=20)]]
     88=== Aligned move of selection ===
     89If 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.
    7690
    77 You can rotate selected nodes and ways by holding down **{{{Shift+Ctrl}}}** + left mouse button and moving the cursor.
     91After 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.
    7892
    79 == Scale ==
    80 [[Image(source:trunk/images/cursor/scale.png,left,margin-right=20)]]
     93=== Drag a Midpoint creates New Node ===
     94Activation 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.
    8195
    82 You can scale selected nodes and ways by holding down **{{{Ctrl+Alt}}}** + left mouse button and moving the cursor.
     96Action: will insert a new node at the location of the cross
    8397
    84 == Cursors ==
    85 The cursor changes to indicate what action will occur:
     98== Merge nodes == #Mergenodes
     99Cursor: [[JOSMImage(cursor/modifier/joinnode)]]
    86100
    87 ||=**Cursor**=||=**Action**=||
    88 ||[[Image(source:trunk/images/cursor/modifier/select_node.png)]]|| a node will be selected ||
    89 ||[[Image(source:trunk/images/cursor/modifier/select_node_add.png)]]|| a node will be added to the current selection ||
    90 ||[[Image(source:trunk/images/cursor/modifier/select_node_remove.png)]]|| a node will be removed from the current selection ||
    91 ||[[Image(source:trunk/images/cursor/modifier/select_way.png)]]|| a way will be selected ||
    92 ||[[Image(source:trunk/images/cursor/modifier/select_way_add.png)]]|| a way will be added to the current selection ||
    93 ||[[Image(source:trunk/images/cursor/modifier/select_way_remove.png)]]|| a way will be removed from the current selection ||
    94 ||[[Image(source:trunk/images/cursor/modifier/selection.png)]]|| objects within the rectangle will be selected ||
    95 ||[[Image(source:trunk/images/cursor/modifier/select_add.png)]]|| objects within the rectangle will added to the current selection ||
    96 ||[[Image(source:trunk/images/cursor/modifier/select_remove.png)]]|| objects within the rectangle will removed from the current selection ||
    97 ||[[Image(source:trunk/images/cursor/modifier/joinnode.png)]]|| the selected nodes will be merged with the node near the pointer ||
    98 ||[[Image(source:trunk/images/cursor/rotate.png)]]|| [#Rotate rotate] the selected objects ||
    99 ||[[Image(source:trunk/images/cursor/scale.png)]]|| [#Scale scale] the selected objects ||
     101Activation steps: hold down `Ctrl` (Windows/Linux) or `Cmd` (Mac) and drag one selected node onto an unselected one
    100102
    101 == Advanced details ==
    102 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. 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. These two settings can be changed with the [Help/Preferences/Advanced advanced preferences] {{{edit.initial-move-threshold}}} (pixels) and {{{edit.initial-move-delay}}} (milliseconds).
     103Action: 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
     106Cursor: [[JOSMImage(cursor/rotate)]]
     107
     108Activation steps: `Shift + Ctrl + left mouse button` (Windows/Linux) or `Shift + Cmd + left mouse button` (Mac) and moving mouse up and down
     109
     110Action: rotate selected nodes and ways around their geometrical center.
     111
     112The rotation angle is displayed in the [wikitr:/Help/StatusBar Status Bar].
     113
     114Rotation at defined angles is possible via the [osmwiki:JOSM/Plugins/ShapeTools ShapeTools Plugin].
     115
     116== Scale == #Scale
     117Cursor: [[JOSMImage(cursor/scale)]]
     118
     119Activation steps: `Ctrl + Alt + left mouse button` (Windows/Linux) or `Cmd + Alt + left mouse button` (Mac) and moving mouse up and down
     120
     121Action:
     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
     125The scaling factor is displayed in the [wikitr:/Help/StatusBar Status Bar].
     126
     127== Advanced details ==#Advanceddetails
     128Whether 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.
     129If 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.
     130These two settings can be changed with the [wikitr:/Help/Preferences/Advanced advanced preferences] `edit.initial-move-threshold` (pixels) and `edit.initial-move-delay` (milliseconds).
    103131
    104132== See also ==
    105 * [wiki:Help/Action/LassoMode]
    106 * [wiki:Help/Plugin/UtilsPlugin2 UtilsPlugin2] contains additional selection functionality
     133* [wikitr:/Shortcuts#Altkey] - if `Alt` doesn't work
     134* [wikitr:/Help/Plugin/UtilsPlugin2 UtilsPlugin2] contains additional selection functionality
    107135
    108136----
    109 Back to [EditToolbar Edit Toolbar][[BR]]
    110 Back to [wiki:/Help Main Help]
     137Back to [wikitr:/Help/Menu/Mode Mode menu] \\
     138Back to [wikitr:/Help Main Help]