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.
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.
How to use
-
Select this object and open the Blend Shape tab. To write into an existing shape, click the shape and the frame to change.
-
Launch the Shape Transfer tool.
-
Drag the target object from the Hierarchy into Target Object.
-
Choose Content and the options below it.
-
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.
Options
| Option | Description |
|---|---|
| Target Object | The 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. |
| Content | Current 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. |
| Destination | For Current Shape. New Shape adds a blend shape. Editing Frame replaces the movement of the frame being edited. |
| Replace Same Names | For Blend Shapes. On (default): blend shapes with the same name are replaced. Off: they are added with unique names. |
| Match By | How each vertex finds its point on the target: Auto (default), Vertex ID, UV or Nearest Surface. See below. |
| Space | Object (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 Only | Only the selected vertices receive the shape. |
| Transfer | Runs 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 By | How it works | Use it when |
|---|---|---|
| Vertex ID | Each 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. |
| UV | Each vertex takes the target point at the same UV position. | Both meshes have UVs with the same layout, but different topology. |
| Nearest Surface | Each vertex takes the closest point on the target surface. | The meshes overlap in space but share neither topology nor UVs. |
| Auto | Uses 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
| Message | What 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
