MC Tween

Special notice! While MC Tween is a nice extension and it will continue to work for AS1 and AS2 until the end of time, it is my duty to inform all citizens that I have switched the focus from further development on MC Tween to a new AS2 and AS3 extension, a real Class this time, called "caurina.transitions.Tweener" (or just Tweener). Tweener doesn't have as many features as MC Tween yet (for example, it doesn't have native filter tweens), and the documentation isn't 100% done, but it features a complete, more solid redesign with a few additional syntax features that were impossible to achieve with MC Tween. And it works the same for AS2 (including Flash Lite 2+) and AS3.

So, if you use MC Tween, or you're thinking about using it, I'd like to suggest you try Tweener instead. It follows all the principles of simplicity I tried to feature on MC Tween, but with a more powerful syntax. Tweener download, examples and documentation are available on Tweener's page. You can read more about this change on this blog post.

Thank you for your attention and sorry for this ugly box. And don't worry, this website will not be deleted or anything.

Notice for October 2008: also note that, if you are still interested in MC Tween and don't want to use class-based AS2 or AS3 solutions, Larry Benedict has taken the matter into his hands and updated MC Tween with some filter features that are not available in the latest version. You can read more about it (and download his version) here or here.

Documentation

» Introduction

Core Methods

» tween()

» stopTween()

Shortcut Methods

» alphaTo()

» bezierSlideTo()

» colorTo()

» colorTransformTo()

» frameTo()

» panTo()

» resizeTo()

» rotateTo()

» scaleTo()

» scrollTo()

» slideTo()

» volumeTo()

» xScaleTo()

» xSlideTo()

» yScaleTo()

» ySlideTo()

Rounded Shortcut Methods

» roundedBezierSlideTo()

Flash 8 Filters Shortcut Methods

» bevelTo()

» blurTo()

» glowTo()

» xBlurTo()

» xGlowTo()

» yBlurTo()

» yGlowTo()

» xyBevelTo()

» xyBlurTo()

» xyGlowTo()

Auxiliary Functions

» getTweens()

» isTweening()

Auxiliary Methods

» lockTween()

Additional Events

.onTweenComplete()

Applies To

MovieClip, Sound, TextField

Availability

Flash 6 and above, using AS1 or AS2.

Usage

<MovieClip|Sound|TextField>.onTweenComplete = <function>;

Parameters

function : The name of a function, in reference (object) form, or an anonymous function.

Returns

N/A

Description

Event handler; invoked immediately after a tweening has ended. This function is called once for every tweened property, and receives the property name as a single string parameter. This function is defined once per object, not per tweening, so do not mistake this by tween()'s callback parameter; this event gets called once for every property being tweened.

This event handler works similarly to the MovieClip's built-in event handlers, like .onEnterFrame, .onRollOver, etc.

Examples

// Warns every time a tweening ends for a MovieClip object, using a named function
warnOnEnd = function(propName) {
  trace ("Tweening "+propName+" has ended.");
};
<MovieClip>.onTweenComplete = warnOnEnd;

// Warns every time a tweening ends for a MovieClip object, using an anonymous function
<MovieClip>.onTweenComplete = function(propName) {
  trace ("Tweening "+propName+" has ended.");
};

// Do something after a TextField _x tween has ended, using an anonymous function
<TextField>.onTweenComplete = function(propName) {
  if (propName == "_x") {
    trace ("The _x tweening has ended!");
    // do something here
  }
};