GradientBevelFilter  - AS3

En array med alfagenomskinlighetsvärden för motsvarande färger i colors-arrayen. Giltiga värden för varje element i arrayen är 0 till 1. 0,25 innebär till exempel att genomskinlighetsvärdet är 25 %.

Egenskapen alphas kan inte ändras genom att dess värden ändras direkt. Du måste i stället hämta en referens till alphas, ändra i referensen och sedan ställa in alphas efter referensen.

Egenskaperna colors, alphas och ratios är relaterade. Det första elementet i colors-arrayen motsvarar det första elementet i alphas-arrayen och i ratios-arrayen och så vidare.

Relaterade API-element

Vinkeln i grader. Giltiga värden är från 0 till 360. Standardvärdet är 45.

Vinkelvärdet motsvarar en teoretisk ljuskällas infallsvinkel på objektet. Värdet bestämmer vid vilken vinkel övergångsfärgerna ska användas på objektet, det vill säga var på objektet högdagrar och skuggor visas, eller var den första färgen i arrayen visas. Färgerna används sedan i den ordning de visas i arrayen.

Relaterade API-element

Mängden vågrät oskärpa. Giltiga värden är från 0 till 255. Om oskärpan är 1 eller mindre kopieras originalbilden i befintligt skick. Standardvärdet är 4. Värden som är 2-potenser (till exempel 2, 4, 8, 16 och 32) är optimerade för snabbare rendering än andra värden.

Mängden lodrät oskärpa. Giltiga värden är från 0 till 255. Om oskärpan är 1 eller mindre kopieras originalbilden i befintligt skick. Standardvärdet är 4. Värden som är 2-potenser (till exempel 2, 4, 8, 16 och 32) är optimerade för snabbare rendering än andra värden.

En array med hexadecimala RGB-färgvärden som ska användas i övertoningen. Röd är till exempel 0xFF0000, blå är 0x0000FF och så vidare.

Egenskapen colors kan inte ändras genom att dess värden ändras direkt. Du måste i stället hämta en referens till colors, ändra i referensen och sedan ställa in colors efter referensen.

Egenskaperna colors, alphas och ratios är relaterade. Det första elementet i colors-arrayen motsvarar det första elementet i alphas-arrayen och i ratios-arrayen och så vidare.

Relaterade API-element

Förskjutningsavståndet. Giltiga värden är från 0 till 8. Standardvärdet är 4.0.

Anger om objektet har en blockeringseffekt. En blockeringseffekt gör objektets fyllning genomskinlig så att dokumentets bakgrundsfärg syns. Värdet true anger en blockeringseffekt. Standardvärdet är false (ingen blockeringseffekt).

Hur många gånger filtret ska tillämpas. Standardvärdet är BitmapFilterQuality.LOW, vilket motsvarar en tillämpning av filtret. Värdet BitmapFilterQuality.MEDIUM används två gånger på filtret. Värdet BitmapFilterQuality.HIGH används tre gånger. Filter med lägre värden renderas snabbare.

För de flesta program är ett quality-värde på låg, medel eller hög tillräckligt. Du kan använda ytterligare numeriska värden upp till 15 för att få olika effekter, men högre värden tar längre tid att rendera. I stället för att öka quality-värdet kan du ofta få en liknande effekt och snabbare rendering genom att bara öka värdena för blurX och blurY.

Relaterade API-element

En array med färgfördelningsförhållanden för motsvarande färger i colors-arrayen. Giltiga värden för varje element i arrayen är 0 till 255.

Egenskapen ratios kan inte ändras genom att dess värden ändras direkt. Du måste i stället hämta en referens till ratios, ändra i referensen och sedan ställa in ratios efter referensen.

Egenskaperna colors, alphas och ratios är relaterade. Det första elementet i colors-arrayen motsvarar det första elementet i alphas-arrayen och i ratios-arrayen och så vidare.

