GradientBevelFilter  - AS3

Matriz de valores de transparência alfa para as cores correspondentes na matriz colors. Os valores válidos para cada elemento na matriz são 0 a 1. Por exemplo, ,25 define um valor de transparência de 25%.

A propriedade alphas não pode ser alterada ao modificar diretamente seus valores. Em vez disso, é necessário obter uma referência para alphas, fazer a alteração conforme a referência e então definir alphas para a referência.

As propriedades colors, alphas e ratios são relatadas. O primeiro elemento na matriz colors corresponde ao primeiro elemento na matriz alphas e na matriz ratios e assim por diante.

Elementos da API relacionados

Ângulo, em graus. Os valores válidos são 0 a 360. O padrão é 45.

O valor do ângulo representa o ângulo da fonte de luz teórica que cai sobre o objeto. O valor determina o ângulo no qual as cores do gradiente são aplicadas ao objeto: onde o realce e a sombra aparecem ou onde a primeira cor na matriz aparece. As cores são então aplicadas na ordem em que aparecem na matriz.

Elementos da API relacionados

Intensidade de desfoque horizontal. Os valores válidos são 0 a 255. Um desfoque de 1 ou menos significa que a imagem original é copiada como está. O valor padrão é 4. Os valores que são uma potência de 2 (como 2, 4, 8, 16 e 32) são otimizados para renderizar mais rapidamente do que outros valores.

Intensidade do desfoque vertical. Os valores válidos são 0 a 255. Um desfoque de 1 ou menos significa que a imagem original é copiada como está. O valor padrão é 4. Os valores que são uma potência de 2 (como 2, 4, 8, 16 e 32) são otimizados para renderizar mais rapidamente do que outros valores.

Uma matriz de valores de cor hexadecimais RGB para uso no gradiente. Por exemplo, vermelho é 0xFF0000, azul é 0x0000FF e assim por diante.

A propriedade colors não pode ser alterada ao modificar diretamente seus valores. Em vez disso, é necessário obter uma referência para colors, fazer a alteração conforme a referência e então definir colors para a referência.

As propriedades colors, alphas e ratios são relatadas. O primeiro elemento na matriz colors corresponde ao primeiro elemento na matriz alphas e na matriz ratios e assim por diante.

Elementos da API relacionados

Distância de deslocamento. Os valores válidos são 0 a 8. O valor padrão é 4,0.

Especifica se o objeto tem um efeito de tachado. Um efeito de tachado torna o preenchimento do objeto transparente e revela a cor do plano de fundo do documento. O valor true especifica um efeito de tachado; o padrão é false (sem efeito de tachado).

Número de vezes para aplicar o filtro. O valor padrão é BitmapFilterQuality.LOW, que é equivalente a aplicar o filtro uma vez. O valor BitmapFilterQuality.MEDIUM aplica o filtro duas vezes; o valor BitmapFilterQuality.HIGH aplica três vezes. Os filtros com valores menores são renderizados mais rapidamente.

Para a maioria dos aplicativos, um valor de quality baixo, médio ou alto é suficiente. Embora você possa usar valores numéricos adicionais até 15 para obter efeitos diferentes, os valores maiores são renderizados mais lentamente. Em vez de aumentar o valor de quality, você pode normalmente obter um efeito similar, com uma renderização mais rápida, simplesmente aumentando os valores das propriedades blurX e blurY.

Elementos da API relacionados

Matriz de proporções de distribuição de cores para as cores correspondentes na matriz colors. Os valores válidos para cada elemento na matriz são 0 a 255.

A propriedade ratios não pode ser alterada ao modificar diretamente seus valores. Em vez disso, é necessário obter uma referência para ratios, fazer a alteração conforme a referência e então definir ratios para a referência.

As propriedades colors, alphas e ratios são relatadas. O primeiro elemento na matriz colors corresponde ao primeiro elemento na matriz alphas e na matriz ratios e assim por diante.

