Shape and Frame Lists
The shape list and frame list at the top of the Blend Shape tab — choosing the edited shape and frame, setting weights, hiding, soloing, locking, ordering, and saving initial weights.
The Blend Shape Mode panel at the top of the Blend Shape tab holds two lists: the shape list, with a weight slider for every blend shape, and the frame list of the shape you are editing. Click the panel header to fold it.
Panel layout
From top to bottom:
-
Notice — appears only when something needs attention: no rigging, a parametric shape, or a modifier that removes blend shapes from the result.
-
Shape list and its button row.
-
Editing line — what your next edit changes, for example Editing 'Smile', Editing 'Smile' frame 2 (100) or Editing 'Smile' at weight 35 adds a new frame.
-
Frame list of the edited shape and its button row. It is hidden when no single shape is selected.
-
Statistics — for the edited frame: how many vertices it moves and how many custom normals it has, for example 152 verts moved · 0 custom normals.
Shape list
Rows
| Part | What it does |
|---|---|
| Eye icon | Hides the shape. Its weight is kept. Click again to show it. |
| Name | Click to edit the shape. Double-click to rename it. Drag it to reorder. |
* after the name | The weight here differs from the shape's initial weight. |
| Slider and value | The weight. Drag the slider or type a value. A small bar on the slider marks the initial weight. |
| S | Solo — shows only this shape. Ctrl/Cmd + click to solo several shapes. |
| Lock icon | Locks the shape so tools and menus cannot change it. |
When the list is empty it reads No blend shapes. Press + to create one.
Selecting shapes
- Click a shape to edit it. Click it again to stop editing.
- Ctrl/Cmd + click adds or removes shapes from the selection, and Shift + click selects a range. With several shapes selected, none is edited and the frame list is hidden — use this to delete shapes or to save or load their weights together.
- Right-click a shape to select it and open the shape menu. Right-click an empty part of the list to open the list menu.
- Selecting a shape never changes its weight.
Buttons
| Button | What it does |
|---|---|
| ? | Shows help for the list — its controls, buttons and menu items. |
| Search | Shows only the shapes whose names contain the text. Upper and lower case are treated the same. |
| + | Creates a blend shape named Shape and starts editing it at weight 100. |
| − | Deletes the selected shapes. Asks first when several are selected. A locked shape is deleted too if you selected it. |
| List menu | Commands for the whole list — see Shape Menus. |
| Trash | Deletes every unlocked shape after asking. Locked shapes are kept. |
Renaming and ordering
- Rename — double-click a name, or choose Rename in the shape menu. Names are unique within the mesh; a name that is already taken gets a number, such as Smile_1. To rename many shapes at once, use Rename Shapes... in the list menu.
- Reorder — drag a shape by its name and drop it between two rows, use Move Up / Move Down in the shape menu, or Sort by Name in the list menu. The list order is the blend shape order on the Skinned Mesh Renderer.
- List height — a long list scrolls. Drag the bar below the list to change its height, and double-click the bar to reset it. The height is remembered for all objects.
Hide, Solo and Lock
Hide (eye icon) and Solo (S) change only what you see. The weight stays, they are not part of undo, and they are cleared when you leave the tab. A hidden shape cannot be edited — tools report 'Smile' is hidden by Mute or Solo. Show it to edit it.
Lock is saved with the object and can be undone. Tools, brushes and menus do not change a locked shape; trying reports 'Smile' is locked. Unlock it to edit it. Renaming, reordering, deleting and saving its weight still work. Lock All and Unlock All are in the list menu.
Weights
Weight range
The weight range follows the Clamp Weights (0-100) preference, which is on by default:
| Clamp Weights (0-100) | Clamp BlendShapes (Deprecated) in Unity's Player Settings | Weight range |
|---|---|---|
| On | Not used | 0 to 100 |
| Off | On | 0 to 100 |
| Off | Off | −100 to 200 |
The wider range lets you push a shape past 100 to exaggerate it, or below 0 to reverse it; beyond the frames, the movement is extended the way Unity does it. The tab always uses the same range as the Skinned Mesh Renderer, so what you see in the tab is what the renderer shows. If the range gets smaller, weights outside it are cut to fit. The preference itself is described on the Preference page.
Initial weights
Each shape has an initial weight — the weight the Skinned Mesh Renderer shows outside this tab.
- When you open the tab, the sliders start from the initial weights, cut to the current range if needed.
- When you leave the tab, every shape returns to its initial weight. A
*next to a name warns that the weight here differs from it. The small bar on the slider shows where the initial weight is, and the slider's tooltip shows its value. - To keep a weight, right-click the shape and choose Save Weight, or choose Save All Weights in the list menu. Load Weight and Load All Weights set the sliders back to the initial weights, and Reset All Weights sets every slider to 0.
- Save Weight and Load Weight act on all selected shapes, so you can Ctrl/Cmd + click several shapes first.
Initial weights also come from:
- the Skinned Mesh Renderer component — changing a blend shape weight there saves it as the initial weight, in one undo step;
- UModelerize, which takes them from the original renderer.
Duplicate and Split give their new shapes an initial weight of 0, so the same movement is not applied twice.
While you edit the object in the Modeling, Rigging or Painting 3D tab, all blend shape weights show as 0. The initial weights come back when you leave the object. Saving the scene while this tab is open stores the initial weights, not the weights in the tab.
Weight changes in the tab can be undone and redone while the tab is open. A slider drag is one undo step.
Frame list
Each row is a frame — Frame 1, Frame 2 and so on — with its frame weight, in weight order.
- The edited frame is the one whose weight equals the shape's weight, and it is highlighted. Click a frame to move the shape's weight onto it.
- Between frames nothing is highlighted. Your next edit adds a frame at the current weight and reports it, for example Added frame 2 at weight 35 to 'Smile'. The new frame starts from the shape you see, so nothing jumps, and one Ctrl + Z undoes both the edit and the new frame.
- Double-click a frame weight to change it. Each frame needs a weight above 0 and up to 100 that no other frame of the shape uses — otherwise you see A frame needs a weight between 0 and 100 that no other frame of this shape uses.
- Right-click a frame to select it and open the frame menu.
| Button | What it does |
|---|---|
| ? | Shows help for the frame list. |
| Weight field | The weight for the next in-between frame. Default 50. |
| + | Adds an in-between frame at that weight. It starts from the current shape at that weight. |
| − | Removes the edited frame. A shape keeps at least one frame. |
The frames of a locked shape can be selected, but not added, removed or re-weighted.
Delta Heatmap
Right-click a shape and turn on Show Delta Heatmap to see where the edited shape moves the mesh. Every moved vertex gets a dot colored by distance — blue for a little, red for the most. The dots follow the edited frame, or the shape's last frame when no frame is selected, and dots behind the surface are not drawn. The setting stays on until you turn it off.
See also — Blend Shape Mode · Shape Menus · Blend Shape Mode Guide
