[Bf-docboard-svn] bf-manual: [7317] trunk/blender_docs/manual/sculpt_paint/sculpting/editing/mask.rst: Sculpt: Reformat Editing Mask
Aaron Carlisle
noreply at blender.org
Fri Oct 30 02:45:47 CET 2020
Revision: 7317
https://developer.blender.org/rBM7317
Author: Blendify
Date: 2020-10-30 02:45:46 +0100 (Fri, 30 Oct 2020)
Log Message:
-----------
Sculpt: Reformat Editing Mask
Modified Paths:
--------------
trunk/blender_docs/manual/sculpt_paint/sculpting/editing/mask.rst
Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/editing/mask.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/editing/mask.rst 2020-10-30 01:23:52 UTC (rev 7316)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/editing/mask.rst 2020-10-30 01:45:46 UTC (rev 7317)
@@ -18,13 +18,6 @@
To edit the mask, select the *Mask Brush* from the Brush panel.
-.. _bpy.ops.paint.mask_flood_fill:
-.. _bpy.ops.paint.mask_lasso_gesture:
-.. _bpy.ops.sculpt.mask_filter:
-.. _bpy.ops.sculpt.mask_expand:
-.. _bpy.ops.mesh.paint_mask_slice:
-.. _bpy.ops.sculpt.dirty_mask:
-
Editing
=======
@@ -37,73 +30,206 @@
Masks can be edited across the entire model.
Using :kbd:`A` opens a pie menu to choose different operations.
-Invert Mask :kbd:`Ctrl-I`
- Inverts an existing mask.
+
+Invert Mask
+-----------
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Sculpt Mode
+ :Menu: :menuselection:`Mask --> Invert Mask`
+ :Hotkey: :kbd:`Ctrl-I`
+
+Inverts an existing mask.
+
+
+.. _bpy.ops.paint.mask_flood_fill:
+
Fill Mask
- Fills the whole mask with a value of 1.
-Clear Mask :kbd:`Alt-M`
- Fills the mask with a value of 0. To completely remove the mask data, see `Clear Sculpt-Mask Data`_.
-Box Mask :kbd:`B`
- Works like the *Box Select* tool, it creates a rectangular mask region.
- Hold :kbd:`Shift` to clear the mask of the selected region.
-Lasso Mask :kbd:`Shift-Ctrl-LMB`
- Can be used to create a free-form mask, similar to the *Lasso Select* tool.
+---------
- .. tip::
+.. admonition:: Reference
+ :class: refbox
- To clear the mask of areas with the *Lasso Mask* tool, first invert the mask,
- apply the *Lasso Mask*, and then invert the mask back.
+ :Mode: Sculpt Mode
+ :Menu: :menuselection:`Mask --> Invert Mask`
+Fills the whole mask with a value of 1.
+
+
+Clear Mask
+----------
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Sculpt Mode
+ :Menu: :menuselection:`Mask --> Invert Mask`
+ :Hotkey: :kbd:`Alt-M`
+
+Fills the mask with a value of 0. To completely remove the mask data, see `Clear Sculpt-Mask Data`_.
+
+
+.. _bpy.ops.paint.mask_box_gesture:
+
+Box Mask
+--------
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Sculpt Mode
+ :Menu: :menuselection:`Mask --> Box Mask`
+ :Hotkey: :kbd:`B`
+
+Works like the *Box Select* tool, it creates a rectangular mask region.
+Hold :kbd:`Shift` to clear the mask of the selected region.
+
+
+.. _bpy.ops.paint.mask_lasso_gesture:
+
+Lasso Mask
+----------
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Sculpt Mode
+ :Menu: :menuselection:`Mask --> Lasso Mask`
+ :Hotkey: :kbd:`Shift-Ctrl-LMB`
+
+Can be used to create a free-form mask, similar to the *Lasso Select* tool.
+
+.. tip::
+
+ To clear the mask of areas with the *Lasso Mask* tool, first invert the mask,
+ apply the *Lasso Mask*, and then invert the mask back.
+
+
+.. _bpy.ops.sculpt.mask_filter:
+
Mask Filters
- Mask filters are operations that are applied to the whole paint mask.
+------------
- Type
- Smooth/Sharpen Mask
- Changes the crispness of the mask edge.
- Grow/Shrink Mask
- Changes the size of the mask.
- Increase/Decrease Contrast
- Changes the contrast of the mask.
- Iterations
- The number of times that the filter is going to be applied.
- Auto Iteration Count
- Use a automatic number of iterations based on the number of vertices of the sculpt.
+.. admonition:: Reference
+ :class: refbox
-Expand Mask by Topology :kbd:`Shift-A`
- Creates a mask radiating outwards from the active vertex in a uniform manner.
+ :Mode: Sculpt Mode
+ :Menu: :menuselection:`Mask --> Mask Filters`
-Expand Mask by Curvature :kbd:`Shift-Alt-A`
- Creates a mask radiating outwards from the active vertex while following the curvature of the mesh.
+Mask filters are operations that are applied to the whole paint mask.
+Type
+ Smooth/Sharpen Mask
+ Changes the crispness of the mask edge.
+ Grow/Shrink Mask
+ Changes the size of the mask.
+ Increase/Decrease Contrast
+ Changes the contrast of the mask.
+
+Iterations
+ The number of times that the filter is going to be applied.
+
+Auto Iteration Count
+ Use a automatic number of iterations based on the number of vertices of the sculpt.
+
+
+.. _bpy.ops.sculpt.mask_expand:
+
+Expand Mask by Topology
+-----------------------
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Sculpt Mode
+ :Menu: :menuselection:`Mask --> Expand Mask by Topology`
+ :Hotkey: :kbd:`Shift-A`
+
+Creates a mask radiating outwards from the active vertex in a uniform manner.
+
+
+Expand Mask by Curvature
+------------------------
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Sculpt Mode
+ :Menu: :menuselection:`Mask --> Expand Mask by Curvature`
+ :Hotkey: :kbd:`Shift-Alt-A`
+
+Creates a mask radiating outwards from the active vertex while following the curvature of the mesh.
+
+
+.. _bpy.ops.mesh.paint_mask_extract:
+
Mask Extract
- Creates a duplicate mesh object based on masked geometry.
+------------
- Threshold
- Minimum mask value to consider the vertex valid to extract a face from the original mesh.
- Add Boundary Loop
- Creates and extra boundary loop on the edges of the geometry,
- making it ready for adding a Subdivision Surface modifier later.
- Smooth Iterations
- Smooth iterations applied to the extracted mesh.
- Project to Sculpt
- Project the extracted mesh on to the original sculpt object.
- Extract as Solid
- Adds a :doc:`Solidify Modifier </modeling/modifiers/generate/solidify>` to the newly created mesh object.
+.. admonition:: Reference
+ :class: refbox
+ :Mode: Sculpt Mode
+ :Menu: :menuselection:`Mask --> Mask Extract`
+
+Creates a duplicate mesh object based on masked geometry.
+
+Threshold
+ Minimum mask value to consider the vertex valid to extract a face from the original mesh.
+
+Add Boundary Loop
+ Creates and extra boundary loop on the edges of the geometry,
+ making it ready for adding a Subdivision Surface modifier later.
+
+Smooth Iterations
+ Smooth iterations applied to the extracted mesh.
+
+Project to Sculpt
+ Project the extracted mesh on to the original sculpt object.
+
+Extract as Solid
+ Adds a :doc:`Solidify Modifier </modeling/modifiers/generate/solidify>` to the newly created mesh object.
+
+
+.. _bpy.ops.mesh.paint_mask_slice:
+
Mask Slice
- Removes the masked vertices from the mesh.
+----------
- Threshold
- Minimum mask value to consider the vertex valid to extract a face from the original mesh
- Fill Holes
- Fills concave holes with geometry that might have resulted from the *Mask Slice* operation.
- Slice to New Object
- Create a new object from the masked geometry.
+.. admonition:: Reference
+ :class: refbox
+ :Mode: Sculpt Mode
+ :Menu: :menuselection:`Mask --> Mask Slice`
+
+Removes the masked vertices from the mesh.
+
+Threshold
+ Minimum mask value to consider the vertex valid to extract a face from the original mesh
+
+Fill Holes
+ Fills concave holes with geometry that might have resulted from the *Mask Slice* operation.
+
+Slice to New Object
+ Create a new object from the masked geometry.
+
+
+.. _bpy.ops.sculpt.dirty_mask:
+
Dirty Mask
- Generates a mask based on the geometry cavity and pointiness.
+----------
+.. admonition:: Reference
+ :class: refbox
+ :Mode: Sculpt Mode
+ :Menu: :menuselection:`Mask --> Dirty Mask`
+
+Generates a mask based on the geometry cavity and pointiness.
+
+
.. _bpy.types.Sculpt.show_mask:
.. _bpy.types.View3DOverlay.sculpt_mode_mask_opacity:
More information about the Bf-docboard-svn
mailing list