diff --git a/manual/sculpt_paint/sculpting/controls.rst b/manual/sculpt_paint/sculpting/controls.rst index b211b17b0..dd250b3fd 100644 --- a/manual/sculpt_paint/sculpting/controls.rst +++ b/manual/sculpt_paint/sculpting/controls.rst @@ -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: diff --git a/manual/sculpt_paint/sculpting/editing/mask.rst b/manual/sculpt_paint/sculpting/editing/mask.rst index 1a72ad15f..47e70df62 100644 --- a/manual/sculpt_paint/sculpting/editing/mask.rst +++ b/manual/sculpt_paint/sculpting/editing/mask.rst @@ -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 `. +.. _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 ` 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 ` settings are applied. +Propagation Steps + Same as :doc:`Auto-Masking `. + + +.. _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 ` 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 ` settings are applied. +Propagation Steps + Same as :doc:`Auto-Masking `. + .. _bpy.ops.sculpt.mask_init: Random Mask