[Bf-docboard-svn] bf-manual: [9678] trunk/blender_docs/manual/sculpt_paint/sculpting/editing/mask.rst: Merge branch 'blender-3.4-release'
Aaron Carlisle
noreply at blender.org
Thu Nov 3 20:04:20 CET 2022
Revision: 9678
https://developer.blender.org/rBM9678
Author: Blendify
Date: 2022-11-03 20:04:20 +0100 (Thu, 03 Nov 2022)
Log Message:
-----------
Merge branch 'blender-3.4-release'
Modified Paths:
--------------
trunk/blender_docs/manual/sculpt_paint/sculpting/controls.rst
trunk/blender_docs/manual/sculpt_paint/sculpting/editing/mask.rst
Property Changed:
----------------
trunk/blender_docs/
Index: trunk/blender_docs
===================================================================
--- trunk/blender_docs 2022-11-03 18:59:25 UTC (rev 9677)
+++ trunk/blender_docs 2022-11-03 19:04:20 UTC (rev 9678)
Property changes on: trunk/blender_docs
___________________________________________________________________
Modified: svn:mergeinfo
## -3,4 +3,6 ##
/branches/blender-3.0-release/blender_docs:8543-9034
/branches/blender-3.1-release/blender_docs:8904-9230
/branches/blender-3.2-release/blender_docs:9236-9417
-/branches/blender-3.3-release/blender_docs:9438-9611
\ No newline at end of property
+/branches/blender-3.3-release/blender_docs:9438-9611
+/branches/blender-3.4-release/blender_docs:9673-9677
+/trunk/blender_docs:9673-9675
\ No newline at end of property
Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/controls.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/controls.rst 2022-11-03 18:59:25 UTC (rev 9677)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/controls.rst 2022-11-03 19:04:20 UTC (rev 9678)
@@ -22,81 +22,125 @@
These properties can be accessed via a :ref:`bpy.types.UIPieMenu` by pressing :kbd:`Alt-A`.
All auto-masking modes can be combined, which makes the generated auto-mask more specific.
-For example it's possible to auto-mask a specific face set, while excluding disconnected topology and face set boundaries,
-and only affect faces that are oriented towards the view via View Normal.
+For example it's possible to auto-mask a specific face set,
+while excluding disconnected topology and face set boundaries,
+and only affect faces that are oriented towards the view via View Normal.
.. _bpy.types.Sculpt.use_automasking_topology:
Topology
- Only vertices that are topologically connected to where you started the stroke/tool on are affected. So loose geometry islands will be auto-masked.
+ Only vertices that are topologically connected to where you started
+ the stroke/tool on are affected. So loose geometry islands will be auto-masked.
- Additionally for the :doc:`Grab </sculpt_paint/sculpting/tools/grab>` and :doc:`Thumb </sculpt_paint/sculpting/tools/thumb>` brushes, anything that is not connected within the brush radius will be auto-masked.
- So even if geometry is connected somewhere, it is considered separate if the connection is not within the radius.
+ Additionally for the :doc:`Grab </sculpt_paint/sculpting/tools/grab>` and
+ :doc:`Thumb </sculpt_paint/sculpting/tools/thumb>` brushes, anything that
+ is not connected within the brush radius will be auto-masked.
+ So even if geometry is connected somewhere,
+ it is considered separate if the connection is not within the radius.
.. _bpy.types.Sculpt.use_automasking_face_sets:
Face Sets
- Only vertices that are part of the same face set that you started the stroke/tool on are affected.
+ Only vertices that are part of the same face set that you started the stroke/tool on are affected.
.. tip::
- If no topology or face set is visible under the curser at the start of the stroke, the previously auto-masked area will be targeted.
- This is especially useful with the "Projected" falloff shape in the :doc:`Falloff Settings </sculpt_paint/brush/falloff>`.
+ If no topology or face set is visible under the curser at the start of the stroke,
+ the previously auto-masked area will be targeted.
+ This is especially useful with the "Projected" falloff shape in the
+ :doc:`Falloff Settings </sculpt_paint/brush/falloff>`.
+
.. _bpy.types.Sculpt.use_automasking_boundary_edges:
Mesh Boundary
- Vertices that are part of open boundary edges are not affected. This also includes boundary edges to hidden faces.
+ Vertices that are part of open boundary edges are not affected.
+ This also includes boundary edges to hidden faces.
+ .. _bpy.types.Brush.automasking_boundary_edges_propagation_steps:
+
Propagation Steps
- Increases the soft gradient towards the auto-masked boundary edges. Each step iterates the distance one edge further.
- This setting is used for for both Mesh Boundary and Face Sets Boundary. It is also currently stored per brush.
+ Increases the soft gradient towards the auto-masked boundary edges.
+ Each step iterates the distance one edge further.
+ This setting is used for for both Mesh Boundary and Face Sets Boundary.
+ It is also currently stored per brush.
.. _bpy.types.Sculpt.use_automasking_boundary_face_sets:
.. _bpy.types.Brush.automasking_boundary_edges_propagation_steps:
Face Sets Boundary
- Vertices that are part of a boundary between face sets are not affected. This also includes boundary edges to hidden faces.
+ Vertices that are part of a boundary between face sets are not affected.
+ This also includes boundary edges to hidden faces.
Propagation Steps are shared with Mesh Boundary auto-masking.
-Cavity
- Vertices that are the peaks of the surface curvature are not affected. While this auto-mask is primarily meant for painting,
+.. _bpy.types.Sculpt.use_automasking_cavity:
+
+Cavity
+ Vertices that are the peaks of the surface curvature are not affected.
+ While this auto-mask is primarily meant for painting,
it can also be used for regular sculpting.
+ .. _bpy.types.Sculpt.automasking_cavity_factor:
+
Factor
- The overall contrast of how strong the cavity is applied. The value of 0.5 is the default, but better results can also be achieved on 0.2
- if a Custom Curve is used as well.
+ The overall contrast of how strong the cavity is applied. The value of 0.5 is the default,
+ but better results can also be achieved on 0.2 if a Custom Curve is used as well.
+
+ .. _bpy.types.Sculpt.automasking_cavity_blur_steps:
+
Blur
- The number of times the cavity mask is blurred. A value of 0 will give the pure cavity auto-mask. Anything higher than 6 will likely have
- a less visible effect and decrease performance.
+ The number of times the cavity mask is blurred. A value of 0 will give the pure cavity auto-mask.
+ Anything higher than 6 will likely have a less visible effect and decrease performance.
Even though the value is capped to 10, it can be increased up to 25 if typing in the value.
+
+ .. _bpy.types.Sculpt.use_automasking_custom_cavity_curve:
+
Custom Curve
- Use a custom curve to fine tweak the cavity auto-mask. This is very useful if only small crevices or flat surfaces should be affected.
+ Use a custom curve to fine tweak the cavity auto-mask.
+ 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 `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 will execute the :ref:`bpy.ops.sculpt.dirty_mask` 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:
+
Cavity (Inverted)
- This is the same as "Cavity", but inverted. This means the valleys/crevices of the surface curvature will not be affected.
+ This is the same as "Cavity", but inverted.
+ This means the valleys/crevices of the surface curvature will not be affected.
It cannot be used at the same time as Cavity and shares all of its settings.
Enable this to quickly invert the cavity auto-mask.
+.. _bpy.types.Sculpt.use_automasking_view_normal:
+
View Normal
- Only vertices with a :term:`Normal` that face the viewer are affected.
- This is similar to the "Front Faces Only" toggle in the :doc:`Brush Setting </sculpt_paint/sculpting/tool_settings/brush_settings>`,
- to only affect visible geometry.
- The advantage of this auto-mask is that it has more options and works on sculpt mode as a whole.
+ Only vertices with a :term:`Normal` that face the viewer are affected.
+ This is similar to the "Front Faces Only" toggle in the
+ :doc:`Brush Setting </sculpt_paint/sculpting/tool_settings/brush_settings>`, to only affect visible geometry.
+ The advantage of this auto-mask is that it has more options and works on sculpt mode as a whole.
+ .. _bpy.types.Sculpt.use_automasking_view_occlusion:
+
Occlusion
Change the View Normal behavior to only affect vertices that are not occluded by other faces.
This setting is incompatible with the other Limit and Falloff sliders.
It also causes a much slower performance.
+
+ .. _bpy.types.Sculpt.automasking_view_normal_limit:
+
Limit
- Determines the range of angles that will be affected. 90 degrees encompasses all that is visible.
+ Determines the range of angles that will be affected. 90 degrees encompasses all that is visible.
+
+ .. _bpy.types.Sculpt.automasking_view_normal_falloff:
+
Falloff
- Extends the angular range of the Limit slider with a soft falloff gradient. This falloff will visually extend the limit range further.
+ Extends the angular range of the Limit slider with a soft falloff gradient.
+ This falloff will visually extend the limit range further.
+.. _bpy.types.Sculpt.automasking_start_normal_falloff:
+.. _bpy.types.Sculpt.automasking_start_normal_limit:
+.. _bpy.types.Sculpt.use_automasking_start_normal:
+
Area Normal
Very similar to the View Normal, but uses the Normal of the surface that you started the stroke/tool on.
This way any direction can be chosen for what vertices will be affected.
- It has the same Limit and Falloff sliders as the View Normal auto-mask.
\ No newline at end of file
+ It has the same Limit and Falloff sliders as the View Normal auto-mask.
Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/editing/mask.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/editing/mask.rst 2022-11-03 18:59:25 UTC (rev 9677)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/editing/mask.rst 2022-11-03 19:04:20 UTC (rev 9678)
@@ -276,7 +276,7 @@
.. _bpy.ops.sculpt.dirty_mask:
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list