Skip to content

MykytaPetrenko/ShapeKeyWrap

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Transfer shape keys in a couple clicks

Blender addon for transfering shapekeys from on mesh to another one and binding thier values. There is another free addon that do almost the same with another algorythm (you may check it here), but sometimes it does not work properly. So have writen my own addon. It is very fast and simple (around a hundred lines of code).

How to transfer Shape Keys

  1. Switch to object mode
  2. Select a target mesh or multiple meshes
  3. Select source mesh (it should be active, don't click at another object after that)
  4. Specify which shape key you want to transfer (N-panel > Tools > Shape Key Wrap). 4.1. By default "Transfer By The List" option is disabled (toggle button is released) and all the shape keys of the source object to be transferred. 4.2. If "Transfer By The List" option is activeted (toggle button is pressed) only checked shape keys from the list will be transferred. "Refresh" button refreshes the list of the shape keys in accordance to all the shape keys of the source object. "Check All" refreshes the list and checks all the shape keys. "Uncheck All" refreshes the list and uncheckes all the shapekeys.
  5. N-panel > Tools > Shape Key Wrap > Click "Transfer Shape Keys". 6 Adjust parameters if something goes wrong (most of the parameters are the parameters of surface deform modifier, the addon is based on it). If "Replace Shapekeys" is on, and target mesh have shape key with the same names as source mesh they will be replaced. Be carefull with the checkbox because the key shape data may be lost irrecoverably. "Bind Values" binds the values of target shape keys ot the values of the source shape keys via drivers.

How to bind Shape Key values by names

By default the add-on will bind shape key values with the shape keys. But you can easily do it separately.

  1. Do steps 1-4 from the preceding paragraph (see above "How to transfer Shape Keys").
  2. Click "Bind Values" button. The shape key values of the target object will be bound do shape keys of the values of the source shape keys with matching names.

Known issues

Unable to bind surface deform modifier error

The problem is related to the inability to bind the surface deform modifier to the source mesh

  • Check out the blender Surface Deform Modifier documentation on target mesh validity and check your mesh. ShapeKeyWrap source is SurfaceDeform target so you need to check the mesh from which you transfer shape keys first of all. The most frequent problem is "edges with more than two faces". "concave faces" is less frequent but also occurs.
  • When there no other problems but you still getting the error. Experimentally I got this behavior when a lot of vertices of target and source mesh have the same coordinates. I have found a few solutions:
    • Disabling modifiers can sometimes resolve this issue.
    • Shifting vertices of one mesh very slightly. You can add such noise enabling "Bind Noise" feature. Very slight noise value sometimes helps.
    • Let me know if you know other solutions

Feedback and Support

Join our Discord Server to share your feedback and ask for help. Please use right channel for feedback and suppor as I have a few add-ons.

Also visit my youtube channel and gumroad page If you liked the addon

Another Add-ons

  • MetaReForge - Paid add-on for Metahuman customization in blender
  • JoinAsPose - Free add-on for attaching the rest pose from one/multiple source armatures to a single target armature.