Differential D16335 Diff 57327 manual/sculpt_paint/sculpting/controls.rst

Changeset View

Standalone View

manual/sculpt_paint/sculpting/controls.rst

Show All 10 Lines	.. reference::
:Mode: Sculpt Mode		:Mode: Sculpt Mode
:Tool: :menuselection:`Header --> Auto-Masking`		:Tool: :menuselection:`Header --> Auto-Masking`
:Shortcut: :kbd:`Alt-A`		:Shortcut: :kbd:`Alt-A`

These properties automatically mask geometry based on geometric features of the mesh.		These properties automatically mask geometry based on geometric features of the mesh.
It's an quick alternative to frequent manual masking.		It's an quick alternative to frequent manual masking.
These masks are initialized on every new stroke or tool usage. They are also never visible as an overlay.		These masks are initialized on every new stroke or tool usage. They are also never visible as an overlay.

		.. screenshot of auto-masking panel and pie menu

Note, these properties are applied across all sculpt brushes, however, they can also be configured		Note, these properties are applied across all sculpt brushes, however, they can also be configured
per brush in the :ref:`Advanced Brush Settings <sculpt-tool-settings-brush-settings-advanced>`.		per brush in the :ref:`Advanced Brush Settings <sculpt-tool-settings-brush-settings-advanced>`.

These properties can be accessed via a :ref:`bpy.types.UIPieMenu` by pressing :kbd:`Alt-A`.		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.		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,		For example it's possible to auto-mask a specific face set,
while excluding disconnected topology and face set boundaries,		while excluding disconnected topology and face set boundaries,
and only affect faces that are oriented towards the view via View Normal.		and only affect faces that are oriented towards the view via View Normal.

.. _bpy.types.Sculpt.use_automasking_topology:		.. _bpy.types.Sculpt.use_automasking_topology:

Topology		Topology
Only vertices that are topologically connected to where you started		Only vertices that are topologically connected to where you started
the stroke/tool on are affected. So loose geometry islands will be auto-masked.		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		Additionally for the :doc:`Grab </sculpt_paint/sculpting/tools/grab>` and
:doc:`Thumb </sculpt_paint/sculpting/tools/thumb>` brushes, anything that		:doc:`Thumb </sculpt_paint/sculpting/tools/thumb>` brushes, anything that
is not connected within the brush radius will be auto-masked.		is not connected within the brush radius will be auto-masked.
So even if geometry is connected somewhere,		So even if geometry is connected somewhere,
it is considered separate if the connection is not within the radius.		it is considered separate if the connection is not within the radius.

		.. add example image

.. _bpy.types.Sculpt.use_automasking_face_sets:		.. _bpy.types.Sculpt.use_automasking_face_sets:

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::		.. tip::

If no topology or face set is visible under the curser at the start of the stroke,		If no topology or face set is visible under the curser at the start of the stroke,
Show All 10 Lines	Mesh Boundary
.. _bpy.types.Brush.automasking_boundary_edges_propagation_steps:		.. _bpy.types.Brush.automasking_boundary_edges_propagation_steps:

Propagation Steps		Propagation Steps
Increases the soft gradient towards the auto-masked boundary edges.		Increases the soft gradient towards the auto-masked boundary edges.
Each step iterates the distance one edge further.		Each step iterates the distance one edge further.
This setting is used for for both Mesh Boundary and Face Sets Boundary.		This setting is used for for both Mesh Boundary and Face Sets Boundary.
It is also currently stored per brush.		It is also currently stored per brush.

		.. add example image

.. _bpy.types.Sculpt.use_automasking_boundary_face_sets:		.. _bpy.types.Sculpt.use_automasking_boundary_face_sets:
.. _bpy.types.Brush.automasking_boundary_edges_propagation_steps:		.. _bpy.types.Brush.automasking_boundary_edges_propagation_steps:

Face Sets Boundary		Face Sets Boundary
Vertices that are part of a boundary between face sets are not affected.		Vertices that are part of a boundary between face sets are not affected.
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.

		.. add example image

.. _bpy.types.Sculpt.use_automasking_cavity:		.. _bpy.types.Sculpt.use_automasking_cavity:

Cavity		Cavity
Vertices that are the peaks of the surface curvature are not affected.		Vertices that are the peaks of the surface curvature are not affected. While this auto-mask is primarily meant for painting,
While this auto-mask is primarily meant for painting,
it can also be used for regular sculpting.		it can also be used for regular sculpting.

.. _bpy.types.Sculpt.automasking_cavity_factor:		.. _bpy.types.Sculpt.automasking_cavity_factor:

Factor		Factor
The overall contrast of how strong the cavity is applied. The value of 0.5 is the default,		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.		but better results can also be achieved on 0.2 if a Custom Curve is used as well.

Show All 17 Lines
.. _bpy.types.Sculpt.use_automasking_cavity_inverted:		.. _bpy.types.Sculpt.use_automasking_cavity_inverted:

Cavity (Inverted)		Cavity (Inverted)
This is the same as "Cavity", but inverted.		This is the same as "Cavity", but inverted.
This means the valleys/crevices of the surface curvature will not be affected.		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.		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.		Enable this to quickly invert the cavity auto-mask.

		.. add example image of cavity and inverted

.. _bpy.types.Sculpt.use_automasking_view_normal:		.. _bpy.types.Sculpt.use_automasking_view_normal:

View Normal		View Normal
Only vertices with a :term:`Normal` that face the viewer are affected.		Only vertices with a :term:`Normal` that face the viewer are affected.
This is similar to the "Front Faces Only" toggle in the		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.		: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.		The advantage of this auto-mask is that it has more options and works on sculpt mode as a whole.

Show All 17 Lines

.. _bpy.types.Sculpt.automasking_start_normal_falloff:		.. _bpy.types.Sculpt.automasking_start_normal_falloff:
.. _bpy.types.Sculpt.automasking_start_normal_limit:		.. _bpy.types.Sculpt.automasking_start_normal_limit:
.. _bpy.types.Sculpt.use_automasking_start_normal:		.. _bpy.types.Sculpt.use_automasking_start_normal:

Area Normal		Area Normal
Very similar to the View Normal, but uses the Normal of the surface that you started the stroke/tool on.		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.		This way any direction can be chosen for what vertices will be affected.
		<<<<<<< .mine
		It has the same Limit and Falloff sliders as the View Normal auto-mask.

		.. add example image of view and normal\|\|\|\|\|\|\| .r9675
		It has the same Limit and Falloff sliders as the View Normal auto-mask.=======
It has the same Limit and Falloff sliders as the View Normal auto-mask.		It has the same Limit and Falloff sliders as the View Normal auto-mask.
		>>>>>>> .r9682
		BlendifyUnsubmitted Not Done Inline Actions Looks like some complications from a merge conflict. Blendify: Looks like some complications from a merge conflict.