[Bf-docboard-svn] bf-manual: [9918] trunk/blender_docs/manual/sculpt_paint: Update for changed Shift R shortcut

[Julien Kaspar]

Revision: 9918
          https://developer.blender.org/rBM9918
Author:   JulienKaspar
Date:     2023-01-27 17:36:30 +0100 (Fri, 27 Jan 2023)
Log Message:
-----------
Update for changed Shift R shortcut
Changed documentation based on rB3e9039091870.
This also includes a tip to use Repeat Last for Mask Filters.

Modified Paths:
--------------
    trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/density_curves.rst
    trunk/blender_docs/manual/sculpt_paint/sculpting/editing/mask.rst
    trunk/blender_docs/manual/sculpt_paint/sculpting/introduction/adaptive.rst
    trunk/blender_docs/manual/sculpt_paint/sculpting/tool_settings/dyntopo.rst
    trunk/blender_docs/manual/sculpt_paint/sculpting/tool_settings/remesh.rst

Modified: trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/density_curves.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/density_curves.rst	2023-01-26 03:00:01 UTC (rev 9917)
+++ trunk/blender_docs/manual/sculpt_paint/curves_sculpting/tools/density_curves.rst	2023-01-27 16:36:30 UTC (rev 9918)
@@ -30,7 +30,7 @@
 
    .. _bpy.ops.sculpt_curves.min_distance_edit:
 
-   Edit Minimum Distance :kbd:`Shift-R`
+   Edit Minimum Distance :kbd:`R`
       Interactively sets the *Distance Min* value by displaying
       a graphic inside the brush cursor, giving a representation of the density.
 

Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/editing/mask.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/editing/mask.rst	2023-01-26 03:00:01 UTC (rev 9917)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/editing/mask.rst	2023-01-27 16:36:30 UTC (rev 9918)
@@ -123,7 +123,8 @@
    Increase/Decrease Contrast
       Changes the contrast of the mask.
 
-In the :ref:`Adjust Last Operation <bpy.ops.screen.redo_last>` panel there are further options.
+In the :ref:`Adjust Last Operation <bpy.ops.screen.redo_last>` panel there are further options
+to add iterations for a stronger effect.
 
 Iterations
    The number of times the filter is applied.
@@ -132,7 +133,11 @@
    Use an automatic number of iterations based on the number of vertices of the sculpt.
    Disable this option to set the Iterations manually.
 
+.. tip::
+   An alternative to Iterations is to use :ref:`Repeat Last <bpy.ops.screen.repeat_last>`
+   via the shortcut :kbd:`Shift-R`.
 
+
 .. _bpy.ops.mesh.paint_mask_extract:
 
 Expand Mask

Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/introduction/adaptive.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/introduction/adaptive.rst	2023-01-26 03:00:01 UTC (rev 9917)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/introduction/adaptive.rst	2023-01-27 16:36:30 UTC (rev 9918)
@@ -4,7 +4,7 @@
 *******************
 
 In order for sculpting to give accurate and predictable results, Blender needs enough geometry.
-Instead of starting out with a highly subdivided mesh, add geometry dynamically 
+Instead of starting out with a highly subdivided mesh, add geometry dynamically
 by using either of the following adaptive sculpting methods.
 
 Voxel Remesher
@@ -23,11 +23,11 @@
 
 .. note::
 
-   This technique will not work on objects that do not have an enclosed volume. 
+   This technique will not work on objects that do not have an enclosed volume.
    Make sure to fill any holes in the mesh before remeshing.
    Or avoid any holes in the mesh/volume that are larger than the defined voxel size.
 
-To more easily access this feature, use the shortcuts :kbd:`Shift-R` to define the resolution,
+To more easily access this feature, use the shortcuts :kbd:`R` to define the resolution,
 and :kbd:`Ctrl-R` to execute the remeshing.
 
 .. figure:: /images/sculpt-paint_sculpt_voxel_grid.png
@@ -54,13 +54,17 @@
 The disadvantages of this technique are a slower performance and limited support for some sculpt mode features.
 Custom attributes like Color Attributes, UV Maps and Face Sets are also lost or corrupted when using Dyntopo.
 
-To more easily access this feature, use the shortcuts :kbd:`Ctrl-D` to enabled Dyntopo 
-and :kbd:`Shift-D` to define the resolution.
+To more easily access this feature, use the shortcuts :kbd:`Ctrl-D` to enabled Dyntopo
+and :kbd:`R` to define the resolution.
 
+.. note::
+   Because Dyntopo and the Voxel Remesher are mutually exclusive and cannot be used at the same time,
+   both use the same shortcut to define the remeshing resolution.
+
 .. figure:: /images/sculpt-paint_sculpt_dyntopo_detail.png
 
-Brushes like :doc:`Simplify </sculpt_paint/sculpting/tools/simplify>`, 
-:doc:`Snake Hook </sculpt_paint/sculpting/tools/snake_hook>` 
+Brushes like :doc:`Simplify </sculpt_paint/sculpting/tools/simplify>`,
+:doc:`Snake Hook </sculpt_paint/sculpting/tools/snake_hook>`
 and :doc:`Clay Strips </sculpt_paint/sculpting/tools/clay_strips>` work especially well with this feature.
 
 
