ScriptReference/Playables.PlayableExtensions

[docscomments[bot]]

ScriptReference/Playables.PlayableExtensions

https://docs.unity3d.com/ScriptReference/Playables.PlayableExtensions.html

[docscomments[bot]]

Comment by @HilariousCow:

Note that setting input weight to zero on any playable will result in any nodes upstream of that input not being evaluated - transforms and animated properties will therefore not filter down.
This is unimportant in the case of AnimationLayerMixerPlayables and AnimationMixerPlayables because the mixer math means that zero weight on the inputs would have zero change to the outcome.
The progression of a playable's time, however, is unaffected. You're merely skipping the animation evaluations in the leaf nodes, (or any IAnimationJob processes? I could be wrong?)
Obviously this is an optimisation, and a perfectly sensible one.
In the case of IAnimationJobs, however, you might be tempted to have a "dead" input stream (weight = 0f) which you still sample for other data.
If you'd like to do something like this (case in point, we wanted to have a PropertyStreamHandle, animated by a custom curve, drive the weight of each input), just fix the playable's inputs to be greater than 1, then in your mixer math, use something other than stream.GetInputWeight as your effective weight (i.e, we used the PropertyStreamHandle's value for each input).
Just know you're going to jettison an optimization by doing that.