manual/files/asset_libraries/introduction.rst

@@ -207,6 +207,7 @@ Included in this library are:
 
 - :doc:`Hair node groups </modeling/geometry_nodes/hair/index>`
 - :doc:`/modeling/geometry_nodes/normals/smooth_by_angle`
+- :doc:`Sculpt Brushes </sculpt_paint/sculpting/brushes/index>`
 
 
 .. _asset-system-files:

manual/sculpt_paint/curves_sculpting/brushes/index.rst

@@ -1,8 +1,10 @@
 
 #########
-  Tools
+  Brushes
 #########
 
+Brushes for Curves *Sculpt Mode* bundled in the *Essentials* library.
+
 .. toctree::
    :maxdepth: 1
 

manual/sculpt_paint/curves_sculpting/index.rst

@@ -9,5 +9,5 @@
    :maxdepth: 2
 
    introduction.rst
-   tools/index.rst
+   brushes/index.rst
    tools_settings.rst

manual/sculpt_paint/sculpting/brushes/index.rst

@@ -0,0 +1,42 @@
+
+#########
+  Brushes
+#########
+
+Brushes for *Sculpt Mode* bundled in the *Essentials* library.
+
+.. toctree::
+   :maxdepth: 1
+
+   draw.rst
+   draw_sharp.rst
+   clay.rst
+   clay_strips.rst
+   clay_thumb.rst
+   layer.rst
+   inflate.rst
+   blob.rst
+   crease.rst
+   smooth.rst
+   flatten.rst
+   fill.rst
+   scrape.rst
+   multiplane_scrape.rst
+   pinch.rst
+   grab.rst
+   elastic_deform.rst
+   snake_hook.rst
+   thumb.rst
+   pose.rst
+   nudge.rst
+   rotate.rst
+   slide_relax.rst
+   boundary.rst
+   cloth.rst
+   simplify.rst
+   mask.rst
+   draw_facesets.rst
+   multires_displacement_eraser.rst
+   multires_displacement_smear.rst
+   paint.rst
+   smear.rst

manual/sculpt_paint/sculpting/index.rst

@@ -10,6 +10,7 @@
    :maxdepth: 2
 
    introduction/index.rst
+   brushes/index.rst
    toolbar.rst
    tools/index.rst
    tool_settings/index.rst

manual/sculpt_paint/sculpting/tools/index.rst

@@ -6,38 +6,6 @@
 .. toctree::
    :maxdepth: 1
 
-   draw.rst
-   draw_sharp.rst
-   clay.rst
-   clay_strips.rst
-   clay_thumb.rst
-   layer.rst
-   inflate.rst
-   blob.rst
-   crease.rst
-   smooth.rst
-   flatten.rst
-   fill.rst
-   scrape.rst
-   multiplane_scrape.rst
-   pinch.rst
-   grab.rst
-   elastic_deform.rst
-   snake_hook.rst
-   thumb.rst
-   pose.rst
-   nudge.rst
-   rotate.rst
-   slide_relax.rst
-   boundary.rst
-   cloth.rst
-   simplify.rst
-   mask.rst
-   draw_facesets.rst
-   multires_displacement_eraser.rst
-   multires_displacement_smear.rst
-   paint.rst
-   smear.rst
    mask_tools.rst
    hide_tools.rst
    face_set_tools.rst

manual/sculpt_paint/texture_paint/brushes.rst

@@ -1,7 +1,9 @@
 
-*******************
+*******
-Texture Paint Tools
+Brushes
-*******************
+*******
+
+Brushes for *Texture Paint* bundled in the *Essentials* library.
 
 Draw
    The normal brush, paints a swath of color.

manual/sculpt_paint/texture_paint/index.rst

@@ -9,5 +9,5 @@
    :maxdepth: 2
 
    introduction.rst
-   tools.rst
+   brushes.rst
    tool_settings/index.rst

manual/sculpt_paint/vertex_paint/brushes.rst

@@ -0,0 +1,23 @@
+
+*******
+Brushes
+*******
+
+Brushes for *Vertex Paint* bundled in the *Essentials* library.
+
+Draw
+   Paints a specified color over the object.
+
+Blur
+   Smooths out the colors of adjacent vertices. In this mode the Color
+   Value is ignored. The strength defines how much the colors are blurred.
+
+Average
+   Smooths color by painting the average resulting color from all colors under the brush.
+
+Smear
+   Smudges colors by grabbing the colors under the brush and "dragging" them.
+   This can be imagined as a finger painting tool.
+
+Brush
+   Tool to use for any of the vertex paint :doc:`brushes <brush>`.

manual/sculpt_paint/vertex_paint/index.rst

@@ -10,6 +10,7 @@
    :maxdepth: 2
 
    introduction.rst
+   brushes.rst
    tools.rst
    tool_settings/index.rst
    editing.rst

manual/sculpt_paint/vertex_paint/tools.rst

@@ -3,19 +3,8 @@
 Vertex Paint Tools
 ******************
 
