.. |select_prims| image:: ../../images/panels/viewport/select_prims.png
.. |select_points| image:: ../../images/panels/viewport/select_points.png
.. |select_edges| image:: ../../images/panels/viewport/select_edges.png
.. |select_faces| image:: ../../images/panels/viewport/select_faces.png
.. |select_instances| image:: ../../images/panels/viewport/select_instances.png
.. |select_models| image:: ../../images/panels/viewport/select_models.png
.. |select_groups| image:: ../../images/panels/viewport/select_groups.png
.. |select_assemblies| image:: ../../images/panels/viewport/select_assemblies.png
.. |select_components| image:: ../../images/panels/viewport/select_components.png
.. |select_subcomponents| image:: ../../images/panels/viewport/select_subcomponents.png

.. |small_snap_off| image:: ../../images/panels/viewport/small_snap_off.png
.. |relative| image:: ../../images/panels/viewport/small_relative.png
.. |absolute| image:: ../../images/panels/viewport/small_absolute.png
.. |small_snap_grid| image:: ../../images/panels/viewport/small_snap_grid.png
.. |small_snap_vertex| image:: ../../images/panels/viewport/small_snap_vertex.png
.. |small_snap_edge| image:: ../../images/panels/viewport/small_snap_edge.png
.. |small_snap_edge_center| image:: ../../images/panels/viewport/small_snap_edge_center.png
.. |small_snap_face_center| image:: ../../images/panels/viewport/small_snap_face_center.png
.. |small_snap_object_surface| image:: ../../images/panels/viewport/small_snap_object_surface.png

.. |move_M| image:: ../../images/panels/viewport/move_M.png
.. |rotate_M| image:: ../../images/panels/viewport/rotate_M.png
.. |scale_M| image:: ../../images/panels/viewport/scale_M.png

.. |selection_mode| image:: ../../images/panels/viewport/selection_mode.PNG

.. |select_M| image:: ../../images/panels/viewport/aselect.png

Select tool
===========

The |select_M| Select tool is accessible from the Tools panel or using the **Q** hotkey.
It has several selection modes which correspond to the different type of elements.

Selection modes 
---------------

The selection mode is shared between the |move_M| Move, |rotate_M| Rotate and |scale_M| Scale tools.
It can be switched in the toolbar or in the **Tool Settings** panel:

|selection_mode|

.. list-table:: 
  :header-rows: 1
  :align: center

  * - Selection Mode
    - Description
  * - |select_prims| Select Prims
    - The default selection mode. Selects entire objects (primitives).
  * - |select_points| Select Points
    - Selects individual vertices (points) of an object. 
  * - |select_edges| Select Edges
    - Selects individual edges of an object.
  * - |select_faces| Select Faces
    - Selects individual faces of an object.
  * - |select_instances| Select Instances
    - Selects individual instances.
  * - |select_models| Select Models
    - Selects all objects within a given model (a container for objects).
  * - |select_groups| Select Groups
    - Selects objects that are grouped together.  `kind = *group*` 
      specifies that the selection includes groups.
  * - |select_assemblies| Select Assemblies
    - Selects objects that are part of an assembly (a collection of objects).  `kind = *assembly*` specifies 
      that the selection includes assemblies.
  * - |select_components| Select Components
    - Selects components of an object, like vertices, edges, and faces.  `kind = *component*` 
      specifies that the selection includes components.
  * - |select_subcomponents| Select Subcomponents
    - Selects subcomponents of an object, like individual points on a curve. `kind = *subcomponent*` 
      specifies that the selection includes subcomponents.