Paket | flash.filters |
Klass | public final class BevelFilter |
Arv | BevelFilter BitmapFilter Object |
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Om du vill skapa ett nytt filter använder du konstruktorn new BevelFilter()
. Användningen av filter beror på för vilket objekt du tillämpar filtret:
- Om du vill använda filter på filmklipp, textfält, knappar och video använder du
filters
-egenskapen (ä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 tar bort 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
-egenskaperna inte är 100 %) 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.cacheAsBitmap
flash.display.BitmapData.applyFilter()
Egenskap | Definieras med | ||
---|---|---|---|
angle : Number
Avfasningens vinkel. | BevelFilter | ||
blurX : Number
Mängden vågrät oskärpa i pixlar. | BevelFilter | ||
blurY : Number
Mängden lodrät oskärpa i pixlar. | BevelFilter | ||
constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | ||
distance : Number
Avfasningens förskjutningsavstånd. | BevelFilter | ||
highlightAlpha : Number
Alfagenomskinlighetsvärdet för högdagerfärgen. | BevelFilter | ||
highlightColor : uint
Avfasningens högdagerfärg. | BevelFilter | ||
knockout : Boolean
Lägger på en blockeringseffekt (true) som gör objektets fyllning genomskinlig så att dokumentets bakgrundsfärg syns. | BevelFilter | ||
quality : int
Hur många gånger filtret ska tillämpas. | BevelFilter | ||
shadowAlpha : Number
Alfagenomskinlighetsvärdet för skuggfärgen. | BevelFilter | ||
shadowColor : uint
Avfasningens skuggfärg. | BevelFilter | ||
strength : Number
Styrkan hos intrycket eller spridningen. | BevelFilter | ||
type : String
Avfasningens placering på objektet. | BevelFilter |
Metod | Definieras med | ||
---|---|---|---|
BevelFilter(distance:Number = 4.0, angle:Number = 45, highlightColor:uint = 0xFFFFFF, highlightAlpha:Number = 1.0, shadowColor:uint = 0x000000, shadowAlpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "inner", knockout:Boolean = false)
Initierar en ny BevelFilter-instans med de angivna parametrarna. | BevelFilter | ||
[åsidosätt]
Returnerar en kopia av det här filterobjektet. | BevelFilter | ||
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 |
angle | egenskap |
angle:Number
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Avfasningens vinkel. Giltiga värden är från 0 till 360°. Standardvärdet är 45°.
Värdet för angle representerar infallsvinkeln för en teoretisk ljuskälla som faller på objektet och avgör placeringen av effekten i förhållande till det. Om distance
-egenskapen är inställd på 0, förskjuts inte effekten från objektet och därför har inte angle
-egenskapen någon effekt.
Implementering
public function get angle():Number
public function set angle(value:Number):void
blurX | egenskap |
blurX:Number
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Mängden vågrät oskärpa i pixlar. Giltiga värden är 0 till 255 (flyttal). Standardvärdet är 4. Värden som är 2-potenser (till exempel 2, 4, 8, 16 och 32) är optimerade för snabbare rendering än andra värden.
Implementering
public function get blurX():Number
public function set blurX(value:Number):void
blurY | egenskap |
blurY:Number
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Mängden lodrät oskärpa i pixlar. Giltiga värden är 0 till 255 (flyttal). Standardvärdet är 4. Värden som är 2-potenser (till exempel 2, 4, 8, 16 och 32) är optimerade för snabbare rendering än andra värden.
Implementering
public function get blurY():Number
public function set blurY(value:Number):void
distance | egenskap |
highlightAlpha | egenskap |
highlightAlpha:Number
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Alfagenomskinlighetsvärdet för högdagerfärgen. Värdet anges som ett normaliserat värde från 0 till 1. 0,25 innebär till exempel att genomskinlighetsvärdet är 25 %. Standardvärdet är 1.
Implementering
public function get highlightAlpha():Number
public function set highlightAlpha(value:Number):void
highlightColor | egenskap |
highlightColor:uint
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Avfasningens högdagerfärg. Giltiga värden anges i hexadecimalt format, 0xRRGGBB. Standardvärdet är 0xFFFFFF.
Implementering
public function get highlightColor():uint
public function set highlightColor(value:uint):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 quality
-vä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
.
Du kan använda följande BitmapFilterQuality
-konstanter för att ange värden för quality
-egenskapen:
BitmapFilterQuality.LOW
BitmapFilterQuality.MEDIUM
BitmapFilterQuality.HIGH
Implementering
public function get quality():int
public function set quality(value:int):void
shadowAlpha | egenskap |
shadowAlpha:Number
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Alfagenomskinlighetsvärdet för skuggfärgen. Värdet anges som ett normaliserat värde från 0 till 1. 0,25 innebär till exempel att genomskinlighetsvärdet är 25 %. Standardvärdet är 1.
Implementering
public function get shadowAlpha():Number
public function set shadowAlpha(value:Number):void
shadowColor | egenskap |
shadowColor:uint
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Avfasningens skuggfärg. Giltiga värden anges i hexadecimalt format, 0xRRGGBB. Standardvärdet är 0x000000.
Implementering
public function get shadowColor():uint
public function set shadowColor(value:uint):void
strength | egenskap |
strength:Number
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Styrkan hos intrycket eller spridningen. Giltiga värden är från 0 till 255. Ju större värde, desto mer färg trycks in och desto starkare blir kontrasten mellan avfasningen och bakgrunden. Standardvärdet är 1.
Implementering
public function get strength():Number
public function set strength(value:Number):void
type | egenskap |
type:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Avfasningens placering på objektet. Inre och yttre avfasningar placeras på den inre eller yttre kanten. En fullständig avfasning placeras på hela objektet. Giltiga värden är BitmapFilterType
-konstanterna:
BitmapFilterType.INNER
BitmapFilterType.OUTER
BitmapFilterType.FULL
Implementering
public function get type():String
public function set type(value:String):void
Utlöser
TypeError — Strängen är null när den ställs in
|
BevelFilter | () | Konstruktor |
public function BevelFilter(distance:Number = 4.0, angle:Number = 45, highlightColor:uint = 0xFFFFFF, highlightAlpha:Number = 1.0, shadowColor:uint = 0x000000, shadowAlpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "inner", knockout:Boolean = false)
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Initierar en ny BevelFilter-instans med de angivna parametrarna.
Parametrardistance:Number (default = 4.0 ) — Avfasningens förskjutningsavstånd i pixlar (flyttal).
| |
angle:Number (default = 45 ) — Avfasningens vinkel, från 0 till 360 grader.
| |
highlightColor:uint (default = 0xFFFFFF ) — Avfasningens högdagerfärg, 0xRRGGBB.
| |
highlightAlpha:Number (default = 1.0 ) — Alfagenomskinlighetsvärdet för högdagerfärgen. Giltiga värden är från 0,0 till 1,0. 0,25 innebär till exempel att genomskinlighetsvärdet är 25 %.
| |
shadowColor:uint (default = 0x000000 ) — Avfasningens skuggfärg, 0xRRGGBB.
| |
shadowAlpha: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 i pixlar. Giltiga värden är från 0 till 255,0 (flyttal).
| |
blurY:Number (default = 4.0 ) — Mängden lodrät oskärpa i pixlar. Giltiga värden är från 0 till 255,0 (flyttal).
| |
strength:Number (default = 1 ) — Styrkan hos intrycket eller spridningen. Ju högre värde desto mer färg används och desto starkare blir kontrasten mellan avfasningen och bakgrunden. Giltiga värden är från 0 till 255,0.
| |
quality:int (default = 1 ) — Avfasningens kvalitet. Giltiga värden är 0 till 15, men i de flesta program kan du använda BitmapFilterQuality -konstanter:
Filter med lägre värden renderas snabbare. Du kan använda andra tillgängliga numeriska värden för att uppnå olika effekter. | |
type:String (default = "inner ") — Avfasningens typ. Giltiga värden är BitmapFilterType -konstanter. BitmapFilterType.INNER , BitmapFilterType.OUTER eller BitmapFilterType.FULL .
| |
knockout:Boolean (default = false ) — Lägger på en blockeringseffekt (true ) som gör objektets fyllning genomskinlig så att dokumentets bakgrundsfärg 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 BevelFilter-instans med samma egenskaper som den ursprungliga BevelFilter-instansen.
|
- Importera de nödvändiga klasserna.
- Deklarera tre egenskaper som används i funktionen
draw()
som ritar det objekt som avfasningsfiltret ska användas på. - Skapa
BevelFilterExample()
-konstruktorfunktionen som gör följande:- Anropar funktionen
draw()
, som beskrivs senare. - Deklarerar en
filter
-variabel som ett BitmapFilter-objekt och kopplar det till det returnerade värdet från ett anrop avgetBitmapFilter()
. - Skapar ett nytt Array-objekt
myFilters
och lägger tillfilter
i arrayen, och kopplarmyFilters
tillfilters
-egenskapen i BevelFilterExample-objektet. Då tillämpas alla filter som finns imyFilters
vilket i det här fallet bara ärfilter
.
- Anropar funktionen
- Skapa
getBitmapFilter
-funktionen och skapa och ange egenskaper för filtret. - Skapa
draw()
-funktionen. Den här funktionen använder metoder i Graphics-klassen, som du får åtkomst till viagraphics
-egenskapen i Sprite-klassen, för att rita fyrkanten.
package { import flash.display.Sprite; import flash.filters.BevelFilter; import flash.filters.BitmapFilter; import flash.filters.BitmapFilterQuality; import flash.filters.BitmapFilterType; public class BevelFilterExample extends Sprite { private var bgColor:uint = 0xFFCC00; private var size:uint = 80; private var offset:uint = 50; public function BevelFilterExample() { draw(); var filter:BitmapFilter = getBitmapFilter(); var myFilters:Array = new Array(); myFilters.push(filter); filters = myFilters; } private function getBitmapFilter():BitmapFilter { var distance:Number = 5; var angleInDegrees:Number = 45; var highlightColor:Number = 0xFFFF00; var highlightAlpha:Number = 0.8; var shadowColor:Number = 0x0000FF; var shadowAlpha:Number = 0.8; var blurX:Number = 5; var blurY:Number = 5; var strength:Number = 5; var quality:Number = BitmapFilterQuality.HIGH; var type:String = BitmapFilterType.INNER; var knockout:Boolean = false; return new BevelFilter(distance, angleInDegrees, highlightColor, highlightAlpha, shadowColor, shadowAlpha, blurX, blurY, strength, quality, type, knockout); } private function draw():void { graphics.beginFill(bgColor); graphics.drawRect(offset, offset, size, size); graphics.endFill(); } } }
Tue Jun 12 2018, 01:40 PM Z