manual/sculpt_paint/sculpting/introduction/visibility_masking_face_sets.rst

@@ -24,6 +24,8 @@ and :kbd:`Shift-H` to isolate the face set under the cursor (or show everything)
 :ref:`Inverting the visibility <bpy.ops.sculpt.face_set_change_visibility>`
 and :ref:`showing all <bpy.ops.paint.hide_show_all>` is also available in the :kbd:`Alt-W` pie menu.
 
+Modifying visibility can also be done via the :doc:`/sculpt_paint/sculpting/tools/hide_tools`.
+
 .. seealso::
 
    More information for controlling the visibility at :doc:`Show & Hide </sculpt_paint/sculpting/editing/sculpt>`.
@@ -84,8 +86,7 @@ More options can be found in the :kbd:`Alt-W` pie menu.
 
 Otherwise Face Sets can be created/edited with the
 :doc:`Draw Face Sets </sculpt_paint/sculpting/tools/draw_facesets>` brush,
-:doc:`Box Face Set </sculpt_paint/sculpting/tools/box_face_set>` and
-:doc:`Lasso Face Set </sculpt_paint/sculpting/tools/lasso_face_set>`.
+:doc:`/sculpt_paint/sculpting/tools/mask_tools`.
 They can also be edited with the
 :doc:`Edit Face Set </sculpt_paint/sculpting/tools/edit_face_set>` tool.
 

manual/sculpt_paint/sculpting/toolbar.rst

@@ -168,20 +168,14 @@ See :doc:`/sculpt_paint/sculpting/introduction/gesture_tools` for more informati
 :doc:`/sculpt_paint/sculpting/tools/mask_tools`
    Create a mask via a gesture.
 
-Box Hide
-   Hides/Shows geometry via a box gesture.
+:doc:`/sculpt_paint/sculpting/tools/hide_tools`
+   Hides/Shows geometry via a gesture.
 
-:doc:`/sculpt_paint/sculpting/tools/box_face_set`
-   Create a face set via a box gesture.
+:doc:`/sculpt_paint/sculpting/tools/face_set_tools`
+   Create a face set via a gesture.
 
-:doc:`/sculpt_paint/sculpting/tools/lasso_face_set`
-   Create a face set via a lasso gesture.
-
-:doc:`/sculpt_paint/sculpting/tools/box_trim`
-   Perform a Boolean operation via a box gesture.
-
-:doc:`/sculpt_paint/sculpting/tools/lasso_trim`
-   Perform a Boolean operation via a lasso gesture.
+:doc:`/sculpt_paint/sculpting/tools/trim_tools`
+   Perform a Boolean operation via a gesture.
 
 :doc:`/sculpt_paint/sculpting/tools/line_project`
    Flatten the geometry towards a drawn line.

manual/sculpt_paint/sculpting/tools/box_face_set.rst

@@ -1,19 +0,0 @@
-
-************
-Box Face Set
-************
-
-.. reference::
-
-   :Mode:      Sculpt Mode
-   :Tool:      :menuselection:`Toolbar --> Box Face Set`
-
-Creates a new :doc:`Face Set </sculpt_paint/sculpting/editing/face_sets>`
-based on a :ref:`box selection <tool-select-box>`.
-
-
-Tool Settings
-=============
-
-Front Faces Only
-   Only creates a mask on the faces that face towards the view.

manual/sculpt_paint/sculpting/tools/face_set_tools.rst

