[Bf-docboard-svn] bf-manual: [7477] trunk/blender_docs/manual/sculpt_paint/weight_paint: Weight Paint Symmetry

[Aaron Carlisle]

Revision: 7477
          https://developer.blender.org/rBM7477
Author:   Blendify
Date:     2020-12-10 22:29:45 +0100 (Thu, 10 Dec 2020)
Log Message:
-----------
Weight Paint Symmetry

rB6c7f30a6f66c9deab015147dd923b5fd18bac97c
rBe9d21136ce2228a11b788f3202ae929d8fd6d927

Modified Paths:
--------------
    trunk/blender_docs/manual/sculpt_paint/weight_paint/introduction.rst
    trunk/blender_docs/manual/sculpt_paint/weight_paint/tool_settings/options.rst
    trunk/blender_docs/manual/sculpt_paint/weight_paint/tool_settings/symmetry.rst

Modified: trunk/blender_docs/manual/sculpt_paint/weight_paint/introduction.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/weight_paint/introduction.rst	2020-12-10 21:07:52 UTC (rev 7476)
+++ trunk/blender_docs/manual/sculpt_paint/weight_paint/introduction.rst	2020-12-10 21:29:45 UTC (rev 7477)
@@ -77,7 +77,7 @@
    Make sure to select the right mode and disable *Lock Active*.
 
 Auto Normalize
-   Once the weights are initially normalized, the :ref:`Auto Normalize <weight-painting-auto-normalize>` option
+   Once the weights are initially normalized, the :ref:`Auto Normalize <bpy.types.ToolSettings.use_auto_normalize>` option
    can be enabled to automatically maintain normalization as you paint.
    This also tells certain tools that the weights are supposed to be already normalized.
 
@@ -93,11 +93,11 @@
 
    In locations affected by more than two bones this allows more precise tweaking and re-balancing of
    weights by temporarily focusing on a subset of bones. This can also be aided by
-   the :ref:`Lock Relative <weight-painting-auto-normalize>` option, which displays weights as
+   the :ref:`Lock Relative <bpy.types.ToolSettings.use_auto_normalize>` option, which displays weights as
    if re-normalized with the locked groups deleted, thus making it appear as if the locked groups didn't even exist.
 
 Multi-Paint
-   Finally, the :ref:`Multi-Paint <weight-painting-auto-normalize>` option allows treating
+   Finally, the :ref:`Multi-Paint <bpy.types.ToolSettings.use_auto_normalize>` option allows treating
    multiple selected bones as if they were one bone, so that the painting operations change
    the combined weight, preserving the ratio within the group. Combined with locking,
    this allows balancing between one set of bones versus the rest, excluding a third set

Modified: trunk/blender_docs/manual/sculpt_paint/weight_paint/tool_settings/options.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/weight_paint/tool_settings/options.rst	2020-12-10 21:07:52 UTC (rev 7476)
+++ trunk/blender_docs/manual/sculpt_paint/weight_paint/tool_settings/options.rst	2020-12-10 21:29:45 UTC (rev 7477)
@@ -10,7 +10,7 @@
 
 The weight paint options change the overall brush behavior.
 
-.. _weight-painting-auto-normalize:
+.. _bpy.types.ToolSettings.use_auto_normalize:
 
 Auto Normalize
    Ensures that all deforming vertex groups add up to one while painting.
@@ -23,6 +23,9 @@
 
    This option works most intuitively when used to maintain normalization while
    painting on top of weights that are already normalized with another tool.
+
+.. _bpy.types.ToolSettings.use_lock_relative:
+
 Lock-Relative
    Displays bone-deforming groups as if all locked deform groups were deleted,
    and the remaining ones were re-normalized.
@@ -29,6 +32,9 @@
    This is intended for use when balancing weights within a group of bones while all other bones are locked.
    With this option you can also temporarily view non-normalized weights as if they were normalized,
    without actually changing the values.
+
+.. _bpy.types.ToolSettings.use_multipaint:
+
 Multi-Paint
    Paint on all selected vertex groups simultaneously, in a way that preserves their relative influence.
    This can be useful when tweaking weights in an area that is affected by more than three bones at once,
@@ -57,21 +63,12 @@
       the tool using vertex groups from *Selected Pose Bones* with low Factor.
       After that simply paint on top to set the desired collective weight.
 
+.. _bpy.types.VertexPaint.use_group_restrict:
+
 Restrict
    This option limits the influence of painting to vertices (even with weight 0)
    belonging to the selected vertex group.
-X Mirror
-   Use the X Mirror option for mirrored painting on groups that have symmetrical names,
-   like with extension ".R"/ ".L" or "_R" / "_L". If a group has no mirrored counterpart,
-   it will paint symmetrically on the active group itself.
-   You can read more about the naming convention in
-   :ref:`Editing Armatures: Naming conventions <armature-editing-naming-conventions>`.
-   The convention for armatures/bones apply here as well.
-Topology Mirror
-   Use topology-based mirroring, for when both sides of a mesh have matching mirrored topology.
-   See :ref:`here <bpy.types.Mesh.use_mirror_topology>` for more information.
 
-
 .. seealso::
 
    See the :ref:`Brush Display <sculpt-paint-brush-display>` options.

Modified: trunk/blender_docs/manual/sculpt_paint/weight_paint/tool_settings/symmetry.rst
===================================================================
--- trunk/blender_docs/manual/sculpt_paint/weight_paint/tool_settings/symmetry.rst	2020-12-10 21:07:52 UTC (rev 7476)
+++ trunk/blender_docs/manual/sculpt_paint/weight_paint/tool_settings/symmetry.rst	2020-12-10 21:29:45 UTC (rev 7477)
@@ -21,5 +21,14 @@
 
 .. _bpy.types.Mesh.use_mirror_vertex_group_x:
 
-Vertex Groups X Symmetry
-   Mirror the :ref:`left/right <armature-editing-naming-conventions>` vertex groups when painting.
+Vertex Group X
+   Use the X Mirror option for mirrored painting on groups that have symmetrical names,
+   like with extension ".R"/ ".L" or "_R" / "_L". If a group has no mirrored counterpart,
+   it will paint symmetrically on the active group itself.
+   You can read more about the naming convention in
+   :ref:`Editing Armatures: Naming conventions <armature-editing-naming-conventions>`.
+   The convention for armatures/bones apply here as well.
+
+Topology Mirror
+   Use topology-based mirroring, for when both sides of a mesh have matching mirrored topology.
+   See :ref:`here <bpy.types.Mesh.use_mirror_topology>` for more information.