[Bf-docboard-svn] bf-manual: [9455] branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting: Curves: Fixes and tweaks to curves sculpting docs

Hans Goudey noreply at blender.org
Sun Aug 7 23:28:07 CEST 2022


Revision: 9455
          https://developer.blender.org/rBM9455
Author:   HooglyBoogly
Date:     2022-08-07 23:28:07 +0200 (Sun, 07 Aug 2022)
Log Message:
-----------
Curves: Fixes and tweaks to curves sculpting docs

Modified Paths:
--------------
    branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/introduction.rst
    branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/add_curves.rst
    branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/comb_curves.rst
    branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/density_curves.rst
    branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/pinch_curves.rst
    branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/selection_paint.rst
    branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/slide_curves.rst
    branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/smooth_curves.rst
    branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/snake_hook_curves.rst

Modified: branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/introduction.rst
===================================================================
--- branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/introduction.rst	2022-08-07 20:42:42 UTC (rev 9454)
+++ branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/introduction.rst	2022-08-07 21:28:07 UTC (rev 9455)
@@ -6,8 +6,9 @@
 *Curves Sculpt Mode* allows working with curves using various brushes.
 It is commonly used for hair grooming, but can be used with all kinds of curves.
 
-Some tools, such as the :doc:`Add Curves </sculpt_paint/curves_sculpting/tools/add_curves>`,
-require the Surface to be set already.
+The curves' surface object plays an important role in many curves sculpting brushes.
+Most brushes such as :doc:`Add Curves </sculpt_paint/curves_sculpting/tools/add_curves>`
+require the surface to be set already.
 
 .. note::
 
@@ -43,13 +44,11 @@
 
 .. _bpy.ops.curves.snap_curves_to_surface:
 
-Snap to Deformed Surfaces
+Snap to Deformed Surface
    Re-attach curves to a deformed surface using the existing attachment information.
    This only works when the topology of the surface mesh has not changed.
 
-.. _Snap to Nearest Surfaces:
-
-Snap to Nearest Surfaces
+Snap to Nearest Surface
    Find the closest point on the surface for the root point of every curve and move the root there.
    This needs to be run after the surface mesh topology changed
 
@@ -56,8 +55,8 @@
 .. _bpy.ops.curves.convert_to_particle_system:
 
 Convert to Particle System
-   Add a new or update an existing hair particle system on the surface object.
-   An operator used for backwards compatibility with the old
+   Add a new hair particle system, or update an system on the surface object.
+   The operator is used for backwards compatibility with the old
    :doc:`hair type particle system </physics/particles/hair/introduction>`.
 
 
@@ -67,10 +66,10 @@
 .. _bpy.ops.sculpt_curves.select_all:
 
 All
-   Select all control points.
+   Select all control points or curves.
 
 None
-   Deselect all control points.
+   Deselect all control points or curves.
 
 Invert
    Invert the selection.
@@ -78,15 +77,15 @@
 .. _bpy.ops.sculpt_curves.select_random:
 
 Random
-   Randomizes existing selection or create new random selection.
+   Randomizes inside the existing selection or create new random selection if nothing is selected already.
 
 .. _bpy.ops.sculpt_curves.select_end:
 
 Endpoints
-   Select end point of curves.
+   Select endpoints of curves.
    Only supported in the Control Point selection mode.
 
 .. _bpy.ops.sculpt_curves.select_grow:
 
 Grow
-   Select curves which are close to curves that are selected already.
+   Select points or curves which are close to already selected elements.

Modified: branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/add_curves.rst
===================================================================
--- branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/add_curves.rst	2022-08-07 20:42:42 UTC (rev 9454)
+++ branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/add_curves.rst	2022-08-07 21:28:07 UTC (rev 9455)
@@ -4,10 +4,10 @@
 **********
 
 Used to distribute new curves on the surface mesh.
-This tool requires the curve to have a :doc:`Surface </sculpt_paint/curves_sculpting/introduction>`,
-commonly used for hair scalp.
+This tool requires the curve to have a :doc:`surface </sculpt_paint/curves_sculpting/introduction>` object set.
 
-The curves follow the Surface normals and can be used to expand existent curve interpolating their characteristics.
+The curves follow the surface normals. Using the interpolation options allows the brush to take the characteristics
+of existing curves.
 
 
 Brush Settings
@@ -20,23 +20,23 @@
 
 .. note::
 
-   Interpolation allows to add hair which is already combed. The new hair is then created
-   following the previously created hair which are in the vicinity.
+   Interpolation allows to add hair which are already combed. The new curves are created
+   following the previously created curves which are in the vicinity.
 
 .. _bpy.types.BrushCurvesSculptSettings.interpolate_length:
 
 Interpolate Length
