Paquete | flash.filters |
Clase | public final class DropShadowFilter |
Herencia | DropShadowFilter BitmapFilter Object |
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
El uso de filtros depende del objeto al que se aplique el filtro:
- Para aplicar filtros a objetos de visualización, utilice la propiedad
filters
(heredada de DisplayObject). La propiedadfilters
de un objeto no lo modifica y se puede quitar el filtro borrando la propiedadfilters
. - Para aplicar filtros a objetos BitmapData, utilice el método
BitmapData.applyFilter()
. Cuando se llama aapplyFilter()
en un objeto BitmapData, se genera una imagen filtrada al procesar el objeto BitmapData de origen y el objeto de filtro.
Si aplica un filtro a un objeto de visualización, el valor de la propiedad cacheAsBitmap
del objeto de visualización se establece en true
. Si borra todos los filtros, se restaurará el valor original de cacheAsBitmap
.
Este filtro admite la aplicación de escala en el escenario. Sin embargo, no admite escalado general, rotación ni sesgo. Cuando se escala el propio objeto (si scaleX
y scaleY
se establece en un valor distinto de 1,0), no se escala el filtro. Sólo se escalará cuando el usuario acerque el escenario.
No se aplica ningún filtro si la imagen resultante excede las dimensiones máximas. En AIR 1.5 y en Flash Player 10, la anchura o altura máxima en píxeles es de 8,191, y el número total de píxeles no puede superar los 16,777,215. (De este modo, si una imagen tiene 8,191 píxeles de anchura, sólo podrá tener 2.048 píxeles de altura.) En Flash Player 9 y versiones anteriores y en AIR 1.1 y versiones anteriores, el límite es 2.880 píxeles de alto y 2.880 píxeles de ancho. Por ejemplo, si amplía un clip de película grande al que se le ha aplicado un filtro, éste se desactiva si la imagen resultante supera las dimensiones máximas.
Elementos de API relacionados
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
Propiedad | Definido por | ||
---|---|---|---|
alpha : Number
Valor de transparencia alfa del color de la sombra. | DropShadowFilter | ||
angle : Number
Ángulo de la sombra. | DropShadowFilter | ||
blurX : Number
Cantidad de desenfoque horizontal. | DropShadowFilter | ||
blurY : Number
Cantidad de desenfoque vertical. | DropShadowFilter | ||
color : uint
Color de la sombra. | DropShadowFilter | ||
constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | ||
distance : Number
Distancia de desplazamiento de la sombra, en píxeles. | DropShadowFilter | ||
hideObject : Boolean
Indica si el objeto está oculto. | DropShadowFilter | ||
inner : Boolean
Indica si la sombra es una sombra interior. | DropShadowFilter | ||
knockout : Boolean
Aplica un efecto de extractor (true), que hace que el relleno del objeto sea transparente y muestra el color de fondo del documento. | DropShadowFilter | ||
quality : int
Número de veces que debe aplicarse el filtro. | DropShadowFilter | ||
strength : Number
Intensidad de la impresión o extensión. | DropShadowFilter |
Método | Definido por | ||
---|---|---|---|
DropShadowFilter(distance:Number = 4.0, angle:Number = 45, color:uint = 0, alpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1.0, quality:int = 1, inner:Boolean = false, knockout:Boolean = false, hideObject:Boolean = false)
Crea una instancia DropShadowFilter nueva con los parámetros especificados. | DropShadowFilter | ||
[override]
Devuelve una copia de este objeto de filtro. | DropShadowFilter | ||
Indica si un objeto tiene definida una propiedad especificada. | Object | ||
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | ||
Indica si existe la propiedad especificada y si es enumerable. | Object | ||
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | ||
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | ||
Devuelve la representación de cadena del objeto especificado. | Object | ||
Devuelve el valor simple del objeto especificado. | Object |
alpha | propiedad |
alpha:Number
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
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.
Implementación
public function get alpha():Number
public function set alpha(value:Number):void
angle | propiedad |
angle:Number
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Ángulo de la sombra. Los valores válidos van de 0 a 360 grados (coma flotante). El valor predeterminado es 45.
Implementación
public function get angle():Number
public function set angle(value:Number):void
blurX | propiedad |
blurX:Number
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Cantidad de desenfoque horizontal. Los valores válidos van de 0 a 255,0 (coma flotante). El valor predeterminado es 4,0.
Implementación
public function get blurX():Number
public function set blurX(value:Number):void
blurY | propiedad |
blurY:Number
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Cantidad de desenfoque vertical. Los valores válidos van de 0 a 255,0 (coma flotante). El valor predeterminado es 4,0.
Implementación
public function get blurY():Number
public function set blurY(value:Number):void
color | propiedad |
color:uint
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Color de la sombra. Los valores válidos tienen formato hexadecimal 0xRRGGBB. El valor predeterminado es 0x000000.
Implementación
public function get color():uint
public function set color(value:uint):void
distance | propiedad |
distance:Number
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Distancia de desplazamiento de la sombra, en píxeles. El valor predeterminado es 4,0 (coma flotante).
Implementación
public function get distance():Number
public function set distance(value:Number):void
hideObject | propiedad |
hideObject:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
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).
Implementación
public function get hideObject():Boolean
public function set hideObject(value:Boolean):void
inner | propiedad |
inner:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
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).
Implementación
public function get inner():Boolean
public function set inner(value:Boolean):void
knockout | propiedad |
knockout:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
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).
Implementación
public function get knockout():Boolean
public function set knockout(value:Boolean):void
quality | propiedad |
quality:int
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
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
.
Implementación
public function get quality():int
public function set quality(value:int):void
Elementos de API relacionados
strength | propiedad |
strength:Number
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
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.
Implementación
public function get strength():Number
public function set strength(value:Number):void
DropShadowFilter | () | Información sobre |
public function DropShadowFilter(distance:Number = 4.0, angle:Number = 45, color:uint = 0, alpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1.0, quality:int = 1, inner:Boolean = false, knockout:Boolean = false, hideObject:Boolean = false)
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Crea una instancia DropShadowFilter nueva con los parámetros especificados.
Parámetrosdistance:Number (default = 4.0 ) — Distancia de desplazamiento de la sombra, en píxeles.
| |
angle:Number (default = 45 ) — Ángulo de la sombra, entre 0 y 360 grados (coma flotante).
| |
color:uint (default = 0 ) — Color de la sombra, expresado en formato hexadecimal 0xRRGGBB. El valor predeterminado es 0x000000.
| |
alpha:Number (default = 1.0 ) — 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%.
| |
blurX:Number (default = 4.0 ) — Cantidad de desenfoque horizontal. Los valores válidos van de 0 a 255,0 (coma flotante).
| |
blurY:Number (default = 4.0 ) — Cantidad de desenfoque vertical. Los valores válidos van de 0 a 255,0 (coma flotante).
| |
strength:Number (default = 1.0 ) — 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 van de 0 a 255,0.
| |
quality:int (default = 1 ) — Número de veces que debe aplicarse el filtro. Utilice las constantes BitmapFilterQuality:
Para más información sobre estos valores, consulte la descripción de la propiedad | |
inner:Boolean (default = false ) — Indica si la sombra es una sombra interior. Un valor true especifica una sombra interior. false especifica una sombra exterior (una sombra alrededor de los bordes exteriores del objeto).
| |
knockout:Boolean (default = false ) — Aplica un efecto de extractor (true ), que hace que el relleno del objeto sea transparente y muestra el color de fondo del documento.
| |
hideObject:Boolean (default = false ) — Indica si el objeto está oculto. Un valor true indica que no se dibuja el objeto propiamente dicho; sólo es visible la sombra.
|
Elementos de API relacionados
clone | () | método |
override public function clone():BitmapFilter
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Devuelve una copia de este objeto de filtro.
Valor devueltoBitmapFilter — Una instancia DropShadowFilter nueva con las mismas propiedades que la instancia DropShadowFilter original.
|
- Declare tres propiedades que se utilicen para dibujar el cuadrado al que se aplicará el filtro.
- 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 propiedadgraphics
de Sprite para dibujar un cuadrado naranja. - En el constructor, declare una variable
filter
como objeto BitmapFilter y asígnele el valor devuelto por una llamada agetBitmapFilter()
. El métodogetBitmapFilter()
define el filtro de sombra utilizado. - Cree un nuevo objeto Array
myFilters
y añada la propiedadfilter
al conjunto. Asigne el conjuntomyFilters
a la propiedadfilters
del objeto DropShadowFilterExample. Esto se aplicará a todos los filtros demyFilters
que, en este caso, sólo esfilter
.
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(); } } }
Tue Jun 12 2018, 02:12 PM Z