Pakket | flash.filters |
Klasse | public final class BevelFilter |
Overerving | BevelFilter BitmapFilter Object |
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Wanneer u een nieuw filter wilt maken, gebruikt u de constructor new BevelFilter()
. 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 waarde van de eigenschap cacheAsBitmap
van het object 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 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.cacheAsBitmap
flash.display.BitmapData.applyFilter()
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
angle : Number
De hoek van de schuine kant. | BevelFilter | ||
blurX : Number
De mate van horizontale vervaging in pixels. | BevelFilter | ||
blurY : Number
De mate van verticale vervaging in pixels. | BevelFilter | ||
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | ||
distance : Number
De verschuivingsafstand van de schuine kant. | BevelFilter | ||
highlightAlpha : Number
De alpha-transparantiewaarde van de markeerkleur. | BevelFilter | ||
highlightColor : uint
De markeerkleur van de schuine kant. | BevelFilter | ||
knockout : Boolean
Past een uitneemeffect toe (true), waardoor het object transparant wordt gevuld en de achtergrondkleur van het document zichtbaar wordt gemaakt. | BevelFilter | ||
quality : int
Het aantal keren dat het filter moet worden toegepast. | BevelFilter | ||
shadowAlpha : Number
De alpha-transparantiewaarde van de schaduwkleur. | BevelFilter | ||
shadowColor : uint
De schaduwkleur van de schuine kant. | BevelFilter | ||
strength : Number
De sterkte van de afdruk of de spreiding. | BevelFilter | ||
type : String
De plaatsing van de schuine kant op het object | BevelFilter |
Methode | Gedefinieerd door | ||
---|---|---|---|
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)
Initialiseert een nieuwe instantie BevelFilter met de opgegeven parameters. | BevelFilter | ||
[overschrijven]
Retourneert een kopie van dit filterobject. | BevelFilter | ||
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 |
angle | eigenschap |
angle:Number
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
De hoek van de schuine kant. Geldige waarden zijn 0 tot en met 360°. De standaardwaarde is 45°.
De waarde angle vertegenwoordigt de hoek van de denkbeeldige lichtbron die op het object valt en bepaalt de plaatsing van het effect ten opzichte van het object. Wanneer de eigenschap distance
op 0 is ingesteld, wordt het effect niet verschoven ten opzichte van het object en heeft de eigenschap angle
daarom geen effect.
Implementatie
public function get angle():Number
public function set angle(value:Number):void
blurX | eigenschap |
blurX:Number
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
De mate van horizontale vervaging in pixels. 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 in pixels. 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
distance | eigenschap |
distance:Number
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
De verschuivingsafstand van de schuine kant. Geldige waarden worden in pixels vermeld (drijvende komma). De standaardwaarde is 4.
Implementatie
public function get distance():Number
public function set distance(value:Number):void
highlightAlpha | eigenschap |
highlightAlpha:Number
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
De alpha-transparantiewaarde van de markeerkleur. De waarde wordt als een genormaliseerde waarde van 0 tot en met 1 opgegeven. De waarde .25 stelt bijvoorbeeld een transparantiewaarde in van 25%. De standaardwaarde is 1.
Implementatie
public function get highlightAlpha():Number
public function set highlightAlpha(value:Number):void
highlightColor | eigenschap |
highlightColor:uint
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
De markeerkleur van de schuine kant. Geldige waarden hebben de hexadecimale notatie 0xRRGGBB. De standaardwaarde is 0xFFFFFF.
Implementatie
public function get highlightColor():uint
public function set highlightColor(value:uint):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 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.
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
shadowAlpha | eigenschap |
shadowAlpha:Number
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
De alpha-transparantiewaarde van de schaduwkleur. Deze waarde wordt als een genormaliseerde waarde van 0 tot en met 1 opgegeven. De waarde .25 stelt bijvoorbeeld een transparantiewaarde in van 25%. De standaardwaarde is 1.
Implementatie
public function get shadowAlpha():Number
public function set shadowAlpha(value:Number):void
shadowColor | eigenschap |
shadowColor:uint
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
De schaduwkleur van de schuine kant. Geldige waarden hebben de hexadecimale notatie 0xRRGGBB. De standaardwaarde is 0x000000.
Implementatie
public function get shadowColor():uint
public function set shadowColor(value:uint):void
strength | eigenschap |
strength:Number
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
De sterkte van de afdruk of de spreiding. Geldige waarden zijn 0 tot en met 255. Hoe hoger de waarde, hoe meer kleur er wordt afgedrukt en hoe sterker het contrast tussen de schuine kant en de achtergrond wordt. De standaardwaarde is 1.
Implementatie
public function get strength():Number
public function set strength(value:Number):void
type | eigenschap |
type:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
De plaatsing van de schuine kant op het object Schuine kanten worden aan de binnen- en buitenranden geplaatst; een volledige schuine kant wordt op het hele object geplaatst. Geldige waarden zijn BitmapFilterType
-constanten:
BitmapFilterType.INNER
BitmapFilterType.OUTER
BitmapFilterType.FULL
Implementatie
public function get type():String
public function set type(value:String):void
Gegenereerde uitzondering
TypeError — De string is null wanneer deze wordt ingesteld.
|
BevelFilter | () | Constructor |
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)
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Initialiseert een nieuwe instantie BevelFilter met de opgegeven parameters.
Parametersdistance:Number (default = 4.0 ) — De verschuivingsafstand van de schuine kant, in pixels (drijvende komma).
| |
angle:Number (default = 45 ) — De hoek van de schuine kant, van 0 tot en met 360 graden.
| |
highlightColor:uint (default = 0xFFFFFF ) — De markeerkleur van de schuine kant, 0xRRGGBB.
| |
highlightAlpha:Number (default = 1.0 ) — De alpha-transparantiewaarde van de markeerkleur. Geldige waarden zijn 0.0 tot en met 1.0. De waarde .25 stelt bijvoorbeeld een transparantiewaarde in van 25%.
| |
shadowColor:uint (default = 0x000000 ) — De markeerkleur van de schuine kant, 0xRRGGBB.
| |
shadowAlpha:Number (default = 1.0 ) — De alpha-transparantiewaarde van 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 in pixels. Geldige waarden zijn 0 tot en met 255,0 (drijvende komma).
| |
blurY:Number (default = 4.0 ) — De mate van verticale vervaging in pixels. Geldige waarden zijn 0 tot en met 255,0 (drijvende komma).
| |
strength:Number (default = 1 ) — 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 schuine kant en de achtergrond wordt. Geldige waarden zijn 0 tot en met 255.0.
| |
quality:int (default = 1 ) — De kwaliteit van de schuine kant Geldige waarden zijn 0 tot en met 15, maar voor de meeste toepassingen kunt u de BitmapFilterQuality -constanten gebruiken:
Filters met lagere waarden renderen sneller. U kunt de andere beschikbare numerieke waarden gebruiken om verschillende effecten te bereiken. | |
type:String (default = "inner ") — Het type schuine kant. Geldige waarden zijn BitmapFilterType -constanten: BitmapFilterType.INNER , BitmapFilterType.OUTER of BitmapFilterType.FULL .
| |
knockout:Boolean (default = false ) — Past een uitneemeffect toe (true ), waardoor 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 BevelFilter waarvan alle eigenschappen hetzelfde zijn als de oorspronkelijke instantie BevelFilter.
|
- Importeer de vereiste klassen.
- Declareer drie eigenschappen die in de functie
draw()
worden gebruikt, die het object tekenen waarop het schuine-kantfilter wordt toegepast. - Maak de constructorfunctie
BevelFilterExample()
, 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 BevelFilterExample. 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.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(); } } }
Wed Jun 13 2018, 11:42 AM Z