@@ -73,8 +77,8 @@
 ---------------
 
 The Multiresolution Modifier can be used for subdivision based sculpting.
-This means the object will be subdivided, similar to the 
-:doc:`Subdivision Surface Modifier </modeling/modifiers/generate/subdivision_surface>`, 
+This means the object will be subdivided, similar to the
+:doc:`Subdivision Surface Modifier </modeling/modifiers/generate/subdivision_surface>`,
 only that the subdivisions can be freely sculpted for very high resolution detailing.
 
 .. figure:: /images/sculpt-paint_sculpt_multires_example.png
@@ -81,32 +85,32 @@
 
 .. note::
    For this technique it is highly recommended to use on a clean topology base mesh.
-   This means the base mesh should be only made of quads 
+   This means the base mesh should be only made of quads
    and avoid non-manifold faces, as well as poles with two connected edges.
    More information at :ref:`bpy.ops.object.quadriflow_remesh` Remeshing for an automatic retopology method.
 
-This technique has the advantage of sculpting with multiple resolutions, 
+This technique has the advantage of sculpting with multiple resolutions,
 meaning you have the ability to sculpt on any level of subdivision.
-This allows to add a much higher resolution of details for rendering and sculpting, 
+This allows to add a much higher resolution of details for rendering and sculpting,
 while displaying lower resolutions for better viewport performance.
 It also allows sculpting on lower resolutions any time for broader changes.
 
-As an example, you can sculpt general proportions in subdivision level 1, 
-add high resolution details in level 4 and switch back to subdivision 1 to correct the shape further. 
+As an example, you can sculpt general proportions in subdivision level 1,
+add high resolution details in level 4 and switch back to subdivision 1 to correct the shape further.
 
-The disadvantages are that you may end up with some mesh distortions 
+The disadvantages are that you may end up with some mesh distortions
 because the topology is not dynamic like voxel remeshing and dyntopo.
-The topology should also not be changed once already subdivided, 
+The topology should also not be changed once already subdivided,
 since any edits to the base mesh will result in corrupted subdivision details.
 
 .. tip::
    Pay attention to the topology that you sculpt and how much it gets stretched.
-   If more resolution is needed you can always subdivide another time, 
+   If more resolution is needed you can always subdivide another time,
    but there will be worse performance and slower level switching once more than 5 subdivisions are used.
-   Alternatively use the :doc:`Slide Relax </sculpt_paint/sculpting/tools/slide_relax>` 
+   Alternatively use the :doc:`Slide Relax </sculpt_paint/sculpting/tools/slide_relax>`
    brush to slide topology to where it is needed.
 
-Additional brushes like the :doc:`Multire Eraser </sculpt_paint/sculpting/tools/multires_displacement_eraser>` and 
+Additional brushes like the :doc:`Multire Eraser </sculpt_paint/sculpting/tools/multires_displacement_eraser>` and
 :doc:`Multires Smear </sculpt_paint/sculpting/tools/multires_displacement_smear>` are recommended for adjustments.
 
 Here are general shortcuts to use the feature.

Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/tool_settings/dyntopo.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/tool_settings/dyntopo.rst	2023-01-26 03:00:01 UTC (rev 9917)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/tool_settings/dyntopo.rst	2023-01-27 16:36:30 UTC (rev 9918)
@@ -21,7 +21,7 @@
 .. _bpy.types.Sculpt.detail_percent:
 .. _bpy.ops.sculpt.dyntopo_detail_size_edit:
 
-Detail Size/Percentage, Resolution :kbd:`Shift-D`
+Detail Size/Percentage, Resolution :kbd:`R`
    Each Detail Type's detail is set here. Depending on the Detail Type being used
    this property will rather show as a pixel count (px), or percentage.
 

Modified: trunk/blender_docs/manual/sculpt_paint/sculpting/tool_settings/remesh.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/sculpting/tool_settings/remesh.rst	2023-01-26 03:00:01 UTC (rev 9917)
+++ trunk/blender_docs/manual/sculpt_paint/sculpting/tool_settings/remesh.rst	2023-01-27 16:36:30 UTC (rev 9918)
@@ -12,7 +12,7 @@
 
 For a general explanation to remeshing, visit the :doc:`Introduction </sculpt_paint/sculpting/introduction/adaptive>`.
 
-Voxel Size :kbd:`Shift-R`
+Voxel Size :kbd:`R`
    The resolution or the amount of detail the remeshed mesh will have.
    The value is used to define the size, in object space, of the :term:`Voxel`.
    These voxels are assembled around the mesh and are used to determine the new geometry.
@@ -20,7 +20,7 @@
    (assuming *Preserve Volume* is enabled).
    Lower values preserve finer details but will result in a mesh with a much more dense topology.
 
-   The voxel size also be adjusted from the 3D Viewport using :kbd:`Shift-R`.
+   The voxel size also be adjusted from the 3D Viewport using :kbd:`R`.
    Using the shortcut displays an interactive grid overlay showing the resulting voxel size.
    Moving the mouse closer to center of the grid decreases the voxel size
    while moving away from the center increase the voxel size.