manual/grease_pencil/modes/weight_paint/index.rst

@@ -8,5 +8,5 @@
 
    introduction.rst
    tools.rst
-   tool_settings/brush.rst
+   tool_settings/index.rst
    weights_menu.rst

manual/grease_pencil/modes/weight_paint/tool_settings/brush.rst

@@ -1,8 +1,8 @@
 .. _tool-grease-pencil-weight-paint-weight:
 
-*****
+**************
-Brush
+Brush Settings
-*****
+**************
 
 Painting needs paint brushes and Blender provides a Brush panel within the Toolbar
 when in *Weight Paint Mode*.
@@ -11,12 +11,17 @@ Brush
    In the :ref:`Data-Block menu <ui-data-block>` you find predefined Brush presets.
    And you can create your own custom presets as needed.
 
-Radius
+Radius :kbd:`F`
    The radius defines the area of influence of the brush.
 Strength
    This is the amount of paint to be applied per brush stroke.
 Use Falloff
    When enabled, use Strength falloff for the brush.
    Brush Strength decays with the distance from the center of the brush.
-Weight
+Weight :kbd:`Ctrl-F`
    The weight (visualized as a color) to be used by the brush.
+
+   Using :kbd:`Ctrl-RMB` you can set the weight to the value thats under the cursor.
+Direction :kbd:`D`
+   Brush direction toggle, *Add* adds weight value while *Subtract* removes weight value.
+   This setting can be toggled with :kbd:`D`.

manual/grease_pencil/modes/weight_paint/tool_settings/index.rst

@@ -0,0 +1,10 @@
+
+#################
+  Tool Settings
+#################
+
+.. toctree::
+   :maxdepth: 2
+
+   brush.rst
+   options.rst

manual/grease_pencil/modes/weight_paint/tool_settings/options.rst

@@ -0,0 +1,16 @@
+
+*******
+Options
+*******
+
+Auto Normalize
+   Ensures that all deforming vertex groups add up to one while painting.
+   When this option is turned off, then all weights of a point can have any value between 0 and 1.
+   However, when vertex groups are used as deform groups for character animation
+   then Blender always interprets the weight values relative to each other.
+   That is, Blender always does a normalization over all deform bones.
+   Hence in practice it is not necessary to maintain a strict normalization and
+   further normalizing weights should not affect animation at all.
+
+   This option works most intuitively when used to maintain normalization while
+   painting on top of weights that are already normalized with another tool.

manual/grease_pencil/modes/weight_paint/tools.rst

@@ -14,6 +14,17 @@ See :doc:`Brush </grease_pencil/modes/weight_paint/tool_settings/brush>` for mor
 Draw
    Paints a specified weight over the strokes.
 
+Blur
+   Smooths out the weighting of adjacent points. 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.
+
 :ref:`Annotate <tool-annotate-freehand>`
    Draw free-hand annotation.