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

    v82 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,middle)]] ''Keyboard shortcut:'' **{{{S}}}**; press {{{S}}} to toggle between this mode and [[Image(source:trunk/images/mapmode/rope.png,20,middle)]] [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,middle)]]; with way [[Image(source:trunk/images/cursor/modifier/select_way.png,24,nolink,middle)]]
    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 ==== Deselecting an object(s) ====
    29 
    30 Cursor: with node [[Image(source:trunk/images/cursor/modifier/select_node_remove.png,24,nolink,middle)]]; with way [[Image(source:trunk/images/cursor/modifier/select_way_remove.png,24,nolink,middle)]]
    31 
    32 Activation steps: hold {{{Alt}}} when using {{{Left mouse button}}}
    33 
    34 Action: a way or node will be removed from the ''currently selected objects''
    35 
    36 ==== Cycle in dense or overlapping objects with pop-up ====
    37 
     28==== Cycle in dense or overlapping objects ====
    3829Cursor: none
    3930
    4031Activation steps:
    41 * {{{Middle mouse click}}} to cycle objects with small pop-up
    42 * {{{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**.
    4334
    4435This is useful when:
    4536
    4637* certain way which **shares common nodes** with one or more other ways
    47 * multiple '''objects overlap'''
    48 * multiple '''objects very close to each other'''
     38* multiple **objects overlap**
     39* multiple **objects very close to each other**
    4940* selecting between multiple nodes if they appear as single node (multiple dots appear as one)
    5041
    51 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.
    5243
    53 TODO: add good pictures
     44=== Selection rectangle === #Selectrectangle
    5445
    55 ==== Double mouse click is used to select first object that surrounds a cursor ====
     46==== Select multiple objects using selection rectangle ====
     47Cursor: [[JOSMImage(cursor/modifier/selection)]]
    5648
    57 Cursor: none
    58 
    59 Activation steps: {{{Double mouse click}}}
    60 
    61 Action: select the surrounding object ([Help/Concepts/Object#Area area] or [Help/Concepts/Object#Relations multipolygon]).
    62 
    63 === Selection rectangle ===
    64 ==== Select multiple objects using selection rectangle ====
    65 
    66 Cursor: [[Image(source:trunk/images/cursor/modifier/selection.png,24,nolink,middle)]]
    67 
    68 Activation steps: hold and drag the {{{Left mouse button}}} around objects
     49Activation steps: hold and drag the `Left mouse button` around objects
    6950
    7051Actions:
    71 * 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:
    7253 * all nodes within the rectangle and
    73  * any ways which are '''entirely within the rectangle''' will be selected
    74  * ''previously selected objects'' will be '''replaced with new object(s)''' and displayed [Help/Dialog/SelectionList in Selection List Dialog]
    75 * 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
    7657
    7758==== Hold right mouse to move rectangle ====
    78 
    7959You can move defined rectangle as many times as you want: simply hold right mouse button and move mouse cursor around.
    8060
    8161Pay attention that in order to select elements, you should release right mouse button first, then left mouse button.
    8262
    83 ==== Modifiers ====
    84 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:
    8565
    86 ====== Combination of modifiers ======
    87 * {{{Alt}}} can be combined with {{{Shift}}}
    88 * {{{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. ||
    8970
    90 ====== 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
    9174
    92 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]
    9380
    94 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.
    9583
    96 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`**.
    9785
    98 ====== 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
    9987
    100 Cursor: [[Image(source:trunk/images/cursor/modifier/select_add.png,24,nolink,middle)]]
     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.
    10190
    102 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.
    10392
    104 Actions: the [Concepts/Object objects] are added to the current selection
    105 
    106 ====== Ctrl modifier ======
    107 
    108 Cursor: [[Image(source:trunk/images/cursor/modifier/select_remove.png,24,nolink,middle)]]
    109 
    110 Activation steps:
    111 
    112 Actions: remove all [Concepts/Object objects] in current rectangle from selected objects (if there were any); nothing is added to the current selection.
    113 
    114 == Move objects ==
    115 
    116 You can move selected [[Image(source:trunk/images/data/node.png,middle)]] [Concepts/Object#Nodes nodes] and [[Image(source:trunk/images/data/way.png,middle)]] [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.
    117 * If the mouse cursor is **near a node** when performing the move action, then **just this node** is moved.
    118  * 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**.
    119 * If the mouse cursor is **near a way** when performing the move action, then **this way**, together with its associated **nodes**, is moved.
    120 
    121 Moving objects is also possible with **{{{shift + arrow keys}}}**.
    122 
    123 === Move multiple objects at once message ===
    124 
    125 You may be asked if it a was mistake. To enable/disable this message use:
    126 
    127 {{{message.movedManyElements}}} in [Help/Preferences/Advanced Advanced Preferences]. Set to {{{true}}} if you want to be asked every time.
    128 
    129 == Merge nodes ==
    130 
    131 Cursor: [[Image(source:trunk/images/cursor/modifier/joinnode.png,24,nolink,middle)]]
    132 
    133 Activation steps: hold down {{{Ctrl}}} and drag one selected node onto the unselected one
    134 
    135 Action: merge selected nodes with another; internally it will simply use [Help/Action/MergeNodes Merge tool] - please read more details here.
    136 
    137 * [[Image(source:trunk/images/mapmode/improvewayaccuracy.png,16,,middle)]] [Action/ImproveWayAccuracy Improve Way Accuracy] - over time many mappers switch to this tools instead of manually selecting-and-moving each node
    138 
    139 == Click and drag on segment midpoint will create a new node ==
    140 
    141 Cursor: fixme
    142 
     93=== Drag a Midpoint creates New Node ===
    14394Activation 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.
    14495
    14596Action: will insert a new node at the location of the cross
    14697
    147 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)]]
    148100
    149 [[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
    150102
    151 == Rotate objects ==
     103Action: merge selected nodes with another; internally it will simply use [wikitr:/Help/Action/MergeNodes Merge Nodes] - please read more details there.
    152104
    153 Cursor: [[Image(source:trunk/images/cursor/rotate.png,24,nolink,middle)]]
     105== Rotate == #Rotate
     106Cursor: [[JOSMImage(cursor/rotate)]]
    154107
    155 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
    156109
    157 Action: rotate selected nodes and ways around their geometrical centre.
     110Action: rotate selected nodes and ways around their geometrical center.
    158111
    159 You might be interested in more complex tools to rotate objects: [wiki:Help#Rotation Help#Rotation] - align road with building (exactly) or rotate at precise angle
     112The rotation angle is displayed in the [wikitr:/Help/StatusBar Status Bar].
    160113
    161 == Scale objects ==
     114Rotation at defined angles is possible via the [osmwiki:JOSM/Plugins/ShapeTools ShapeTools Plugin].
    162115
    163 Cursor: [[Image(source:trunk/images/cursor/scale.png,24,nolink,middle)]]
     116== Scale == #Scale
     117Cursor: [[JOSMImage(cursor/scale)]]
    164118
    165 Activation steps: {{{Ctrl+Alt}}} + {{{Left mouse button}}} and moving mouse up and down
     119Activation steps: `Ctrl + Alt + left mouse button` (Windows/Linux) or `Cmd + Alt + left mouse button` (Mac) and moving mouse up and down
    166120
    167 Action:
    168 
    169 * 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.
    170123* if used only on 2 nodes, it will move them from or to their mid point (depending on mouse move)
    171124
    172 == Advanced details ==
    173 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).
    174131
    175132== See also ==
    176 * [wiki:/Help#Selection "Selection" section at main page] - some popular selection tools
    177 * [Action/UnselectAll Unselect all] {{{Escape}}}
    178 * [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
    179135
    180136----
    181 Back to [EditToolbar Edit Toolbar][[BR]]
    182 Back to [wiki:/Help Main Help]
     137Back to [wikitr:/Help/Menu/Mode Mode menu] \\
     138Back to [wikitr:/Help Main Help]