Pakket | flash.filters |
Klasse | public final class GlowFilter |
Overerving | GlowFilter BitmapFilter Object |
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
distance
enangle
van de slagschaduw op 0 zijn ingesteld. U kunt het filter toepassen op elk weergaveobject (objecten die overerven van de klasse DisplayObject), zoals de objecten MovieClip, SimpleButton, TextField en Video, en op objecten BitmapData.
Het gebruik van filters is afhankelijk van het object waarop u het filter toepast:
- Wanneer u filters wilt toepassen op weergaveobjecten, gebruikt u de eigenschap
filters
(overerfd van DisplayObject). Het instellen van de eigenschapfilters
van een object wijzigt het object niet en het filter kan ongedaan worden gemaakt door de eigenschapfilters
te wissen. - Wanneer u filters wilt toepassen op objecten BitmapData, gebruikt u de methode
BitmapData.applyFilter()
. WanneerapplyFilter()
op een object BitmapData wordt aangeroepen, wordt van het bronobject BitmapData en het filterobject een gefilterde afbeelding gegenereerd.
Wanneer u een filter toepast op een weergaveobject, wordt de eigenschap cacheAsBitmap
van het weergaveobject op true
ingesteld. Wanneer u alle filters wist, wordt de oorspronkelijke waarde van cacheAsBitmap
hersteld.
Dit filter ondersteunt werkgebiedschaling. Schalen, roteren en scheeftrekken worden echter niet ondersteund. Wanneer het object zelf wordt geschaald (wanneer scaleX
en scaleY
worden ingesteld op een andere waarde dan 1,0), wordt het filter niet geschaald. Het wordt alleen geschaald wanneer de gebruiker op het werkgebied inzoomt.
Er wordt geen filter toegepast als de resulterende afbeelding groter is dan de maximale afmetingen. In AIR 1.5 en Flash Player 10 is de maximale grootte 8,191 pixels breed of hoog en mag het totale aantal pixels niet groter zijn dan 16,777,215 pixels. (Als een afbeelding 8,191 pixels breed is, kan deze daarom slechts 2048 pixels hoog zijn.) In Flash Player 9 en lager en AIR 1.1 en lager is de maximale hoogte 2880 pixels en de maximale breedte 2880 pixels. Wanneer u bijvoorbeeld inzoomt op een grote filmclip met een toegepast filter, wordt het filter uitgeschakeld wanneer de resulterende afbeelding de maximale afmetingen overschrijdt.
Verwante API-elementen
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
flash.display.DisplayObject.scaleX
flash.display.DisplayObject.scaleY
flash.filters.DropShadowFilter.distance
flash.filters.DropShadowFilter.angle
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
alpha : Number
De alpha-transparantiewaarde voor de kleur. | GlowFilter | ||
blurX : Number
De mate van horizontale vervaging. | GlowFilter | ||
blurY : Number
De mate van verticale vervaging. | GlowFilter | ||
color : uint
De kleur van de gloed. | GlowFilter | ||
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | ||
inner : Boolean
Geeft op of de gloed een binnengloed is. | GlowFilter | ||
knockout : Boolean
Geeft op of het object een uitneemeffect heeft. | GlowFilter | ||
quality : int
Het aantal keren dat het filter moet worden toegepast. | GlowFilter | ||
strength : Number
De sterkte van de afdruk of de spreiding. | GlowFilter |
Methode | Gedefinieerd door | ||
---|---|---|---|
GlowFilter(color:uint = 0xFF0000, alpha:Number = 1.0, blurX:Number = 6.0, blurY:Number = 6.0, strength:Number = 2, quality:int = 1, inner:Boolean = false, knockout:Boolean = false)
Initialiseert een nieuwe instantie GlowFilter met de opgegeven parameters. | GlowFilter | ||
[overschrijven]
Retourneert een kopie van dit filterobject. | GlowFilter | ||
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | ||
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | ||
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | ||
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | ||
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | ||
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | ||
Retourneert de primitieve waarde van het opgegeven object. | Object |
alpha | eigenschap |
alpha:Number
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
De alpha-transparantiewaarde voor de kleur. Geldige waarden zijn 0 tot en met 1. De waarde .25 stelt bijvoorbeeld een transparantiewaarde in van 25%. De standaardwaarde is 1.
Implementatie
public function get alpha():Number
public function set alpha(value:Number):void
blurX | eigenschap |
blurX:Number
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
De mate van horizontale vervaging. Geldige waarden zijn 0 tot en met 255 (drijvende komma). De standaardwaarde is 6. Waarden die een macht van 2 zijn (zoals 2, 4, 8, 16 en 32), zijn geoptimaliseerd om sneller te renderen dan andere waarden.
Implementatie
public function get blurX():Number
public function set blurX(value:Number):void
blurY | eigenschap |
blurY:Number
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
De mate van verticale vervaging. Geldige waarden zijn 0 tot en met 255 (drijvende komma). De standaardwaarde is 6. Waarden die een macht van 2 zijn (zoals 2, 4, 8, 16 en 32), zijn geoptimaliseerd om sneller te renderen dan andere waarden.
Implementatie
public function get blurY():Number
public function set blurY(value:Number):void
color | eigenschap |
inner | eigenschap |
inner:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Geeft op of de gloed een binnengloed is. De waarde true
geeft een binnengloed aan. De standaardwaarde is false
, een buitengloed (een gloed rondom de buitenranden van het object).
Implementatie
public function get inner():Boolean
public function set inner(value:Boolean):void
knockout | eigenschap |
knockout:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Geeft op of het object een uitneemeffect heeft. De waarde true
zorgt ervoor dat het object transparant wordt gevuld en de achtergrondkleur van het document zichtbaar wordt gemaakt. De standaardwaarde is false
(niet uitnemen).
Implementatie
public function get knockout():Boolean
public function set knockout(value:Boolean):void
quality | eigenschap |
quality:int
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
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.
Implementatie
public function get quality():int
public function set quality(value:int):void
Verwante API-elementen
strength | eigenschap |
strength:Number
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
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 gloed en de achtergrond wordt. Geldige waarden zijn 0 tot en met 255. De standaardwaarde is 2.
Implementatie
public function get strength():Number
public function set strength(value:Number):void
GlowFilter | () | Constructor |
public function GlowFilter(color:uint = 0xFF0000, alpha:Number = 1.0, blurX:Number = 6.0, blurY:Number = 6.0, strength:Number = 2, quality:int = 1, inner:Boolean = false, knockout:Boolean = false)
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Initialiseert een nieuwe instantie GlowFilter met de opgegeven parameters.
Parameterscolor:uint (default = 0xFF0000 ) — De kleur van de gloed, in de hexadecimale notatie 0x RRGGBB. De standaardwaarde is 0xFF0000.
| |
alpha:Number (default = 1.0 ) — De alpha-transparantiewaarde voor de kleur. Geldige waarden zijn 0 tot en met 1. De waarde .25 stelt bijvoorbeeld een transparantiewaarde in van 25%.
| |
blurX:Number (default = 6.0 ) — De mate van horizontale vervaging. Geldige waarden zijn 0 tot en met 255 (drijvende komma). Waarden die een macht van 2 zijn (zoals 2, 4, 8, 16 en 32), zijn geoptimaliseerd om sneller te renderen dan andere waarden.
| |
blurY:Number (default = 6.0 ) — De mate van verticale vervaging. Geldige waarden zijn 0 tot en met 255 (drijvende komma). Waarden die een macht van 2 zijn (zoals 2, 4, 8, 16 en 32), zijn geoptimaliseerd om sneller te renderen dan andere waarden.
| |
strength:Number (default = 2 ) — 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 gloed en de achtergrond wordt. Geldige waarden zijn 0 tot en met 255.
| |
quality:int (default = 1 ) — Het aantal keren dat het filter moet worden toegepast. Gebruik de BitmapFilterQuality-constanten:
Zie voor meer informatie de beschrijving van de eigenschap | |
inner:Boolean (default = false ) — Geeft op of de gloed een binnengloed is. De waarde true geeft een binnengloed op. De waarde false geeft een buitengloed op (een gloed rondom de buitenranden van het object).
| |
knockout:Boolean (default = false ) — Geeft op of het object een uitneemeffect heeft. De waarde true zorgt ervoor dat het object transparant wordt gevuld en de achtergrondkleur van het document zichtbaar wordt gemaakt.
|
Verwante API-elementen
clone | () | methode |
override public function clone():BitmapFilter
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Retourneert een kopie van dit filterobject.
Geretourneerde waardeBitmapFilter — Een nieuwe instantie GlowFilter met alle eigenschappen van de oorspronkelijke instantie GlowFilter.
|
- Importeer de vereiste klassen.
- Declareer drie eigenschappen die in de methode
draw
worden gebruikt, die de methoden van de klasse Graphics gebruikt, waar met behulp van de eigenschapgraphics
van Sprite toegang toe wordt gekregen om een oranje vierkant te tekenen. - Maak de constructorfunctie, die het volgende doet:
- Roept de functie
draw
aan om een rechthoek te maken. - Maakt het BitmapFilter-object
glowFilter
en wijst dit object toe aan de retourwaarden van de functiegetBitmapFilter()
. - Wijst de array met de waarden van het
glowFilter
-object toe aan de eigenschapfilters
van het hoofdweergaveobject. In dit geval worden de eigenschappen van het gloedfilter overgenomen door alle onderliggende weergaveobjecten van het hoofdweergaveobject. Als gevolg hiervan worden de eigenschappen van het gloedfilter weergegeven door de rechthoek die door de functiedraw()
is gemaakt.
- Roept de functie
package { import flash.display.Sprite; import flash.events.Event; import flash.events.MouseEvent; import flash.filters.BitmapFilter; import flash.filters.BitmapFilterQuality; import flash.filters.GlowFilter; public class GlowFilterExample extends Sprite { private var bgColor:uint = 0xFFCC00; private var size:uint = 80; private var offset:uint = 50; public function GlowFilterExample() { //draw the rectangle using the draw() function below draw(); //assign the values from getBitmapFilter function below //to a BitmapFilter object "glowFilter" var glowFilter:BitmapFilter = getBitmapFilter(); //populate the filters property of the root display object with the array of values //from the glowFilter object. filters = [ glowFilter ]; } private function getBitmapFilter():BitmapFilter { var color:Number = 0x33CCFF; var alpha:Number = 0.8; var blurX:Number = 35; var blurY:Number = 35; var strength:Number = 2; var inner:Boolean = false; var knockout:Boolean = false; var quality:Number = BitmapFilterQuality.HIGH; return new GlowFilter(color, alpha, blurX, blurY, strength, quality, inner, knockout); } private function draw():void { graphics.beginFill(bgColor); graphics.drawRect(offset, offset, size, size); graphics.endFill(); } } }
Wed Jun 13 2018, 11:42 AM Z