ActionQueue

Creates an Action from input arguments and adds it to the queue. This method accepts a number of argument configurations that are translated into an Action object. You can also directly add an Action or TimedAction object. Adding an Action object You can add any object of type Action, IAction, TimedAction and ITimedAction - including complete ActionQueues! public function addAction (inAction:IAction) : void Example:

var queue:ActionQueue = new ActionQueue();
var action:Action = new Action(createShapes, 10);
queue.addAction(action);    
queue.run();

Adding a local function Will be called in local scope. public function addAction (inFunction:Function, argument1, argument2, ...) : void Example:

var queue:ActionQueue = new ActionQueue();
queue.addAction(createShapes, 10);    
queue.run();

Adding a object's method Will be called in the object's scope. public function addAction (inMethod:Function, argument1, argument2, ...) : void Example:

var queue:ActionQueue = new ActionQueue();
queue.addAction(mShapeCreator.createShapes, 10);
queue.run();

Adding a object's method by name Will be called in the object's scope. The method must have public access. public function addAction (inMethodOwner:Object, inMethodName:String, argument1, argument2, ...) : void Example:

var queue:ActionQueue = new ActionQueue();
queue.addAction(mShapeCreator, "createShapes", 10);    
queue.run();

Using ready-made animation methods You can use any function that returns a TimedAction, or use one of the ready made class metods from these classes: AQAddMove AQBlink AQFade AQFollowMouse AQMove AQPulse AQFunction AQScale AQSet AQTimeline Example: This example will fade out a MovieClip from the current alpha to 0 in 0.5 seconds:

var queue:ActionQueue = new ActionQueue();
var CURRENT:Number = Number.NaN;
queue.addAction(new AQFade().fade(my_mc, .5, CURRENT, 0));
queue.run();

Custom timed actions Similar to "Adding an Action": add a TimedAction object. Example:

var action:TimedAction = new TimedAction(doMoveAndScale, duration, effect);
queue.addAction(action);

... where function doMoveAndScale performs the animation based on the percentage value it receives:

protected function doMoveAndScale (inValue:Number) : Boolean {
    
var percentage:Number = 1-inValue; // end of animation: inValue == 0
    
tClip.x = NumberUtils.percentageValue(initX, mClipData.endx, percentage);
tClip.y = NumberUtils.percentageValue(initY, mClipData.endy, percentage);
tClip.scaleX = tClip.scaleY = NumberUtils.percentageValue(1, mClipData.endscale, percentage);
    
return true; // if false the action will stop
}

Adds an Action that is run asynchronously: other actions will follow right after and will not wait for this action to finish. Asynchronous actions can be paused and stopped with pause and stop.

Adds a Condition to the queue. A running queue is automatically halted as long as the condition is not met. The condition will be checked on each frame update (using FramePulse events.

Adds a "end of loop" marker to the queue.

Adds a "go to marker" action to the queue.

Adds a marker to the queue. Markers can be used to receive an event when the queue passes a marker, or to jump to a specific point in the queue.

Use pause() to add a paused state to the queue; when this action is run the queue is paused until resume is called on it. Use pause(duration) to add a waiting action to the queue.

Adds a "start of loop" marker to the queue.

Check whether the queue did pass a marker. The marker has to be 'run' - any jumps over in-between markers will not mark it as 'passed'.

Ends a current running loop.

Jumps the action pointer to a marker.

Name of the last visited marker.

Pauses the current running action and all asynchronous actions.

Quits the queue.

Resets the queue: stops current ActionRunners, removes all actions, clears the "visited markers" history.

Resumes a paused queue.

Starts the queue.

Skips to the next action (if any). If the queue is paused, skip will resume the queue. WIll also skip a paused state.

Stops the queue.

Toggles the playing/paused state of the queue.