Paqueteflash.filters
Clasepublic final class BevelFilter
HerenciaBevelFilter Inheritance BitmapFilter Inheritance Object

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

La clase BevelFilter le permite aplicar un efecto de bisel a objetos de visualización. El efecto de biselado da aspecto tridimensional a objetos como los botones. Puede personalizar el aspecto del biselado con distintos colores de resaltado y sombreado, la cantidad de desenfoque del biselado, el ángulo del biselado, la ubicación del biselado y un efecto de extractor. 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.

Para crear un nuevo filtro, utilice el constructor new BevelFilter(). El uso de filtros depende del objeto al que se aplique el filtro:

Si aplica un filtro a un objeto de visualización, el valor de la propiedad cacheAsBitmap del objeto se establece en true. Si quita 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 las propiedades scaleX y scaleY no se establecen en 100%), 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 acerca un clip de película con un filtro aplicado, éste se desactiva si la imagen resultante supera el límite de 2880 píxeles.

Ver los ejemplos

Véase también

flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
flash.display.BitmapData.applyFilter()


Propiedades públicas
 PropiedadDefinido por
  angle : Number
Ángulo del bisel.
BevelFilter
  blurX : Number
Cantidad de desenfoque horizontal, expresada en píxeles.
BevelFilter
  blurY : Number
Cantidad de desenfoque vertical, expresada en píxeles.
BevelFilter
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
  distance : Number
Distancia de desplazamiento del bisel.
BevelFilter
  highlightAlpha : Number
Valor de transparencia alfa del color de resaltado.
BevelFilter
  highlightColor : uint
Color de resaltado del bisel.
BevelFilter
  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.
BevelFilter
 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.
BevelFilter
  shadowAlpha : Number
Valor de transparencia alfa del color de la sombra.
BevelFilter
  shadowColor : uint
Color de sombra del bisel.
BevelFilter
  strength : Number
Intensidad de la impresión o extensión.
BevelFilter
  type : String
Colocación del bisel en el objeto.
BevelFilter
Métodos públicos
 MétodoDefinido por
  
BevelFilter(distance:Number = 4.0, angle:Number = 45, highlightColor:uint = 0xFFFFFF, highlightAlpha:Number = 1.0, shadowColor:uint = 0x000000, shadowAlpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "inner", knockout:Boolean = false)
Inicializa una instancia BevelFilter nueva con los parámetros especificados.
BevelFilter
  
Devuelve una copia de este objeto de filtro.
BevelFilter
 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
anglepropiedad
angle:Number  [read-write]

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

Ángulo del bisel. Los valores válidos son de 0 a 360°. El valor predeterminado es 45°.

El valor de angle representa el ángulo de la fuente de luz teórica que ilumina el objeto y determina la posición del efecto con respecto al objeto Si la propiedad distance se define como 0, el efecto no se desplaza del objeto y el resultado es que la propiedad angle no se aplica.


