Paquete | flash.filters |
Clase | public final class GlowFilter |
Herencia | GlowFilter ![]() ![]() |
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
distance
y angle
del filtro de la sombra definidas como cero. Puede aplicar el filtro a cualquier objeto de visualización (es decir, objetos que hereden de la clase DisplayObject), como objetos MovieClip, SimpleButton, TextField y Video, y también objetos BitmapData.
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, 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 el límite de píxeles.
Elementos de API relacionados
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
flash.display.DisplayObject.scaleX
flash.display.DisplayObject.scaleY
flash.filters.DropShadowFilter.distance
flash.filters.DropShadowFilter.angle
Propiedad | Definido por | ||
---|---|---|---|
alpha : Number
Valor de transparencia alfa del color. | GlowFilter | ||
blurX : Number
Cantidad de desenfoque horizontal. | GlowFilter | ||
blurY : Number
Cantidad de desenfoque vertical. | GlowFilter | ||
color : uint
Color del iluminado. | GlowFilter | ||
![]() | constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
inner : Boolean
Especifica si el iluminado es interior. | GlowFilter | ||
knockout : Boolean
Especifica si el objeto tiene un efecto extractor. | GlowFilter | ||
quality : int
Número de veces que debe aplicarse el filtro. | GlowFilter | ||
strength : Number
Intensidad de la impresión o extensión. | GlowFilter |
Método | Definido por | ||
---|---|---|---|
GlowFilter(color:uint = 0xFF0000, alpha:Number = 1.0, blurX:Number = 6.0, blurY:Number = 6.0, strength:Number = 2, quality:int = 1, inner:Boolean = false, knockout:Boolean = false)
Inicializa una instancia GlowFilter nueva con los parámetros especificados. | GlowFilter | ||
[override]
Devuelve una copia de este objeto de filtro. | GlowFilter | ||
![]() |
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. Los valores válidos van de 0 a 1. Por ejemplo, 0,25 establece un valor de transparencia del 25%. El valor predeterminado es 1.
Implementación
public function get alpha():Number
public function set alpha(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 (coma flotante). El valor predeterminado es 6. 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.
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 (coma flotante). El valor predeterminado es 6. 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.
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 del iluminado. Los valores válidos tienen formato hexadecimal 0xRRGGBB. El valor predeterminado es 0xFF0000.
Implementación
public function get color():uint
public function set color(value:uint):void
inner | propiedad |
inner:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Especifica si el iluminado es interior. El valor true
indica un iluminado interior. El valor predeterminado es false
, un iluminado exterior (un iluminado 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 |
Especifica si el objeto tiene un efecto extractor. Con el valor true
el relleno del objeto es transparente y el color de fondo del documento queda visible. El valor predeterminado es false
(sin efecto 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 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
.
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 el iluminado y el fondo. Los valores válidos van de 0 a 255. El valor por defecto es 2.
Implementación
public function get strength():Number
public function set strength(value:Number):void
GlowFilter | () | Información sobre |
public function GlowFilter(color:uint = 0xFF0000, alpha:Number = 1.0, blurX:Number = 6.0, blurY:Number = 6.0, strength:Number = 2, quality:int = 1, inner:Boolean = false, knockout:Boolean = false)
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Inicializa una instancia GlowFilter nueva con los parámetros especificados.
Parámetroscolor:uint (default = 0xFF0000 ) — Color del iluminado, expresado en formato hexadecimal 0xRRGGBB. El valor predeterminado es 0xFF0000.
| |
alpha:Number (default = 1.0 ) — Valor de transparencia alfa del color. Los valores válidos van de 0 a 1. Por ejemplo, 0,25 establece un valor de transparencia del 25%.
| |
blurX:Number (default = 6.0 ) — Cantidad de desenfoque horizontal. Los valores válidos van de 0 a 255 (coma flotante). 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.
| |
blurY:Number (default = 6.0 ) — Cantidad de desenfoque vertical. Los valores válidos van de 0 a 255 (coma flotante). 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.
| |
strength:Number (default = 2 ) — 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 el iluminado y el fondo. Los valores válidos van de 0 a 255.
| |
quality:int (default = 1 ) — Número de veces que debe aplicarse el filtro. Utilice las constantes BitmapFilterQuality:
Para más información, consulte la descripción de la propiedad | |
inner:Boolean (default = false ) — Especifica si el iluminado es interior. El valor true indica un iluminado interior. El valor false especifica un iluminado exterior (un iluminado alrededor de los bordes exteriores del objeto).
| |
knockout:Boolean (default = false ) — Especifica si el objeto tiene un efecto extractor. Con el valor true el relleno del objeto es transparente y el color de fondo del documento queda visible.
|
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 — Instancia GlowFilter nueva con todas las propiedades de la instancia GlowFilter original.
|
- Importe las clases necesarias.
- Declare tres propiedades utilizadas en el método
draw
, que usa métodos de la clase Graphics a los que accede mediante la propiedadgraphics
de Sprite para dibujar un cuadrado naranja. - Cree la función constructora, que realiza lo siguiente:
- Llama a la función
draw
para crear un rectángulo. - Crea un objeto BitmapFilter
glowFilter
y le asigna el valores devueltos por la funciónmétodo getBitmapFilter()
. - Asigna el conjunto de valores del objeto
glowFilter
a la propiedadfilters
del objeto de visualización raíz. En este caso, todos elementos secundarios de objetos de visualización del objeto de visualización raíz heredan las propiedades de un filtro de resplandor. Por lo tanto, el rectángulo creado en la funcióndraw()
muestra las propiedades de filtro de resplandor.
- Llama a la función
package { import flash.display.Sprite; import flash.events.Event; import flash.events.MouseEvent; import flash.filters.BitmapFilter; import flash.filters.BitmapFilterQuality; import flash.filters.GlowFilter; public class GlowFilterExample extends Sprite { private var bgColor:uint = 0xFFCC00; private var size:uint = 80; private var offset:uint = 50; public function GlowFilterExample() { //draw the rectangle using the draw() function below draw(); //assign the values from getBitmapFilter function below //to a BitmapFilter object "glowFilter" var glowFilter:BitmapFilter = getBitmapFilter(); //populate the filters property of the root display object with the array of values //from the glowFilter object. filters = [ glowFilter ]; } private function getBitmapFilter():BitmapFilter { var color:Number = 0x33CCFF; var alpha:Number = 0.8; var blurX:Number = 35; var blurY:Number = 35; var strength:Number = 2; var inner:Boolean = false; var knockout:Boolean = false; var quality:Number = BitmapFilterQuality.HIGH; return new GlowFilter(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