För att förstå hur färgerna i en övertoningsavfasning fördelas kan du först tänka på vilka färger du vill ha i övertoningsavfasningen. Tänk på att en enkel avfasning har en högdagerfärg och en skuggfärg. En övertoningsavfasning har en högdagerövertoning och en skuggövertoning. Anta att högdagern visas i det översta vänstra hörnet och att skuggan visas i det nedersta högra hörnet. Anta att en möjlig användning av filtret har fyra färger i högdagern och fyra i skuggan. Utöver högdagern och skuggan använder filtret en basfyllningsfärg som visas där högdagerns och skuggans kanter möts. Därför är det totala antalet färger nio och det motsvarande antalet element i arrayen ratios är nio.

Om du tänker dig en övertoning som en kombination av remsor i olika färger som övergår i varandra anger varje ratio-värde placeringen för färgen i övertoningens radie, där 0 betecknar övertoningens yttersta punkt och 255 betecknar övertoningens innersta punkt. För det mesta används mellanvärdet 128. 128 är basfyllningsvärdet. För att få den avfasningseffekt som visas på bilden nedan tilldelar du de ratio-värden som följer med hjälp av exemplet med nio färger:

• De första fyra färgerna varierar från 0 till 127. Värdet ökar så att varje värde är större än eller lika med det föregående värdet. Detta är högdagerns avfasningskant.
• Den femte färgen (den mittersta färgen) är basfyllningen, satt till 128. Pixelvärdet 128 anger basfyllningen, som antingen visas utanför figuren (och runt avfasningskanterna) om typen angetts till yttre, eller inuti figuren, vilket innebär att objektets egen fyllning täcks om typen inre har angetts.
• De sista fyra färgerna varierar från 129 till 255. Värdet ökar så att varje värde är större än eller lika med det föregående värdet. Detta är skuggans avfasningskant.

Om du vill att färgerna ska fördelas jämnt för varje kant använder du ett udda antal färger där mellanfärgen är basfyllningen. Fördela värdena mellan 0 till 127 och 129 till 255 jämnt bland färgerna och justera sedan värdet så att bredden för varje färgremsa i övertoningen ändras. För en övertoningsavfasning med nio färger är en möjlig array [16, 32, 64, 96, 128, 160, 192, 224, 235]. På följande bild visas övertoningsavfasningen som beskrivs:

Tänk på att färgspridningen i övertoningen baseras på värdena för egenskaperna blurX, blurY, strength och quality samt ratios-värdena.

Relaterade API-element

Styrkan hos intrycket eller spridningen. Ju högre värde desto mer färg används och desto starkare blir kontrasten mellan avfasningen och bakgrunden. Giltiga värden är från 0 till 255. Värdet 0 innebär att filtret inte används. Standardvärdet är 1.

Relaterade API-element

Avfasningens placering. Möjliga värden är BitmapFilterType-konstanter:

• BitmapFilterType.OUTER – avfasning på objektets yttre kant
• BitmapFilterType.INNER – avfasning på objektets inre kant
• BitmapFilterType.FULL – avfasning på objektets ovansida

Initierar filtret med de angivna parametrarna.

Relaterade API-element

Returnerar en kopia av det här filterobjektet.

1. Importera de nödvändiga klasserna.
2. Deklarera globala variabler som används för att definiera kvadraten och filtret.
3. Skapa konstruktorfunktionerna som gör följande:
   • Anropar draw()-metoden som använder metoder för Graphics-klassen genom graphics-egenskapen för Sprite för att rita en fyrkant.
   • Skapar ett nytt BitmapFilter-objekt med namnet filter och kopplar det till det returnerade värdet för ett anrop av getBitmapFilter() som skapar filtret.
   • Skapar en ny array med namnet myFilters och lägger till filter i arrayen.
   • Tilldelar myFilters till filters-egenskapen i GradientBevelFilterExample-objektet. Då tillämpas alla filter som finns i myFilters vilket i det här fallet bara är 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();
        }
    }
}