MC Tween: it saves the world.™

Home | Using MC Tween | Documentation | Animation Types | Downloads | Examples | Extensions | Author & Disclaimer | Links

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

» roundedSlideTo()

» roundedTween()

» roundedXSlideTo()

» roundedYSlideTo()

Flash 8 Filters Shortcut Methods

» bevelTo()

» blurTo()

» glowTo()

» xBlurTo()

» xGlowTo()

» yBlurTo()

» yGlowTo()

» xyBevelTo()

» xyBlurTo()

» xyGlowTo()

Auxiliary Functions

» getTweens()

» isTweening()

Auxiliary Methods

» lockTween()

» unlockTween()

» pauseTween()

» resumeTween()

Additional Events

» onTweenComplete

» onTweenUpdate

Introduction

MC Tween works by adding new methods and functions to existing Actionscript classes - namely, the MovieClip, Sound and TextField classes. Since you won't have to instantiate new objects or extend anything, the new methods are all one need to know in order to create new tweenings with this extension.

To view the help for each different command, please select one of the methods, functions or event handlers below for an explanation of what each one does. If you're using AS2, also be sure to read the AS2 usage notes.

 

Core methods are the methods that make tweening work, and eventually, stop it if needed. They are all you need to get most of the functionality out of MC Tween.

Tweening starting
(MovieClip, Sound, TextField)

» tween()

Tweening ending
(MovieClip, Sound, TextField)
» stopTween()

 

Shortcut methods are methods that help you do tweenings faster, easier, and keep the code more readable. They also provide ways of tweening attributes that otherwise aren't direcly available as a property, like a MovieClip tinting or a Sound volume, for example.

Opacity control
(MovieClip, TextField)

» alphaTo()

Moving around
(MovieClip, TextField)

» slideTo()

» xSlideTo()

» ySlideTo()

» bezierSlideTo()

Rotating
(MovieClip, TextField)

» rotateTo()

Resizing
(MovieClip, TextField)

» resizeTo()

» scaleTo()

» xScaleTo()

» yScaleTo()

Color tinting
(MovieClip, TextField)

» colorTo()

Color transforming
(MovieClip)

» colorTransformTo()

Timeline controlling
(MovieClip)

» frameTo()

Volume/panning control
(Sound)

» volumeTo()

» panTo()

Scrolling
(TextField)

» scrollTo()

 

Rounded shortcut methods are just like shortcut methods, but create an animation using rounded values only. This is useful when siliding movieclips that must always be featured on rounded x and y positions, like movieclips with pixel font content.

Tweening starting
(MovieClip, Sound, TextField)

» roundedTween()

Moving around
(MovieClip, TextField)

» roundedSlideTo()

» roundedXSlideTo()

» roundedYSlideTo()

» roundedBezierSlideTo()

 

Flash 8 filters shortcut methods are methods used to apply Flash 8 filters tweenings to an object.

Blur
(MovieClip, TextField)

» blurTo()

» xBlurTo()

» yBlurTo()

» xyBlurTo()

Glow
(MovieClip, TextField)

» glowTo()

» xGlowTo()

» yGlowTo()

» xyGlowTo()

Bevel
(MovieClip, TextField)

» bevelTo()

» xyBevelTo()

 

Auxiliary functions are functions that work by dealing helping the user find out whether a tweening is being executed or not on an object.

Tweenings
(MovieClip, Sound, TextField)

» getTweens()

» isTweening()

 

Auxiliary methods are methods that control existing tweenings - pausing or resuming them - or how an object deals with them - locking or unlocking an object from being tweened.

Tweening locking
(MovieClip, Sound, TextField)

» lockTween()

» unlockTween()

Tweening pausing/resuming
(MovieClip, Sound, TextField)

» pauseTween()

» resumeTween()

 

Finally, additional events are new event handlers that can be added to objects to respond to a tweening update (once a frame) or completion (when the tweening has ended). Much like MovieClip event handlers, these additional events are directly added to the objects, with no listening or broadcasting involved.

Tweening events
(MovieClip, Sound, TextField)

» onTweenUpdate

» onTweenComplete

 

MC Tween· Zeh Fernando, 2003-2006 · Proudly hosted at DreamHost · Disclaimer