Legacy Documentation: Version 4.5.0

Script language:

  • JS
  • C#
  • Boo
Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

AnimationState.AddMixingTransform

AddMixingTransform(mix: Transform, recursive: bool = true): void;
void AddMixingTransform(Transform mix, bool recursive = true);
def AddMixingTransform(mix as Transform, recursive as bool = true) as void

Description

Adds a transform which should be animated. This allows you to reduce the number of animations you have to create.

For example you might have a handwaving animation. You might want to play the hand waving animation on a idle character or on a walking character. Either you have to create 2 hand waving animations one for idle, one for walking. By using mixing the hand waving animation will have full control of the shoulder. But the lower body will not be affected by it, and continue playing the idle or walk animation. Thus you only need one hand waving animation.

If recursive is true all children of the mix transform will also be animated. If you don't call AddMixingTransform, all animation curves will be used.

	function Start() {
		var shoulder : Transform;
		animation["wave_hand"].AddMixingTransform(shoulder);
	}
using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour {
    void Start() {
        Transform shoulder;
        animation["wave_hand"].AddMixingTransform(shoulder);
    }
}
import UnityEngine
import System.Collections

public class ExampleClass(MonoBehaviour):

	def Start() as void:
		shoulder as Transform
		animation['wave_hand'].AddMixingTransform(shoulder)

Another example using a path:

	function Start () {
		// Adds a mixing transform using a path instead
		var mixTransform : Transform = transform.Find("root/upper_body/left_shoulder");
		animation["wave_hand"].AddMixingTransform(mixTransform);
	}
using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour {
    void Start() {
        Transform mixTransform = transform.Find("root/upper_body/left_shoulder");
        animation["wave_hand"].AddMixingTransform(mixTransform);
    }
}
import UnityEngine
import System.Collections

public class ExampleClass(MonoBehaviour):

	def Start() as void:
		mixTransform as Transform = transform.Find('root/upper_body/left_shoulder')
		animation['wave_hand'].AddMixingTransform(mixTransform)