La quantità di sfocatura orizzontale. I valori validi sono compresi tra 0 e 255 (virgola mobile). Il valore predefinito è 4. I valori che sono potenze di 2 (come 2, 4, 8, 16 e 32) vengono ottimizzati per eseguire il rendering più rapidamente di altri valori.

La quantità di sfocatura verticale. I valori validi sono compresi tra 0 e 255 (virgola mobile). Il valore predefinito è 4. I valori che sono potenze di 2 (come 2, 4, 8, 16 e 32) vengono ottimizzati per eseguire il rendering più rapidamente di altri valori.

Il numero di operazioni di sfocatura da eseguire. Il valore predefinito è BitmapFilterQuality.LOW, che equivale ad applicare il filtro una volta. Il valore BitmapFilterQuality.MEDIUM applica il filtro due volte; il valore BitmapFilterQuality.HIGH lo applica tre volte e si avvicina a una sfocatura gaussiana. Il rendering dei filtri con valori bassi avviene più rapidamente.

Per la maggior parte delle applicazioni è sufficiente un valore quality basso, medio o alto. Benché sia possibile utilizzare valori numerici aggiuntivi fino a 15 per aumentare il numero di applicazioni della sfocatura, il rendering dei valori elevati avviene più lentamente. Anziché aumentare il valore di quality, spesso è possibile ottenere un effetto simile (e con un rendering più veloce) semplicemente incrementando i valori delle proprietà blurX e blurY.

Per specificare i valori della proprietà quality è possibile utilizzare le seguenti costanti di BitmapFilterQuality:

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

Inizializza il filtro con i parametri specificati. I valori predefiniti creano un'immagine morbida e sfuocata.

Restituisce una copia di questo oggetto filtro.

1. Importare le classi richieste.
2. Dichiarare tre proprietà utilizzate nella funzione draw(), che disegna l'oggetto a cui viene applicato il filtro di sfocatura.
3. Creare la funzione di costruzione BlurFilterExample(), che esegue le seguenti operazioni:
   • Chiama la funzione draw(), che viene dichiarata successivamente.
   • Dichiara la variabile filter come oggetto BitmapFilter e la assegna al valore restituito di una chiamata a getBitmapFilter().
   • Crea un nuovo oggetto Array myFilters e aggiunge filter all'array, quindi assegna myFilters alla proprietà filters dell'oggetto BlurFilterExample. In questo modo vengono applicati tutti i filtri presenti in myFilters; in questo caso solo filter.
4. Creare la funzione getBitmapFilter() per creare e impostare le proprietà per il filtro.
5. Creare la funzione draw(). Questa funzione utilizza i metodi della classe Graphics, a cui si accede tramite la proprietà graphics della classe Sprite, per disegnare il quadrato.

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