Changeset View
Changeset View
Standalone View
Standalone View
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. | |||||