Question

With ActionScript3 for Flash Player 9+, what is the nicest way to call a ‘once-off’ function after exactly one frame?

I am aware of the Timer class and it’s uses, and the callLater method on Flex UIComponents (which, glancing through the source, doesn’t look very efficient in this scenario). I’m also aware of setTimeout (in flash.utils).

The Timer class and setTimeout utility are both time based, so how would we guarantee that our function will get called after exactly one frame?

From my limited testing it seems that functions passed to setTimeout only execute after at least one frame (try setting the delay to 0). But this is not guaranteed.

Of course, we could listen for Event.ENTER_FRAME events from a DisplayObject, but that seems like overkill for a once-off delayed function call.

Answer 1

Flex was intended to abstract away the frame-based nature of the Flash Player so you will not find much to help you with your problem. The best approach is to listen for ENTER_FRAME as you suggest. If that’s overkill (and I’m not sure why you think it is), you could create a helper class which takes a DisplayObject and Function as arguments which will automatically add/remove the ENTER_FRAME event listener for you.

public class NextFrameCommand() {      private var functionToCall : Function;      public function NextFrameCommand(dObj: DisplayObject, func : Function) {         functionToCall = func;     }      public function start() : void {         dObj.addEventListener(Event.ENTER_FRAME, onEnterFrame);     }      private function onEnterFrame(e : Event) : void {         e.target.removeEventListener(Event.ENTER_FRAME, onEnterFrame);         functionToCall.call();     }  } 

I haven’t tested that code but hopefully you get the idea….