blender/blender-manual
23
23
Fork 103
Code Issues 72 Pull Requests 6 Projects 1 Releases Wiki Activity

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
Conversation 3 Commits 2 Files Changed 2 +53 -2
2 changed files with 53 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files
Showing only changes of commit 7405205bcd - Show all commits

10
manual/sculpt_paint/sculpting/controls.rst
View File

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

45
manual/sculpt_paint/sculpting/editing/mask.rst
View File

@ -206,7 +206,7 @@ Slice to New Object
Create a new object from the masked geometry. Create a new object from the masked geometry.
.. _bpy.ops.sculpt.dirty_mask: .. _bpy.ops.sculpt.mask_from_cavity:
Mask From Cavity Mask From Cavity
================ ================
@ -235,6 +235,49 @@ Invert
Custom Curve Custom Curve
Same as :doc:`Auto-Masking </sculpt_paint/sculpting/controls>`. Same as :doc:`Auto-Masking </sculpt_paint/sculpting/controls>`.
.. _bpy.ops.sculpt.mask_from_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>`.
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: .. _bpy.ops.sculpt.mask_init: