UModeler X MCPリリース — AIエージェントでモデリング
UModeler X

Shape Menus

Every command in the Blend Shape tab's shape menu, list menu and frame menu — duplicate, apply, split, mirror, symmetrize, mix, extract, update from objects, batch rename, name presets, locking and deleting.

Translation in progress — showing the English version.

The Blend Shape tab has three menus, and each one acts on a different target.

MenuHow to open itActs on
Shape menuRight-click a shape in the shape listThe edited shape. Save Weight and Load Weight act on all selected shapes.
List menuThe menu button in the shape list's button row, or right-click an empty part of the listThe whole list, or the mix you see
Frame menuRight-click a frame in the frame listThe edited frame

Hover over an item for a short description; the ? buttons under the lists repeat them. Greyed-out items do not apply right now — for example Apply to Basis on a locked shape. Each command that changes the shapes or the mesh is one undo step.


Shape menu

▣ Image
Shape menu opened by right-clicking a shape: Duplicate, Rename, Lock, Save Weight, Load Weight, Move Up, Move Down, Apply to Basis, Split Left/Right, Select Moved Vertices, Show Delta Heatmap
ItemWhat it does
DuplicateCopies the shape with all its frames. The copy is named after the original with _copy and placed right below it.
RenameRenames the shape, like double-clicking its name.
LockLocks or unlocks the shape, like the lock icon on its row. A check mark shows a locked shape.
Save WeightSaves the weight of the selected shapes as their initial weight, so it stays when you leave the tab.
Load WeightSets the weight of the selected shapes back to their initial weight.
Move Up / Move DownMoves the shape one place up or down.
Apply to BasisAdds the edited shape at its current weight to the base mesh, then deletes the shape.
Split Left/RightSplits the shape into one new shape per side of the symmetry plane. The original is kept.
Select Moved VerticesSelects the vertices the shape moves, in any of its frames.
Show Delta HeatmapColors the moved vertices by distance, red for the most. A check mark shows when it is on.

For initial weights, see Shape and Frame Lists.

Apply to Basis

Bakes the edited shape into the base mesh at its current weight — the slider value, even if the shape is hidden — and deletes the shape. Normals are baked as well, so the shading stays as you saw it. Other shapes keep their movement, now on top of the new base. The Scene view reports the result, for example Applied 'Smile' at weight 100 to the base mesh and deleted it. 812 vertices moved. At weight 0 the base mesh stays the same and the shape is only deleted.

Split Left/Right

Uses the axis, center and tolerance of the symmetry plane; symmetry does not have to be on. The item name and the suffixes of the new shapes follow the symmetry axis:

AxisMenu itemNew shapes
XSplit Left/RightSmile_L, Smile_R (L is the model's left, the −X side, when it faces +Z)
YSplit Top/BottomSmile_Top, Smile_Bottom
ZSplit Front/BackSmile_Front, Smile_Back

Vertices on the plane go half to each side, and the split fades smoothly over a narrow band around the plane, so the two new shapes add up exactly to the original. The new shapes are inserted below the original with weight 0 and an initial weight of 0, and the first one becomes the edited shape. See Symmetry for the plane settings.

▣ Image
Before and after Split Left/Right: a full Smile shape, and Smile_L and Smile_R each moving one mouth corner

Select Moved Vertices

Selects every vertex the shape moves, in any frame. If the Object, Edge or Face tool is active, it switches to the Vertex tool first. Use it to check a shape's area, or as the starting selection for the Edit tools. When the shape moves nothing, the Scene view reports No vertices are moved in 'Smile'.


List menu

▣ Image
List menu opened from the menu button: Sort by Name, Reset All Weights, Save All Weights, Load All Weights, New Shape from Mix, Extract Mix as Object, Apply All, Update from Objects, Update from Objects (Flipped), Rename Shapes..., Add ARKit Face Shapes, Add VRChat Viseme Shapes, Lock All, Unlock All, Delete All
ItemWhat it does
Sort by NamePuts all shapes in name order.
Reset All WeightsSets every weight to 0.
Save All WeightsSaves every weight here as the initial weights.
Load All WeightsSets every weight back to its initial weight.
New Shape from MixMakes a new shape from what you see now, with all weights combined.
Extract Mix as ObjectCopies what you see now into a new object without rigging or blend shapes.
Apply AllAdds every unlocked shape at its current weight to the base mesh, then deletes those shapes.
Update from ObjectsRebuilds each shape from the scene object named after this object and the shape, such as Head_Smile.
Update from Objects (Flipped)The same, mirrored across the symmetry plane.
Rename Shapes...Opens a window that renames several shapes at once.
Add ARKit Face ShapesAdds the 52 ARKit face-tracking names as empty shapes.
Add VRChat Viseme ShapesAdds the 15 VRChat viseme names as empty shapes.
Lock All / Unlock AllLocks or unlocks every shape.
Delete AllDeletes every unlocked shape after asking. Locked shapes are kept.

New Shape from Mix

Creates a shape named Mix from the result you see — every visible shape at its weight; hidden shapes are left out. All weights then go to 0 and the new shape to 100, so the view does not change. Only vertex movement is captured; its normals are calculated. Available when at least one visible shape has a weight other than 0.

Extract Mix as Object

Copies what you see into a new, separate UModeler X object with no rigging and no blend shapes. Hidden shapes are left out, and the normals you see are kept. The copy is made from the source mesh in its rest pose, so modifiers and the bone pose are not included.

The new object is placed at the same position under the same parent and selected. It is named after this object and the visible shape, such as Head_Smile, or Head_Mix when several shapes are visible — the names Update from Objects looks for.

Apply All

Bakes every unlocked shape into the base mesh at its current slider weight, including its normals, and deletes those shapes. Locked shapes keep their movement and weight. The Scene view reports how many shapes were applied, how many vertices moved and how many locked shapes were kept.

Update from Objects

Brings back shapes you sculpted as separate objects. For each shape, it looks in the same scene for an object named ObjectName_ShapeName — for example Head_Smile for the shape Smile on the object Head — and rebuilds the shape's last frame from that object.

  • Vertices are matched automatically in object space, as with Shape Transfer set to Match By: Auto and Space: Object. A copy made by Extract Mix as Object matches every vertex exactly as long as you did not add or delete vertices.
  • Matched vertices take the object's shape; vertices that could not be matched keep their values.
  • Locked shapes are skipped. The item is greyed out when no matching object exists.
  • The Scene view reports Updated N blend shapes from objects. and how many were already the same.

Update from Objects (Flipped) does the same but mirrors the result across the symmetry plane.

See Blend Shape Mode Guide for the full round trip.

Rename Shapes...

Opens the Rename Blend Shapes window, which renames every shape in one undo step.

▣ Image
Rename Blend Shapes window: Find, Replace, Use Regex, Prefix and Suffix fields, the preview list of old and new names, and the Rename and Close buttons
FieldWhat it does
FindText to look for in each name. Upper and lower case must match. Leave empty to skip find and replace.
ReplaceText that replaces every match.
Use RegexTreats Find as a regular expression. Replace can then use groups such as $1.
Prefix / SuffixText added before / after every name.

The rules run in this order: find and replace, then prefix, then suffix. The list shows each changed name as old → new, including the number added when a name would clash, and the line below counts them. Press Rename to apply, Close to finish.

Add ARKit Face Shapes / Add VRChat Viseme Shapes

Add the standard names as empty shapes. Names already in the list are skipped, so you can run them again safely. The Scene view reports Added N empty blend shapes. The first added shape becomes the edited shape at weight 0 — click its frame in the frame list to start sculpting.

  • ARKit — the 52 names face-tracking apps and VTuber tools look for: eyeBlinkLeft, eyeLookDownLeft, eyeLookInLeft, eyeLookOutLeft, eyeLookUpLeft, eyeSquintLeft, eyeWideLeft, eyeBlinkRight, eyeLookDownRight, eyeLookInRight, eyeLookOutRight, eyeLookUpRight, eyeSquintRight, eyeWideRight, jawForward, jawLeft, jawRight, jawOpen, mouthClose, mouthFunnel, mouthPucker, mouthLeft, mouthRight, mouthSmileLeft, mouthSmileRight, mouthFrownLeft, mouthFrownRight, mouthDimpleLeft, mouthDimpleRight, mouthStretchLeft, mouthStretchRight, mouthRollLower, mouthRollUpper, mouthShrugLower, mouthShrugUpper, mouthPressLeft, mouthPressRight, mouthLowerDownLeft, mouthLowerDownRight, mouthUpperUpLeft, mouthUpperUpRight, browDownLeft, browDownRight, browInnerUp, browOuterUpLeft, browOuterUpRight, cheekPuff, cheekSquintLeft, cheekSquintRight, noseSneerLeft, noseSneerRight, tongueOut.
  • VRChat — the 15 lip-sync visemes the avatar descriptor's auto-detection looks for: vrc.v_sil, vrc.v_pp, vrc.v_ff, vrc.v_th, vrc.v_dd, vrc.v_kk, vrc.v_ch, vrc.v_ss, vrc.v_nn, vrc.v_rr, vrc.v_aa, vrc.v_e, vrc.v_ih, vrc.v_oh, vrc.v_ou.

Lock All, Unlock All and Delete All

Lock All and Unlock All change every shape at once; for one shape, use the lock icon on its row. Delete All asks Delete all N unlocked blend shapes? and keeps locked shapes — the trash button under the list does the same.


Frame menu

▣ Image
Frame menu opened by right-clicking a frame: Mirror Shape, Symmetrize, Select Moved Vertices, Clear Frame Deltas, Clear Normal/Tangent Overrides
ItemWhat it does
Mirror ShapeFlips the frame across the symmetry plane.
SymmetrizeCopies one side of the frame onto the other. Needs symmetry on.
Select Moved VerticesSelects the vertices this frame moves.
Clear Frame DeltasClears every vertex movement and custom normal of the frame.
Clear Normal/Tangent OverridesReturns the frame to calculated normals and tangents.

On a locked shape only Select Moved Vertices is available.

Mirror Shape

Every vertex takes the mirrored movement of its partner on the other side, so a smile on the left side becomes the same smile on the right side. Movement across the plane is removed from vertices that lie on it. It uses the symmetry plane's axis, center and tolerance — symmetry does not have to be on — and needs a selected frame.

▣ Image
Before and after Mirror Shape: a frame that raises the left mouth corner, and the same frame raising the right corner instead

Symmetrize

Copies the movement of one side of the frame onto the other, so both sides match. It needs symmetry turned on (Sym button or Shift + Y).

  • The source side is the symmetry Reference Side. Auto takes the side that moves more.
  • With vertices selected, only those vertices and their mirror partners change. Otherwise the whole frame is symmetrized.
  • When the weight is between frames, a frame is added at that weight first.
  • The Scene view reports the result, for example Symmetrized 210 vertices. It also says how many vertices have no mirror partner within the tolerance.

The Symmetrize buttons in the Sym options of the Scene view do the same while this tab is open — they symmetrize the edited frame, not the base mesh — from the side you pick. See Symmetry for Reference Side, Match Tolerance and Clip Center.

Clear Frame Deltas and Clear Normal/Tangent Overrides

Clear Frame Deltas removes all vertex movement from the frame, together with the custom normals and tangents around the moved vertices. To clear only some vertices, or every frame or every shape, use the Erase Tool.

Clear Normal/Tangent Overrides keeps the movement but drops the normals and tangents set with the Normal / Tangent Tool or the Numeric Tool, so they are calculated again from the shape.


See also — Shape and Frame Lists · Edit Group · Symmetry

Shape Menus | UModeler X Manual