@@ -0,0 +1,71 @@
+
+**********************
+Face Set Gesture Tools
+**********************
+
+.. reference::
+
+   :Mode:      Sculpt Mode
+
+Face Set gesture tools apply a single new Face Set to all faces within the selection area.
+
+All Face Set gesture tools can be activated in the Toolbar and are comprised of the following:
+
+.. _tool-box-face-set:
+
+Box Face Set
+============
+
+.. reference::
+
+   :Mode:      Sculpt Mode
+   :Tool:      :menuselection:`Toolbar --> Box Face Set`
+
+
+Creates a new :doc:`Face Set </sculpt_paint/sculpting/editing/face_sets>`
+based on a :ref:`box gesture <gesture-tool-box>`.
+
+.. _tool-lasso-face-set:
+
+Lasso Face Set
+==============
+
+.. reference::
+
+   :Mode:      Sculpt Mode
+   :Tool:      :menuselection:`Toolbar --> Lasso Face Set`
+
+Creates a new :doc:`Face Set </sculpt_paint/sculpting/editing/face_sets>`
+based on a :ref:`lasso gesture <gesture-tool-lasso>`.
+
+.. _tool-line-face-set:
+
+Line Face Set
+=============
+
+.. reference::
+
+   :Mode:      Sculpt Mode
+   :Tool:      :menuselection:`Toolbar --> Line Face Set`
+
+Creates a new :doc:`Face Set </sculpt_paint/sculpting/editing/face_sets>`
+based on a :ref:`line gesture <gesture-tool-line>`.
+
+.. _tool-polyline-face-set:
+
+Polyline Face Set
+=================
+
+.. reference::
+
+   :Mode:      Sculpt Mode
+   :Tool:      :menuselection:`Toolbar --> Polyline Face Set`
+
+Creates a new :doc:`Face Set </sculpt_paint/sculpting/editing/face_sets>`
+based on a :ref:`polyline gesture <gesture-tool-polyline>`.
+
+Tool Settings
+=============
+
+Front Faces Only
+   Only creates a face set on the faces that face towards the view.

manual/sculpt_paint/sculpting/tools/hide_tools.rst

@@ -0,0 +1,84 @@
+
+******************
+Hide Gesture Tools
+******************
+
+.. reference::
+
+   :Mode:      Sculpt Mode
+
+Hide gesture tools hide all selected vertices within the selection area and any of their connected 
+edges and faces.
+Holding :kbd:`Ctrl` while performing the selection reveals the vertices, edges, and faces.
+
+Pressing :kbd:`LMB` with any of these tools without also dragging reveals all elements of a mesh.
+
+All hide gesture tools can be activated in the Toolbar and are comprised of the following:
+
+.. _tool-box-hide:
+
+Box Hide
+========
+
+.. reference::
+
+   :Mode:      Sculpt Mode
+   :Tool:      :menuselection:`Toolbar --> Box Hide`
+
+
+Hides vertices and connected edges and faces based on a
+:ref:`box gesture <gesture-tool-box>`.
+
+.. _tool-lasso-hide:
+
+Lasso Hide
+==========
+
+.. reference::
+
+   :Mode:      Sculpt Mode
+   :Tool:      :menuselection:`Toolbar --> Lasso Hide`
+
+Hides vertices and connected edges and faces based on a
+:ref:`lasso gesture <gesture-tool-lasso>`.
+
+.. _tool-line-hide:
+
+Line Hide
+=========
+
+.. reference::
+
+   :Mode:      Sculpt Mode
+   :Tool:      :menuselection:`Toolbar --> Line Mask`
+
+Hides vertices and connected edges and faces based on a
+:ref:`line gesture <gesture-tool-line>`.
+
+.. _tool-polyline-hide:
+
+Polyline Hide
+=============
+
+.. reference::
+
+   :Mode:      Sculpt Mode
+   :Tool:      :menuselection:`Toolbar --> Polyline Mask`
+
+Hides vertices and connected edges and faces based on a
+:ref:`polyline gesture <gesture-tool-polyline>`.
+
+.. note::
+    
+    The Polyline Hide tool does not support showing all vertices via pressing :kbd:`LMB`.
+
+Tool Settings
+=============
+
+Visibility Area 
+   Determines whether all vertices inside or outside the selected area should be affected.
+
+   :Inside:
+      All vertices and connected elements inside the selection area will be hidden.
+   :Outside:
+      All vertices and connected elements outside the selection area will be hidden.

