GradientBevelFilter  - AS3

Tablica wartości przezroczystości alpha, które odpowiadają kolorom z tablicy colors. Poprawne wartości dla każdego elementu tablicy należą do zakresu od 0 do 1. Przykład: 0,25 powoduje ustawienie przezroczystości równej 25%.

Właściwość alphas nie może być zmieniana poprzez bezpośrednie modyfikowanie jej wartości. Zamiast tego należy uzyskać odwołanie do właściwości alphas, zmienić odwołanie, a następnie ustawić właściwość alphas na wartość odwołania.

Właściwości colors, alphas i ratios są ze sobą powiązane. Pierwszy element tablicy colors odpowiada pierwszemu elementowi w tablicy alphas oraz w tablicy ratios, itd.

Powiązane elementy interfejsu API

Kąt w stopniach. Poprawne wartości należą do zakresu od 0 do 360. Wartością domyślną jest 45.

Wartość kąta reprezentuje kąt padania światła z teoretycznego źródła światła oświetlającego obiekt. Wartość określa kąt, pod jakim kolory gradientowe są nakładane na obiekt: miejsca pojawiania się podświetlenia i cienia oraz miejsce, w którym występuje pierwszy kolor w tablicy. Następnie kolory są stosowane w kolejności, w jakiej pojawiają się w tablicy.

Powiązane elementy interfejsu API

Intensywność rozmycia w poziomie. Poprawne wartości należą do zakresu od 0 do 255. Rozmycie równe 1 oznacza, że obraz oryginalny jest kopiowany w stanie oryginalnym. Wartością domyślną jest 4. Wartości, które są potęgami 2 (na przykład liczby 2, 4, 8, 16 i 32), są zoptymalizowane i są renderowane szybciej niż inne wartości.

Intensywność rozmycia w pionie. Poprawne wartości należą do zakresu od 0 do 255. Rozmycie równe 1 oznacza, że obraz oryginalny jest kopiowany w stanie oryginalnym. Wartością domyślną jest 4. Wartości, które są potęgami 2 (na przykład liczby 2, 4, 8, 16 i 32), są zoptymalizowane i są renderowane szybciej niż inne wartości.

Tablica szesnastkowych wartości kolorów RGB, które będą używane w gradiencie. Na przykład: czerwony ma wartość 0xFF0000, niebieski 0x0000FF itd.

Właściwość colors nie może być zmieniana poprzez bezpośrednie modyfikowanie jej wartości. Zamiast tego należy uzyskać odwołanie do właściwości colors, zmienić odwołanie, a następnie ustawić właściwość colors na wartość odwołania.

Właściwości colors, alphas i ratios są ze sobą powiązane. Pierwszy element tablicy colors odpowiada pierwszemu elementowi w tablicy alphas oraz w tablicy ratios, itd.

Powiązane elementy interfejsu API

Odległość przesunięcia. Poprawne wartości należą do zakresu od 0 do 8. Wartością domyślną jest 4.0.

Określa, czy z tym obiektem skojarzono ramkę odcięcia. Efekt odcięcia sprawia, że wypełnienie obiektu jest przezroczyste i ujawnia kolor tła dokumentu. Wartość true określa efekt odcięcia; wartością domyślną jest false (brak efektu odcięcia).

Liczba operacji zastosowania filtra. Wartością domyślną jest BitmapFilterQuality.LOW, która jest równoważna jednorazowemu zastosowaniu filtra. Wartość BitmapFilterQuality.MEDIUM powoduje dwukrotne zastosowanie filtra; wartość BitmapFilterQuality.HIGH powoduje trzykrotne zastosowanie filtra. Filtry o niższych wartościach są renderowane szybciej.

W większości zastosowań wystarczające są następujące wartości quality: low, medium i high. Mimo że w celu osiągnięcia różnych efektów można stosować dodatkowe wartości liczbowe (aż do 15), wyższe wartości są renderowane wolniej. Zamiast zwiększać wartość quality — w celu uzyskania podobnego efektu przy krótszym czasie renderowania — można po prostu zwiększać wartości właściwości blurX i blurY.

Powiązane elementy interfejsu API

Tablica współczynników rozkładu kolorów, które odpowiadają kolorom z tablicy colors. Poprawne wartości dla każdego elementu tablicy należą do zakresu od 0 do 255.

Właściwość ratios nie może być zmieniana poprzez bezpośrednie modyfikowanie jej wartości. Zamiast tego należy uzyskać odwołanie do właściwości ratios, zmienić odwołanie, a następnie ustawić właściwość ratios na wartość odwołania.

Właściwości colors, alphas i ratios są ze sobą powiązane. Pierwszy element tablicy colors odpowiada pierwszemu elementowi w tablicy alphas oraz w tablicy ratios, itd.

