Valor de transparencia alfa del color de la sombra. Los valores válidos van de 0,0 a 1,0. Por ejemplo, 0,25 establece un valor de transparencia del 25%. El valor predeterminado es 1,0.

Ángulo de la sombra. Los valores válidos van de 0 a 360 grados (coma flotante). El valor predeterminado es 45.

Cantidad de desenfoque horizontal. Los valores válidos van de 0 a 255,0 (coma flotante). El valor predeterminado es 4,0.

Cantidad de desenfoque vertical. Los valores válidos van de 0 a 255,0 (coma flotante). El valor predeterminado es 4,0.

Color de la sombra. Los valores válidos tienen formato hexadecimal 0xRRGGBB. El valor predeterminado es 0x000000.

Distancia de desplazamiento de la sombra, en píxeles. El valor predeterminado es 4,0 (coma flotante).

Indica si el objeto está oculto. El valor true indica que no se dibuja el objeto propiamente dicho; sólo es visible la sombra. El valor predeterminado es false (se muestra el objeto).

Indica si la sombra es una sombra interior. El valor true indica una sombra interior. El valor predeterminado es false, una sombra exterior (una sombra alrededor de los bordes exteriores del objeto).

Aplica un efecto de extractor (true), que hace que el relleno del objeto sea transparente y muestra el color de fondo del documento. El valor predeterminado es false (sin extractor).

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

Para la mayoría de las aplicaciones, es suficiente un valor 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.

Véase también

Intensidad de la impresión o extensión. Cuanto más alto sea el valor, más color se imprimirá y mayor será el contraste entre la sombra y el fondo. Los valores válidos son de 0 a 255,0. El valor por defecto es 1,0.

Crea una instancia DropShadowFilter nueva con los parámetros especificados.

Véase también

Devuelve una copia de este objeto de filtro.

1. Declare tres propiedades que se utilicen para dibujar el cuadrado al que se aplicará el filtro.
2. Cree la función constructora. El constructor llama al método draw(), que utiliza métodos de la clase Graphics a los que accede mediante la propiedad graphics de Sprite para dibujar un cuadrado naranja.
3. En el constructor, declare una variable filter como objeto BitmapFilter y asígnele el valor devuelto por una llamada a getBitmapFilter(). El método getBitmapFilter() define el filtro de sombra utilizado.
4. Cree un nuevo objeto Array myFilters y añada la propiedad filter a la matriz. Asigne la matriz myFilters a la propiedad filters del objeto DropShadowFilterExample. Esto se aplicará a todos los filtros de myFilters que, en este caso, sólo es filter.

package {
    import flash.display.Sprite;
    import flash.events.Event;
    import flash.events.MouseEvent;
    import flash.filters.BitmapFilter;
    import flash.filters.BitmapFilterQuality;
    import flash.filters.DropShadowFilter;

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

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

        private function getBitmapFilter():BitmapFilter {
            var color:Number = 0x000000;
            var angle:Number = 45;
            var alpha:Number = 0.8;
            var blurX:Number = 8;
            var blurY:Number = 8;
            var distance:Number = 15;
            var strength:Number = 0.65;
            var inner:Boolean = false;
            var knockout:Boolean = false;
            var quality:Number = BitmapFilterQuality.HIGH;
            return new DropShadowFilter(distance,
                                        angle,
                                        color,
                                        alpha,
                                        blurX,
                                        blurY,
                                        strength,
                                        quality,
                                        inner,
                                        knockout);
        }

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