manual/sculpt_paint/sculpting/tools/index.rst

@@ -39,10 +39,9 @@
    paint.rst
    smear.rst
    mask_tools.rst
-   box_face_set.rst
-   lasso_face_set.rst
-   box_trim.rst
-   lasso_trim.rst
+   hide_tools.rst
+   face_set_tools.rst
+   trim_tools.rst
    line_project.rst
    mesh_filter.rst
    cloth_filter.rst

manual/sculpt_paint/sculpting/tools/lasso_face_set.rst

@@ -1,19 +0,0 @@
-
-**************
-Lasso Face Set
-**************
-
-.. reference::
-
-   :Mode:      Sculpt Mode
-   :Tool:      :menuselection:`Toolbar --> Lasso Face Set`
-
-Creates a new :doc:`Face Set </sculpt_paint/sculpting/editing/face_sets>`
-based on a :ref:`lasso selection <tool-select-lasso>`.
-
-
-Tool Settings
-=============
-
-Front Faces Only
-   Only creates a mask on the faces that face towards the view.

manual/sculpt_paint/sculpting/tools/lasso_trim.rst

@@ -1,84 +0,0 @@
-
-**********
-Lasso Trim
-**********
-
-.. reference::
-
-   :Mode:      Sculpt Mode
-   :Tool:      :menuselection:`Toolbar --> Lasso Trim`
-
-Adds or removes geometry based on a :ref:`lasso selection <tool-select-lasso>`.
-This tool is especially useful for sketching an early base mesh for further
-sculpting with the :doc:`voxel remesher </sculpt_paint/sculpting/tool_settings/remesh>`.
-
-.. list-table::
-
-   * - .. figure:: /images/sculpt-paint_sculpt_trim_lasso_visual_example_a.png
-
-          Using Lasso Trim set to *Join*
-
-     - .. figure:: /images/sculpt-paint_sculpt_trim_lasso_visual_example_b.png
-
-          The symmetrized mesh.
-
-     - .. figure:: /images/sculpt-paint_sculpt_trim_lasso_visual_example_c.png
-
-          Sculpting with voxel remeshing.
-
-New geometry is assigned to a new :ref:`Face Set <sculpting-editing-facesets>`.
-When removing geometry, the new interior geometry along the selection will be assigned
-a new face set instead.
-
-.. note::
-
-   It is not recommended to use this tool on a mesh above 100k vertices when using *Difference*
-   or *Union* as the Trim Mode with the *Exact* Solver.
-   This tool is using a Boolean operation so it might take a long time to process.
-   For higher resolution meshes it is recommended to instead use the
-   :doc:`Line Project </sculpt_paint/sculpting/tools/line_project>` tool or the *Fair Positions*
-   mode of the :doc:`Edit Face Set </sculpt_paint/sculpting/tools/edit_face_set>` tool to trim geometry.
-
-
-Tool Settings
-=============
-
-Solver
-   Algorithm used to calculate the Boolean intersections.
-
-   :Fast:
-      Uses a mathematically simple solver which offers the best performance;
-      however, this solver lacks support for overlapping geometry.
-   :Exact:
-      Uses a mathematically complex solver which offers the best results and has full
-      support for overlapping geometry; however, this solver is much slower than the
-      *Fast Solver*.
-
-Trim Mode
-   Geometry can be either added or removed by choosing one of these modes.
-
-   :Difference:
-      Removes geometry, filling any holes that are created.
-   :Union:
-      Creates a geometry and joins any intersections with existing geometry.
-   :Join:
-      Similar to *Union* but joins the mesh as separate geometry,
-      without performing any Boolean operations with existing geometry.
-
-Shape Orientation
-   The method used to orientate the trimming shape.
-
-   :View:
-      Use the view to orientate the trimming shape.
-   :Surface:
-      Use the surface normal to orientate the trimming shape.
-
-Extrude Mode
-   :Fixed:
-      Aligns new geometry orthogonally for 90 degree angles in depth.
-   :Project:
-      Aligns new geometry with the perspective of the current view for a tapered result.
-
-Use Cursor for Depth
-   Use cursor location and radius for the dimensions and position of the trimming shape.
-   If not set, the tool uses the full depth of the object from the camera view.

