GradientBevelFilter  - AS3

Een array van alpha-transparantiewaarden voor de overeenkomende kleuren in de array colors. Geldige waarden voor elk element in de array zijn 0 tot en met 1. De waarde .25 stelt bijvoorbeeld een transparantiewaarde in van 25%.

U kunt de eigenschap alphas niet wijzigen door de waarden ervan rechtstreeks te wijzigen. In plaats hiervan moet u een verwijzing naar alphas opvragen, de wijziging doorvoeren in de verwijzing en vervolgens alphas instellen op de verwijzing.

De eigenschappen colors, alphas en ratios zijn gerelateerd. Het eerste element in de array colors de array alphas en in de arrayratios, enzovoort.

Verwante API-elementen

De hoek in graden. Geldige waarden zijn 0 tot en met 360. De standaardwaarde is 45.

De waarde angle vertegenwoordigt de hoek van de denkbeeldige lichtbron die op het object valt. De waarde bepaalt de hoek waarmee de verlopende kleuren op het object worden toegepast: waar het licht en waar de schaduw wordt weergegeven of waar de eerste kleur in de array wordt weergegeven. De kleuren worden vervolgens in de volgorde toegepast waarin ze in de array aanwezig zijn.

Verwante API-elementen

De mate van horizontale vervaging. Geldige waarden zijn 0 tot en met 255. Een vervaging van 1 houdt in dat de afbeelding in de oorspronkelijke staat wordt gekopieerd. De standaardwaarde is 4. Waarden die een macht van 2 zijn (zoals 2, 4, 8, 16 en 32), zijn geoptimaliseerd om sneller te renderen dan andere waarden.

De mate van verticale vervaging. Geldige waarden zijn 0 tot en met 255. Een vervaging van 1 houdt in dat de afbeelding in de oorspronkelijke staat wordt gekopieerd. De standaardwaarde is 4. Waarden die een macht van 2 zijn (zoals 2, 4, 8, 16 en 32), zijn geoptimaliseerd om sneller te renderen dan andere waarden.

Een array van hexadecimale RGB-kleurwaarden voor gebruik in het verloop. Rood is bijvoorbeeld 0xFF0000, blauw is 0x0000FF, enzovoort.

U kunt de eigenschap colors niet wijzigen door de waarden ervan rechtstreeks te wijzigen. In plaats hiervan moet u een verwijzing naar colors opvragen, de wijziging doorvoeren in de verwijzing en vervolgens colors instellen op de verwijzing.

De eigenschappen colors, alphas en ratios zijn gerelateerd. Het eerste element in de array colors de array alphas en in de arrayratios, enzovoort.

Verwante API-elementen

De verschuivingsafstand. Geldige waarden zijn 0 tot en met 8. De standaardwaarde is 4.0.

Geeft op of het object een uitneemeffect heeft. Met een uitneemeffect wordt het object transparant gevuld en wordt de achtergrondkleur van het document zichtbaar gemaakt. De waarde true geeft een uitneemeffect op; de standaardwaarde is false (niet uitnemen).

Het aantal keren dat het filter moet worden toegepast. De standaardwaarde is BitmapFilterQuality.LOW. Hiermee wordt het filter eenmaal toegepast. De waarde BitmapFilterQuality.MEDIUM past het filter tweemaal toe, terwijl het met de waarde BitmapFilterQuality.HIGH driemaal wordt toegepast. Filters met lagere waarden worden sneller gerenderd.

Voor de meeste toepassingen is een waarde van laag, normaal of hoog voor quality voldoende. Hoewel u aanvullende numerieke waarden tot en met 15 kunt gebruiken om verschillende effecten te verkrijgen, worden hogere waarden langzamer gerenderd. In plaats van de waarde van quality te verhogen, krijgt u vaak een vergelijkbaar effect met snellere rendering door de waarden van blurX en blurY te verhogen.

Verwante API-elementen

Een array met kleurdistributieverhoudingen voor de overeenkomende kleuren in de array colors. Geldige waarden voor elk element in de array zijn 0 tot en met 255.

U kunt de eigenschap ratios niet wijzigen door de waarden ervan rechtstreeks te wijzigen. In plaats hiervan moet u een verwijzing naar ratios opvragen, de wijziging doorvoeren in de verwijzing en vervolgens ratios instellen op de verwijzing.

De eigenschappen colors, alphas en ratios zijn gerelateerd. Het eerste element in de array colors de array alphas en in de arrayratios, enzovoort.

