The interpolator determines how in-between values in an animation are calculated. By default, the MotionPath class assumes that the values are of type Number and can calculate in-between Number values automatically. If the MotionPath class is given keyframes with non-Number values, or if the desired behavior should use a different approach to interpolation (such as per-channel color interpolation), then an interpolator should be supplied.

Flex supplies predefined interpolators in the spark.effects.interpolation package.

A sequence of Keyframe objects that represent the time/value pairs that the property takes during the animation. Each successive pair of keyframes controls the animation during the time interval between them. The optional easer and valueBy properties of the later keyframe are used to determine the behavior during that interval. The sequence of keyframes must be sorted in order of increasing time values.

Animations always start at time=0 and lasts for a duration equal to the time value in the final keyframe. If no keyframe is defined at time=0, that keyframe is implicit, using the value of the target property at the time the animation begins.

Because keyframes explicitly define the times involved in an animation, the duration for an effect using keyframes is set according to the maximum time of the final keyframe of all MotionPaths in the effect. For example, if an effect has keyframes at times 0, 500, 1000, and 2000, then the effective duration of that effect is 2000 ms, regardless of any duration property set on the effect itself. Because the final keyframe determines the duration, there must always be a final keyframe in any MotionPath. That is, it is implicit that the time in the final keyframe is the duration of the MotionPath.

Any keyframe may leave its value undefined (either unset, set to null, or set to NaN). In that case, the value is determined dynamically when the animation starts. Any undefined value is determined as follows:

1. If it is the first keyframe, it is calculated from the next keyframe if that keyframe has both a value and valueBy property set, as the difference of those values. Otherwise it gets the current value of the property from the target.
2. If it is the final keyframe and the animation is running in a transition, it uses the value in the destination view state of the transition.
3. Otherwise, any keyframe calculates its value by using the previous keyframe's value and adding the current keyframe's valueBy to it, if valueBy is set.

Related API Elements

The name of the property on the effect target to be animated.

Constructor.

Returns a copy of this MotionPath object, including copies of each keyframe.

Calculates and returns an interpolated value, given the elapsed time fraction. The function determines the keyframe interval that the fraction falls within and then interpolates within that interval between the values of the bounding keyframes on that interval.

Parameters