Paket | flash.filters |
Klass | public final class DropShadowFilter |
Arv | DropShadowFilter BitmapFilter Object |
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Användningen av filter beror på för vilket objekt du tillämpar filtret:
- Om du vill använda filter för att visa objekt använder du egenskapen
filters
(ärvs från DisplayObject). Inställningar avfilters
-egenskaper i ett objekt ändrar inte objektet. Du kan ta bort filtret genom att rensa egenskapenfilters
. - Om du vill använda filter på BitmapData-objekt använder du metoden
BitmapData.applyFilter()
. OmapplyFilter()
anropas för ett BitmapData-objekt används BitmapData-källobjektet och filterobjektet för att generera en filtrerad bild som resultat.
Om du använder ett filter för att visa ett objekt, anges värdet för cacheAsBitmap
-egenskapen till true
. Om du rensar alla filter återställs ursprungsvärdet cacheAsBitmap
.
Det här filtret stöder skalning på scenen. Det stöder däremot inte allmän skalning, rotering och skevning. Om själva objektet skalas (om scaleX
och scaleY
har ett annat värde än 1.0) skalas inte filtret. Det skalas endast om användaren zoomar in på scenen.
Inget filter används om resultatbilden överskrider maxdimensionerna. I AIR 1.5 och Flash Player 10 är maxstorleken 8 191 pixlar i bredd eller höjd, och det totala antalet pixlar får inte överskrida 16 777 215 pixlar. (Om en bild är 8 191 pixlar bred kan den därför bara vara 2 048 pixlar hög.) I Flash Player 9 och tidigare och i AIR 1.1 och tidigare är begränsningen 2 880 pixlar i höjd och 2 880 pixlar i bredd. Om du till exempel zoomar in på ett stort filmklipp med ett filter, inaktiveras filtret om den resulterande bilden överskrider maxdimensionerna.
Relaterade API-element
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
Egenskap | Definieras med | ||
---|---|---|---|
alpha : Number
Alfagenomskinlighetsvärdet för skuggfärgen. | DropShadowFilter | ||
angle : Number
Skuggans vinkel. | DropShadowFilter | ||
blurX : Number
Mängden vågrät oskärpa. | DropShadowFilter | ||
blurY : Number
Mängden lodrät oskärpa. | DropShadowFilter | ||
color : uint
Skuggans färg. | DropShadowFilter | ||
constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | ||
distance : Number
Skuggans förskjutningsavstånd i pixlar. | DropShadowFilter | ||
hideObject : Boolean
Indikerar om objektet är dolt eller inte. | DropShadowFilter | ||
inner : Boolean
Indikerar om skuggan är en innerskugga eller inte. | DropShadowFilter | ||
knockout : Boolean
Lägger på en blockeringseffekt (true) som gör objektets fyllning genomskinlig så att dokumentets bakgrundsfärg syns. | DropShadowFilter | ||
quality : int
Hur många gånger filtret ska tillämpas. | DropShadowFilter | ||
strength : Number
Styrkan hos intrycket eller spridningen. | DropShadowFilter |
Metod | Definieras med | ||
---|---|---|---|
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)
Skapar ett nytt DropShadowFilter-objekt med de angivna parametrarna. | DropShadowFilter | ||
[åsidosätt]
Returnerar en kopia av det här filterobjektet. | DropShadowFilter | ||
Anger om det finns en egenskap angiven för ett objekt. | Object | ||
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | ||
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | ||
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | ||
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | ||
Returnerar det angivna objektets strängbeteckning. | Object | ||
Returnerar det angivna objektets primitiva värde. | Object |
alpha | egenskap |
alpha:Number
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Alfagenomskinlighetsvärdet för skuggfärgen. Giltiga värden är från 0,0 till 1,0. 0,25 innebär till exempel att genomskinlighetsvärdet är 25 %. Standardvärdet är 1.0.
Implementering
public function get alpha():Number
public function set alpha(value:Number):void
angle | egenskap |
blurX | egenskap |
blurY | egenskap |
color | egenskap |
distance | egenskap |
hideObject | egenskap |
hideObject:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Indikerar om objektet är dolt eller inte. Värdet true
indikerar att objektet inte ritas. Bara skuggan syns. Standardvärdet är false
(objektet visas).
Implementering
public function get hideObject():Boolean
public function set hideObject(value:Boolean):void
inner | egenskap |
inner:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Indikerar om skuggan är en innerskugga eller inte. Värdet false
anger att den är en innerskugga. Standardvärdet är false
, en ytterskugga (en skugga runt objektets yttre kanter).
Implementering
public function get inner():Boolean
public function set inner(value:Boolean):void
knockout | egenskap |
knockout:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Lägger på en blockeringseffekt (true
) som gör objektets fyllning genomskinlig så att dokumentets bakgrundsfärg syns. Standardvärdet är false
(ingen blockering).
Implementering
public function get knockout():Boolean
public function set knockout(value:Boolean):void
quality | egenskap |
quality:int
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
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 kvalitetsvä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
.
Implementering
public function get quality():int
public function set quality(value:int):void
Relaterade API-element
strength | egenskap |
strength:Number
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Styrkan hos intrycket eller spridningen. Ju högre värde desto mer färg används och desto starkare blir kontrasten mellan skuggan och bakgrunden. Giltiga värden är från 0 till 255,0. Standardvärdet är 1,0.
Implementering
public function get strength():Number
public function set strength(value:Number):void
DropShadowFilter | () | Konstruktor |
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)
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Skapar ett nytt DropShadowFilter-objekt med de angivna parametrarna.
Parametrardistance:Number (default = 4.0 ) — Skuggans förskjutningsavstånd i pixlar.
| |
angle:Number (default = 45 ) — Skuggans vinkel, 0 till 360 grader (flyttal).
| |
color:uint (default = 0 ) — Färg på skuggan i det hexadecimala formatet 0xRRGGBB. Standardvärdet är 0x000000.
| |
alpha:Number (default = 1.0 ) — Alfagenomskinlighetsvärdet för skuggfärgen. Giltiga värden är från 0,0 till 1,0. 0,25 innebär till exempel att genomskinlighetsvärdet är 25 %.
| |
blurX:Number (default = 4.0 ) — Mängden vågrät oskärpa. Giltiga värden är från 0 till 255,0 (flyttal).
| |
blurY:Number (default = 4.0 ) — Mängden lodrät oskärpa. Giltiga värden är från 0 till 255,0 (flyttal).
| |
strength:Number (default = 1.0 ) — Styrkan hos intrycket eller spridningen. Ju högre värde desto mer färg används och desto starkare blir kontrasten mellan skuggan och bakgrunden. Giltiga värden är från 0 till 255,0.
| |
quality:int (default = 1 ) — Hur många gånger filtret ska tillämpas. Använd BitmapFilterQuality-konstanterna:
Mer information om dessa värden finns i | |
inner:Boolean (default = false ) — Indikerar om skuggan är en innerskugga eller inte. Värdet true anger en innerskugga. Värdet false anger en ytterskugga (en skugga runt objektets yttre kanter).
| |
knockout:Boolean (default = false ) — Lägger på en blockeringseffekt (true ) som gör objektets fyllning genomskinlig så att dokumentets bakgrundsfärg syns.
| |
hideObject:Boolean (default = false ) — Indikerar om objektet är dolt eller inte. Värdet true indikerar att objektet inte ritas. Bara skuggan syns.
|
Relaterade API-element
clone | () | metod |
override public function clone():BitmapFilter
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Returnerar en kopia av det här filterobjektet.
ReturnerarBitmapFilter — En ny instans av DropShadowFilter med samma egenskaper som den ursprungliga DropShadowFilter-instansen.
|
- Deklarera tre egenskaper som används för att rita fyrkanten som filtret ska användas på.
- Skapa konstruktorfunktionen. Konstruktorn anropar
draw()
-metoden som använder metoder för Graphics-klassen genomgraphics
-egenskapen för Sprite för att rita en orange fyrkant. - Deklarera en
filter
-variabel som ett BitmapFilter-objekt och koppla det till det returnerade värdet från ett anrop avgetBitmapFilter()
. MetodengetBitmapFilter()
definierar det skuggfilter som används. - Skapa ett nytt Array-objekt
myFilters
och lägg tillfilter
i arrayen. TilldelamyFilters
-array tillfilters
-egenskapen i DropShadowFilterExample-objektet. Då tillämpas alla filter som finns imyFilters
vilket i det här fallet bara ärfilter
.
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(); } } }
Tue Jun 12 2018, 01:40 PM Z