Returns an array of all PathFollower instances associated with this path

A value between 0 and 1 that can be used to move all followers along the path. progress is identical to rawProgress except that the rawProgress is not re-interpolated between 0 and 1. For example, if you set the motion path's rawProgress to 2.1, progress would be 0.1 (the corresponding value between 0 and 1), essentially wrapping it. If rawProgress is set to -3.4, progress would be 0.6. You may set progress to any value but it will be re-interpolated to its corresponding value between 0 and 1 very much like a DisplayObject's "rotation" property in Flash where setting it to 270 works fine but when you trace() the rotation value it will report as -90 instead because rotation is always interpolated to be between 180 and -180. Setting progress affects rawProgress too. For example:

myPath.progress = 2.1;
trace(myPath.progress); //traces "0.1"
trace(myPath.rawProgress); //traces "2.1"

Either property can be used to move all followers along the path. Unlike a PathFollower's progress or rawProgress, this value is not absolute for motion paths - it simply facilitates movement of followers together along the path in a way that performs better than tweening each follower independently (plus it's easier). If your goal is to tween all followers around a CirclePath2D twice completely, you could just add 2 to the progress or rawProgress value or use a relative value in the tween, like:

TweenLite.to(myCircle, 5, {progress:"2"}); //or myCircle.progress + 2

Also note that if you set progress to any value outside of the 0-1 range, rawProgress will be set to that exact value. If progress is set to a value within the typical 0-1 range, it will only affect the decimal value of rawProgress. For example, if rawProgress is 3.4 and then you set progress to 0.1, rawProgress will end up at 3.1 (notice the "3" integer was kept). But if progress was instead set to 5.1, since it exceeds the 0-1 range, rawProgress would become 5.1. This behavior was adopted in order to deal most effectively with wrapping situations. For example, if rawProgress was tweened to 3.4 and then later you wanted to fine-tune where things were positioned by tweening progress to 0.8, it still may be important to be able to determine how many loops/wraps occurred, so rawProgress should be 3.8, not reset to 0.8. Feel free to use rawProgress exclusively if you prefer to avoid any of the re-interpolation that occurs with progress.

See also

Identical to progress except that the value is not re-interpolated between 0 and 1. For example, if you set the motion path's rawProgress to 2.1, progress would be 0.1 (the corresponding value between 0 and 1), essentially wrapping it. If rawProgress is set to -3.4, progress would be 0.6. Setting progress affects rawProgress and vice versa. For example:

myPath.progress = 2.1;
trace(myPath.progress); //traces "0.1"
trace(myPath.rawProgress); //traces "2.1"

Either property can be used to move all followers along the path. Unlike a PathFollower's progress or rawProgress, this value is not absolute for motion paths - it simply facilitates relative movement of followers together along the path in a way that performs better than tweening each follower independently (plus it's easier). If your goal is to tween all followers around a CirclePath2D twice completely, for example, you could just add 2 to the progress or rawProgress value or use a relative value in the tween, like:

TweenLite.to(myCircle, 5, {rawProgress:"2"}); //or myCircle.rawProgress + 2

See also

Returns an array of all target instances associated with the PathFollowers of this path

Adds a follower to the path, optionally setting it to a particular progress position. If the target isn't a PathFollower instance already, one will be created for it. The target can be any object that has x and y properties.

Parameters

Distributes objects evenly along the MotionPath. You can optionally define minimum and maximum progress values between which the objects will be distributed. For example, if you want them distributed from the very beginning of the path to the middle, you would do:

path.distribute([mc1, mc2, mc3], 0, 0.5);

As it loops through the targets array, if a target is found for which a PathFollower doesn't exist, one will automatically be created and added to the path. The targets array can be populated with PathFollowers or DisplayObjects or Points or pretty much any object.

Parameters

Returns the PathFollower instance associated with a particular target or null if none exists.

Parameters

Sets the line style for the path which you will only see if you add the path to the display list with something like addChild() and make sure the visible property is true. For example, to make a CirclePath2D visible with a red line red that's 3 pixels thick, you could do:

var myCircle:CirclePath2D = new CirclePath2D(150, 150, 100);
myCircle.lineStyle(3, 0xFF0000);
addChild(myCircle);

Parameters

Removes all followers.

Removes the target as a follower. The target can be a PathFollower instance or the target associated with one of the PathFollower instances.

Parameters

Positions any object with x and y properties on the path at a specific progress position. For example, to position mc in the middle of the path, you would do:

myPath.renderObjectAt(mc, 0.5);

Some paths have methods to translate other meaningful information into a progress value, like for a CirclePath2D you can get the progress associated with the 90-degree position with the angleToPosition() method like this:

myCircle.renderObjectAt(mc, myCircle.angleToProgress(90));

Parameters

Forces the MotionPath to re-render itself and all of its followers.

Parameters