Adobe® Flex® 4 Language Reference
Show Packages and Classes List |  Packages  |  Classes  |  Index  |  Appendixes
spark.effects.animation 
SimpleMotionPath 
Packagespark.effects.animation
Classpublic class SimpleMotionPath
InheritanceSimpleMotionPath Inheritance MotionPath Inheritance Object

Language Version: ActionScript 3.0
Product Version: Flex 4
Runtime Versions: Flash Player 10, AIR 1.5

The SimpleMotionPath class specifies the name of a property, and the values that that property takes over time, for instances of the Animate effect.

This class is a simple subclass of MotionPath for defining two keyframes to hold the valueFrom, valueTo, and valueBy properties. The MotionPath class itself can define any number of keyframes.

Default MXML Propertykeyframes

See also



Public Properties
 PropertyDefined By
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
 Inheritedinterpolator : IInterpolator
The interpolator determines how in-between values in an animation are calculated.
MotionPath
 Inheritedkeyframes : Vector.<Keyframe>
A sequence of Keyframe objects that represent the time/value pairs that the property takes during the animation.
MotionPath
 Inheritedproperty : String
The name of the property on the effect target to be animated.
MotionPath
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
  valueBy : Object
Optional property which specifies the delta used to calculate either the valueFrom or valueTo value.
SimpleMotionPath
  valueFrom : Object
The starting value for the property during the animation.
SimpleMotionPath
  valueTo : Object
The value that the named property will animate to.
SimpleMotionPath
Public Methods
 MethodDefined By
  
SimpleMotionPath(property:String = null, valueFrom:Object = null, valueTo:Object = null, valueBy:Object = null)
Constructor.
SimpleMotionPath
 Inherited
Returns a copy of this MotionPath object, including copies of each keyframe
MotionPath
 Inherited
Calculates and returns an interpolated value, given the elapsed time fraction.
MotionPath
 Inherited
Indicates whether an object has a specified property defined.
Object
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
Returns the string representation of this object, formatted according to locale-specific conventions.
Object
 Inherited
Returns the string representation of the specified object.
Object
 Inherited
Returns the primitive value of the specified object.
Object
Property Detail

valueBy

property
valueBy:Object

Language Version: ActionScript 3.0
Product Version: Flex 4
Runtime Versions: Flash Player 10, AIR 1.5

Optional property which specifies the delta used to calculate either the valueFrom or valueTo value. Providing this optional property lets the effect calculate the necessary from/to values if either are not provided or are to be determined dynamically when the animation begins.

The way that the valueBy value is used depends on which of the other values are set. If neither are set, then the valueFrom value is determined from the current property value in the target, and the valueTo value is valueFrom + valueBy. If one or the other is set, but not both, then the unset value is calculated by the other value: valueTo = valueFrom + valueBy or valueFrom = valueTo - valueBy). If both are set, then the valueBy property is ignored.

Note that since valueBy is of type Object, the effect cannot directly calculate the other values from it. It uses the effect's interpolator to calculate the values by calling the interpolator's increment() and decrement() methods. If no interpolator is set, then it will use NumberInterpolator by default.



Implementation
    public function get valueBy():Object
    public function set valueBy(value:Object):void

valueFrom

property 
valueFrom:Object

Language Version: ActionScript 3.0
Product Version: Flex 4
Runtime Versions: Flash Player 10, AIR 1.5

The starting value for the property during the animation.

A value of Null or NaN (in the case of Numbers) specifies that a value must be determined dynamically at runtime, either by getting the value from the target property directly or calculating it if the other value is valid and there is also a valid valueBy value supplied.



Implementation
    public function get valueFrom():Object
    public function set valueFrom(value:Object):void

valueTo

property 
valueTo:Object

Language Version: ActionScript 3.0
Product Version: Flex 4
Runtime Versions: Flash Player 10, AIR 1.5

The value that the named property will animate to.

A value of Null or NaN (in the case of Numbers) element specifies that a value must be determined dynamically at runtime, either by getting the value from the target property directly or calculating it if the other value is valid and there is also a valid valueBy value supplied.



Implementation
    public function get valueTo():Object
    public function set valueTo(value:Object):void
Constructor Detail

SimpleMotionPath

()Constructor
public function SimpleMotionPath(property:String = null, valueFrom:Object = null, valueTo:Object = null, valueBy:Object = null)

Constructor. You can specify both the valueFrom and valueTo parameters, or specify the valueBy parameter and either the valueFrom or valueTo parameter. If you omit these parameters, Flex calculates them from the effect target.

Parameters
property:String (default = null) — The name of the property being animated.
 
valueFrom:Object (default = null) — The initial value of the property.
 
valueTo:Object (default = null) — The final value of the property.
 
valueBy:Object (default = null) — An optional parameter that specifies the delta with which to calculate either the from or to values, if one is omitted.