Paqueteflash.filters
Clasepublic final class GlowFilter
HerenciaGlowFilter Inheritance BitmapFilter Inheritance Object

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

La clase GlowFilter le permite aplicar un efecto de iluminación a objetos de visualización. Cuenta con varias opciones para el estilo del iluminado, incluidos iluminado interior o exterior y modo de extractor. El filtro de iluminado es muy similar al filtro de sombreado con las propiedades 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:

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 genera, 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.

El filtro no se aplica si la imagen resultante supera los 2880 píxeles de anchura o altura. 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 2880 píxeles.

Ver los ejemplos

Véase también

flash.display.BitmapData.applyFilter()
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
flash.display.DisplayObject.scaleX
flash.display.DisplayObject.scaleY
flash.filters.DropShadowFilter.distance
flash.filters.DropShadowFilter.angle


Propiedades públicas
 PropiedadDefinido 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
 Inheritedconstructor : 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
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
  quality : int
Número de veces que debe aplicarse el filtro.
GlowFilter
  strength : Number
Intensidad de la impresión o extensión.
GlowFilter
Métodos públicos
 MétodoDefinido 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
  
Devuelve una copia de este objeto de filtro.
GlowFilter
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
 Inherited
Devuelve la representación de cadena del objeto especificado.
Object
 Inherited
Devuelve el valor simple del objeto especificado.
Object
Información sobre propiedades
alphapropiedad
alpha:Number  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: 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
blurXpropiedad 
blurX:Number  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: 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
blurYpropiedad 
blurY:Number  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: 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
colorpropiedad 
color:uint  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: 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
innerpropiedad 
inner:Boolean  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: 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
knockoutpropiedad 
knockout:Boolean  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: 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
qualitypropiedad 
quality:int  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: 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

Véase también

strengthpropiedad 
strength:Number  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: 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
Información sobre constructores
GlowFilter()constructor
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
Versión del reproductor: Flash Player 9

Inicializa una instancia GlowFilter nueva con los parámetros especificados.

Parámetros
color: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:
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

Para más información, consulte la descripción de la propiedad quality.

 
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.

Véase también

Información sobre métodos
clone()método
public override function clone():BitmapFilter

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Devuelve una copia de este objeto de filtro.

Valor devuelto
BitmapFilter — Instancia GlowFilter nueva con todas las propiedades de la instancia GlowFilter original.
Ejemplos Cómo utilizar los ejemplos
GlowFilterExample.as

En el ejemplo siguiente, se dibuja un cuadrado y se le aplica un filtro de desenfoque. El flujo de trabajo general de este ejemplo es el siguiente:
  1. Importe las clases necesarias.
  2. Declare tres propiedades utilizadas en el método draw, que usa métodos de la clase Graphics a los que accede mediante la propiedad graphics de Sprite para dibujar un cuadrado naranja.
  3. Cree la función constructora, que realiza lo siguiente:
    • Llama al método draw.
    • Crea un nuevo objeto BitmapFilter denominado filter y le asigna el valor devuelto de la llamada a getBitmapFilter(), que define el filtro.
    • Crea una nueva matriz denominada myFilters y le añade la propiedad filter.
    • Asigna myFilters a la propiedad filters del objeto BevelFilterExample. 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.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();
            var filter:BitmapFilter = getBitmapFilter();
            var myFilters:Array = new Array();
            myFilters.push(filter);
            filters = myFilters;
        }

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




 

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/flash/filters/GlowFilter.html