Aby zrozumieć sposób, w jaki dystrybuowane są kolory w fazie gradientowej, najpierw należy wziąć pod uwagę kolory, które mają znaleźć się w fazie gradientowej. Należy zauważyć, że faza prosta obejmuje kolor podświetlenia i kolor cienia; faza gradientowa ma gradient podświetlenia i gradient cienia. Załóżmy, że podświetlenie pojawia się w lewym górnym narożniku, a cień w prawym dolnym narożniku. Załóżmy, że w jednym z możliwych zastosowań filtra dostępne są cztery kolory w podświetleniu oraz cztery kolory w cieniu. Ponadto, oprócz podświetlenia i cienia, filtr korzysta z podstawowego koloru wypełnienia, który pojawi się w miejscach zetknięcia krawędzie podświetlenia i cienia. Dlatego suma kolorów wynosi dziewięć, a liczba odpowiadających elementów w tablicy ratios wynosi również dziewięć.

Jeśli gradient zostanie potraktowany jako złożenie pasków różnych kolorów, które się ze sobą mieszają, wówczas każda wartość współczynnika ustawia położenie koloru na promieniu gradientu. Wartość 0 odpowiada najbardziej zewnętrznemu punktowi gradientu, a wartość 255 odpowiada najbardziej wewnętrznemu punktowi gradientu. W typowych zastosowaniach wartość środkowa jest równa 128 o jest to również podstawowa wartość wypełnienia. Aby uzyskać efekt fazy przedstawiony na poniższym obrazie, należy przypisać wartości współczynników w następujący sposób, korzystając z przykładu dziewięciu kolorów:

• Wartości pierwszych czterech kolorów należą do zakresu 0-127 i wzrastają w taki sposób, że każda kolejna wartość jest większa od poprzedniej lub równa poprzedniej. Jest to krawędź z fazą podświetlenia.
• Piąty kolor (kolor środkowy) jest wypełnieniem podstawowym, równym 128. Wartość piksela równa 128 ustawia wypełnienie podstawowe, które pojawia się na zewnątrz kształtu (i wokół krawędzi z fazą), pod warunkiem że ustawiono typ zewnętrzny; lub wewnątrz kształtu i powoduje zakrycie wypełnienia obiektu, pod warunkiem że ustawiono typ wewnętrzny.
• Wartości ostatnich czterech kolorów należą do zakresu 129-255 i wzrastają w taki sposób, że każda kolejna wartość jest większa od poprzedniej lub równa poprzedniej. Jest to krawędź z fazą cienia.

Jeśli wymagany jest równy rozkład kolorów dla każdej krawędzi, należy stosować nieparzyste liczby kolorów, a kolor środkowy powinien być wypełnieniem podstawowym. Kolory należy równomiernie rozłożyć między wartościami z zakresów 0-127 i 129-255, a następnie dostosować wartość w celu zmiany szerokości każdego paska koloru w gradiencie. W przypadku fazy gradientowej z dziewięcioma kolorami możliwa jest tablica [16, 32, 64, 96, 128, 160, 192, 224, 235]. Poniższy przykład przedstawia opisywaną fazę gradientową:

Należy pamiętać, że zakres kolorów w gradiencie jest uzależniony od wartości właściwości blurX, blurY, strength i quality, a także wartości ratios.

Powiązane elementy interfejsu API

Siła odciskania lub zalewkowania. Im wyższa jest wartość, tym więcej koloru zostaje odciśnięte, co powoduje również wzmocnienie kontrastu między fazą i tłem. Poprawne wartości należą do zakresu od 0 do 255. Wartość 0 oznacza, że filtr nie jest stosowany. Wartością domyślną jest 1.

Powiązane elementy interfejsu API

Położenie efektu fazy. Możliwe wartości są stałymi BitmapFilterType:

• BitmapFilterType.OUTER — faza na zewnętrznej krawędzi obiektu
• BitmapFilterType.INNER — faza na wewnętrznej krawędzi obiektu
• BitmapFilterType.FULL — faza na górnej stronie obiektu

Inicjuje filtr z zadanymi parametrami.

Powiązane elementy interfejsu API

Zwraca kopię tego obiektu typu Filter.

1. Zaimportuj wymagane klasy.
2. Zadeklaruj zmienne globalne w celu zdefiniowania kwadratu i filtru.
3. Utwórz funkcje konstruktora, którego działanie jest następujące:
   • Wywołuje metodę draw(), która korzysta z klasy Graphics, do której uzyskuje dostęp za pośrednictwem właświwości graphics Sprite, w celu narysowania szarego kwadratu.
   • Tworzy obiekt BitmapFilter o nazwie filter i przypisuje do niego wartość zwracaną przez wywołanie metody getBitmapFilter(), która tworzy filtr.
   • Tworzy nową tablicę o nazwie myFilters i dodaje do niej obiekt filter.
   • Przypisuje tablicę myFilters do właściwości filters obiektu GradientBevelFilterExample. To spowoduje zastosowanie wszystkich filtrów zalezionych w obiekcie myFilters — w tym przykładzie jest to filtr 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();
        }
    }
}