Changes between Version 71 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

    v71 v116  
    11[[TranslatedPages]]
     2[[PageOutline(2-10,Table of Contents)]]
    23
    3 [[PageOutline(1-6,Table of Contents)]]
     4= Select mode =
    45
    5 = Selection mode, Move and Rotate Objects =
     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 [[Image(source:trunk/images/mapmode/move/move.png)]] ''Keyboard shortcut:'' **{{{S}}}**; press {{{S}}} to toggle between this mode and [[Image(source:trunk/images/mapmode/rope.png,20,link=)]] [wiki:Help/Action/LassoMode lasso mode] — is a one of the [wiki:Help/Modes JOSM 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 == Selection mode == #Selecttool
     12== Select mode == #Selecttool
     13This mode is to change the selection of [wikitr:/Help/Concepts/Object objects] on the map.
    1014
    11 This mode enables the user to make selections of different [Concepts/Object objects].
    12 
    13 The selected objects are drawn in a different style (red colour by default); depending on [Help/Preferences/Display display preferences] and the [Help/Dialog/MapPaint active styles].
     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].
    1416
    1517The cursor icon will also change depending on the selection mode.
    1618
    17 === Select the single object ===
    18 ==== Single left mouse click is used to select an object ====
     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. ||
    1926
    20 Cursor: with node [[Image(source:trunk/images/cursor/modifier/select_node.png,24,nolink)]]; with way [[Image(source:trunk/images/cursor/modifier/select_way.png,24,nolink)]]
    2127
    22 Activation steps: {{{Left mouse click}}}
    23 
    24 Action: Select a node or way under mouse cursor.
    25 
    26 More precisely, ''previously selected object(s)'' will be '''replaced''' with new object and displayed [Help/Dialog/SelectionList in Selection List Dialog].
    27 
    28 ==== Select the way ====
    29 
     28==== Cycle in dense or overlapping objects ====
    3029Cursor: none
    3130
    3231Activation steps:
    33 * {{{Middle mouse click}}}
    34 * {{{Left mouse click}}} while holding the {{{Alt}}} (or {{{AltGr}}}) key to cycle through nearby objects '''without showing a pop-up window'''
     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**.
    3534
    3635This is useful when:
    3736
    3837* certain way which **shares common nodes** with one or more other ways
    39 * multiple '''objects overlap'''
    40 * multiple '''objects very close to each other'''
     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)
    4141
    42 Action: 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 [Help/Preferences/Advanced advanced preference] {{{selectaction.cycles.multiple.matches}}} to true. Holding {{{Ctrl}}} afterwards to directly select an object.
     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.
    4343
    44 ==== Double mouse click is used to select an object under cursor ====
     44=== Selection rectangle === #Selectrectangle
    4545
    46 Cursor: none
     46==== Select multiple objects using selection rectangle ====
     47Cursor: [[JOSMImage(cursor/modifier/selection)]]
    4748
    48 Activation steps: {{{Double mouse click}}}
    49 
    50 Action: select the surrounding object ([Help/Concepts/Object#Relations closed way] or [Help/Concepts/Object#Relations multipolygon]).
    51 
    52 === Deselecting an object(s) ===
    53 
    54 Cursor: with node [[Image(source:trunk/images/cursor/modifier/select_node_remove.png,24,nolink)]]; with way [[Image(source:trunk/images/cursor/modifier/select_way_remove.png,24,nolink)]]
    55 
    56 Activation steps: hold {{{Alt}}} when using {{{Left mouse button}}}
    57 
    58 Action: a way or node will be removed from the ''currently selected objects''
    59 
    60 === Selection rectangle ===
    61 ==== Select multiple objects using selection rectangle ====
    62 
    63 Cursor: [[Image(source:trunk/images/cursor/modifier/selection.png,24,nolink)]]
    64 
    65 Activation steps: hold and drag the {{{Left mouse button}}} around objects
     49Activation steps: hold and drag the `Left mouse button` around objects
    6650
    6751Actions:
    68 * Release the {{{Left mouse button}}} - to select all [Concepts/Object objects] within the rectangle, more precisely:
     52* Release the `Left mouse button` - to select all [wikitr:/Help/Concepts/Object objects] within the rectangle, more precisely:
    6953 * all nodes within the rectangle and
    70  * any ways which are '''entirely within the rectangle''' will be selected
    71  * ''previously selected objects'' will be '''replaced with new object(s)''' and displayed [Help/Dialog/SelectionList in Selection List Dialog]
    72 * Hold the {{{Right mouse button}}} when releasing the left mouse button - cancel the selection rectangle
     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
    7357
    7458==== Hold right mouse to move rectangle ====
    75 
    7659You can move defined rectangle as many times as you want: simply hold right mouse button and move mouse cursor around.
    7760
    7861Pay attention that in order to select elements, you should release right mouse button first, then left mouse button.
    7962
    80 ==== Modifiers ====
    81 When the mouse button is released and either **{{{Alt}}}**, **{{{Shift}}}** or **{{{Ctrl}}}** is held, action will changed; 3 paragraphs below cover it in detail.
     63==== Modifiers ==== #Modifiers
     64When the mouse button is released and either **`Alt`**, **`Shift`**, **`Ctrl`** or **`Cmd`** is held, action will change:
    8265
    83 ====== Combination of modifiers ======
    84 * {{{Alt}}} can be combined with {{{Shift}}}
    85 * {{{Alt}}} can't be combined with {{{Ctrl}}} - as this is used for the **[#Scale scale]** command
     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. ||
    8670
    87 ====== Alt modifier ======
     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
    8874
    89 Cursor: none
     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]
    9080
    91 Activation steps: {{{Alt}}}
     81== Move == #Move
     82You can move the whole selection by moving the pointer close to a selected object, click and drag the pointer.
    9283
    93 Actions: in addition to the normal behaviour, select all ways that have at least one node within selection rectangle
     84Moving is also possible with **`Shift + Arrow keys`**.
    9485
    95 ====== Shift modifier ======
     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
    9687
    97 Cursor: [[Image(source:trunk/images/cursor/modifier/select_add.png,24,nolink)]]
     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.
    9890
    99 Activation steps: {{{Shift}}}
     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.
    10092
    101 Actions: the [Concepts/Object objects] are added to the current selection
    102 
    103 ====== Ctrl modifier ======
    104 
    105 Cursor: [[Image(source:trunk/images/cursor/modifier/select_remove.png,24,nolink)]]
    106 
    107 Activation steps:
    108 
    109 Actions: remove all [Concepts/Object objects] in current rectangle from selected objects (if there were any); nothing is added to the current selection.
    110 
    111 == Move ==
    112 
    113 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.
    114 * If the mouse cursor is **near a node** when performing the move action, then **just this node** is moved.
    115  * 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**.
    116 * If the mouse cursor is **near a way** when performing the move action, then **this way**, together with its associated **nodes**, is moved.
    117 
    118 Moving objects is also possible with **{{{shift + arrow keys}}}**.
    119 
    120 == Merge nodes ==
    121 
    122 Cursor: [[Image(source:trunk/images/cursor/modifier/joinnode.png,24,nolink)]]
    123 
    124 Activation steps: hold down {{{Ctrl}}} and drag one selected node onto the unselected one
    125 
    126 Action: merge selected nodes with another; internally it will simply use [Help/Action/MergeNodes Merge tool] - please read more details here.
    127 
    128 == Click and drag on segment midpoint will create a new node ==
    129 
    130 Cursor: fixme
    131 
     93=== Drag a Midpoint creates New Node ===
    13294Activation 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.
    13395
    13496Action: will insert a new node at the location of the cross
    13597
    136 On illustration below shown twice: you cannot create node ''simply by clicking a midpoint'' (second segment from the left in this case) as it will select whole way (red glow); instead, you should ''click and drag'' midpoint.
     98== Merge nodes == #Mergenodes
     99Cursor: [[JOSMImage(cursor/modifier/joinnode)]]
    137100
    138 [[Image(ex-move-segment-node-1.gif,nolink)]]
     101Activation steps: hold down `Ctrl` (Windows/Linux) or `Cmd` (Mac) and drag one selected node onto an unselected one
    139102
    140 == Rotate ==
     103Action: merge selected nodes with another; internally it will simply use [wikitr:/Help/Action/MergeNodes Merge Nodes] - please read more details there.
    141104
    142 Cursor: [[Image(source:trunk/images/cursor/rotate.png,24,nolink)]]
     105== Rotate == #Rotate
     106Cursor: [[JOSMImage(cursor/rotate)]]
    143107
    144 Activation steps: {{{Shift+Ctrl}}} + {{{Left mouse button}}} and moving mouse up and down
     108Activation steps: `Shift + Ctrl + left mouse button` (Windows/Linux) or `Shift + Cmd + left mouse button` (Mac) and moving mouse up and down
    145109
    146 Action: rotate selected nodes and ways around their geometrical centre.
     110Action: rotate selected nodes and ways around their geometrical center.
    147111
    148 == Scale ==
     112The rotation angle is displayed in the [wikitr:/Help/StatusBar Status Bar].
    149113
    150 Cursor: [[Image(source:trunk/images/cursor/scale.png,24,nolink)]]
     114Rotation at defined angles is possible via the [osmwiki:JOSM/Plugins/ShapeTools ShapeTools Plugin].
    151115
    152 Activation steps: {{{Ctrl+Alt}}} + {{{Left mouse button}}} and moving mouse up and down
     116== Scale == #Scale
     117Cursor: [[JOSMImage(cursor/scale)]]
    153118
    154 Action:
     119Activation steps: `Ctrl + Alt + left mouse button` (Windows/Linux) or `Cmd + Alt + left mouse button` (Mac) and moving mouse up and down
    155120
    156 * scale selected nodes and ways around their geometrical centre. Proportions will be kept.
     121Action:
     122* scale selected nodes and ways around their geometrical center. Proportions will be kept.
    157123* if used only on 2 nodes, it will move them from or to their mid point (depending on mouse move)
    158124
    159 == Advanced details ==
    160 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).
     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).
    161131
    162132== See also ==
    163 * [wiki:/Help#Selection "Selection" section at main page] - some popular selection tools
    164 * [wiki:Help/Action/UnselectAll Unselect all] {{{Escape}}}
    165 * [[Image(source:trunk/images/mapmode/improvewayaccuracy.png,16,link=)]] [wiki:Help/Action/ImproveWayAccuracy Improve Way Accuracy] - over time many mappers switch to this tools instead of manually moving each node
    166 * [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
    167135
    168136----
    169 Back to [EditToolbar Edit Toolbar][[BR]]
    170 Back to [wiki:/Help Main Help]
     137Back to [wikitr:/Help/Menu/Mode Mode menu] \\
     138Back to [wikitr:/Help Main Help]