manual/sculpt_paint/brush/brush_settings.rst

@@ -170,6 +170,25 @@ Deformation Target
 Advanced
 ========
 
+.. _sculpt-tool-settings-brush-type:
+
+Brush Type
+   Defines the basic behavior and the available settings. Through the settings of
+   a brush type, brushes can be created that produce vastly different effects.
+
+   The *Essentials* asset library contains brushes for each of the brush types. Their preview image
+   and description should give a good idea of the effect the brush produces, with the particular
+   combination of brush type and settings. Because of this, they are usually the more useful starting
+   point for custom brushes than the mere brush type is, which is why the brush type is part of the
+   *Advanced* brush settings.
+
+   types.
+
+   - :doc:`Sculpt </sculpt_paint/sculpting/brushes/brush_types>`
+   - :doc:`Vertex Paint </sculpt_paint/vertex_paint/brushes>`
+   - :doc:`Weight Paint </sculpt_paint/weight_paint/brushes>`
+   - :doc:`Texture Paint </sculpt_paint/texture_paint/brushes>`
+
 Accumulate
    Causes stroke dabs to accumulate on top of each other.
 

manual/sculpt_paint/sculpting/brushes/brush_types.rst

@@ -1,10 +1,13 @@
 
-********
-Overview
-********
 
-There are a number of brushes for sculpt mode bundled in the *Essentials* asset library.
-This is an overview of all of them, categorized by their general functions.
+***********
+Brush Types
+***********
+
+See :ref:`Brush Type <sculpt-tool-settings-brush-type>`.
+
+Available brush types are listed here, together with links to the *Essentials* library brushes
+using them.
 
 Add/Subtract Brushes
 ====================
@@ -13,33 +16,49 @@ Add/Subtract Brushes
    :align: right
    :width: 250
 
-These brushes generally push vertices outwards and inwards.
+These brush types generally push vertices outwards and inwards.
+
+Draw
+   Brushes: :doc:`draw`
 
-:doc:`draw`
    The standard brush for pushing vertices inwards and outwards from the surface direction.
 
-:doc:`draw_sharp`
+Draw Sharp
+   Brushes: :doc:`draw_sharp`
+
    Same as *Draw* but with a much sharper :doc:`Falloff </sculpt_paint/brush/falloff>`.
    Useful for creating creases and sharp angles.
 
-:doc:`clay`
+Clay
+   Brushes: :doc:`clay`
+
    Similar to the *Draw* brush but with a flattening effect and subtle smoothing.
    Useful for polishing and building volumes.
 
-:doc:`clay_strips`
+Clay Strips
+   Brushes: :doc:`clay_strips`
+
    The same as the *Clay* brush, but more aggressive with a square falloff.
    A common standard for building rough volumes.
 
-:doc:`layer`
+Layer
+   Brushes: :doc:`layer`
+
    Draw with a fixed height. Useful for adding flat layers to a surface.
 
-:doc:`inflate`
+Inflate
+   Brushes: :doc:`inflate`
+
    Moves the mesh in multiple direction. Useful for inflating or shrinking surfaces and volumes.
 
-:doc:`blob`
+Blob
+   Brushes: :doc:`blob`
+
    Magnifies the mesh as you draw. Useful for an additional inflation effect on the stroke.
 
-:doc:`crease`
+Crease
+   Brushes: :doc:`crease`
+
    Same as *Blob* but with a pinching effect. Useful for creating and polishing sharp creases.
 
 
@@ -53,20 +72,30 @@ Contrast Brushes
 Recognizable by their red icon and cursor.
 These brushes generally flatten or heighten the contrast of the surface.
 
-:doc:`smooth`
+Smooth
+   Brushes: :doc:`smooth`
+
    Smooths out irregularities in the surface and shrinks volumes by averaging the vertices positions.
    An essential brush that is frequently used.
 
-:doc:`flatten`
+Flatten
+   Brushes: :doc:`flatten`
+
    Pushes vertices to an average height to create a flat plateau.
 
-:doc:`fill`
+Fill
+   Brushes: :doc:`fill`
+
    Pushes surfaces outwards. Useful for filling in holes and crevices.
 
-:doc:`scrape`
+Scrape
+   Brushes: :doc:`scrape`
+
    Pushes surfaces inwards. This is the most common brush for flattening meshes.
 