manual/sculpt_paint/sculpting/tools/mask_tools.rst

@@ -52,7 +52,7 @@ Line Mask
    :Tool:      :menuselection:`Toolbar --> Line Mask`
 
 Creates a new :doc:`Mask </sculpt_paint/sculpting/editing/mask>` based on a
-:ref:`line gesture <gesture-tool-line>`
+:ref:`line gesture <gesture-tool-line>`.
 
 .. _tool-polyline-mask:
 
@@ -65,10 +65,10 @@ Polyline Mask
    :Tool:      :menuselection:`Toolbar --> Polyline Mask`
 
 Creates a new :doc:`Mask </sculpt_paint/sculpting/editing/mask>` based on a
-:ref:`polyline gesture <gesture-tool-polyline>`
+:ref:`polyline gesture <gesture-tool-polyline>`.
 
-Common Options
-==============
+Tool Settings
+=============
 
 Front Faces Only
    Only creates a mask on the faces that face towards the view.

manual/sculpt_paint/sculpting/tools/trim_tools.rst

@@ -1,14 +1,13 @@
 
-********
-Box Trim
-********
+******************
+Trim Gesture Tools
+******************
 
 .. reference::
 
    :Mode:      Sculpt Mode
-   :Tool:      :menuselection:`Toolbar --> Box Trim`
 
-Adds or removes geometry based on a :ref:`box selection <tool-select-box>`.
+Trim gesture tools add or remove geometry based on a selection area.
 This tool is especially useful for sketching an early base mesh for further
 sculpting with the :doc:`voxel remesher </sculpt_paint/sculpting/tool_settings/remesh>`.
 
@@ -40,6 +39,61 @@ a new face set instead.
    :doc:`Line Project </sculpt_paint/sculpting/tools/line_project>` tool or the *Fair Positions*
    mode of the :doc:`Edit Face Set </sculpt_paint/sculpting/tools/edit_face_set>` tool to trim geometry.
 
+.. _tool-box-trim:
+
+Box Trim
+========
+
+.. reference::
+
+   :Mode:      Sculpt Mode
+   :Tool:      :menuselection:`Toolbar --> Box Trim`
+
+Performs a Boolean operation based on the area defined by a
+:ref:`box gesture <gesture-tool-box>`.
+
+.. _tool-lasso-trim:
+
+Lasso Trim
+==========
+
+.. reference::
+
+   :Mode:      Sculpt Mode
+   :Tool:      :menuselection:`Toolbar --> Lasso Trim`
+
+Performs a Boolean operation based on the area defined by a
+:ref:`lasso gesture <gesture-tool-lasso>`.
+
+.. _tool-line-trim:
+
+Line Trim
+=========
+
+.. reference::
+
+   :Mode:      Sculpt Mode
+   :Tool:      :menuselection:`Toolbar --> Line Trim`
+
+Performs a Boolean operation based on the area defined by a
+:ref:`line gesture <gesture-tool-line>`.
+
+.. note::
+    
+    The Line Trim tool does not support adding geometry. Only *Difference* mode is supported.
+
+.. _tool-polyline-trim:
+
+Polyline Trim
+=============
+
+.. reference::
+
+   :Mode:      Sculpt Mode
+   :Tool:      :menuselection:`Toolbar --> Polyline Trim`
+
+Performs a Boolean operation based on the area defined by a
+:ref:`polyline gesture <gesture-tool-polyline>`.
 
 Tool Settings
 =============