Pakket | flash.filters |
Klasse | public final class BlurFilter |
Overerving | BlurFilter BitmapFilter Object |
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
quality
van dit filter op 1 wordt ingesteld, is het resultaat een licht onscherpe afbeelding. Wanneer de eigenschap quality
op 3 wordt ingesteld, benadert dit Gaussiaans vervagen. 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.
Wanneer u een nieuw filter wilt maken, gebruikt u de constructor new BlurFilter()
. Het gebruik van filters is afhankelijk van het object waarop u het filter toepast:
- Wanneer u filters wilt toepassen op filmclips, tekstvelden, knoppen en video, 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 verwijdert, 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 de eigenschappen scaleX
en scaleY
niet zijn ingesteld op 100%), wordt het filtereffect 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.cacheAsBitmap
flash.display.BitmapData.applyFilter()
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
blurX : Number
De mate van horizontale vervaging. | BlurFilter | ||
blurY : Number
De mate van verticale vervaging. | BlurFilter | ||
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | ||
quality : int
Het aantal keren dat vervaging moet worden uitgevoerd. | BlurFilter |
Methode | Gedefinieerd door | ||
---|---|---|---|
Initialiseert het filter met de opgegeven parameters. | BlurFilter | ||
[overschrijven]
Retourneert een kopie van dit filterobject. | BlurFilter | ||
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 |
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 4. 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 4. 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
quality | eigenschap |
quality:int
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Het aantal keren dat vervaging moet worden uitgevoerd. 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 en Gaussiaans vervagen wordt benaderd. Filters met lagere waarden worden sneller gerenderd.
Voor de meeste toepassingen is een waarde van laag, normaal of hoog voor quality
voldoende. Hoewel u hogere waarden (tot en met 15) kunt gebruiken om het aantal malen dat de vervaging wordt toegepast te verhogen, 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.
U kunt de volgende BitmapFilterQuality-constanten gebruiken om waarden van de eigenschap quality
op te geven:
BitmapFilterQuality.LOW
BitmapFilterQuality.MEDIUM
BitmapFilterQuality.HIGH
Implementatie
public function get quality():int
public function set quality(value:int):void
BlurFilter | () | Constructor |
public function BlurFilter(blurX:Number = 4.0, blurY:Number = 4.0, quality:int = 1)
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Initialiseert het filter met de opgegeven parameters. De standaardwaarden resulteren in een licht onscherpe afbeelding.
ParametersblurX:Number (default = 4.0 ) — De mate waarin horizontaal moet worden vervaagd. Geldige waarden zijn 0 tot en met 255,0 (drijvende-kommawaarde).
| |
blurY:Number (default = 4.0 ) — De mate waarin verticaal moet worden vervaagd. Geldige waarden zijn 0 tot en met 255,0 (drijvende-kommawaarde).
| |
quality:int (default = 1 ) — Het aantal keren dat het filter moet worden toegepast. U kunt de kwaliteit opgeven met de BitmapFilterQuality-constanten:
Hoge kwaliteit benadert Gaussiaans vervagen. Voor de meeste toepassingen zijn deze drie waarden voldoende. Hoewel u aanvullende numerieke waarden tot en met 15 kunt gebruiken om verschillende effecten te verkrijgen, worden hogere waarden langzamer gerenderd. |
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 BlurFilter waarvan alle eigenschappen hetzelfde zijn als de oorspronkelijke instantie BlurFilter.
|
- Importeer de vereiste klassen.
- Declareer drie eigenschappen die in de functie
draw()
worden gebruikt, die het object tekenen waarop het vervagende filter wordt toegepast. - Maak de constructorfunctie
BlurFilterExample()
, die het volgende doet:- Roept de functie
draw()
aan, die later wordt gedeclareerd. - Declareert een variabele
filter
als een object BitmapFilter en wijst het toe aan de geretourneerde waarde van een aanroep vangetBitmapFilter()
. - Maakt een nieuw Array-object
myFilters
, voegtfilter
toe aan de array en wijstmyFilters
toe aan de eigenschapfilters
van het object BlurFilterExample. Hiermee worden alle filters toegepast die worden gevonden inmyFilters
, wat in dit geval alleenfilter
is.
- Roept de functie
- Maak de functie
getBitmapFilter()
om eigenschappen te maken en in te stellen voor het filter. - Maak de functie
draw()
. Deze functie gebruikt methoden van de klasse Graphics, waar met behulp van de eigenschapgraphics
van de klasse Sprite toegang toe wordt verkregen om een vierkant te tekenen.
package { import flash.display.Sprite; import flash.filters.BitmapFilter; import flash.filters.BitmapFilterQuality; import flash.filters.BlurFilter; public class BlurFilterExample extends Sprite { private var bgColor:uint = 0xFFCC00; private var size:uint = 80; private var offset:uint = 50; public function BlurFilterExample() { draw(); var filter:BitmapFilter = getBitmapFilter(); var myFilters:Array = new Array(); myFilters.push(filter); filters = myFilters; } private function getBitmapFilter():BitmapFilter { var blurX:Number = 30; var blurY:Number = 30; return new BlurFilter(blurX, blurY, BitmapFilterQuality.HIGH); } private function draw():void { graphics.beginFill(bgColor); graphics.drawRect(offset, offset, size, size); graphics.endFill(); } } }
Wed Jun 13 2018, 11:42 AM Z