| Frames (Show Nav) | No Frames |
± Before installing the Fuse Extension
Remove all earlier versions of Fuse and lmc_tween in Extension Manager prior to opening the new extension file.
This is critical to avoid file conflicts and failing to do so might make it impossible to remove older versions at a later date. All legacy versions of Fuse and Fuse extensions are available via email request, so please don't hesitate to clean house by using the Remove button in extension manager, and deleting any additional Fuse class files from your system when finished.
After you have done this, simply double-click the file FuseKit2.1.mxp to install the extension, then restart Flash.
To use the new Custom Easing Tool, go to Window > Other panels > customEasingTool2 on Flash's main menu. To use code completion, open the lefthand sidebar in the Actions panel and find the Fuse2.1 book. Highlighting any item in that panel, or any valid Fuse Kit keyword in your code and hitting F1 will open the Help page for that specific item. Some screenshots of these features can be viewed at What's New in Fuse 2.1.
NOTE: A known problem with the extension is that FuseFMP tweening shortcuts like Blur_BlurXTo don't show code hints (all other methods do however). If you're a Flash extension expert and can help solve this problem, please email Moses from the Fuse site - Thank you!
± If upgrading Fuse within an existing program that used an older version
The following item represents a DEFAULT BEHAVIOR CHANGE for Fuse that affects all users.
Starting in version 2.1, Fuses now stop playing when interrupted.
Fuses are often interrupted during play, usually due to user interaction triggering overlapping tweens. In earlier versions, interrupted Fuses would attempt to keep playing by skipping forward to the next action. However, that behavior only made combining Fuse & interactivity more difficult.
A class and instance property were added to Fuse:
- Fuse class default:
Fuse.AUTOSTOP = true- Fuse instance
autoStoppropertyAuto-stopped Fuses dispatch the
"onStop"event. Then, if they are also set to auto-clear (either via the class defaultAUTOCLEARor the instance propertyautoClear), they also delete themselves.To clarify: If you want a Fuse to stop in the case that it is interrupted, you don't need to do anything — the class setting is now turned on by default. But if you want a Fuse to attempt to recover from interruptions by continuing its play (the old behavior), you now need to either change the class setting to false or set the Fuse instance's
autoStopproperty to false, which overrides the class default.In most cases — especially when starting a fresh project with Fuse 2.1 or higher — this new behavior should make things easier for you and you'll probably never need to change either of these settings.
If you upgrade Fuse in an existing project and this new behavior breaks your program, you should add the following line of code (one time, right after your setup command), which will revert Fuse to its previous interruption-handling behavior:
Fuse.AUTOSTOP = false;
To get started, first install the Extension (see important info at the top of this page first). Next, look for the example FLA's included in the download bundle. Those files will walk you through everything you need to know to use the Fuse Kit. You should also find the link to the gotoAndLearn Fuse Video Tutorial at the Fuse site.
± Still not sure you should upgrade? Here are some reasons.
- The Fuse Kit is the official update to lmc_tween. It adds Filter tweens, bezier curve tweens and lots more.
- It's easy! The ZigoEngine works the same way, only a few small details have changed.
- Zigo's work made coding accessible to all. This ethic has been 100% honored in Fuse Kit. Fuse also has simple options you can use with tweening shortcuts. Read Getting Started for the basics.
- Don't use lmc tween and Fuse Kit in the same project. That will cause problems.
- Setup is different. Instead of the old #include, you will use Fuse setup commands. If you install the Fuse Extension setup commands can be auto-written in the Actions panel sidebar.
- New rule: "one tween per target per property." In lmc tween, you could "overlap" multiple tweens on the same target and property using delays. Now if you want to run tweens sequentially you should use Fuse.
- The final two parameters in tween calls, extra1 & extra2, have been moved. These params are used for elastic and back easing equations. You can still add them within a Callback Object.
Fuse 2.0 was a major upgrade to the kit that was released in conjunction with the Fuse Forum, FuseList, and new branding. Because you're jumping from an older version up to 2.1, here's a list of highlights from the 2.0 overhaul. If upgrading Fuse within an existing program that used an older version, read that topic above.
± Major format changes to the Kit
- The architecture evolved into a set of optional classes that can be mixed & matched, or excluded to conserve filesize. This affects you most in that setup commands have changed.
- FuseFMP, a major addition, brought easy Bitmap Filter Tweening and management.
- Shortcuts were broken out as an optional feature, PennerEasing combined into one class, and FuseKitCommon class was added to centralize shared elements and error messages as well as aid in using Fuse Kit with any Logging class. Gone are limited-functionality packages like fuse_lite in favor of this new system.
- The entire Kit also went MTASC-strict and received javadoc-style comments even on private members.
- BitmapFilter & Bezier Curve tweening
- Fuse time-based advance trigger : The power to advance (and continue play) before the current action or group finishes.
- This awesome feature makes it possible to both stagger and overlap tweens on the front and tail ends, as flexibly as you can in the timeline.
- Time-based triggers can be set in seconds, Fuse Timecode format, or you can pass a negative number for seconds counted back from the end of the animation.
- New fadeIn and fadeOut shortcuts control _alpha + _visible at once. (Further updated in 2.1 to add a tweenable _fade property.)
- More flexible mixing of Shortcuts, Fuse Simple Syntax and Object Syntax for tweens like my_mc.tween( {start_x:'-100'} );
- New Fuse methods
- clone() to generate a copy of a Fuse
- pushTween() to add a Fuse tween using ZigoEngine.doTween parameters.
- fastForward() to skip through animations
- getInstances() lets you get an array of Fuses in memory with optional filters like play state and targets.
- removed concat()
- ZigoEngine class defaults added (some just renamed) in 2.0 included:
- AUTOSTOP (if true all tweens in the target are stopped whenever a new one is added)
ROUND_RESULTS (if true math is rounded - great for tweening pixelfonts)
DURATION (1 if not set externally) (default seconds if unspecified in a tween)
EASING ('easeOutQuint' if not set externally) (default easing if unspecified in a tween)
OUTPUT_LEVEL (0=no error traces, 1=normal, 2=extra output - also see Fuse.OUTPUT_LEVEL)
VERSION (returns a string stating version and other information)
SKIP_LEVEL: An advanced concept introduced in 2.0, providing fine-detail control over what happens when tweens either fail to affect a visual change or have no duration, and how callbacks are handled in these various situations. Also see: doTween > Callback Objects > skipLevel.- The final two params of all tween methods, extra1 & extra2, were moved into the callback object parameter, along with other special features like cycles, roundResults and skipLevel. cycles introduced - lets you 'yoyo' back and forth in a tween as many times as you wish.
- Multiple-target support (via Array) in the primary tween methods, meaning more than one target and more than one property can be tweened in one call.
- Callbacks sent with multiple targets/properties are blocked so they fire per tween-call block.
- Usage changed significantly for the methods removeTween, ffTween, rewTween, pauseTween, resumeTween
- To affect all tweens in the swf you must now pass the string 'ALL' (instead of null). Null or blank will abort.
- To affect any color-transform you may now pass the string 'ALLCOLOR' instead of a specific color key like _brightness
- All of these methods now accept multiple targets (array) and multiple properties (array or comma-delim string)
- rewTween got additional params to enable rewind-and-pause and the option to suppress refiring of start events/callbacks.
(Version 2.1 added a suppressEndEvents parameter to ffTween.)- Generic color-handling methods added to ZigoEngine: setColorByKey, getColorTransObj, getColorKeysObj
- Fuse custom events - fire any event automatically from the engine, using the parameters event: and optional eventparams:{ }
- Fuse time updates: Timecode String support (example: "01:50" = 1.5 seconds), new synonyms time/duration/seconds, delay/startAt
Please also read What's new in Fuse 2.1 ? which will bring you up to date.