-:doc:`multiplane_scrape`
+Multi-plane Scrape
+   Brushes: :doc:`multiplane_scrape`
+
    Scrapes the mesh with two angled planes at the same time, producing a sharp edge between them.
 
 
@@ -80,37 +109,57 @@ Transform Brushes
 Recognizable by their yellow icon and cursor.
 These brushes generally move, pinch and magnify the mesh.
 
-:doc:`pinch`
+Pinch
+   Brushes: :doc:`pinch`
+
    Pulls vertices towards the center of the brush. Useful for polishing angles and creases.
 
-:doc:`grab`
+Grab
+   Brushes: :doc:`grab`
+
    Moves vertices along with the mouse. An essential brush for building shapes and adjusting proportions.
 
-:doc:`elastic_deform`
+Elastic Deform
+   Brushes: :doc:`elastic_deform`
+
    Used to simulate realistic deformations such as grabbing or twisting of :term:`Elastic` objects.
 
-:doc:`snake_hook`
+Snake Hook
+   Brushes: :doc:`snake_hook`
+
    Pulls vertices along with the stroke to create long, snake-like forms.
 
-:doc:`thumb`
+Thumb
+   Brushes: :doc:`thumb`
+
    Same as *Grab* but moves vertices along the surface direction. Useful for preserving specific surfaces.
 
-:doc:`pose`
+Pose
+   Brushes: :doc:`pose`
+
    Simulating an armature-like deformations. Useful for quick posing and transformations.
 
-:doc:`nudge`
+Nudge
+   Brushes: :doc:`nudge`
+
    Similar as *Thumb* but dynamically picks up vertices like the *Snake Hook*.
    Useful for nudging something along the mesh surface.
 
-:doc:`twist`
+Rotate
+   Brushes: :doc:`twist`
+
    Rotates vertices within the brush in the direction mouse.
 
-:doc:`slide_relax`
+Slide Relax
+   Brushes: :doc:`slide_relax`
+
    Slides the topology of the mesh in the direction of the stroke
    while preserving the geometrical shape of the mesh.
    Also useful for redistributing topology where it is needed.
 
-:doc:`boundary`
+Boundary
+   Brushes: :doc:`boundary`
+
    Transform mesh boundaries specifically with various deformations.
 
 
@@ -124,22 +173,34 @@ Utility Brushes
 No clear color assignment.
 These brushes are general purpose brushes or specific.
 
-:doc:`cloth`
+Cloth
+   Brushes: :doc:`cloth`
+
    Simulates cloth to create folds and draping, which can be sculpted further.
 
-:doc:`density`
+Simplify
+   Brushes: :doc:`density`
+
    Cleans up geometry by collapsing short edges.
 
-:doc:`mask`
+Mask
+   Brushes: :doc:`mask`
+
    Paints a selection on parts of the mesh to be unaffected by other brushes.
 
-:doc:`draw_facesets`
+Draw Face Sets
+   Brushes: :doc:`draw_facesets`
+
    Paint new or extend existing face sets.
 
-:doc:`multires_displacement_eraser`
+Multires Displacement Eraser
+   Brushes: :doc:`multires_displacement_eraser`
+
    Remove displacement information on a Multiresolution modifier.
 
-:doc:`multires_displacement_smear`
+Multires Displacement Smear
+   Brushes: :doc:`multires_displacement_smear`
+
    Smear displacement information on a Multiresolution modifier.
 
 
@@ -153,9 +214,13 @@ Painting Brushes
 Recognizable by their green icon.
 These brushes are used for painting color attributes within sculpt mode.
 
-:doc:`paint`
+Paint
+   Brushes: :doc:`paint`
+
    Paint on the vertices of your mesh via color attributes.
 
-:doc:`smear`
+Smear
+   Brushes: :doc:`smear`
+
    Smears the vertex colors via color attributes.
 

manual/sculpt_paint/sculpting/brushes/index.rst

@@ -8,7 +8,7 @@ Brushes for *Sculpt Mode* bundled in the *Essentials* library.
 .. toctree::
    :maxdepth: 1
 
-   overview.rst
+   brush_types.rst
    draw.rst
    draw_sharp.rst
    clay.rst

manual/sculpt_paint/sculpting/tools/brush_tool.rst

@@ -11,6 +11,6 @@ Brush
 Tool to use for any of the *Sculpt* mode brushes. Activating a brush from an asset shelf or brush
 selector will also activate this tool for convenience.
 
