Mixers serve the same purpose as Mecanim Blend Trees; they allow you to blend multiple animations based on a parameter. For example, you might blend between Idle, Walk, and Run based on how fast you want the character to move (such as in proportion to how far the user tilts a joystick) so that they animate appropriately for any speed instead of only having a few specific speeds they can move at.

Also note that Blend Trees can be played in Animancer using using Controller States.

Blend Trees vs. Mixers

The Linear Mixers sample demonstrates how to use both Mixers and Blend Trees.

There are several key differences between them:

Mixer Types

There are several different types of Mixers and you can create your own by inheriting from any of them:

Manual Mixers

ManualMixerStates allow you to simply control the AnimancerNode.Weight of each state manually without any automated calculations. This is often useful for additive animations and blend shapes for things like facial expressions, though the Facial Expressions sample simply puts all the facial blend shape animations on their own Layer.

Parameters and Thresholds

Other Mixers have a Parameter property and Thresholds array which are used to calculate the weight of each state for you.

• Mixer Parameters can be bound to Animancer Parameters so that their values can be controlled without needing to directly access the state.
• Setting a Parameter value takes effect immediately, it isn't affected by the fade duration of a transition and doesn't happen smoothly over time unless you apply Parameter Smoothing to it.
• The Mixer Creation page explains how to set the Thresholds.
• When the Parameter is exactly equal to a particular threshold, the corresponding state will be at exactly 1 weight.
• Parameter values between the Thresholds will calculate fractional weights based on the interpolation algorithm being used.

2D Mixer Dead Zones

When selecting a 2D mixer, Directional generally offers better interpolation than Cartesian for animations that represent direction such as move forward/back/left/right.

In areas with 180 degrees or more between states the interpolation is ill-defined and will likely have undesirable results. For example, if you have clips for forward, back, and left, but no right, then you will get odd results if you set the parameter to the right.

Other Details

MixerStates are a type of AnimancerState with several other differences from regular ClipStates:

• The Clip property will always return null.
• Length, Time, and NormalizedTime are calculated using the weighted average of the Mixer's children.
• You can access the children of a Mixer via mixer.GetChild(x) or mixer.ChildStates[x].
• The children aren't given a Key (unless you manually set it).

Events

There are several important things to note when using Events with Mixers:

• Animancer Events can be assigned to a Mixer or its child animations:
  • Events on the Mixer will trigger based on the weighted average NormalizedTime of all children.
  • Events on a child will trigger based on the NormalizedTime of that specific child. All children are always playing and therefore triggering their events while the Mixer is playing, so you may need to check if the AnimancerEvent.Current.State.Weight is zero or a small number to ignore any events you don't want.
  • Animation Events work the same as Animancer Events registered on the Mixer's children, except they don't have any way to determine which child they came from.
• The Inspector for a Mixer Transition only allows you to configure events for the Mixer itself, but if you assign a Transition Asset as one of its animations then that asset can define the events for that child.

Other Pages