Sculpt: Add Mask from Boundary operators #104938

Merged
Aaron Carlisle merged 2 commits from Sean-Kim/blender-manual:mask-from-border into blender-v4.3-release 2024-10-04 04:40:44 +02:00
2 changed files with 57 additions and 2 deletions

View File

@ -61,6 +61,10 @@ Mesh Boundary
Each step iterates the distance one edge further.
This setting is used for both Mesh Boundary and Face Sets Boundary.
Create Mask
This will execute the :ref:`bpy.ops.sculpt.mask_from_mesh_boundary` operator with the current auto-masking settings.
This is very useful to visualize the current auto-mask, or to edit the mask further manually.
.. _bpy.types.Sculpt.use_automasking_boundary_face_sets:
Face Sets Boundary
@ -68,6 +72,10 @@ Face Sets Boundary
This also includes boundary edges to hidden faces.
Propagation Steps are shared with Mesh Boundary auto-masking.
Create Mask
This will execute the :ref:`bpy.ops.sculpt.mask_from_face_sets_boundary` operator with the current auto-masking settings.
This is very useful to visualize the current auto-mask, or to edit the mask further manually.
.. _bpy.types.Sculpt.use_automasking_cavity:
Cavity
@ -89,7 +97,7 @@ Cavity
This is very useful if only small crevices or flat surfaces should be affected.
Or for example if the contrast should be increased/decreased in a specific way.
Create Mask
This will execute the :ref:`bpy.ops.sculpt.dirty_mask` operator with the current auto-masking settings.
This will execute the :ref:`bpy.ops.sculpt.mask_from_cavity` operator with the current auto-masking settings.
This is very useful to visualize the current auto-mask, or to edit the mask further manually.
.. _bpy.types.Sculpt.use_automasking_cavity_inverted:

View File

@ -206,7 +206,7 @@ Slice to New Object
Create a new object from the masked geometry.
.. _bpy.ops.sculpt.dirty_mask:
.. _bpy.ops.sculpt.mask_from_cavity:
Mask From Cavity
================
@ -236,6 +236,53 @@ Custom Curve
Same as :doc:`Auto-Masking </sculpt_paint/sculpting/controls>`.
.. _bpy.ops.sculpt.mask_from_mesh_boundary:
Mask From Mesh Boundary
=======================
.. reference::
:Mode: Sculpt Mode
:Menu: :menuselection:`Mask --> Mask from Mesh Boundary`
Generates a mask based on the topological islands of the mesh. The settings of the operation can be changed
in the :doc:`Adjust Last Operation </interface/undo_redo>` panel.
Mode
Choose how the newly created mask is mixed with the existing one. By default it will replace the old mask via
"Mix".
Mix Factor
The factor of the mix effect. Choose how strong the new mask is applied on the existing one.
Automask Settings
The same settings as the :doc:`Auto-Masking </sculpt_paint/sculpting/controls>` settings are applied.
Propagation Steps
Same as :doc:`Auto-Masking </sculpt_paint/sculpting/controls>`.
.. _bpy.ops.sculpt.mask_from_face_sets_boundary:
Mask From Face Sets Boundary
============================
.. reference::
:Mode: Sculpt Mode
:Menu: :menuselection:`Mask --> Mask from Face Sets Boundary`
Generates a mask based on the face set islands of the mesh. The settings of the operation can be changed
in the :doc:`Adjust Last Operation </interface/undo_redo>` panel.
Mode
Choose how the newly created mask is mixed with the existing one. By default it will replace the old mask via
"Mix".
Mix Factor
The factor of the mix effect. Choose how strong the new mask is applied on the existing one.
Automask Settings
The same settings as the :doc:`Auto-Masking </sculpt_paint/sculpting/controls>` settings are applied.
Propagation Steps
Same as :doc:`Auto-Masking </sculpt_paint/sculpting/controls>`.
.. _bpy.ops.sculpt.mask_init:
Random Mask