Version: 2023.1
Language : English
Additional Blend Tree Options
Animator Override Controllers

Working with blend shapes

Preparing the artwork

Once you have your blend shapes set up in your 3D modeling application (such as Autodesk® Maya®):

  1. In your 3D modeling application, enable these export settings:
    • Enable exporting animation.
    • Enable exporting blend shapes for deformed models.
  2. Export your selection to an .fbx file.
  3. Import your FBX file into Unity.
  4. Select the newly imported Model in the Hierarchy window. The InspectorA Unity window that displays information about the currently selected GameObject, asset or project settings, allowing you to inspect and edit the values. More info
    See in Glossary
    window displays the BlendShapes section containing all the blend shapes under the SkinnedMeshRenderer component.
  5. For each of the blend shapes listed, you can change its influence (weighting) to the default shape, where:
  6. 0 means the blend shape has no influence.
  7. 100 means the blend shape has full influence.

Create animations In Unity

To create a blend animation:

  1. Open the Animation window (from the main Unity menu: Window > Animation > Animation).
  2. On the left side of the window, click Add Curve and add a blend shape. The Inspector window displays the new blend shape in the BlendShapes section under the SkinnedMeshRenderer component.

Create the animation you want by adjusting the keyframesA frame that marks the start or end point of a transition in an animation. Frames in between the keyframes are called inbetweens.
See in Glossary
and blend weights.

To preview your animation, click Play in the Editor window or the Animation window.

Scripting access

You can also set the blend weights through scripting using functions like GetBlendShapeWeight and SetBlendShapeWeight.

To check how many blend shapes a MeshThe main graphics primitive of Unity. Meshes make up a large part of your 3D worlds. Unity supports triangulated or Quadrangulated polygon meshes. Nurbs, Nurms, Subdiv surfaces must be converted to polygons. More info
See in Glossary
has, use the blendShapeCount variable.

This code example demonstrates how to blend a default shape into two other blend shapes over time when attached to a GameObjectThe fundamental object in Unity scenes, which can represent characters, props, scenery, cameras, waypoints, and more. A GameObject’s functionality is defined by the Components attached to it. More info
See in Glossary
with three or more blend shapes:

using UnityEngine;
using System.Collections;
 
public class BlendShapeExample : MonoBehaviour
{
    int blendShapeCount;
    SkinnedMeshRenderer skinnedMeshRenderer;
    Mesh skinnedMesh;
    float blendOne = 0f;
    float blendTwo = 0f;
    float blendSpeed = 1f;
    bool blendOneFinished = false;

    void Awake ()
    {
        skinnedMeshRenderer = GetComponent<SkinnedMeshRenderer> ();
        skinnedMesh = GetComponent<SkinnedMeshRenderer> ().sharedMesh;
    }

    void Start ()
    {
        blendShapeCount = skinnedMesh.blendShapeCount; 
    }

    void Update ()
    {
        if (blendShapeCount > 2) {
            if (blendOne < 100f) {
                skinnedMeshRenderer.SetBlendShapeWeight (0, blendOne);
                blendOne += blendSpeed;
            } else {
                blendOneFinished = true;
            }

            if (blendOneFinished == true && blendTwo < 100f) {
                skinnedMeshRenderer.SetBlendShapeWeight (1, blendTwo);
                blendTwo += blendSpeed;
            }
        }
    }
}
Additional Blend Tree Options
Animator Override Controllers