[Bf-docboard-svn] bf-manual: [9380] trunk/blender_docs/manual/interface/selecting.rst: Describe the differences between Blender's selection tool and operators
Aaron Carlisle
noreply at blender.org
Mon Jun 27 16:27:52 CEST 2022
Revision: 9380
https://developer.blender.org/rBM9380
Author: Blendify
Date: 2022-06-27 16:27:52 +0200 (Mon, 27 Jun 2022)
Log Message:
-----------
Describe the differences between Blender's selection tool and operators
Author: @arc_
Differential Revision: https://developer.blender.org/D15054
Modified Paths:
--------------
trunk/blender_docs/manual/interface/selecting.rst
Modified: trunk/blender_docs/manual/interface/selecting.rst
===================================================================
--- trunk/blender_docs/manual/interface/selecting.rst 2022-06-27 14:01:15 UTC (rev 9379)
+++ trunk/blender_docs/manual/interface/selecting.rst 2022-06-27 14:27:52 UTC (rev 9380)
@@ -3,15 +3,37 @@
Selecting
*********
-By default Blender uses the :kbd:`LMB` to select items in the Blender window.
-Alternatively, the :kbd:`RMB` can be used instead by changing
-the :doc:`Preferences </editors/preferences/keymap>`.
-Blender has several selecting tools that can be used across the different editors.
+By default, Blender uses :kbd:`LMB` to select items.
+This can be changed to :kbd:`RMB` in the :doc:`Preferences </editors/preferences/keymap>`.
+Blender has several selection tools that can be used across the different editors.
-Selection Tools
-===============
+.. note::
+ Some editors deviate from the keyboard shortcuts shown below. For example, most editors
+ use :kbd:`Shift` to add a single item to the selection, but the
+ :doc:`Outliner </editors/outliner/introduction>` uses :kbd:`Ctrl`.
+ Similarly, most editors use :kbd:`Ctrl-RMB` for performing a *Lasso Select*,
+ but :doc:`node editors </interface/controls/nodes/introduction>` use :kbd:`Ctrl-Alt-LMB`.
+
+Most selection tools come in two variants, where one variant is available in the Toolbar
+and the other in the *Select* menu. While the variants' names are almost identical
+(such as *Select Box* in the Toolbar versus *Box Select* in the menu),
+the way they work is a bit different. New users coming from other applications
+will find the Toolbar variants to be the most familiar.
+
+
+Toolbar Selection Tools
+=======================
+
+All the Toolbar selection tools behave the same when clicking an item: they select it
+(and deselect any previously selected items). If you hold :kbd:`Shift` while clicking,
+the item will be added to the selection (if it's not selected) or removed from the selection
+(if it is selected).
+
+What makes the tools different is what happens when you drag.
+
+
.. _tool-select-tweak:
Tweak
@@ -19,34 +41,32 @@
.. reference::
- :Shortcut: :kbd:`LMB`
+ :Tool: :menuselection:`Toolbar --> Tweak`
+ :Shortcut: :kbd:`W`
-Clicking on an item selects it, using modifier keys you can perform other operations.
-Holding the selection and moving the mouse on interactive items such as objects in the 3D Viewport
-or keyframes in an animation editor will general move the item with the mouse.
+Dragging an item will move it around.
-.. _bpy.ops.*.select_box:
.. _tool-select-box:
-Box Select
+Select Box
----------
.. reference::
- :Menu: :menuselection:`Select --> Box Select`
- :Shortcut: :kbd:`B`
+ :Tool: :menuselection:`Toolbar --> Select Box`
+ :Shortcut: :kbd:`W`
-To activate the tool, press :kbd:`B` or click and drag :kbd:`LMB`.
-With *Select Box* you draw a rectangle while holding down :kbd:`LMB`.
-Any item that lies even partially within this rectangle becomes selected.
-If any item that was last active appears in the selection it will become active.
+Dragging will create a rectangle, and select all the items that are partially or completely inside it
+once you release. (Any other items will be deselected.)
-For deselecting items, use :kbd:`MMB`, or :kbd:`Shift-LMB`.
-To move the selection area hold :kbd:`Ctrl-Spacebar` while moving the cursor.
+Holding :kbd:`Shift` while dragging will add the items to the selection.
+Holding :kbd:`Ctrl` will remove them.
-.. list-table:: Box Select example.
+While dragging, you can additionally hold :kbd:`Spacebar` to move the rectangle around with the mouse.
+.. list-table:: Select Box example (Edit Mode).
+
* - .. _fig-mesh-select-basics-start:
.. figure:: /images/interface_selecting_border-select1.png
@@ -69,26 +89,39 @@
Complete.
-.. _bpy.ops.*.select_circle:
.. _tool-select-circle:
-Circle Select
+Select Circle
-------------
.. reference::
- :Menu: :menuselection:`Select --> Circle Select`
- :Shortcut: :kbd:`C`
+ :Tool: :menuselection:`Toolbar --> Select Circle`
+ :Shortcut: :kbd:`W`
-*Circle Select* :kbd:`C` allows you to select multiple items within a circular area.
-Move your mouse over any items within the circular area (shown with a dotted circle)
-while holding :kbd:`LMB` to select those items. Alternatively, use
-:kbd:`MMB` to deselect them. When you are done selecting, press :kbd:`RMB` or
-:kbd:`Esc`. To change the diameter of the circle, scroll with the :kbd:`Wheel`
-or use the :kbd:`NumpadPlus` and :kbd:`NumpadMinus` keys.
+Dragging will select all the items which the circle passed over.
+Items which you didn't pass over will be deselected.
-.. list-table:: Circle Select example.
+Holding :kbd:`Shift` while dragging will add the items to the selection.
+Holding :kbd:`Ctrl` will remove them.
+You can change the radius of the circle in the tool settings (which can be found
+in the area header, in the Tool tab of the Sidebar :kbd:`N`, or in the Active Tool tab
+of the :doc:`Properties editor </editors/properties_editor>`).
+
+.. note::
+
+ In :doc:`Object Mode </editors/3dview/modes>`: unlike *Select Box*,
+ which selects objects as soon as the box covers any part of their geometry,
+ *Select Circle* only selects objects if the circle passes over their origin point.
+ The origin is shown as an orange dot for selected objects but is invisible for unselected ones,
+ unless "Origins (All)" is enabled in the :doc:`/editors/3dview/display/overlays`.
+
+ This difference in behavior does not apply to the other modes
+ (like Edit Mode and Pose Mode).
+
+.. list-table:: Select Circle example (Edit Mode).
+
* - .. figure:: /images/interface_selecting_circle-select1.png
:width: 320px
@@ -102,33 +135,33 @@
- .. figure:: /images/interface_selecting_circle-select3.png
:width: 320px
- Dragging.
+ Complete.
-.. note::
- In *Object Mode* the *Circle Select* operates on objects by their origins.
-
-
-.. _bpy.ops.*.select_lasso:
.. _tool-select-lasso:
-Lasso Select
+Select Lasso
------------
.. reference::
- :Shortcut: :kbd:`Ctrl-RMB`
+ :Tool: :menuselection:`Toolbar --> Select Lasso`
+ :Shortcut: :kbd:`W`
-*Lasso Select* is used to create a free-form selection. Simply hold :kbd:`Ctrl-RMB`
-while drawing a dotted line around the items you want to select.
-The shape you draw will be automatically closed by connecting a line
-from the current position back to the starting point.
+Dragging will create a freeform shape, and select all the items inside it once you release.
+(Any other items will be deselected.)
-*Lasso Select* adds to the previous selection. For deselection, use :kbd:`Shift-Ctrl-RMB`.
-To move the selection area hold :kbd:`Ctrl-Spacebar` while moving the cursor.
+Holding :kbd:`Shift` while dragging will add the items to the selection.
+Holding :kbd:`Ctrl` will remove them.
-.. list-table:: An example of using the *Lasso Select tool* in *Vertex Select Mode*.
+While dragging, you can additionally hold :kbd:`Spacebar` to move the shape around with the mouse.
+.. note::
+ *Select Lasso* behaves the same as *Select Circle* in that
+ it only looks at origin points in Object Mode.
+
+.. list-table:: Select Lasso example (Edit Mode).
+
* - .. figure:: /images/interface_selecting_lasso-select1.png
:width: 200px
@@ -144,32 +177,108 @@
Complete.
-.. note::
- In *Object Mode* the *Lasso Select* operates on objects by their origins.
+Selection Modes
+---------------
-
-Selecting Modes
-===============
-
.. reference::
:Tool: Select Tools
:Panel: :menuselection:`Tool Settings --> Mode`
-Each tool has some sort of mode to configure how to tool interacts with existing selections.
-Note that not every selection tool supports each of these modes.
+Each of the Toolbar selection tools has a mode to configure
+how it interacts with existing selections.
+Note that not every tool supports all of these modes.
Set
- Sets a new selection ignoring any existing selections.
+ Sets a new selection (the previous selection is discarded).
+ This is the default.
Extend
Adds newly selected items to the existing selection.
- The selection can also be extended by :kbd:`Shift-LMB`.
Subtract
Removes newly selected items from the existing selection.
- Items can be removed from the selection by :kbd:`Shift-LMB` already selected items.
-Invert
- Selects non-selected items and deselects existing selection.
- The selection can also be inverted by :kbd:`Ctrl-I`.
+Invert :kbd:`Ctrl-I`
+ Inverts the selection (unselected items become selected and vice versa).
Intersect
- Selects items that intersect with existing selection.
+ Selects items that intersect with the existing selection.
+
+
+Menu Selection Tools
+====================
+
+These tools are variants of the previously described ones.
+They're available in the menu rather than the Toolbar
+and work slightly differently.
+
+
+.. _bpy.ops.*.select_box:
+
+Box Select
+----------
+
+.. reference::
+
+ :Menu: :menuselection:`Select --> Box Select`
+ :Shortcut: :kbd:`B`
+
+To use this tool, you first activate the menu item or keyboard shortcut
+and then drag a box as usual. Unlike *Select Box*, the default behavior
+here is to add the items inside the box to the selection.
+(The ones outside the box are not deselected.)
+
+To remove the items inside the box from the selection,
+hold :kbd:`Shift`, or drag with :kbd:`MMB` instead.
+
+While dragging, you can additionally hold :kbd:`Spacebar` to move the box around with the mouse.
+
+
+.. _bpy.ops.*.select_circle:
+
+Circle Select
+-------------
+
+.. reference::
+
+ :Menu: :menuselection:`Select --> Circle Select`
+ :Shortcut: :kbd:`C`
+
+To use this tool, you first activate the menu item or keyboard shortcut
+and then drag a circle around as usual. Unlike *Select Circle*, the default
+behavior here is to add the items inside the circle to the selection.
+(The ones outside the circle are not deselected.)
+
+To remove the items inside the circle from the selection,
+hold :kbd:`Shift`, or drag with :kbd:`MMB` instead.
+
+You can change the radius of the circle by scrolling with the :kbd:`Wheel`
+or using the :kbd:`NumpadPlus` and :kbd:`NumpadMinus` keys.
+
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list