-   Use length of the curves in close proximity.
+   Use the average length of the curves in close proximity.
 
 .. _bpy.types.BrushCurvesSculptSettings.interpolate_shape:
 
 Interpolate Shape
-   Use shape and the amount of control points of the curves in close proximity.
+   Use the average shape of the curves in close proximity.
 
 .. _bpy.types.BrushCurvesSculptSettings.interpolate_point_count:
 
 Interpolate Point Count
-   Use the amount of control points of the curves in close proximity.
+   Use the average amount of control points of the curves in close proximity.
 
 .. _bpy.types.BrushCurvesSculptSettings.curve_length:
 
@@ -46,4 +46,4 @@
 .. _bpy.types.BrushCurvesSculptSettings.points_per_curve:
 
 Points per Curve
-  Number of Control Points for the new created curves when the shape is not interpolated.
+  Number of Control Points for the new created curves when the point count is not interpolated.

Modified: branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/comb_curves.rst
===================================================================
--- branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/comb_curves.rst	2022-08-07 20:42:42 UTC (rev 9454)
+++ branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/comb_curves.rst	2022-08-07 21:28:07 UTC (rev 9455)
@@ -3,4 +3,4 @@
 Comb Curves
 ***********
 
-Shape the curves by moving its control points while preserving the curve length.
+Shape the curves by moving their control points while preserving the initial length of every curve segment.

Modified: branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/density_curves.rst
===================================================================
--- branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/density_curves.rst	2022-08-07 20:42:42 UTC (rev 9454)
+++ branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/density_curves.rst	2022-08-07 21:28:07 UTC (rev 9455)
@@ -17,7 +17,7 @@
    Determines whether the brush adds or removes curves.
 
    :Auto:
-      Either add or remove curves depending on the minimum distance of the curves under the cursor.
+      Either add or remove curves depending on the distance between existing curve roots under the cursor.
    :Add:
       Add new curves between existing curves, taking the minimum distance into account.
    :Remove:
@@ -40,4 +40,4 @@
 .. _bpy.types.BrushCurvesSculptSettings.density_add_attempts:
 
 Count Max
-   The maximum amount of points that it tries to sample in the surface.
+   The maximum amount of points that the brush tries to sample in the surface.

Modified: branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/pinch_curves.rst
===================================================================
--- branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/pinch_curves.rst	2022-08-07 20:42:42 UTC (rev 9454)
+++ branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/pinch_curves.rst	2022-08-07 21:28:07 UTC (rev 9455)
@@ -3,6 +3,6 @@
 Pinch Curves
 ************
 
-Converges adjacent curves to the curve at the center of the cursor.
+Converges adjacent curves to the location at the center of the cursor.
 
 The pinch brush can be inverted by holding :kbd:`Ctrl`.

Modified: branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/selection_paint.rst
===================================================================
--- branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/selection_paint.rst	2022-08-07 20:42:42 UTC (rev 9454)
+++ branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/selection_paint.rst	2022-08-07 21:28:07 UTC (rev 9455)
@@ -4,7 +4,7 @@
 ***************
 
 Paint curves or control paints to use as masks for the other tools.
-The selection visibility can be controlled by the Selection Opacity option in the Viewport Overlays.
+The selection visibility can be controlled by the *Selection Opacity* option in the Viewport Overlays.
 
 By default the selection sets a new selection. The selection paint can be extended
 by holding :kbd:`Shift` and it can be subtracted by holding :kbd:`Ctrl` while painting.

Modified: branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/slide_curves.rst
===================================================================
--- branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/slide_curves.rst	2022-08-07 20:42:42 UTC (rev 9454)
+++ branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/slide_curves.rst	2022-08-07 21:28:07 UTC (rev 9455)
@@ -5,7 +5,4 @@
 
 Slides the curves along the surface mesh. This tool requires the curve to have a
 :doc:`Surface </sculpt_paint/curves_sculpting/introduction>`.
-
-.. note::
-
-   The curves are not rotated to follow the surface normals.
+Each curve is also rotated by the change in the surface normal.

Modified: branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/smooth_curves.rst
===================================================================
--- branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/smooth_curves.rst	2022-08-07 20:42:42 UTC (rev 9454)
+++ branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/smooth_curves.rst	2022-08-07 21:28:07 UTC (rev 9455)
@@ -3,4 +3,4 @@
 Smooth Curves
 *************
 
-Parallels visually adjacent segments.
+This brush makes curve segments close to one another more parallel.

Modified: branches/blender-3.3-release/blender_docs/manual/sculpt_paint/curves_sculpting/tools/snake_hook_curves.rst
===================================================================

@@ Diff output truncated at 10240 characters. @@


More information about the Bf-docboard-svn mailing list