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

    v66 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]
     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 [wiki:Help/Modes 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
    74 ==== Modifiers ====
    75 When the mouse button is released and either **{{{Alt}}}**, **{{{Shift}}}** or **{{{Ctrl}}}** is held, action will changed; 3 paragraphs below cover it in detail.
     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.
    7660
    77 ====== Combination of modifiers ======
    78 * {{{Alt}}} can be combined with {{{Shift}}}
    79 * {{{Alt}}} can't be combined with {{{Ctrl}}} - as this is used for the **[#Scale scale]** command
     61Pay attention that in order to select elements, you should release right mouse button first, then left mouse button.
    8062
    81 ====== Alt modifier ======
     63==== Modifiers ==== #Modifiers
     64When the mouse button is released and either **`Alt`**, **`Shift`**, **`Ctrl`** or **`Cmd`** is held, action will change:
    8265
    83 Cursor: none
     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. ||
    8470
    85 Activation steps: {{{Alt}}}
     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
    8674
    87 Actions: in addition to the normal behaviour, select all ways that have at least one node within selection rectangle
     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]
    8880
    89 ====== Shift modifier ======
     81== Move == #Move
     82You can move the whole selection by moving the pointer close to a selected object, click and drag the pointer.
    9083
    91 Cursor: [[Image(source:trunk/images/cursor/modifier/select_add.png,24,nolink)]]
     84Moving is also possible with **`Shift + Arrow keys`**.
    9285
    93 Activation steps: {{{Shift}}}
     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
    9487
    95 Actions: the [Concepts/Object objects] are added to the current selection
     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.
    9690
    97 ====== Ctrl modifier ======
     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.
    9892
    99 Cursor: [[Image(source:trunk/images/cursor/modifier/select_remove.png,24,nolink)]]
    100 
    101 Activation steps:
    102 
    103 Actions: remove all [Concepts/Object objects] in current rectangle from selected objects (if there were any); nothing is added to the current selection.
    104 
    105 == Move ==
    106 
    107 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.
    108 * If the mouse cursor is **near a node** when performing the move action, then **just this node** is moved.
    109  * 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**.
    110 * If the mouse cursor is **near a way** when performing the move action, then **this way**, together with its associated **nodes**, is moved.
    111 
    112 Moving objects is also possible with **{{{shift + arrow keys}}}**.
    113 
    114 == Merge nodes ==
    115 
    116 Cursor: [[Image(source:trunk/images/cursor/modifier/joinnode.png,24,nolink)]]
    117 
    118 Activation steps: hold down {{{Ctrl}}} and drag one selected node onto the unselected one
    119 
    120 Action: merge selected nodes with another; internally it will simply use [Help/Action/MergeNodes Merge tool] - please read more details here.
    121 
    122 == Click and drag on segment midpoint will create a new node ==
    123 
    124 Cursor: fixme
    125 
     93=== Drag a Midpoint creates New Node ===
    12694Activation 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.
    12795
    12896Action: will insert a new node at the location of the cross
    12997
    130 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)]]
    131100
    132 [[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
    133102
    134 == Rotate ==
     103Action: merge selected nodes with another; internally it will simply use [wikitr:/Help/Action/MergeNodes Merge Nodes] - please read more details there.
    135104
    136 Cursor: [[Image(source:trunk/images/cursor/rotate.png,24,nolink)]]
     105== Rotate == #Rotate
     106Cursor: [[JOSMImage(cursor/rotate)]]
    137107
    138 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
    139109
    140 Action: rotate selected nodes and ways around their geometrical centre.
     110Action: rotate selected nodes and ways around their geometrical center.
    141111
    142 == Scale ==
     112The rotation angle is displayed in the [wikitr:/Help/StatusBar Status Bar].
    143113
    144 Cursor: [[Image(source:trunk/images/cursor/scale.png,24,nolink)]]
     114Rotation at defined angles is possible via the [osmwiki:JOSM/Plugins/ShapeTools ShapeTools Plugin].
    145115
    146 Activation steps: {{{Ctrl+Alt}}} + {{{Left mouse button}}} and moving mouse up and down
     116== Scale == #Scale
     117Cursor: [[JOSMImage(cursor/scale)]]
    147118
    148 Action:
     119Activation steps: `Ctrl + Alt + left mouse button` (Windows/Linux) or `Cmd + Alt + left mouse button` (Mac) and moving mouse up and down
    149120
    150 * 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.
    151123* if used only on 2 nodes, it will move them from or to their mid point (depending on mouse move)
    152124
    153 == Advanced details ==
    154 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).
    155131
    156132== See also ==
    157 * [wiki:/Help#Selection "Selection" section at main page] - some popular selection tools
    158 * [wiki:Help/Action/UnselectAll Unselect all] {{{Escape}}}
    159 * [[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
    160 * [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
    161135
    162136----
    163 Back to [EditToolbar Edit Toolbar][[BR]]
    164 Back to [wiki:/Help Main Help]
     137Back to [wikitr:/Help/Menu/Mode Mode menu] \\
     138Back to [wikitr:/Help Main Help]