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

Shape Transfer Tool

The Shape Transfer tool brings the current shape or the blend shapes of another object into this mesh — as a new shape, into the edited frame, or as same-named shapes — matching vertices by vertex ID, UV or nearest surface.

Translation in progress — showing the English version.

The Shape Transfer Tool takes the shape of another object — the target — and turns it into blend shape data on this mesh. It can:

  • add the target's current shape as a new blend shape — for example a copy of the head that you sculpted into a smile;
  • write the target's current shape into the edited frame;
  • copy the target's blend shapes, by name — for example to give eyebrows, a beard or a mask the same expressions as the face they sit on.
▣ Image
Shape Transfer tool panel: Target Object, Content, Destination, Replace Same Names, Match By, Space, Selected Vertices Only, the Transfer button and the result line

How to use

  1. Select this object and open the Blend Shape tab. To write into an existing shape, click the shape and the frame to change.

  2. Launch the Shape Transfer tool.

  3. Drag the target object from the Hierarchy into Target Object.

  4. Choose Content and the options below it.

  5. Press Transfer. The line under the button and a Scene view message report the result, for example Added 'Smile' by vertex ID. 812 vertices moved.

▶ Video
Transfer the blend shapes of a face onto a separate eyebrow mesh: set Target Object to the face, Content to Blend Shapes, Match By to Nearest Surface, press Transfer and test the Smile slider on the eyebrows

Options

OptionDescription
Target ObjectThe object to take the shape from — a UModeler X object, or any object with a Mesh Filter or a Skinned Mesh Renderer. For a UModeler X object, its visible result is used.
ContentCurrent Shape — the shape the target shows now, including its own blend shape weights. Blend Shapes — each blend shape of the target, through the same vertex match.
DestinationFor Current Shape. New Shape adds a blend shape. Editing Frame replaces the movement of the frame being edited.
Replace Same NamesFor Blend Shapes. On (default): blend shapes with the same name are replaced. Off: they are added with unique names.
Match ByHow each vertex finds its point on the target: Auto (default), Vertex ID, UV or Nearest Surface. See below.
SpaceObject (default) lines up the local coordinates of the two objects, so a copy moved aside still matches. World lines them up where they are in the scene.
Selected Vertices OnlyOnly the selected vertices receive the shape.
TransferRuns the transfer.

The options that do not apply to the chosen Content are greyed out. Options and the target are remembered until you close Unity.


Matching vertices

Match ByHow it worksUse it when
Vertex IDEach vertex takes the target vertex with the same ID.The target is a UModeler X object with the same topology — for example a duplicate of this object, or a copy made with Extract Mix as Object. Exact.
UVEach vertex takes the target point at the same UV position.Both meshes have UVs with the same layout, but different topology.
Nearest SurfaceEach vertex takes the closest point on the target surface.The meshes overlap in space but share neither topology nor UVs.
AutoUses Vertex ID when possible. Otherwise it tries UV and keeps it only if at least 90% of the vertices find a match and the result is plausible — the rest fall back to the nearest surface. Otherwise it uses Nearest Surface.You are not sure.

The result line names the method that was used and, when it applies, how many vertices used the nearest surface instead and how many were not matched.


What the transfer writes

Current Shape → New Shape — a new shape at weight 100, ready to edit, with an initial weight of 0. It is named after the target object. When the target's name starts with this object's name and an underscore, as Extract Mix as Object names copies, that part is dropped — Head_Smile becomes Smile. If the target has exactly this mesh's shape, the panel says The target has the same shape. Nothing to add.

Current Shape → Editing Frame — matched vertices take the target's shape; matched vertices that do not move are set to 0, and vertices that were not matched keep their values. If nothing would change, the panel says The editing frame already has this shape. When the weight is between frames, a frame is added first.

Blend Shapes — one shape per target blend shape, with the same name and the same frame weights. The match is made between the two base shapes, so the target's current weights do not matter. Target shapes that do not move any vertex of this mesh are skipped, and the result line says how many. With Replace Same Names, a shape with the same name here is replaced, but a locked one is left alone. The first new or replaced shape becomes the edited shape.


Messages

MessageWhat to do
Pick a target object.Assign Target Object.
Pick an object other than this one.The target cannot be the object itself.
The target has no mesh.Pick an object with a mesh.
Vertex ID matching needs a UModeler X target with the same topology.Use Auto, UV or Nearest Surface.
UV matching needs UVs on both meshes.Use Nearest Surface.
The target has no blend shapes.Use Current Shape, or pick another target.
The target's blend shapes are not in its mesh. Turn on rigging on the target, or match by vertex ID.The target is a UModeler X object whose shapes are not written to its mesh — its rigging is off, or a modifier removes them.
Select vertices to transfer to.Select vertices, or turn off Selected Vertices Only.

See also — Edit Group · Copy Deltas Tool · Shape Menus

Shape Transfer Tool | UModeler X Manual