Implementación
    public function get angle():Number
    public function set angle(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, expresada en píxeles. Los valores válidos son de 0 a 255 (coma flotante). El valor predeterminado es 4. 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, expresada en píxeles. Los valores válidos son de 0 a 255 (coma flotante). El valor predeterminado es 4. 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
distancepropiedad 
distance:Number  [read-write]

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

Distancia de desplazamiento del bisel. Los valores válidos son en píxeles (coma flotante). El valor por defecto es 4.


Implementación
    public function get distance():Number
    public function set distance(value:Number):void
highlightAlphapropiedad 
highlightAlpha:Number  [read-write]

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

Valor de transparencia alfa del color de resaltado. El valor se especifica como un valor normalizado 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 highlightAlpha():Number
    public function set highlightAlpha(value:Number):void
highlightColorpropiedad 
highlightColor:uint  [read-write]

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

Color de resaltado del bisel. Los valores válidos tienen formato hexadecimal, 0xRRGGBB. El valor predeterminado es 0xFFFFFF.


Implementación
    public function get highlightColor():uint
    public function set highlightColor(value:uint):void
knockoutpropiedad 
knockout:Boolean  [read-write]

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

Puede utilizar las siguientes constantes BitmapFilterQuality para especificar los valores de la propiedad quality:


Implementación
    public function get quality():int
    public function set quality(value:int):void
shadowAlphapropiedad 
shadowAlpha:Number  [read-write]

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

Valor de transparencia alfa del color de la sombra. Este valor se especifica como un valor normalizado de 0 a 1. Por ejemplo, 0,25 establece un valor de transparencia del 25%. El valor por defecto es 1.


Implementación
    public function get shadowAlpha():Number
    public function set shadowAlpha(value:Number):void
shadowColorpropiedad 
shadowColor:uint  [read-write]

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

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


Implementación
    public function get shadowColor():uint
    public function set shadowColor(value:uint):void
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. Los valores válidos son de 0 a 255. Cuanto más alto sea el valor, más color se imprimirá y mayor será el contraste entre el bisel y el fondo. El valor predeterminado es 1.


Implementación
    public function get strength():Number
    public function set strength(value:Number):void
typepropiedad 
type:String  [read-write]

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

Colocación del bisel en el objeto. Los biseles interior y exterior se colocan en los bordes interior y exterior; el bisel completo se coloca en todo el objeto. Los valores válidos son las constantes BitmapFilterType:


Implementación
    public function get type():String
    public function set type(value:String):void

Emite
TypeError — La cadena es null cuando se define
Información sobre constructores
BevelFilter()constructor
public function BevelFilter(distance:Number = 4.0, angle:Number = 45, highlightColor:uint = 0xFFFFFF, highlightAlpha:Number = 1.0, shadowColor:uint = 0x000000, shadowAlpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "inner", knockout:Boolean = false)

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

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

Parámetros
distance:Number (default = 4.0) — Distancia de desplazamiento del bisel, en píxeles (coma flotante).
 
angle:Number (default = 45) — Ángulo del bisel, de 0 a 360 grados.
 
highlightColor:uint (default = 0xFFFFFF) — Color de resaltado del bisel, 0xRRGGBB.
 
highlightAlpha:Number (default = 1.0) — Valor de transparencia alfa del color de resaltado. Los valores válidos van de 0,0 a 1,0. Por ejemplo, 0,25 establece un valor de transparencia del 25%.
 
shadowColor:uint (default = 0x000000) — Color de sombra del bisel, 0xRRGGBB.
 
shadowAlpha: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, expresada en píxeles. Los valores válidos van de 0 a 255,0 (coma flotante).
 
blurY:Number (default = 4.0) — Cantidad de desenfoque vertical, expresada en píxeles. Los valores válidos van de 0 a 255,0 (coma flotante).
 
strength:Number (default = 1) — 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 bisel y el fondo. Los valores válidos van de 0 a 255,0.
 
quality:int (default = 1) — La calidad del bisel. Los valores válidos oscilan entre 0 y 15, pero para la mayor parte de las aplicaciones puede utilizar constantes BitmapFilterQuality:
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

Los filtros con valores más pequeños se representan más rápidamente. Puede utilizar otros valores numéricos disponibles para lograr distintos efectos.

 
type:String (default = "inner") — Tipo de bisel. Los valores válidos son constantes BitmapFilterType: BitmapFilterType.INNER, BitmapFilterType.OUTER o BitmapFilterType.FULL.
 
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.

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 BevelFilter nueva con las mismas propiedades que la instancia BevelFilter original.
Ejemplos Cómo utilizar los ejemplos
BevelFilterExample.as

En el ejemplo siguiente, se crea un cuadrado de color amarillo oscuro y se le aplica un bisel con resaltado amarillo brillante (0xFFFF00) y una sombra azul (0x0000FF). El flujo de trabajo general de este ejemplo es el siguiente:
  1. Importe las clases necesarias.
  2. Declare tres propiedades utilizadas en la función draw(), que dibuja el objeto al que se aplicará el bisel.
  3. Cree la función constructora BevelFilterExample(), que realiza lo siguiente:
    • Llama a la función draw() que se declara más adelante.
    • Declara una variable filter como objeto BitmapFilter y lo asigna al valor devuelto de una llamada a getBitmapFilter().
    • Crea un nuevo objeto Array myFilters y añade la propiedad filter a la matriz. Después 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.
  4. Cree la función getBitmapFilter para crear y definir las propiedades del filtro.
  5. Cree la función draw(). Esta función utiliza métodos de la clase Graphics, a la que se accede mediante la propiedad graphics de la clase Sprite, para dibujar el cuadrado.
package {
    import flash.display.Sprite;
    import flash.filters.BevelFilter;
    import flash.filters.BitmapFilter;
    import flash.filters.BitmapFilterQuality;
    import flash.filters.BitmapFilterType;

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

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

        private function getBitmapFilter():BitmapFilter {
            var distance:Number       = 5;
            var angleInDegrees:Number = 45;
            var highlightColor:Number = 0xFFFF00;
            var highlightAlpha:Number = 0.8;
            var shadowColor:Number    = 0x0000FF;
            var shadowAlpha:Number    = 0.8;
            var blurX:Number          = 5;
            var blurY:Number          = 5;
            var strength:Number       = 5;
            var quality:Number        = BitmapFilterQuality.HIGH;
            var type:String           = BitmapFilterType.INNER;
            var knockout:Boolean      = false;

            return new BevelFilter(distance,
                                   angleInDegrees,
                                   highlightColor,
                                   highlightAlpha,
                                   shadowColor,
                                   shadowAlpha,
                                   blurX,
                                   blurY,
                                   strength,
                                   quality,
                                   type,
                                   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/BevelFilter.html