Sculpt: Create Hide, Face Set, and Trim pages #104840

Merged
Sean Kim merged 1 commits from Sean-Kim/blender-manual:consolidate-sculpt-gesture-tools into blender-v4.2-release 2024-06-25 16:30:37 +02:00
10 changed files with 230 additions and 149 deletions
Showing only changes of commit f1ee81de8d - Show all commits

View File

@ -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.

View File

@ -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.

View File

@ -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.

View File

@ -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.

View File

@ -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.

View File

@ -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

View File

@ -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.

View File

@ -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.

View File

@ -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.

View File

@ -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
=============