[Bf-docboard-svn] bf-manual: [9866] trunk/blender_docs/manual/sculpt_paint/sculpting: Improved the sculpting gesture tool pages
Julien Kaspar
noreply at blender.org
Tue Jan 10 11:26:00 CET 2023
Revision: 9866
https://developer.blender.org/rBM9866
Author: JulienKaspar
Date: 2023-01-10 11:25:59 +0100 (Tue, 10 Jan 2023)
Log Message:
-----------
Improved the sculpting gesture tool pages
Modified Paths:
--------------
trunk/blender_docs/manual/sculpt_paint/sculpting/toolbar.rst
trunk/blender_docs/manual/sculpt_paint/sculpting/tools/box_face_set.rst
trunk/blender_docs/manual/sculpt_paint/sculpting/tools/box_mask.rst
trunk/blender_docs/manual/sculpt_paint/sculpting/tools/box_trim.rst
trunk/blender_docs/manual/sculpt_paint/sculpting/tools/lasso_face_set.rst
trunk/blender_docs/manual/sculpt_paint/sculpting/tools/lasso_mask.rst
trunk/blender_docs/manual/sculpt_paint/sculpting/tools/lasso_trim.rst
trunk/blender_docs/manual/sculpt_paint/sculpting/tools/line_mask.rst
trunk/blender_docs/manual/sculpt_paint/sculpting/tools/line_project.rst
Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/toolbar.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/toolbar.rst 2023-01-09 17:26:19 UTC (rev 9865)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/toolbar.rst 2023-01-10 10:25:59 UTC (rev 9866)
@@ -168,6 +168,9 @@
:doc:`/sculpt_paint/sculpting/tools/line_mask`
Create a mask via on one side of a drawn line.
+Box Hide
+ Hides/Shows geometry via a box gesture.
+
:doc:`/sculpt_paint/sculpting/tools/box_face_set`
Create a face set via a box gesture.
Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/tools/box_face_set.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/tools/box_face_set.rst 2023-01-09 17:26:19 UTC (rev 9865)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/tools/box_face_set.rst 2023-01-10 10:25:59 UTC (rev 9866)
@@ -16,4 +16,4 @@
=============
Front Faces Only
- Only draw face sets on the front side of faces.
+ Only creates a mask on the faces that face towards the view.
Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/tools/box_mask.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/tools/box_mask.rst 2023-01-09 17:26:19 UTC (rev 9865)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/tools/box_mask.rst 2023-01-10 10:25:59 UTC (rev 9866)
@@ -10,8 +10,11 @@
Creates a new :doc:`Mask </sculpt_paint/sculpting/editing/mask>`
based on a :ref:`box selection <tool-select-box>`.
+Hold :kbd:`Ctrl` to subtract from the mask instead.
+This tool is also accessible as a :ref:`shortcut operator <bpy.ops.paint.mask_box_gesture>` on :kbd:`B`.
+
Tool Settings
=============
Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/tools/box_trim.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/tools/box_trim.rst 2023-01-09 17:26:19 UTC (rev 9865)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/tools/box_trim.rst 2023-01-10 10:25:59 UTC (rev 9866)
@@ -8,22 +8,35 @@
:Mode: Sculpt Mode
:Tool: :menuselection:`Toolbar --> Box Trim`
-Adds or removes geometry using a Boolean operation based on a :ref:`box selection <tool-select-box>`.
+Adds or removes geometry based on a :ref:`box selection <tool-select-box>`.
+This tool is especially useful for sketching an early base mesh for further
+sculpting with the :ref:`voxel remesher </sculpt_paint/sculpting/tool_settings/remesh>`.
+.. add visual example of removing/adding geometry for a rough base.
+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.
+ This tool is using a Boolean operation so it might take a long time to process.
+ For higher resolution meshes it is recommedned 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.
+
+
Tool Settings
=============
Trim Mode
- The operation to perform on the mesh; geometry can be either added or removed.
- When using the *Union* or *Join* mode the new geometry is assigned to
- a new :ref:`Face Set <sculpting-editing-facesets>`. When using *Difference* mode,
- interior geometry is also added to a new face set.
+ Geometry can be either added or removed by choosing one of these modes.
Difference
- Removes geometry in the shape of the selection filling any holes that are created in existing geometry.
+ Removes geometry, filling any holes that are created.
Union
- Fills the selected outline with a new mesh and joins any intersections with existing geometry.
+ 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.
Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/tools/lasso_face_set.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/tools/lasso_face_set.rst 2023-01-09 17:26:19 UTC (rev 9865)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/tools/lasso_face_set.rst 2023-01-10 10:25:59 UTC (rev 9866)
@@ -16,4 +16,4 @@
=============
Front Faces Only
- Only draw face sets on the front side of faces.
+ Only creates a mask on the faces that face towards the view.
Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/tools/lasso_mask.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/tools/lasso_mask.rst 2023-01-09 17:26:19 UTC (rev 9865)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/tools/lasso_mask.rst 2023-01-10 10:25:59 UTC (rev 9866)
@@ -10,8 +10,11 @@
Creates a new :doc:`Mask </sculpt_paint/sculpting/editing/mask>`
based on a :ref:`lasso selection <tool-select-lasso>`.
+Hold :kbd:`Ctrl` to subtract from the mask instead.
+This tool is also accessible as a :ref:`shortcut operator <bpy.ops.paint.mask_box_gesture>` on :kbd:`Ctrl Shift LMB-Drag`.
+
Tool Settings
=============
Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/tools/lasso_trim.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/tools/lasso_trim.rst 2023-01-09 17:26:19 UTC (rev 9865)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/tools/lasso_trim.rst 2023-01-10 10:25:59 UTC (rev 9866)
@@ -9,21 +9,33 @@
:Tool: :menuselection:`Toolbar --> Lasso Trim`
Adds or removes geometry using a Boolean operation 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 :ref:`voxel remesher </sculpt_paint/sculpting/tool_settings/remesh>`.
+.. add visual example of removing/adding geometry for a rough base.
+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.
+ This tool is using a Boolean operation it might take a long time to process.
+ For higher resolution meshes it is recommedned 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.
+
Tool Settings
=============
Trim Mode
- The operation to perform on the mesh; geometry can be either added or removed.
- When using the *Union* or *Join* mode the new geometry is assigned to
- a new :ref:`Face Set <sculpting-editing-facesets>`. When using *Difference* mode,
- interior geometry is also added to a new face set.
+ Geometry can be either added or removed by choosing one of these modes.
Difference
- Removes geometry in the shape of the selection filling any holes that are created in existing geometry.
+ Removes geometry, filling any holes that are created.
Union
- Fills the selected outline with a new mesh and joins any intersections with existing geometry.
+ 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.
Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/tools/line_mask.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/tools/line_mask.rst 2023-01-09 17:26:19 UTC (rev 9865)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/tools/line_mask.rst 2023-01-10 10:25:59 UTC (rev 9866)
@@ -9,29 +9,22 @@
:Tool: :menuselection:`Toolbar --> Line Mask`
This tool creates a :doc:`Mask </sculpt_paint/sculpting/editing/mask>`
-based on plan determined by the camera view and a drawn line.
-The masked region of the mesh is visualized by the shaded side of the line.
+across one side of a drawn line.
+The affected areas is visualized by the shaded side of the line.
-
-Tool Settings
-=============
-
-Front Faces Only
- Only creates a mask on the front side of faces.
-
-Limit to Segment
- Apply the gesture action only to the area that is contained within
- the segment without extending its effect to the entire line.
-
-
Usage
=====
-#. Orient the 3D Viewport to define the local view plane to use for the mask.
-#. :kbd:`LMB` and hold while moving the cursor to define the line to pick a region of the view plane to mask.
+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
========
@@ -40,4 +33,15 @@
Snap :kbd:`Ctrl`
Constrains the rotation of the line to 15 degree intervals.
Move :kbd:`Ctrl-Spacebar`
- Changes the location of the line.
+ 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.
Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/tools/line_project.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/tools/line_project.rst 2023-01-09 17:26:19 UTC (rev 9865)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/tools/line_project.rst 2023-01-10 10:25:59 UTC (rev 9866)
@@ -11,20 +11,24 @@
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list