Legacy Documentation: Version 4.6.2
Language: English
Mecanim Performance and Optimization
Animation Scripting (Legacy)

Legacy animation system

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Sumbission failed

For some reason your suggested change could not be submitted. Please try again in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Prior to the introduction of Mecanim, Unity used its own animation system and for backward compatiblity, this system is still available. The main reason for using legacy animation is to continue working with an old project without the work of updating it for Mecanim. However, it is not recommended that you use the legacy system for new projects.

Working with legacy animations

To import a legacy animation, you first need to mark it as such in the Mesh importer’s Rig tab:

The Animation tab on the importer will then look something like this:

Import Animation Selects whether or not animation should be imported at all.
Wrap Mode The method of handling what happens when the animation comes to an end:-
        Default Uses whatever setting is specified in the animation clip.
        Once Play the clip to the end and then finish.
        Loop Play to the end, then immediately restart from the beginning.
        PingPong Play to the end, then play from the end in reverse, and so on.
        Forever Play to the end, then loop the last frame indefinitely.
Anim Compression Settings to attempt to remove redundant information from clips.
        Off No compression.
        Keyframe reduction Attempt to remove keyframes where differences are too small to be seen
        Keyframe reduction and compression As for Keyframe reduction, but clip data is also compressed.
Rotation error Minimum difference in rotation values (in degrees), below which two keyframes are counted as equal.
Position error Minimum difference in position (as a percentage of coordinate values), below which two keyframes are counted as equal.
Rotation error Minimum difference in scale (as a percentage of coordinate values), below which two keyframes are counted as equal.

Below the properties in the inspector is a list of animation clips. When you click on a clip in the list, an additional panel will appear below it in the inspector:-

The Start and End values can be changed to allow you to use just a part of the original clip (see the page on |splitting animations for further details). The Add Loop Frame option adds an extra keyframe to the end of the animation that is exactly the same as the keyframe at the start. This enables the animation to loop smoothly even when the last frame doesn’t exactly match up with the first. The Wrap Mode setting is identical to the master setting in the main animation properties but applies only to that specific clip.

Mecanim Performance and Optimization
Animation Scripting (Legacy)