Voor meer begrip van de manier waarop kleuren in een verlopende schuine kant worden verdeeld, moet u eerst bedenken welke kleuren u wilt opnemen in de verlopende schuine kant. Bedenk dat een eenvoudige schuine kant een lichte kleur en een schaduwkleur heeft; een verlopende schuine kant heeft een lichtverloop en een schaduwverloop. Stel dat het licht in de linkerbovenhoek wordt weergegeven en de schaduw in de rechterbenedenhoek. Stel dat een mogelijk gebruik van het filter vier kleuren heeft in het licht en vier in de schaduw. Naast het licht en de schaduw gebruikt het filter een basisvulkleur die wordt weergegeven waar de randen van licht en schaduw elkaar raken. Het totale aantal kleuren is dan ook negen en het overeenkomstige aantal elementen in de array van verhoudingen is ook negen.

Wanneer u een verloop beschouwt als een samenstelling van strepen in verschillende kleuren die in elkaar overlopen, stelt elke ratiowaarde de positie van de kleur op de straal van het verloop in, waarbij 0 het buitenste punt van het verloop en 255 het binnenste punt van het verloop vertegenwoordigt. Voor gangbaar gebruik is de middelste waarde 128, de basisvulwaarde. U kunt als volgt de ratiowaarden toewijzen met behulp van het voorbeeld met de negen kleuren om het schuine-kanteffect in de onderstaande afbeelding te verkrijgen:

• De eerste vier kleuren lopen van 0 tot en met 127, in oplopende volgorde, zodat elke waarde groter is dan of gelijk is aan de vorige. Dit is de lichte schuine kant.
• De vijfde kleur (de middelste kleur) is de basisvulkleur en is ingesteld op 128. De pixelwaarde 128 stelt de basisvulling in die buiten de vorm (en rondom de schuine kanten) wordt weergegeven wanneer het type op buiten is ingesteld, of die binnen de vorm wordt weergegeven, waarbij de vulling van het object wordt bedekt, wanneer het type op binnen is ingesteld.
• De laatste vier kleuren lopen van 129 tot en met 255, in oplopende volgorde, zodat elke waarde groter is dan of gelijk is aan de vorige. Dit is de donkere schuine kant (schaduw).

Wanneer u een gelijke verdeling van kleuren aan elke kant wilt, gebruik dan een oneven aantal kleuren, met de middelste kleur als basisvulkleur. Verdeel de waarden tussen 0 en 127 en tussen 129 en 255 gelijkwaardig over de kleuren en pas vervolgens de waarde aan om de breedte van elke kleurstreep in het verloop te wijzigen. Voor een verlopende schuine kant met negen kleuren is een mogelijke array [16, 32, 64, 96, 128, 160, 192, 224, 235]. De volgende afbeelding toont de beschreven schuine kant.

De spreiding van de kleuren in het verloop varieert op basis van de waarden van de eigenschappen blurX, blurY, strength en quality en de waarden ratios.

Verwante API-elementen

De sterkte van de afdruk of de spreiding. Hoe hoger de waarde, hoe meer kleur er wordt afgedrukt en hoe sterker het contrast tussen de schuine kant en de achtergrond wordt. Geldige waarden zijn 0 tot en met 255. Een waarde 0 houdt in dat het filter niet wordt toegepast. De standaardwaarde is 1.

Verwante API-elementen

De plaatsing van het schuine-kanteffect. Mogelijke waarden zijn de BitmapFilterType-constanten:

• BitmapFilterType.OUTER — Schuine kant op de buitenste rand van het object.
• BitmapFilterType.INNER — Schuine kant op de binnenrand van het object.
• BitmapFilterType.FULL — Schuine kant op de bovenkant van het object.

Initialiseert het filter met de opgegeven parameters.

Verwante API-elementen

Retourneert een kopie van dit filterobject.

1. Importeer de vereiste klassen.
2. Declareer algemene variabelen om het vierkant en het filter te definiëren.
3. Maak de constructorfunctie, die het volgende doet:
   • Roept de methode draw() aan, die de methoden van de klasse Graphics gebruikt, waar met behulp van de eigenschap graphics van Sprite toegang toe wordt gekregen om een grijs vierkant te tekenen.
   • Maakt een object BitmapFilter met de naam filter en wijst er de geretourneerde waarde van een aanroep van getBitmapFilter() aan toe, die het filter maakt.
   • Maakt een nieuwe array met de naam myFilters en voegt erfilter aan toe.
   • Wijst myFilters toe aan de eigenschap filters van het object GradientBevelFilterExample. Hiermee worden alle filters toegepast die worden gevonden in myFilters, wat in dit geval alleen filter is.

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();
        }
    }
}