From 7405205bcd9e2c196cbca0855e968c79bd66197f Mon Sep 17 00:00:00 2001 From: Sean Kim Date: Fri, 27 Sep 2024 10:16:36 -0700 Subject: [PATCH 1/2] Sculpt: Add Mask from Boundary operators Added in blender/blender@591f4c0e59dd132f3ee3a74cb1c3908bdd58016c --- manual/sculpt_paint/sculpting/controls.rst | 10 ++++- .../sculpt_paint/sculpting/editing/mask.rst | 45 ++++++++++++++++++- 2 files changed, 53 insertions(+), 2 deletions(-) diff --git a/manual/sculpt_paint/sculpting/controls.rst b/manual/sculpt_paint/sculpting/controls.rst index b211b17b0..5e0eefebf 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_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_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..bdf8ff35f 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 ================ @@ -235,6 +235,49 @@ Invert Custom Curve Same as :doc:`Auto-Masking `. +.. _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 ` 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 `. + +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: -- 2.30.2 From f3b10d95b3d48e3d880a854054c056401d1dda7c Mon Sep 17 00:00:00 2001 From: Sean Kim Date: Tue, 1 Oct 2024 09:18:22 -0700 Subject: [PATCH 2/2] Fix references --- manual/sculpt_paint/sculpting/controls.rst | 4 ++-- manual/sculpt_paint/sculpting/editing/mask.rst | 6 +++++- 2 files changed, 7 insertions(+), 3 deletions(-) diff --git a/manual/sculpt_paint/sculpting/controls.rst b/manual/sculpt_paint/sculpting/controls.rst index 5e0eefebf..dd250b3fd 100644 --- a/manual/sculpt_paint/sculpting/controls.rst +++ b/manual/sculpt_paint/sculpting/controls.rst @@ -62,7 +62,7 @@ Mesh 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 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: @@ -73,7 +73,7 @@ Face Sets Boundary 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 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: diff --git a/manual/sculpt_paint/sculpting/editing/mask.rst b/manual/sculpt_paint/sculpting/editing/mask.rst index bdf8ff35f..47e70df62 100644 --- a/manual/sculpt_paint/sculpting/editing/mask.rst +++ b/manual/sculpt_paint/sculpting/editing/mask.rst @@ -235,7 +235,8 @@ Invert Custom Curve Same as :doc:`Auto-Masking `. -.. _bpy.ops.sculpt.mask_from_boundary + +.. _bpy.ops.sculpt.mask_from_mesh_boundary: Mask From Mesh Boundary ======================= @@ -258,6 +259,9 @@ Automask Settings Propagation Steps Same as :doc:`Auto-Masking `. + +.. _bpy.ops.sculpt.mask_from_face_sets_boundary: + Mask From Face Sets Boundary ============================ -- 2.30.2