-Draw
+Brush
-   Paints a specified color over the object.
+   Tool to use for any of the vertex paint :doc:`brushes <brushes>`.
-
-Blur
-   Smooths out the colors of adjacent vertices. In this mode the Color
-   Value is ignored. The strength defines how much the colors are blurred.
-
-Average
-   Smooths color by painting the average resulting color from all colors under the brush.
-
-Smear
-   Smudges colors by grabbing the colors under the brush and "dragging" them.
-   This can be imagined as a finger painting tool.
 
 :ref:`Annotate <tool-annotate-freehand>`
    Draw free-hand annotation.

manual/sculpt_paint/weight_paint/brushes.rst

@@ -0,0 +1,52 @@
+
+*******
+Brushes
+*******
+
+Draw
+   Paints a specified weight over the object.
+
+   Blend
+      The brush :term:`Blend Modes` defines in which way the weight value is
+      applied to the vertex group while painting.
+
+      Mix
+         In this Blending mode the Weight value defines the *target weight*
+         that will eventually be reached when you paint long enough on the same
+         location of the mesh. And the strength determines how many strokes
+         you need to place at the target weight. Note that for strength = 1.0
+         the target weight is painted immediately and for Weight = 0.0 the brush just does nothing.
+      Add
+         In this Blending mode the specified weight value is *added* to the vertex weights.
+         The strength determines which fraction of the weight gets added per stroke.
+         However, the brush will not paint weight values above 1.0.
+      Subtract
+         In this Blending mode the specified weight value is *subtracted* from the vertex weights.
+         The strength determines which fraction of the weight gets removed per stroke.
+         However, the brush will not paint weight values below 0.0.
+      Lighten
+         In this Blending mode the specified weight value is interpreted as the target weight.
+         Very similar to the Mix Blending mode, but only weights below the target weight are affected.
+         Weights above the target weight remain unchanged.
+      Darken
+         This Blending mode is very similar to the Lighten Blending mode.
+         But only weights above the target weight are affected.
+         Weights below the target weight remain unchanged.
+      Multiply
+         Multiplies the vertex weights with the specified weight value.
+         This is somewhat like subtract, but the amount of removed weight is now
+         dependent on the Weight value itself.
+      Blur
+         Smooths out the weighting of adjacent vertices. In this mode the Weight
+         Value is ignored. The strength defines how much the smoothing is applied.
+
+Blur
+   Smooths out the weighting of adjacent vertices. In this mode the Weight
+   Value is ignored. The strength defines how much the smoothing is applied.
+
+Average
+   Smooths weights by painting the average resulting weight from all weights under the brush.
+
+Smear
+   Smudges weights by grabbing the weights under the brush and "dragging" them.
+   This can be imagined as a finger painting tool.

manual/sculpt_paint/weight_paint/index.rst

@@ -8,6 +8,7 @@
    :maxdepth: 2
 
    introduction.rst
+   brushes.rst
    tools.rst
    tool_settings/index.rst
    usage.rst

manual/sculpt_paint/weight_paint/tools.rst

@@ -3,53 +3,8 @@
 Weight Paint Tools
 ******************
 
-Draw
+Brush
-   Paints a specified weight over the object.
+   Tool to use for any of the weight paint :doc:`brushes <brushes>`.
-
-   Blend
-      The brush :term:`Blend Modes` defines in which way the weight value is
-      applied to the vertex group while painting.
-
-      Mix
-         In this Blending mode the Weight value defines the *target weight*
-         that will eventually be reached when you paint long enough on the same
-         location of the mesh. And the strength determines how many strokes
-         you need to place at the target weight. Note that for strength = 1.0
-         the target weight is painted immediately and for Weight = 0.0 the brush just does nothing.
-      Add
-         In this Blending mode the specified weight value is *added* to the vertex weights.
-         The strength determines which fraction of the weight gets added per stroke.
-         However, the brush will not paint weight values above 1.0.
-      Subtract
-         In this Blending mode the specified weight value is *subtracted* from the vertex weights.
-         The strength determines which fraction of the weight gets removed per stroke.
-         However, the brush will not paint weight values below 0.0.
-      Lighten
-         In this Blending mode the specified weight value is interpreted as the target weight.
-         Very similar to the Mix Blending mode, but only weights below the target weight are affected.
-         Weights above the target weight remain unchanged.
-      Darken
-         This Blending mode is very similar to the Lighten Blending mode.
-         But only weights above the target weight are affected.
-         Weights below the target weight remain unchanged.
-      Multiply
-         Multiplies the vertex weights with the specified weight value.
-         This is somewhat like subtract, but the amount of removed weight is now
-         dependent on the Weight value itself.
-      Blur
-         Smooths out the weighting of adjacent vertices. In this mode the Weight
-         Value is ignored. The strength defines how much the smoothing is applied.
-
-Blur
-   Smooths out the weighting of adjacent vertices. In this mode the Weight
-   Value is ignored. The strength defines how much the smoothing is applied.
-
-Average
-   Smooths weights by painting the average resulting weight from all weights under the brush.
-
-Smear
-   Smudges weights by grabbing the weights under the brush and "dragging" them.
-   This can be imagined as a finger painting tool.
 
 Gradient
    Applies a linear/radial weight gradient;