.. |aselect| image:: ../../images/panels/viewport/aselect.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
.. |soft_selection| image:: ../../images/panels/viewport/soft_selection.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
.. |tool_settings_move| image:: ../../images/panels/viewport/tool_settings_move.png
.. |move_snap| image:: ../../images/panels/viewport/move_snap.gif
.. |move_align| image:: ../../images/panels/viewport/move_align.gif
.. |move_relative| image:: ../../images/panels/viewport/move_relative.gif
.. |snap_mode| image:: ../../images/panels/viewport/snap_mode.png

=======================
Viewport Tools
=======================

Edit hotkeys
------------

The hotkeys listed below provide access to interaction 
with the scene contents:

.. list-table::
    :header-rows: 1
    :widths: 25, 75
    :align: center

    * - Shortcut
      - Action
    * - Shift + RMB
      - Pie Menu
    * - Alt + B
      - Change Background
    * - Q
      - Select Tool
    * - W
      - Move Tool
    * - E
      - Rotate Tool
    * - R
      - Scale Tool
    * - B
      - Soft Selection
    * - B (Hold)
      - Change Soft Selection Falloff
    * - D
      - Edit Pivot Mode
    * - J
      - Stepped Mode
    * - X
      - Grid Snap Mode

Select Instances
================

.. warning::
  Currently editing of the animated instances is not supported.

In the **Instance** selection mode, it is possible to edit only a part of the 
existing instances with any of the available tools.

.. image:: ../../images/panels/viewport/move_instances.gif

Tool list 
=========

The description of the Viewport tools 
is provided in the following sections:

.. toctree::
   :maxdepth: 1

   Select Tool <selection.rst>
   Move Tool <moving.rst>
   Rotate Tool <rotation.rst>
   Scale Tool <scaling.rst>

.. warning::
    Currently, editing animated instances is not supported. You can only edit:
      * **Prims with non-timesampled `xformOps` attributes:** where the transform (position, rotation, scale) does not change over time.
      * **Prims with one timesample on `xformOps` attributes:** where the transform is defined at a single point in time.
      * **Prims without `xformOps` attributes:** that don't have any transform information defined.
    
    Thus you cannot directly manipulate animated transformations of instances using the viewport tools. 

Modelling
---------

Soft Selection
==============

.. warning::
  Currently, the Soft Selection tool only affects non-timesampled attributes of the points.

The Soft Selection provides partial selection of the sub-components and editing the meshes more naturally.
It allows to automatically select the nearest points to the selection 
and edit them with influence strength fade. Thus, the mesh will be edited with the smooth 
transition between the adjoint points, edges, faces etc.

The Soft Selection mode can be used for each viewport tool: Move, Rotate and Scale.

.. image:: ../../images/panels/viewport/soft_select_deformation.gif

The Soft Selection can be activated and configured in the **Tool Settings** panel.

.. image:: ../../images/panels/viewport/soft_selection.png

The influence of the soft selection is defined using Falloff Radius, Falloff Curve and Interpolation Type parameters.

.. image:: ../../images/panels/viewport/soft_select_radius.gif 

The area of the soft selection is indicated by the Falloff Color gradient: 

.. image:: ../../images/panels/viewport/soft_select_gradient.gif

Click to the gradient scale to add a new color.
Use the circle above the scale to select the color and the square below to delete it.
The selected gradient color can be adjusted using the Position value or by dragging the color indicator.