-See :doc:`brushes </sculpt_paint/sculpting/brushes/index>` (or the
-:doc:`overview </sculpt_paint/sculpting/brushes/overview>`) for a detailed list of all brushes and
-their options.
+See :doc:`brushes </sculpt_paint/sculpting/brushes/index>` (or the available
+:doc:`Brush Types </sculpt_paint/sculpting/brushes/brush_types>`) for a detailed list of all
+brushes and their options.

manual/sculpt_paint/texture_paint/brushes.rst

@@ -3,12 +3,24 @@
 Brushes
 *******
 
-Brushes for *Texture Paint* bundled in the *Essentials* library.
+Brush Types
+===========
+
+See :ref:`Brush Type <sculpt-tool-settings-brush-type>`.
+
+Available brush types are listed here, together with brushes from the
+*Essentials* asset library using them.
+
+
+Draw
+   Brushes: Paint Texture
 
-Paint Texture
    The normal brush, draws a swath of color.
 
-Blur Texture
+
+Soften
+   Brushes: Blur Texture
+
    Uses a "blur effect" to soften or sharpen the image.
 
    Direction
@@ -31,11 +43,15 @@ Blur Texture
       :Gaussian: Gaussian will sample the pixels near the center of the brush most.
       :Box: Box samples all surrounding pixels equally.
 
-Smear Texture
+Smear
+   Brushes: Smear Texture
+
    When you click, takes the colors under the cursor, and blends them in the direction you move the mouse.
    Similar to the "smudge" tool of *Gimp*.
 
-Clone Texture
+Clone
+   Brushes: Clone Texture
+
    Copies the colors from the specified image (or location of the same image) to the active image.
 
    In 3D projective painting the clone cursor can be set with :kbd:`Ctrl-LMB`.
@@ -52,7 +68,9 @@ Clone Texture
    Alpha (2D only)
       Opacity of the clone image display.
 
-Fill Texture
+Fill
+   Brushes: Fill Texture
+
    It can be used to fill large areas of the image with the brush color.
    The tool fills adjacent pixels that have a color value similar to the pixel you clicked on.
 
@@ -76,7 +94,9 @@ Fill Texture
       regardless of whether the options are activated
       in the :doc:`External </sculpt_paint/texture_paint/tool_settings/options>` panel.
 
-Mask Texture
+Mask
+   Brushes: Mask Texture
+
    This brush paints gray-scale values on the mask texture
    specified in the :doc:`Mask panel </sculpt_paint/texture_paint/tool_settings/mask>`.
    Any masked surfaces will not be affected by other paint brushes, similar to

manual/sculpt_paint/vertex_paint/brushes.rst

@@ -3,18 +3,33 @@
 Brushes
 *******
 
-Brushes for *Vertex Paint* mode bundled in the *Essentials* library.
+
+Brush Types
+===========
+
+See :ref:`Brush Type <sculpt-tool-settings-brush-type>`.
+
+Available brush types are listed here, together with brushes from the
+*Essentials* asset library using them.
 
 Paint Vertex
+   Brushes: Paint Vertex
+
    Paints a specified color over the object.
 
-Blur Vertex
+Blur
+   Brushes: Blur Vertex
+
    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 Vertex
+Average
+   Brushes: Average Vertex
+
    Smooths color by painting the average resulting color from all colors under the brush.
 
-Smear Vertex
+Smear
+   Brushes: Smear Vertex
+
    Smudges colors by grabbing the colors under the brush and "dragging" them.
    This can be imagined as a finger painting tool.

manual/sculpt_paint/weight_paint/brushes.rst

@@ -3,9 +3,18 @@
 Brushes
 *******
 
-Brushes for *Weight Paint* mode bundled in the *Essentials* library.
+Brush Types
+===========
+
+See :ref:`Brush Type <sculpt-tool-settings-brush-type>`.
+
+Available brush types are listed here, together with brushes from the
+*Essentials* asset library using them.
+
+
+Draw
+   Brushes: Paint Weight
 
-Paint Weight
    Paints a specified weight over the object.
 
    Blend
@@ -42,13 +51,19 @@ Paint Weight
          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 Weight
+Blur
+   Brushes: Blur Weight
+
    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 Weight
+Average
+   Brushes: Average Weight
+
    Smooths weights by painting the average resulting weight from all weights under the brush.
 
-Smear Weight
+Smear
+   Brushes: Smear Weight
+
    Smudges weights by grabbing the weights under the brush and "dragging" them.
    This can be imagined as a finger painting tool.