Movie::Advance

Movie::Advance
virtual float Advance(float deltaT, unsigned frameCatchUpCount = 2, bool capture = true) = 0;
Description

Advance advances the movie animation based on the time that has passed since the last advance call, in seconds. In general, the time interval should be less than or equal to 1 movie frame rate. If it is not, multiple frames will be advanced if frameCatchUpCount is greater than 0. 

When called, Advance performs tasks such as timeline animation processing, ActionScript execution, queued input processing and resolving loaded movies. The cost of Advance is directly proportional to the number of nested movie clips existing within the movie instance and the complexity of ActionScript.

Parameters
Parameters 
Description 
float deltaT 
The time interval that have passed since the last Advance call, in seconds. A deltaT value of 0 allows frame 1 of a newly created movie clip to be executed in case Advance has not yet been called. 
unsigned frameCatchUpCount = 2 
Specifies the maximum number of frames for which catch up-will be attempted in case animation falls behind by more then one frame time slice. While generally good, catch up should be capped because it can cause extra processing cost if Advance rate is consistently lower then the target frame rate of the SWF. Default catch-up value is 2. 
bool capture = true 
If set to true, then method Movie::Capture will be executed at the end of Advance. 
Return Value

The time remaining till the next Advance call, in seconds.