     
     /**
      *  IBitmapFilter instance to apply and animate.
+     *
+     *  <p>The filters that you can use with this effect are defined in the spark.filters. package. 
+     *  Common filters include the DropShadowFilter, GlowFilter, BlurFilter, and ShaderFilter.</p>
      *  
      *  @langversion 3.0
      *  @playerversion Flash 10

use namespace mx_internal;

/**
 * This effect applies an IBitmapFilter instance and allows you to animate
 * an arbitrary set of properties of the filter between values, as specified
 * by the motionPaths. 
 * 
 * Example usage is as follows:
 * @example AnimateFilter example:
 * <listing version="3.0">
 * &lt;?xml version="1.0" encoding="utf-8"?&gt;
 * &lt;Application xmlns="http://ns.adobe.com/mxml/2009" &gt;
 * 
 * &lt;Script&gt;
 * &lt;![CDATA[
 * 
 * import mx.effects.*;
 * import spark.filters.DropShadowFilter;
 * 
 * // Use AnimateFilter to animate the color, distance, and angle
 * // of a DropShadowFilter.
 * 
 * private function doDropShadowFilterSample():void{
 *     var df:DropShadowFilter = new DropShadowFilter();
 *     var anim:AnimateFilter = new AnimateFilter(btn1, df);
 *     
 *     anim.motionPaths = [
 *         new SimpleMotionPath("color", 0, 0x0000FF),
 *         new SimpleMotionPath("distance", 0, 10),		
 *         new SimpleMotionPath("angle", 270, 360)
 *     ];
 * 
 *     anim.repeatCount = 0;
 *     anim.duration = 500;
 *     anim.repeatBehavior = Animation.REVERSE;
 *     anim.play();
 * }
 * 
 * ]]&gt;
 * &lt;/Script&gt;
 * 
 * &lt;Button id="btn1" x="50" y="50" label="Animate a DropShadowFilter" click="doDropShadowFilterSample()" /&gt;
 * 
 * &lt;/Application&gt;
 * </listing>
 *  
 *  @langversion 3.0
 *  @playerversion Flash 10
 *  @playerversion AIR 1.5


    /**
     *  Constructor. 
     *
     *  @param target The Object to animate with this effect.  
     *  
     *  @langversion 3.0
     *  @playerversion Flash 10
