Legacy Documentation: Version 4.6(go to latest)
Language: English
  • C#
  • JS
  • Boo

Script language

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

AnimationState.AddMixingTransform

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

public function AddMixingTransform(mix: Transform, recursive: bool = true): void;
public void AddMixingTransform(Transform mix, bool recursive = true);
public 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)