Para entender como as cores em um bisel de gradiente são distribuídas, pense primeiro nas cores que você deseja em seu bisel de gradiente. Considere que um simples bisel tem uma cor de realce e uma cor de sombra; um bisel de gradiente tem um gradiente de realce e um gradiente de sombra. Considere que o realce aparece no canto superior esquerdo e que a sombra aparece no canto inferior direito. Suponha que um possível uso do filtro possui quatro cores no realce e quatro na sombra. Além do realce e da sombra, o filtro usa uma cor de preenchimento base que aparece onde as bordas do realce e da sombra se encontram. Portanto, o número total de cores é nove e o número correspondente de elementos na matriz de proporções é nove.

Se você pensar em um gradiente como composto de listas de várias cores, mesclando-se entre si, cada valor de proporção define a posição da cor no raio do gradiente, onde 0 representa o ponto mais externo do gradiente e 255 representa o ponto mais interno do gradiente. Para um uso típico, o valor do meio é 128 e esse é o valor de preenchimento base. Para obter o efeito de bisel mostrado na imagem abaixo, atribua os valores da proporção do modo a seguir, usando o exemplo de nove cores:

• As primeiras quatro cores vão de 0 a 127, aumentando em valor para que cada valor seja maior do que ou igual ao anterior. Essa é a borda do bisel de realce.
• A quinta cor (a cor do meio) é o preenchimento base, definido para 128. O valor do pixel de 128 define o preenchimento base, que aparece fora da forma (e em volta das bordas do bisel), se o tipo for definido como externo; ou dentro da forma, efetivamente cobrindo o preenchimento do próprio objeto, se o tipo for definido como interno.
• As últimas quatro cores vão de 129 a 255, aumentando em valor para que cada valor seja maior do que ou igual ao anterior. Essa é a borda do bisel de sombra.

Se você quiser uma distribuição igual de cores para cada borda, use um número ímpar de cores, em que a cor do meio é o preenchimento base. Distribua os valores entre 0 a 127 e 129 a 255 igualmente entre as cores, depois ajuste o valor para alterar a largura de cada listra de cor no gradiente. Para um bisel de gradiente com nove cores, uma matriz possível é [16, 32, 64, 96, 128, 160, 192, 224, 235]. A imagem a seguir representa o bisel de gradiente, conforme descrito:

Lembre-se de que a dispersão das cores no gradiente varia com base nos valores das propriedades blurX, blurY, strength e quality, assim como os valores ratios.

Elementos da API relacionados

Intensidade da impressão ou dispersão. Quanto maior o valor, mais cores são impressas e mais forte será o contraste entre o bisel e o plano de fundo. Os valores válidos são 0 a 255. Um valor 0 significa que o filtro não é aplicado. O valor padrão é 1.

Elementos da API relacionados

Disposição do efeito de bisel. Os possíveis valores são as constantes BitmapFilterType:

• BitmapFilterType.OUTER — Bisel na borda externa do objeto
• BitmapFilterType.INNER — Bisel na borda interna do objeto
• BitmapFilterType.FULL — Bisel na parte superior do objeto

Inicializa o filtro com os parâmetros especificados.

Elementos da API relacionados

Retorna uma cópia deste objeto de filtro.

1. Importe as classes necessárias.
2. Declare as variáveis globais para definir o quadrado e o filtro.
3. Crie as funções de construtor, que fazem o seguinte:
   • Chama o método draw(), que usa os métodos da classe Graphics acessada por meio da propriedade graphics de Sprite para desenhar um quadrado cinza.
   • Cria um objeto BitmapFilter chamado filter e atribui a ele o valor de retorno de uma chamada para getBitmapFilter(), o que cria o filtro.
   • Cria uma nova matriz chamada myFilters e adiciona o filter a ela.
   • Atribui myFilters à propriedade filters do objeto GradientBevelFilterExample. Isso aplica todos os filtros encontrados em myFilters, o que, nesse caso, é somente 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();
        }
    }
}