Changeset View
Changeset View
Standalone 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 | |||||
Blendify: Looks like some complications from a merge conflict. | |||||
Looks like some complications from a merge conflict.