Element Groups
Element Groups are named sets of vertices, edges or faces saved with an object, so you can reselect, hide, lock or protect them later in Modeling, Rigging, the Blend Shape tab and the UV Editor.
Element Groups are named sets of vertices, edges or faces that are saved with a UModeler X object. Use them to reselect a part of the model in one click, hide it or show it on its own, lock it against accidental selection, or keep a brush inside or outside it.
The same groups appear in Modeling, Multiple Objects, Rigging, the Blend Shape tab and the UV Editor — a group made in one place is available in all the others. Vertex groups made in earlier versions are kept and appear as Vertex groups.
How to use
-
Select a UModeler X object and open the Vertex, Edge or Face tool. The mode decides the type of group you create.
-
Select the elements you want to group in the Scene view.
-
In the Element Groups panel of the tool's Inspector options, click +. A new group, such as Face Group 1, is added for the current mode.
-
Click Add on the group's row to put the selected elements in it. Click the name to rename the group.
-
Later, click Select on the row to select the group again — from any mode and in any editor.
Where the panel appears
| Where | Panel |
|---|---|
| Modeling — Vertex, Edge and Face tools, Isolation and Target Weld | Element Groups foldout in the tool options. New groups use the current mode. |
| Modeling — tools that pick faces themselves: Linear Array, Radial Array, Follow, Inset, Edge Flip, Face Color, Face Normal, Hotspot Texturing, Material, UV Param, Quadify | At the end of the tool options, working with face groups. |
| Modeling — tools that pick vertices themselves: Align, Vertex Color | At the end of the tool options, working with vertex groups. |
| Multiple Objects — element tools | One panel per object, titled Element Groups - object name. Each object keeps its own groups. |
| Rigging mode | Element Groups section in the Rigging inspector. It follows the Vertex / Edge / Face selection mode of the Weight Tool. |
| Blend Shape tab | The Vertex, Edge and Face tools and the other selection tools of the tab. |
| UV Editor | At the top of the tool panel while the Vertex, Edge, Face or Island tool is active. |
In the UV Editor, the Vertex tool works with vertex groups, the Edge tool with edge groups, and the Face and Island tools with face groups. Groups are made of mesh elements, so the UV selection is converted to mesh elements and back. Selecting a group selects only what the UV Editor shows — the current UV channel and material, without hidden faces. With the Island tool, selecting a face group selects every island the group touches.
Group types
A group holds one type of element — vertices, edges or faces. The type is set when you create the group, from the current mode, and is shown by the icon in front of the name and the letter after the member count: 12V, 12E or 12F.
- Add and Remove work only in the group's own mode. In another mode they are disabled, and the tooltip tells you which mode to switch to.
- Select works in every mode. The group is converted the same way a selection is converted when you switch modes:
- Vertex mode — edge and face groups select all of their vertices.
- Edge mode — face groups select all edges of their faces; vertex groups select the edges whose two ends are both in the group.
- Face mode — vertex and edge groups select the faces whose edges are all covered by the group.
The group list
Each row shows, from left to right:
| Control | Description |
|---|---|
| Eye icon | Hide Group / Show Group. Hides or shows all elements of the group, the same way H hides the selection. The eye stays open while any member is visible. |
| Hand icon | Disable Selection / Allow Selection. Locks or unlocks the group for viewport selection — see Selection lock below. |
| Type icon | Vertex, Edge or Face. |
| Name | Click to rename. Clearing the name restores the default, such as Face Group 3. |
| Count | Number of members with the type letter, such as 12F. |
| Add | Adds the selected elements to the group. |
| Remove | Removes the selected elements from the group. |
| Select | Selects the group's elements, replacing the selection. Shift + click adds them to the selection, Ctrl (macOS Cmd) + click removes them. |
- Filter — the search field above the list shows only groups whose names contain the text.
- List height — drag the handle under the list to change its height; double-click the handle to reset it. By default about four groups are visible, and the height is remembered as an editor setting.
- Hidden elements are never selected, even by a group's Select button.
Working with several groups
Click a row to pick it. Ctrl (macOS Cmd) + click adds or removes a row, and Shift + click picks a range of the rows shown by the filter. Picked rows are remembered per object, across tools and editors.
The buttons under the list:
| Button | Description |
|---|---|
| Select | Selects only the elements of the picked groups. |
| Deselect | Removes the elements of the picked groups from the selection. |
| Hide | Hides the picked groups. Other hidden elements stay hidden. |
| Hide Others | Hides everything except the picked groups, and shows the picked groups. |
| Show All | Shows every hidden element of the mesh, whatever group it is in. Available while anything is hidden. |
| Auto Group... | Creates groups from connected parts — see Auto Group below. |
| + | Creates an empty group for the current mode and picks it. |
| - | Deletes the picked groups. Only the groups are deleted, not their elements. |
The buttons that act on picked groups are available only while at least one row is picked.
Every panel action — creating, deleting, renaming, adding, removing, selecting, hiding, locking, Auto Group — is one undo step. Picking rows is not recorded.
Selection lock
Click a group's hand icon to lock it. A locked group stays visible, but clicking and drag-selecting in the viewport skip it, and its elements are not highlighted under the cursor — the same idea as the pick toggle in Unity's Hierarchy window. Use it to protect finished parts while you select around them.
- You can still remove locked elements from the selection with Ctrl (macOS Cmd).
- The panel's Select buttons still select a locked group.
- The lock works in the UV Editor as well.
- Click the icon again (Allow Selection) to unlock.
Auto Group
Auto Group... creates one group for each connected part of the mesh.
-
Choose the mode for the groups (Vertex, Edge or Face). Optionally, select the elements to group — with nothing selected, all visible elements are used.
-
Click Auto Group... at the bottom of the panel.
-
Set the options and click Group (or press Enter). Cancel or Esc closes the window without changes.
How parts are connected depends on the mode:
- Vertex — vertices joined by edges.
- Edge — edges that share a vertex, including loose wire edges.
- Face — faces that share a vertex, the same parts the Isolate Tool selects.
Only the elements being grouped can connect parts; when you group a selection, unselected elements in between do not join two parts.
| Option | Description |
|---|---|
| Split by UV Island | Face mode only. Faces on different UV islands go to different groups. Default off. |
| UV Channel | The UV channel whose islands split the groups, 0 – 7. Default 0. |
| Split by Angle | Face mode only. Neighboring faces that bend more than Max Angle go to different groups. Default off. |
| Max Angle | The largest angle in degrees between neighboring faces that stay in the same group, 0 – 180. Default 40. |
| Skip Identical Groups | Does not create a group whose members exactly match an existing group of the same type. Default on. |
- With either split option on, faces connect only across shared edges, so faces that touch at a single corner end up in different groups.
- New groups are named after the mode and the options — Vertex Isolate 1, Edge Isolate 1, Face Isolate 1, Face UV Island 1, Face Angle 1 or Face UV Angle 1 — and the numbers continue from existing groups with the same name.
- If more than 200 groups would be created, you are asked to confirm first. The Scene view reports how many groups were created and how many identical ones were skipped.
- The options are remembered for next time.
Limiting brushes with groups
The Deform brushes (Standard, Move, Flatten, Pinch, Smooth, Relax), the Blend Shape brushes, the Weight Brush and the Vertex Color Brush show a Group Filter row in their options, with a check box for each group.
-
Check one or more groups.
-
Choose the filter mode:
- Only — the brush paints only the checked groups.
- Except — the brush leaves the checked groups untouched.
- Edge and face groups use their vertices.
- With no group checked, the filter is off.
- The filter belongs to the object and is shared by all of its brushes. It is a working setting — it is not saved with the object and is not part of undo.
- With Symmetry on, the mirrored stroke uses the same filter.
- When the object has no groups, the list shows No element groups. Make them in the Vertex, Edge or Face tool.
Groups and topology edits
Groups follow the mesh as you edit it. New elements take the groups of the elements they are made from:
- Faces split from a grouped face stay in its face groups.
- Edge pieces cut from a grouped edge stay in its edge groups.
- New vertices take the vertex groups of the vertices they are created from.
This works with Subdivide, Loop Cut, Slice Cut, Inset, Bevel, Follow, Merge, Weld, Quadify, Detach and other tools. Deleted elements simply leave their groups.
Saving and export
Groups — their names, types, members and selection locks — are saved with the object. Hidden elements stay hidden after saving as well.
Groups are UModeler X editing data. They are not written to the Unity mesh or to exported files.
See also — Element Group · Isolate Tool · Symmetry · Weight Tool · UV Editor Guide · Blend Shape Mode
