Page MenuHome
Differential D5502 Diff 17188 manual/sculpt_paint/weight_paint/editing.rst

Changeset View

Standalone View

View Options

manual/sculpt_paint/weight_paint/editing.rst

Context not available.
Blender provides a set of helper tools for Weight Painting. Blender provides a set of helper tools for Weight Painting.
.. _bpy.ops.object.vertex_group_levels: .. _sculpt-paint_weight-paint_editing_subset:
.. rubric:: The Subset Option .. rubric:: The Subset Option
Context not available.
In these modes the tools operate only on selected vertices or faces. In these modes the tools operate only on selected vertices or faces.
.. _bpy.ops.paint.weight_from_bones:
Assign from Bone Envelopes Assign from Bone Envelopes
========================== ==========================
Context not available.
methods as available in the Parent armature menu. methods as available in the Parent armature menu.
.. _bpy.ops.object.vertex_group_normalize_all:
Normalize All Normalize All
============= =============
Context not available.
Keep the values of the active group while normalizing all the others. Keep the values of the active group while normalizing all the others.
.. _bpy.ops.object.vertex_group_normalize:
Normalize Normalize
========= =========
Context not available.
Normalize example. Normalize example.
.. _bpy.ops.object.vertex_group_mirror:
Mirror Mirror
====== ======
This tool mirrors the weights from one side of the mesh to the opposite side The *Mirror Vertex Group* tool mirrors the weights from one side of a perfectly symmetrical mesh
(only mirroring along X axis is supported). But note, the weights are not to the opposite side. Only mirroring along local X axis is supported.
transferred to the corresponding opposite bone weight group. Those vertices that have no corresponding vertex on the other side will not be affected.
The mirror only takes place within the selected Vertex Group. But note, the weights are not transferred to the corresponding opposite bone weight group.
.. figure:: /images/sculpt-paint_weight-paint_weight-tools_mirror-example.png .. figure:: /images/sculpt-paint_weight-paint_weight-tools_mirror-example.png
Context not available.
Mirror options. Mirror options.
Mirror Weights Mirror Weights
Mirrors the weights of the active group to the other side. With this option checked, every selected vertex receives
Note, this only affects the active weight group. the weight information of its symmetrical counterpart.
If both vertices are selected, it will be a weight information exchange;
if only one is selected, information from the unselected will be copied into the selected one,
that loses its own information. Information on weight is passed for the active group only,
unless *All Groups* is checked, in which case it is passed for all groups.
Flip Group Names Flip Group Names
Exchange the names of left and right side. This option only renames the groups. Works with selected vertices that belong to vertex groups with "symmetrical names"
(with components like "L", "R", "right", "left").
All selected vertices that belong to the active group, or to the symmetrical of the active group,
will have their assignation to that group replaced by an assignation to the symmetrical one;
however, its weight will be preserved.
If *All Groups* is checked, all assignations to these kind of groups
will be replaced by the symmetrical counterpart, also keeping the old weights.
All Groups All Groups
Operate on all selected bones. Operate on all vertex groups, instead of the active one.
Topology Mirror Topology Mirror
Mirror for meshes which are not 100% symmetric (approximate mirror). Mirror for meshes which are not 100% symmetric (approximate mirror).
See :ref:`here <modeling_meshes_editing_topology-mirror>` for more information. See :ref:`here <modeling_meshes_editing_topology-mirror>` for more information.
.. tip:: Mirror to Opposite Bone
If you want to create a mirrored weight group for the opposite bone .. tip:: Mirror to Opposite Bone
(of a symmetric character), then you can do this:
If you want to create a mirrored weight group for the opposite bone
(of a symmetric character), then you can do this:
#. Delete the target Vertex Group (where the mirrored weights will be placed).
#. Create a copy of the source bone Vertex Group
(the group containing the weights which you want to copy).
#. Rename the new Vertex Group to the name of the target Vertex Group
(the group you deleted above).
#. Select the Target Vertex Group and call the Mirror tool
(use only the Mirror weights option and optionally *Topology Mirror* if your mesh is not symmetric).
#. Delete the target Vertex Group (where the mirrored weights will be placed).
#. Create a copy of the source bone Vertex Group
(the group containing the weights which you want to copy).
#. Rename the new Vertex Group to the name of the target Vertex Group
(the group you deleted above).
#. Select the Target Vertex Group and call the Mirror tool
(use only the Mirror weights option and optionally *Topology Mirror* if your mesh is not symmetric).
.. _bpy.ops.object.vertex_group_invert:
Invert Invert
====== ======
Context not available.
Subset Subset
Restrict the tool to a subset. Restrict the tool to a subset.
See above :ref:`The Subset Option <bpy.ops.object.vertex_group_levels>` about how subsets are defined. See above :ref:`The Subset Option <sculpt-paint_weight-paint_editing_subset>` about how subsets are defined.
Add Weights Add Weights
Add vertices that have no weight before inverting (these weights will all be set to 1.0). Add vertices that have no weight before inverting (these weights will all be set to 1.0).
Remove Weights Remove Weights
Context not available.
Locked vertex Groups are not affected. Locked vertex Groups are not affected.
.. _bpy.ops.object.vertex_group_clean:
Clean Clean
===== =====
Context not available.
Subset Subset
Restrict the tool to a subset. Restrict the tool to a subset.
See above :ref:`The Subset Option <bpy.ops.object.vertex_group_levels>` for how subsets are defined. See above :ref:`The Subset Option <sculpt-paint_weight-paint_editing_subset>` for how subsets are defined.
Limit Limit
This is the minimum weight value that will be kept in the Group. This is the minimum weight value that will be kept in the Group.
Weights below this value will be removed from the group. Weights below this value will be removed from the group.
Context not available.
keep at least one weight, even if it is below the limit value! keep at least one weight, even if it is below the limit value!
.. _bpy.ops.object.vertex_group_quantize:
Quantize Quantize
======== ========
Context not available.
For example 5 would allow the following weights ``[0.0, 0.2, 0.4, 0.6, 0.8, 1.0]``. For example 5 would allow the following weights ``[0.0, 0.2, 0.4, 0.6, 0.8, 1.0]``.
.. _bpy.ops.object.vertex_group_levels:
Levels Levels
====== ======
Context not available.
Subset Subset
Restrict the tool to a subset. Restrict the tool to a subset.
See above :ref:`The Subset Option <bpy.ops.object.vertex_group_levels>` for how subsets are defined. See above :ref:`The Subset Option <sculpt-paint_weight-paint_editing_subset>` for how subsets are defined.
Offset Offset
A value from the range (-1.0 - 1.0) to be added to all weights in the Vertex Group. A value from the range (-1.0 - 1.0) to be added to all weights in the Vertex Group.
Gain Gain
Context not available.
(weight > 1.0) with this tool. (weight > 1.0) with this tool.
.. _bpy.ops.object.vertex_group_smooth:
Smooth Smooth
====== ======
Context not available.
Unless you really want to reset your changes to the initial call of the tool. Unless you really want to reset your changes to the initial call of the tool.
.. _bpy.ops.object.vertex_group_limit_total:
Limit Total Limit Total
=========== ===========
Context not available.
Subset Subset
Restrict the tool to a subset. Restrict the tool to a subset.
See above :ref:`The Subset Option <bpy.ops.object.vertex_group_levels>` for how subsets are defined. See above :ref:`The Subset Option <sculpt-paint_weight-paint_editing_subset>` for how subsets are defined.
Limit Limit
Maximum number of weights allowed on each vertex. Maximum number of weights allowed on each vertex.
.. _bpy.ops.object.vertex_group_fix:
Fix Deforms Fix Deforms
=========== ===========
Context not available.