112 lines
3.8 KiB

Vertex Groups Panel
.. reference::
:Mode: All Modes
:Panel: :menuselection:`Object Data tab --> Vertex Groups`
.. figure:: /images/modeling_meshes_properties_vertex-groups_introduction_panel.png
:align: right
The Vertex Group panel.
Vertex groups are maintained within the *Object Data* Properties, in the *Vertex Groups* panel.
.. _bpy.ops.object.vertex_group_add:
.. _bpy.ops.object.vertex_group_sort:
.. _bpy.ops.object.vertex_group_copy:
.. _bpy.ops.object.vertex_group_copy_to_selected:
.. _bpy.ops.object.vertex_group_remove_from:
.. _bpy.ops.object.vertex_group_remove:
.. _bpy.ops.object.vertex_group_move:
Active Vertex Group
A :ref:`List view <ui-list-view>`.
Locks the group from being editable. You can only rename or delete the group.
Add ``+``
Create an empty vertex group.
Remove ``-``
Deletes the active vertex group.
Sort by Name
Sorts vertex groups alphabetically.
Sort by Bone Hierarchy
Duplicate Vertex Group
Add a copy of the active vertex group as a new group.
The new group will be named like the original group with "_copy" appended at the end of its name.
And it will contain associations to exactly the same vertices
with the exact same weights as in the source vertex group.
Copy Vertex Group to Selected
Copy all vertex groups to other selected objects provided they have matching indices
(typically this is true for copies of the mesh which are only deformed and not otherwise edited).
Mirror Vertex Group
Mirrors weights and/or flips group names.
See :ref:`Mirror Vertex Group <bpy.ops.object.vertex_group_mirror>` for more information.
Mirror Vertex Group (Topology)
Performs the *Mirror Vertex Group* with the *Topology Mirror* option enabled.
Remove from All Groups
Unassigns the selected vertices from all (even locked) groups.
After this operation has been performed, the vertices will no longer be contained in any vertex group.
(Not available for locked groups.)
Clear Active Group
Remove all assigned vertices from the active group. The group is made empty.
Note that the vertices may still be assigned to other vertex groups of the object.
(Not available for locked groups.)
Delete All Unlocked Groups
Remove all vertex groups from the object that are *not* locked.
Delete All Groups
Remove all vertex groups from the object.
Lock All
Lock all groups.
Unlock All
Unlock all groups.
Lock Invert All
Invert group locks.
Editing Vertex Groups
.. reference::
:Mode: Edit Mode
:Panel: :menuselection:`Object Data tab --> Vertex Groups`
:Menu: :menuselection:`Vertex --> Vertex Groups`
:Shortcut: :kbd:`Ctrl-G`
.. figure:: /images/modeling_meshes_properties_vertex-groups_vertex-groups_panel-edit.png
:align: right
Vertex Group panel in Edit or Weight Paint Mode.
When you switch either to Edit Mode or to Weight Paint Mode, vertex weights can be edited.
The same operations are available in the 3D Viewport's
:menuselection:`Vertex --> Vertex Groups` menu or :kbd:`Ctrl-G`.
To assign the selected vertices to the active group with the weight as defined in the *Weight* (see below).
To remove the selected vertices from the active group (and thus also delete their weight values).
To select all vertices contained in the group.
To deselect all vertices contained in the group.
The weight value that gets assigned to the selected vertices.
Set Active Group
Lets you select the group that will become the active one (menu only).