diff --git a/manual/sculpt_paint/sculpting/introduction/gesture_tools.rst b/manual/sculpt_paint/sculpting/introduction/gesture_tools.rst new file mode 100644 index 000000000..166689a91 --- /dev/null +++ b/manual/sculpt_paint/sculpting/introduction/gesture_tools.rst @@ -0,0 +1,77 @@ +============= +Gesture Tools +============= + +Separate from brushes and filters, Sculpt mode also has a set of tools that perform actions to a drawn +selection area. These tools are similar to the selection tools (e.g. :ref:`box selection ` +and :ref:`lasso selection ` in other areas of Blender). + +These tools do not provide a selection of elements that are then modified, they directly modify the underlying +mesh. + +.. _gesture-tool-box: + +Box Gestures +============ + +Dragging creates a rectangular area defined by where :kbd:`LMB` was pressed and where :kbd:`LMB` is released. + +Controls +-------- + +Move :kbd:`Spacebar` + Hold to reposition the selection area. + +.. _gesture-tool-lasso: + +Lasso Gestures +============== + +Dragging creates a freeform area that follows the cursor defined by where :kbd:`LMB` was pressed and where :kbd:`LMB` +is released. + +Controls +-------- + +Move :kbd:`Spacebar` + Hold to reposition the selection area. + +.. _gesture-tool-line: + +Line Gestures +============= + +Dragging creates a line. The resulting action acts upon everything on the highlighed side of the line. The area acted +upon is extended in both directions of the viewport. + +Controls +-------- + +Flip :kbd:`F` + Toggles the side of the line that the tool affects. +Snap :kbd:`Ctrl` + Hold to constrain the rotation of the line to user-specified intervals. Defaults to 5 degree increments, + customizable via the Snapping menu indicated by the magnet icon in the header. +Move :kbd:`Spacebar` + Hold to reposition the line. + +.. _gesture-tool-polyline: + +Tool Settings +------------- + +Limit to Segment + The affected area will not extend the length of the drawn line. + This helps defining a smaller area instead of extending the line infinitely long. + +Polyline Gestures +================= + +Clicking places a point in the viewport. Each time :kbd:`LMB` is pressed, a new point of the polygon is created. +Pressing :kbd:`LMB` on the starting point or pressing :kbd:`Return` closes the selection area. + +Controls +-------- + +Move :kbd:`Spacebar` + Hold to reposition the selection area. \ No newline at end of file diff --git a/manual/sculpt_paint/sculpting/introduction/index.rst b/manual/sculpt_paint/sculpting/introduction/index.rst index 3710f33af..ce790305b 100644 --- a/manual/sculpt_paint/sculpting/introduction/index.rst +++ b/manual/sculpt_paint/sculpting/introduction/index.rst @@ -7,6 +7,7 @@ general.rst brush.rst + gesture_tools.rst visibility_masking_face_sets.rst filters.rst transforming.rst diff --git a/manual/sculpt_paint/sculpting/introduction/visibility_masking_face_sets.rst b/manual/sculpt_paint/sculpting/introduction/visibility_masking_face_sets.rst index 71be34157..ee040f6af 100644 --- a/manual/sculpt_paint/sculpting/introduction/visibility_masking_face_sets.rst +++ b/manual/sculpt_paint/sculpting/introduction/visibility_masking_face_sets.rst @@ -37,11 +37,8 @@ Masks .. figure:: /images/sculpt-paint_sculpting_editing_mask_example.jpg A mask is used to control which vertices of the mesh are influenced by sculpting and painting. -The mask can for example be created/edited via the :doc:`Mask Brush `, -:doc:`Box Mask `, -:doc:`Lasso Mask `, -:doc:`Line Mask ` -and :doc:`Mask by Color ` tools. +The mask can for example be created/edited via the :doc:`/sculpt_paint/sculpting/tools/mask_tools` +and :doc:`Mask by Color ` tool. Internally, masks are stored using the ``sculpt_mask`` :doc:`/modeling/geometry_nodes/attributes_reference`. diff --git a/manual/sculpt_paint/sculpting/toolbar.rst b/manual/sculpt_paint/sculpting/toolbar.rst index 04f4a219a..9ec43c022 100644 --- a/manual/sculpt_paint/sculpting/toolbar.rst +++ b/manual/sculpt_paint/sculpting/toolbar.rst @@ -162,16 +162,11 @@ Gesture Tools .. figure:: /images/sculpt-paint_sculpting_toolbar_gestures.png :align: right -General gesture tools to apply an operation via box, lasso and line shapes. +General gesture tools to apply an operation via box, lasso, line and polyline shapes. +See :doc:`/sculpt_paint/sculpting/introduction/gesture_tools` for more information. -:doc:`/sculpt_paint/sculpting/tools/box_mask` - Create a mask via a box gesture. - -:doc:`/sculpt_paint/sculpting/tools/lasso_mask` - Create a mask via a lasso gesture. - -:doc:`/sculpt_paint/sculpting/tools/line_mask` - Create a mask via on one side of a drawn line. +:doc:`/sculpt_paint/sculpting/tools/mask_tools` + Create a mask via a gesture. Box Hide Hides/Shows geometry via a box gesture. diff --git a/manual/sculpt_paint/sculpting/tools/box_mask.rst b/manual/sculpt_paint/sculpting/tools/box_mask.rst deleted file mode 100644 index 3db10d491..000000000 --- a/manual/sculpt_paint/sculpting/tools/box_mask.rst +++ /dev/null @@ -1,22 +0,0 @@ - -******** -Box Mask -******** - -.. reference:: - - :Mode: Sculpt Mode - :Tool: :menuselection:`Toolbar --> Box Mask` - -Creates a new :doc:`Mask ` -based on a :ref:`box selection `. -Hold :kbd:`Ctrl` to subtract from the mask instead. - -This tool is also accessible as a :ref:`shortcut operator ` on :kbd:`B`. - - -Tool Settings -============= - -Front Faces Only - Only creates a mask on the faces that face towards the view. diff --git a/manual/sculpt_paint/sculpting/tools/index.rst b/manual/sculpt_paint/sculpting/tools/index.rst index b7fffc5df..d0c4c88e3 100644 --- a/manual/sculpt_paint/sculpting/tools/index.rst +++ b/manual/sculpt_paint/sculpting/tools/index.rst @@ -38,9 +38,7 @@ multires_displacement_smear.rst paint.rst smear.rst - box_mask.rst - lasso_mask.rst - line_mask.rst + mask_tools.rst box_face_set.rst lasso_face_set.rst box_trim.rst diff --git a/manual/sculpt_paint/sculpting/tools/lasso_mask.rst b/manual/sculpt_paint/sculpting/tools/lasso_mask.rst deleted file mode 100644 index 48513975f..000000000 --- a/manual/sculpt_paint/sculpting/tools/lasso_mask.rst +++ /dev/null @@ -1,23 +0,0 @@ - -********** -Lasso Mask -********** - -.. reference:: - - :Mode: Sculpt Mode - :Tool: :menuselection:`Toolbar --> Lasso Mask` - -Creates a new :doc:`Mask ` -based on a :ref:`lasso selection `. -Hold :kbd:`Ctrl` to subtract from the mask instead. - -This tool is also accessible as a :ref:`shortcut operator ` on -:kbd:`Shift-Ctrl-LMB` drag. - - -Tool Settings -============= - -Front Faces Only - Only creates a mask on the faces that face towards the view. diff --git a/manual/sculpt_paint/sculpting/tools/line_mask.rst b/manual/sculpt_paint/sculpting/tools/line_mask.rst deleted file mode 100644 index f1905afc6..000000000 --- a/manual/sculpt_paint/sculpting/tools/line_mask.rst +++ /dev/null @@ -1,48 +0,0 @@ - -********* -Line Mask -********* - -.. reference:: - - :Mode: Sculpt Mode - :Tool: :menuselection:`Toolbar --> Line Mask` - -This tool creates a :doc:`Mask ` -across one side of a drawn line. -The affected area is visualized by the shaded side of the line. - - -Usage -===== - -Use the tool by: - -#. Orient the 3D Viewport to define the direction in depth. -#. :kbd:`LMB` and hold while moving the cursor to define direction of the line mask. -#. Adjust the operation with extra *Controls* shortcuts. -#. Release :kbd:`LMB` to confirm. - -Hold :kbd:`Ctrl` to subtract from the mask instead. - - -Controls -======== - -Flip :kbd:`F` - Changes the side of the line that the tool creates a mask. -Snap :kbd:`Ctrl` - Constrains the rotation of the line to 15 degree intervals. -Move :kbd:`Ctrl-Spacebar` - Reposition the line. - - -Tool Settings -============= - -Front Faces Only - Only creates a mask on the faces that face towards the view. - -Limit to Segment - The affected area will not extend the length of the drawn line. - This helps defining a smaller area instead of extending the line infinitely long. diff --git a/manual/sculpt_paint/sculpting/tools/mask_tools.rst b/manual/sculpt_paint/sculpting/tools/mask_tools.rst new file mode 100644 index 000000000..c8b47129f --- /dev/null +++ b/manual/sculpt_paint/sculpting/tools/mask_tools.rst @@ -0,0 +1,73 @@ + +****************** +Mask Gesture Tools +****************** + +.. reference:: + + :Mode: Sculpt Mode + :Tool: :menuselection:`Toolbar --> Box Mask` + +Mask gesture tools apply a constant value to all selected vertices within the selection area. +By default, these tools fully mask each vertex. Holding :kbd:`Ctrl` while performing the selection +clears the mask. + +All mask gesture tools can be activated in the Toolbar and are comprised of the following: + +.. _tool-box-mask: + +Box Mask +======== + +.. reference:: + + :Mode: Sculpt Mode + :Tool: :menuselection:`Toolbar --> Box Mask` + :Shortcut: :kbd:`B` + + +Creates a new :doc:`Mask ` based on a +:ref:`box gesture `. + +.. _tool-lasso-mask: + +Lasso Mask +========== + +.. reference:: + + :Mode: Sculpt Mode + :Tool: :menuselection:`Toolbar --> Lasso Mask` + +Creates a new :doc:`Mask ` based on a +:ref:`lasso gesture `. + +.. _tool-line-mask: + +Line Mask +========= + +.. reference:: + + :Mode: Sculpt Mode + :Tool: :menuselection:`Toolbar --> Line Mask` + +Creates a new :doc:`Mask ` based on a +:ref:`line gesture ` + +Polyline Mask +============= + +.. reference:: + + :Mode: Sculpt Mode + :Tool: :menuselection:`Toolbar --> Polyline Mask` + +Creates a new :doc:`Mask ` based on a +:ref:`line gesture ` + +Common Options +============== + +Front Faces Only + Only creates a mask on the faces that face towards the view. \ No newline at end of file