Pakket | flash.filters |
Klasse | public final class DropShadowFilter |
Overerving | DropShadowFilter BitmapFilter Object |
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
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 waarde van 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
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
alpha : Number
De alpha-transparantiewaarde voor de schaduwkleur. | DropShadowFilter | ||
angle : Number
De hoek van de schaduw. | DropShadowFilter | ||
blurX : Number
De mate van horizontale vervaging. | DropShadowFilter | ||
blurY : Number
De mate van verticale vervaging. | DropShadowFilter | ||
color : uint
De kleur van de schaduw. | DropShadowFilter | ||
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | ||
distance : Number
De verschuivingsafstand voor de schaduw, in pixels. | DropShadowFilter | ||
hideObject : Boolean
Geeft aan of het object is verborgen. | DropShadowFilter | ||
inner : Boolean
Geeft aan of de schaduw een binnenschaduw is. | DropShadowFilter | ||
knockout : Boolean
Past een uitneemeffect toe (true), waardoor het object transparant wordt gevuld en de achtergrondkleur van het document zichtbaar wordt gemaakt. | DropShadowFilter | ||
quality : int
Het aantal keren dat het filter moet worden toegepast. | DropShadowFilter | ||
strength : Number
De sterkte van de afdruk of de spreiding. | DropShadowFilter |
Methode | Gedefinieerd door | ||
---|---|---|---|
DropShadowFilter(distance:Number = 4.0, angle:Number = 45, color:uint = 0, alpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1.0, quality:int = 1, inner:Boolean = false, knockout:Boolean = false, hideObject:Boolean = false)
Maakt een nieuwe instantie DropShadowFilter met de opgegeven parameters. | DropShadowFilter | ||
[overschrijven]
Retourneert een kopie van dit filterobject. | DropShadowFilter | ||
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 schaduwkleur. Geldige waarden zijn 0.0 tot en met 1.0. De waarde .25 stelt bijvoorbeeld een transparantiewaarde in van 25%. De standaardwaarde is 1.0.
Implementatie
public function get alpha():Number
public function set alpha(value:Number):void
angle | eigenschap |
blurX | eigenschap |
blurY | eigenschap |
color | eigenschap |
distance | eigenschap |
hideObject | eigenschap |
hideObject:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Geeft aan of het object is verborgen. De waarde true
geeft aan dat het object zelf niet is getekend; alleen de schaduw is zichtbaar. De standaardwaarde is false
(het object is zichtbaar).
Implementatie
public function get hideObject():Boolean
public function set hideObject(value:Boolean):void
inner | eigenschap |
inner:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Geeft aan of de schaduw een binnenschaduw is. De waarde true
geeft een binnenschaduw op. De standaardwaarde is false
, een buitenschaduw (een schaduw 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 |
Past een uitneemeffect toe (true
), waardoor 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 kwaliteitswaarde laag, normaal of hoog 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 schaduw en de achtergrond wordt. Geldige waarden zijn 0 tot en met 255,0. De standaardwaarde is 1.0.
Implementatie
public function get strength():Number
public function set strength(value:Number):void
DropShadowFilter | () | Constructor |
public function DropShadowFilter(distance:Number = 4.0, angle:Number = 45, color:uint = 0, alpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1.0, quality:int = 1, inner:Boolean = false, knockout:Boolean = false, hideObject:Boolean = false)
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Maakt een nieuwe instantie DropShadowFilter met de opgegeven parameters.
Parametersdistance:Number (default = 4.0 ) — De verschuivingsafstand voor de schaduw, in pixels.
| |
angle:Number (default = 45 ) — Hoek van de schaduw, 0 tot en met 360 graden (drijvende komma).
| |
color:uint (default = 0 ) — De kleur van de schaduw, in de hexadecimale notatie 0xRRGGBB. De standaardwaarde is 0x000000.
| |
alpha:Number (default = 1.0 ) — De alpha-transparantiewaarde voor de schaduwkleur. Geldige waarden zijn 0.0 tot en met 1.0. De waarde .25 stelt bijvoorbeeld een transparantiewaarde in van 25%.
| |
blurX:Number (default = 4.0 ) — De mate van horizontale vervaging. Geldige waarden zijn 0 tot en met 255,0 (drijvende komma).
| |
blurY:Number (default = 4.0 ) — De mate van verticale vervaging. Geldige waarden zijn 0 tot en met 255,0 (drijvende komma).
| |
strength:Number (default = 1.0 ) — 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 schaduw en de achtergrond wordt. Geldige waarden zijn 0 tot en met 255.0.
| |
quality:int (default = 1 ) — Het aantal keren dat het filter moet worden toegepast. Gebruik de BitmapFilterQuality-constanten:
Zie de beschrijving van de eigenschap | |
inner:Boolean (default = false ) — Geeft aan of de schaduw een binnenschaduw is. De waarde true geeft een binnenschaduw op. De waarde false geeft een buitenschaduw op (een schaduw rondom de buitenranden van het object).
| |
knockout:Boolean (default = false ) — Past een uitneemeffect toe (true ), waardoor het object transparant wordt gevuld en de achtergrondkleur van het document zichtbaar wordt gemaakt.
| |
hideObject:Boolean (default = false ) — Geeft aan of het object is verborgen. De waarde true geeft aan dat het object zelf niet is getekend; alleen de schaduw is zichtbaar.
|
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 DropShadowFilter met alle eigenschappen van de oorspronkelijke instantie DropShadowFilter.
|
- Declareer drie eigenschappen die worden gebruikt om het vierkant te tekenen waarop het filter wordt toegepast.
- Maak de constructorfunctie. De constructor roept de methode
draw()
aan, die methoden van de klasse Graphics gebruikt die worden benaderd via de eigenschapgraphics
van Sprite om een oranje vierkant te tekenen. - Declareer in de constructor een variabele
filter
als een object BitmapFilter en wijs deze toe aan de geretourneerde waarde van een aanroep vangetBitmapFilter()
. De methodegetBitmapFilter()
definieert de slagschaduw die wordt gebruikt. - Maak een nieuw Array-object
myFilters
en voegfilter
toe aan de array. Wijs de arraymyFilters
toe aan de eigenschapfilters
van het object DropShadowFilterExample. Hiermee worden alle filters toegepast die worden gevonden inmyFilters
, wat in dit geval alleenfilter
is.
package { import flash.display.Sprite; import flash.events.Event; import flash.events.MouseEvent; import flash.filters.BitmapFilter; import flash.filters.BitmapFilterQuality; import flash.filters.DropShadowFilter; public class DropShadowFilterExample extends Sprite { private var bgColor:uint = 0xFFCC00; private var size:uint = 80; private var offset:uint = 50; public function DropShadowFilterExample() { draw(); var filter:BitmapFilter = getBitmapFilter(); var myFilters:Array = new Array(); myFilters.push(filter); filters = myFilters; } private function getBitmapFilter():BitmapFilter { var color:Number = 0x000000; var angle:Number = 45; var alpha:Number = 0.8; var blurX:Number = 8; var blurY:Number = 8; var distance:Number = 15; var strength:Number = 0.65; var inner:Boolean = false; var knockout:Boolean = false; var quality:Number = BitmapFilterQuality.HIGH; return new DropShadowFilter(distance, angle, 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