GradientBevelFilter  - AS3

Conjunto de valores de transparencia alfa para los colores correspondientes del conjunto colors. Los valores válidos para cada elemento del conjunto van de 0 a 1. Por ejemplo, 0,25 establece un valor de transparencia del 25%.

La propiedad alphas no puede cambiarse directamente mediante la modificación de estos valores. Debe obtener una referencia a alphas, realizar el cambio en la referencia y definir alphas como la referencia.

Las propiedades colors, alphas y ratios están relacionadas. El primer elemento del conjunto colors corresponde al primer elemento del conjunto alphas en el conjunto ratios y así sucesivamente.

Elementos de API relacionados

Ángulo, expresado en grados. Los valores válidos van de 0 a 360. El valor por defecto es 45.

El valor de angle representa el ángulo de la fuente de luz que en teoría cae sobre el objeto. El valor determina el ángulo en el que se aplican al objeto los colores de degradado: donde aparecen la luz y la sombra o donde aparece el primer color del conjunto. A continuación se aplican los colores en el orden en el que aparecen en el conjunto.

Elementos de API relacionados

Cantidad de desenfoque horizontal. Los valores válidos van de 0 a 255. Un desenfoque de 1 o menos indica que la imagen original se copiará tal cual. 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.

Cantidad de desenfoque vertical. Los valores válidos van de 0 a 255. Un desenfoque de 1 o menos indica que la imagen original se copiará tal cual. 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.

Conjunto de valores de colores hexadecimales RGB que se van a utilizar en el degradado. Por ejemplo, rojo es 0xFF0000, azul es 0x0000FF, y así sucesivamente.

La propiedad colors no puede cambiarse directamente mediante la modificación de estos valores. Debe obtener una referencia a colors, realizar el cambio en la referencia y definir colors como la referencia.

Las propiedades colors, alphas y ratios están relacionadas. El primer elemento del conjunto colors corresponde al primer elemento del conjunto alphas en el conjunto ratios y así sucesivamente.

Elementos de API relacionados

Distancia de desplazamiento. Los valores válidos van de 0 a 8. El valor predeterminado es 4,0.

Especifica si el objeto tiene un efecto extractor. El efecto extractor hace que el relleno del objeto sea transparente y el color de fondo del documento quede visible. El valor true especifica un efecto extractor; el valor predeterminado es false (sin efecto recorte).

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.

Elementos de API relacionados

Conjunto de proporciones de distribución de color para los colores correspondientes del conjunto colors. Los valores válidos para cada elemento del conjunto van de 0 a 255.

La propiedad ratios no puede cambiarse directamente mediante la modificación de estos valores. Debe obtener una referencia a ratios, realizar el cambio en la referencia y definir ratios como la referencia.

Las propiedades colors, alphas y ratios están relacionadas. El primer elemento del conjunto colors corresponde al primer elemento del conjunto alphas en el conjunto ratios y así sucesivamente.

Para entender cómo se distribuyen los colores en un bisel degradado, piense primero en los colores que desea incluir en el bisel. Un bisel sencillo tiene un color de resaltado y un color de sombra; un bisel degradado tiene un degradado de resaltado y un degradado de sombra. Suponga que el resaltado aparece en la esquina superior izquierda y la sombra en la esquina inferior derecha. Un filtro podría tener cuatro colores en el resaltado y cuatro en la sombra. Además del resaltado y la sombra, el filtro utiliza un color de relleno base que aparece donde se encuentran los bordes del resaltado y de la sombra. Por lo tanto, el número total de colores es nueve y el número correspondiente de elementos en el conjunto de proporciones es nueve.

En un degradado compuesto de franjas de varios colores combinados, el valor de proporción define la posición del color en el radio del degradado, donde 0 representa el punto en el límite exterior del degradado y 255 representa el punto más interior del degradado. En una situación típica, el valor intermedio es 128 y ése es el valor de relleno base. Para obtener el efecto de bisel que se muestra en la imagen, asigne los valores de proporciones siguientes, utilizando el ejemplo de nueve colores:

