If true, the LinePath2D will analyze every Point whenever it renders to see if any Point's x or y value has changed, thus making it possible to tween them dynamically. Setting autoUpdatePoints to true increases the CPU load due to the extra processing, so only set it to true if you plan to change one or more of the Points' position.

The array of Points through which the LinePath2D is drawn. IMPORTANT: Changes to the array are NOT automatically applied or reflected in the LinePath2D - just like the filters property of a DisplayObject, you must set the points property of a LinePath2D directly to ensure that any changes are applied internally.

Total length of the LinePath2D as though it were stretched out in a straight, flat line.

Constructor

Appends multiple Points to the end of the points array. Identical to the appendPoint() method, but accepts an array of Points instead of just one.

Adds a Point to the end of the current LinePath2D (essentially redefining its end point).

Finds the closest overall progress value on the LinePath2D based on the target object's current position (x and y properties). For example, to position the mc object on the LinePath2D at the spot that's closest to the Point x:100, y:50, you could do:

path.addFollower(mc, path.getClosestProgress(new Point(100, 50)));

Translates the progress along a particular segment of the LinePath2D to an overall progress value, making it easy to position an object like "halfway along the 2nd segment of the line". For example:

path.addFollower(mc, path.getSegmentProgress(2, 0.5));

Inserts multiple Points into the points array at a particular index/position. Identical to the insertPoint() method, but accepts an array of points instead of just one.

Inserts a Point at a particular index value in the points array, similar to splice() in an array. For example, if a LinePath2D instance has 3 Points already and you want to insert a new Point right after the first one, you would do:

var path:LinePath2D = new LinePath2D([new Point(0, 0),
new Point(100, 50),
new Point(200, 300)]);
path.insertPoint(new Point(50, 50), 1);



Removes a particular Point instance from the points array.

Removes the Point that resides at a particular index/position in the points array. Just like in arrays, the index is zero-based. For example, to remove the second Point in the array, do removePointByIndex(1);

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));

Allows you to snap an object like a Sprite, Point, MovieClip, etc. to the LinePath2D by determining the closest position along the line to the current position of the object. It will automatically create a PathFollower instance for the target object and reposition it on the LinePath2D.