.. _MainPanel: List Panel ----------------------------- Vertex Group Plus contains a list with additional utility features. .. image:: /static/VertexGroupPlusList.webp ------ Search & Filtering ==================== In the lower area of the list, there is an arrow that you can click on to expand a *Search Subpanel*. Filter Deform +++++++++++++++ .. video:: /static/FilterDeform.webm :width: 600 :autoplay: :loop: :nocontrols: :muted: - **Show All**: Shows ALL vertex groups. - **Deform Only**: Shows deformed vertex group only and hide other vertex groups. - **Hide Deform**: Hide deformed vertex group and show other vertex groups. .. note:: Deform here means there is a bone that uses deform and has the same name as the vertex group that is present in the armature object pointed by the armature modifier. | .. video:: /static/TagFilter.webm :width: 600 :autoplay: :loop: :nocontrols: :muted: | Search By Name +++++++++++++++++++ - Filter and search vertex groups by name, a vertex group will match if they contain the string in this search box, this feature is not case sensitive. | Invert Name Filter +++++++++++++++++++ - This allows you to invert the filter and show vertex groups with name without the string. | Sort By Name +++++++++++++++++++ - Sort the displayed search results alphabeticaly, this only sort the vertex groups in the UI and does not actually affect the vertex group's actual position / index. | Reverse +++++++++++++++++++ - Reverse the order of the search results, this only applies to the UI and does not actually affect the vertex group's actual position / index in the list. | .. _TagFilter: Tag Filter +++++++++++++++++++ - Filter vertex groups by giving them tags, the tags are not case sensitive but it needs to be the exact string to match, the items are separated by comma. | Tag Invert +++++++++++++++++++ - Inverting the selection shows the vertex group that does not match the tags. | Match All Tags +++++++++++++++++++ - **On**: Turining on match all tags will only match the vertex group if its tag has all the tags in the filter. This is to pinpoint certain vertex groups by narrowing down the selection. When more tags are added, the less matches that will appear. - **Off**: Turning off match all tags will only match vertex groups that contains any of the tag in the list. This is to include items from multiple tags and expand the selection as more tags are added. When more tags are added, the more matches will appear. | Edit Selected Tags ++++++++++++++++++++++++ Allow you Add or Remove Tags to selected vertex groups Options _________ .. image:: /static/EditSelectedTags.webp New Tag ********* Add Tags to Selected Vertex Groups and Add into the Current Session Tag Pool Tag Column ********** Amount of Tags in a Row Toggle Tags ************** - List All Available Tags in Vertex Groups - It will remember all available tags in this session until you close the menu - If you remove the tags and the tags is no longer available and there are no unselected vertex groups with the tags, it will display the tags with broken heart icon, that indicates that the tags will be forgotten after this session - If you remove the tags, but there are other unselected vertex groups have the tags, it will show as plus icon, as it is still available, just not within the selected ones - If any of the tags is detected in the selected vertex groups, it will be display with X icon Icons ******* **Broken Heart**: This Tag was removed from the objects and no longer available, but it is still remembered in this session in case you want to add it back, click to add to selected vertex groups **Add**: Add this Tag to selected Vertex Groups **Remove**: Remove this Tag from selected Vertex Groups | Select Filtered ++++++++++++++++++++++++ - Select the current filtered Vertex Groups (Visible Vertext Groups in List) - **Click** - Deselect All and Select the Filtered Vertex Groups - **Alt** - Deselect All Vertex Groups - **Shift** - Keep Existing Selection and add the Filtered Vertex Groups into selection - **Shift + Alt** - Keep Existing Selection and remove and deselect Filtered Vertex Groups from selection | ------ Available Tags ==================== This subpanel will appear if any of the vertex groups have tags. .. image:: /static/AvailableTags.webp This panel list shows all the available tags that are found in the vertex groups and present it as a button that you can click on to add or remove tags to the tag filter. | Tag Column +++++++++++++++ Changes the amount of columns for the tag button. .. video:: /static/TagColumn.webm :width: 600 :autoplay: :loop: :nocontrols: :muted: | Add / Remove Tag ++++++++++++++++++ This button will remove tags from the :ref:`TagFilter` if it is in the filter, or add tags into the filter if it is not in the filter. .. video:: /static/ToogleTags.webm :width: 600 :autoplay: :loop: :nocontrols: :muted: ------ Vertex Group Extra Data ========================= This shows some extra data that is added in by the addon. .. image:: /static/VertexGroupData.webp | Tags ++++++++++++++++++ Display the tags that are attached to the vertex groups for filtering purposes. | Notes ++++++++++++++++++ You can use this to add some notes for self reference. ----------------------------------------------- Operation Buttons (Edit Mode) =============================== These are some operations that you can use. .. image:: /static/OperationButton.webp | .. _WeightPanel: Weight Panel ++++++++++++++++++ A weight panel that you can use for the other operators. - :ref:`CreateFromSelected`, :ref:`SetWeight`, :ref:`AssignWeight` Weight Control Toggle ___________________________ .. image:: /static/WeightControlButton.webp When enabled, it will add an increment and decrement button between the slider, as well as a few preset weight that you can click to set the weight. The increment/decrement step/amount can be set in :ref:`preferences `, or hold down "ctrl + click" on the button to have a quicker access to the preferences. It also adds an eyedropper to sample weight from the mesh. You can enable the *Weight Control Toggle* in :ref:`preferences `. | .. _CreateFromSelected: Create From Selected ++++++++++++++++++++++ Creates a vertex group with selected vertices. Options _________ .. image:: /static/CreateFromSelected.webp Name ********* Name of the new vertex group Weight slider ***************** This allows you to adjust the weight of the selected vertices, this weight option is default in the :ref:`WeightPanel` setting. Remove From Other Vertex Group ********************************* This toggle allows you to remove vertices from other vertex groups and adds it to the newly created vertex group. | ----------------------------------------------- .. _SetWeight: Set Weight ++++++++++++++++++++++ Set the weight of selected vertices to a vertex group. Options _________ .. image:: /static/SetSelectedWeight.webp Set / Unassign **************** - **Set**: Set weights of the selected vertices to the target vertex group. - **Unassign**: Unassign weights of the selected vertices from the target Vertex Group Weight ********* This allows you to adjust the weight of the selected vertices, this weight option is default in the :ref:`WeightPanel` setting. Target ********************************* The target allows you to apply the following operators to the vertex group. - **Active**: Applies to only active vertex groups. - **Selected**: Applies to selected vertex groups. - **All**: Applies to all vertex groups. | .. image:: /static/CreateFromSelected.webp Unassign Weight ++++++++++++++++++++++ Unassign weights of the selected vertices from the active vertex group. This operator works the same as :ref:`AssignWeight`. | Show Weight ++++++++++++++++++++++ Overlay option placed here for convenience to show weight color in *Edit Mode*. | Vertex List ++++++++++++++++ This option can be disabled in preferences under :ref:`WarningPreferences`. Checkout :ref:`VertexList` for details.