• Los primeros cuatro colores van del 0 al 127, de forma que cada valor es superior o igual que el anterior. Este es el borde biselado resaltado.
• El quinto color (el del centro) es el relleno de base, definido como 128. El valor de píxel 128 define el relleno de base, que aparece fuera de la forma (y alrededor de los bordes biselados) si el tipo es exterior; o dentro de la forma, cubriendo el relleno del propio objeto, si el tipo seleccionado es interior.
• Los últimos cuatro colores van del 129 al 255, de forma que cada valor es superior o igual que el anterior. Este es el borde biselado de sombra.

Si desea obtener una distribución uniforme de los colores en cada borde, utilice un número impar de colores, con el color central como relleno de base. Distribuya los valores entre 0 y 127, y 129 y 255 de forma uniforme entre sus colores, a continuación, ajuste el valor para cambiar la anchura de cada franja de color del degradado. Para obtener un bisel degradado de nueve colores, un conjunto posible sería [16, 32, 64, 96, 128, 160, 192, 224, 235]. La imagen siguiente representa el bisel degradado descrito:

Tenga en cuenta que la extensión de los colores del degradado varía en función de los valores de las propiedades blurX, blurY, strength y quality, así como de los valores de ratios.

Elementos de API relacionados

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. Un valor de 0 significa que el filtro no se aplica. El valor predeterminado es 1.

Elementos de API relacionados

Colocación del efecto de bisel. Los valores posibles son constantes BitmapFilterType:

• BitmapFilterType.OUTER: bisel en lado exterior del objeto
• BitmapFilterType.INNER: bisel en lado interior del objeto.
• BitmapFilterType.FULL: bisel en la parte superior del objeto.

Inicializa el filtro con los parámetros especificados.

Elementos de API relacionados

Devuelve una copia de este objeto de filtro.

1. Importe las clases necesarias.
2. Declare variables globales utilizadas para definir el cuadrado y el filtro.
3. Cree las funciones constructoras, que realizan lo siguiente:
   • 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 gris.
   • Crea un objeto BitmapFilter llamado filter y le asigna el valor devuelto de la llamada a getBitmapFilter(), que crea el filtro.
   • Crea una nueva matriz denominada myFilters y le añade la propiedad filter.
   • Asigna myFilters a la propiedad filters del objeto GradientBevelFilterExample. Esto se aplicará a todos los filtros de myFilters que, en este caso, sólo es filter.

package {
    import flash.display.Sprite;
    import flash.filters.BitmapFilter;
    import flash.filters.BitmapFilterQuality;
    import flash.filters.BitmapFilterType;
    import flash.filters.GradientBevelFilter;

    public class GradientBevelFilterExample extends Sprite {
        private var bgColor:uint     = 0xCCCCCC;
        private var size:uint        = 80;
        private var offset:uint      = 50;
        private var distance:Number  = 5;
        private var angleInDegrees:Number = 225; // opposite 45 degrees
        private var colors:Array     = [0xFFFFFF, 0xCCCCCC, 0x000000];
        private var alphas:Array     = [1, 0, 1];
        private var ratios:Array     = [0, 128, 255];
        private var blurX:Number     = 8;
        private var blurY:Number     = 8;
        private var strength:Number  = 2;
        private var quality:Number   = BitmapFilterQuality.HIGH
        private var type:String      = BitmapFilterType.INNER;
        private var knockout:Boolean = true;

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

        private function getBitmapFilter():BitmapFilter {
            return new GradientBevelFilter(distance,
                                           angleInDegrees,
                                           colors,
                                           alphas,
                                           ratios,
                                           blurX,
                                           blurY,
                                           strength,
                                           quality,
                                           type,
                                           knockout);
        }

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