Cantidad de desenfoque horizontal. Los valores válidos son de 0 a 255 (coma flotante). El valor predeterminado es 4. Los valores que son potencia de 2 (como 2, 4, 8, 16 y 32) se optimizan para representarse más rápidamente que otros valores.

Cantidad de desenfoque vertical. Los valores válidos son de 0 a 255 (coma flotante). El valor predeterminado es 4. Los valores que son potencia de 2 (como 2, 4, 8, 16 y 32) se optimizan para representarse más rápidamente que otros valores.

Número de veces que debe realizarse el desenfoque. El valor predeterminado es BitmapFilterQuality.LOW, lo que equivale a aplicar el filtro una vez. El valor BitmapFilterQuality.MEDIUM aplica el filtro dos veces; el valor BitmapFilterQuality.HIGH lo aplica tres veces y se aproxima a un desenfoque gaussiano. Los filtros con valores más bajos se representan con mayor rapidez.

Para la mayoría de las aplicaciones, es suficiente un valor quality de calidad baja, media o alta. Aunque puede utilizar valores numéricos hasta 15 para conseguir efectos distintos, los valores más altos se representan más lentamente. En lugar de aumentar el valor de quality, se suele conseguir un efecto similar, con una representación más rápida, simplemente aumentando los valores de las propiedades blurX y blurY.

Puede utilizar las siguientes constantes BitmapFilterQuality para especificar los valores de la propiedad quality:

• BitmapFilterQuality.LOW
• BitmapFilterQuality.MEDIUM
• BitmapFilterQuality.HIGH

Inicializa el filtro con los parámetros especificados. Los valores predeterminados crean una imagen suave y desenfocada.

Devuelve una copia de este objeto de filtro.

1. Importe las clases necesarias.
2. Declare tres propiedades utilizadas en la función draw(), que dibuja el objeto al que se aplicará el filtro de desenfoque.
3. Cree la función constructora BlurFilterExample(), que realiza lo siguiente:
   • Llama a la función draw(), que se declara más adelante.
   • Declara una variable filter como un objeto BitmapFilter y lo asigna al valor devuelto de una llamada a getBitmapFilter().
   • Crea un nuevo objeto Array myFilters y añade la propiedad filter a la matriz. Después asigna myFilters a la propiedad filters del objeto BlurFilterExample. Esto se aplicará a todos los filtros de myFilters que, en este caso, sólo es filter.
4. Cree la función getBitmapFilter() para crear y definir las propiedades del filtro.
5. Cree la función draw(). Esta función utiliza métodos de la clase Graphics, a la que se accede mediante la propiedad graphics de la clase Sprite, para dibujar el cuadrado.

package {
    import flash.display.Sprite;
    import flash.filters.BitmapFilter;
    import flash.filters.BitmapFilterQuality;
    import flash.filters.BlurFilter;

    public class BlurFilterExample extends Sprite {
        private var bgColor:uint = 0xFFCC00;
        private var size:uint    = 80;
        private var offset:uint  = 50;

        public function BlurFilterExample() {
            draw();
            var filter:BitmapFilter = getBitmapFilter();
            var myFilters:Array = new Array();
            myFilters.push(filter);
            filters = myFilters;
        }

        private function getBitmapFilter():BitmapFilter {
            var blurX:Number = 30;
            var blurY:Number = 30;
            return new BlurFilter(blurX, blurY, BitmapFilterQuality.HIGH);
        }

        private function draw():void {
            graphics.beginFill(bgColor);
            graphics.drawRect(offset, offset, size, size);
            graphics.endFill();
        }
    }
}