.blurTo()
Applies To
MovieClip, TextField
Availability
Flash 8 and above, using AS1 or AS2.
Usage
<MovieClip|TextField>.blurTo(BlurFilter [, seconds, animation type, delay, callback, extra1, extra2]); or <MovieClip|TextField>.blurTo(blurRadius [, quality, seconds, animation type, delay, callback, extra1, extra2]);
Parameters
BlurFilter : A flash.filters.BlurFilter object that will be applied to this object's filters array.
blurRadius : A numeric value indicating the radius of the desired blur. The bigger this value, the more blurred the object will look. This is equivalent to this filter's blurX and blurY properties.
quality : A numeric value indicating the quality of this blur, usually from 1 ("Low") to 3 ("High"). It's, roughly, the number of times this filter is applied - the higher the number, the better the quality, but also the higher the time it takes to be applied. If ommited, this value defaults to 2. This value is not tweenable. This is equivalent to this filter's quality property.
All other parameters are standard tween() related. Refer to the .tween() command for reference.
Returns
Nothing.
Description
Shortcut method; applies a Blur filter to an existing object, tweening its properties.
If the object doesn't have any filter of this type applied, it creates a new filter with default values and then tweens to the new one. If the object already has a filter of this type applied, it will tween the existing filter's properties to match the new one. If the object has two different filters of this same type applied, it will tween the first one.
Some values are not tweenable and will be rewritten on the new filter if they differ from the original value.
Examples
// Creates a filter template and applies it, tweening in 2 seconds with a liner transformation var myBlurry = new flash.filters.BlurFilter(0, 0, 4); <MovieClip>.blurTo(myBlurry, 2, "linear");
// Adds a blur to a textfield, using 20 pixels of blur, using "medium" quality, and in 1 second <TextField>.blurTo(20, 2, 1);
See Also
xyBlurTo(), xBlurTo(), yBlurTo(), flash.filters.BlurFilter
|