Paket | flash.filters |
Klasse | public final class BevelFilter |
Vererbung | BevelFilter BitmapFilter Object |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Verwenden Sie zum Erstellen eines neuen Filters den Konstruktor new BevelFilter()
. Die Verwendung von Filtern hängt davon ab, auf welches Objekt sie jeweils angewendet werden:
- Um Filter auf Movieclips, Textfelder, Schaltflächen und Videosequenzen anzuwenden, verwenden Sie die Eigenschaft
filters
(von DisplayObject übernommen). Durch die Einstellung derfilters
-Eigenschaft wird das betroffene Objekt selbst nicht verändert, und Sie können den Filter wieder entfernen, indem Sie diefilters
-Eigenschaft löschen. - Um Filter auf BitmapData-Objekte anzuwenden, verwenden Sie die
BitmapData.applyFilter()
-Methode. Durch den Aufruf vonapplyFilter()
bei einem BitmapData-Objekt wird das gefilterte Bild aus dem BitmapData-Quellobjekt und dem Filterobjekt generiert.
Wenn Sie einen Filter auf ein Anzeigeobjekt anwenden, wird der Wert der cacheAsBitmap
-Eigenschaft des Objekts auf true
gesetzt. Wenn Sie alle Filter entfernen, wird der ursprüngliche Wert von cacheAsBitmap
wiederhergestellt.
Dieser Filter unterstützt Bühnenskalierung. Allgemeine Skalierung, Drehung und Neigung werden dagegen nicht unterstützt. Wenn das Objekt selbst skaliert wird (also die Eigenschaften scaleX
und scaleY
ungleich 100 % sind), wird der Filtereffekt nicht skaliert. Er wird nur dann skaliert, wenn die Bühne vergrößert dargestellt wird.
Ein Filter wird nicht angewendet, wenn das Ergebnisbild die maximalen Abmessungen überschreitet. In AIR 1.5 und Flash Player 10 beträgt die maximale Höhe oder Breite 8.191 Pixel; die gesamte Pixelzahl darf 16.777.215 nicht übersteigen. (Wenn ein Bild also 8.191 Pixel breit ist, darf es nur 2.048 Pixel hoch sein.) In Flash Player 9 und niedriger und AIR 1.1 und niedriger liegt die Grenze bei je 2.880 Pixel Höhe und Breite. Wenn Sie beispielsweise einen großen Movieclip mit aktiviertem Filter vergrößert darstellen, wird der Filter deaktiviert, sobald das Ergebnisbild die maximalen Abmessungen überschreitet.
Verwandte API-Elemente
flash.display.DisplayObject.cacheAsBitmap
flash.display.BitmapData.applyFilter()
Eigenschaft | Definiert von | ||
---|---|---|---|
angle : Number
Der Winkel der Abschrägung. | BevelFilter | ||
blurX : Number
Der Grad der horizontalen Weichzeichnung in Pixel. | BevelFilter | ||
blurY : Number
Der Grad der vertikalen Weichzeichnung in Pixel. | BevelFilter | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
distance : Number
Der Offset der Abschrägung. | BevelFilter | ||
highlightAlpha : Number
Der Alphatransparenzwert der Glanzlichtfarbe. | BevelFilter | ||
highlightColor : uint
Die Glanzlichtfarbe der Abschrägung. | BevelFilter | ||
knockout : Boolean
Wendet einen Aussparungseffekt (true) an, der die Objektfüllung transparent macht und die Hintergrundfarbe des Dokuments zum Vorschein bringt. | BevelFilter | ||
quality : int
Gibt an, wie oft der Filter angewendet werden soll. | BevelFilter | ||
shadowAlpha : Number
Der Alphatransparenzwert der Schattenfarbe. | BevelFilter | ||
shadowColor : uint
Die Schattenfarbe der Abschrägung. | BevelFilter | ||
strength : Number
Die Stärke des Abdrucks oder Auftragens. | BevelFilter | ||
type : String
Die Platzierung der Abschrägung auf dem Objekt. | BevelFilter |
Methode | Definiert von | ||
---|---|---|---|
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)
Initialisiert eine neue BevelFilter-Instanz mit den angegebenen Parametern. | BevelFilter | ||
[override]
Gibt eine Kopie dieses Filterobjekts zurück. | BevelFilter | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
angle | Eigenschaft |
angle:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Der Winkel der Abschrägung. Die zulässigen Werte liegen zwischen 0 und 360 Grad. Der Standardwert ist 45°.
Dieser Wert stellt den Winkel einer imaginären, das Objekt beleuchtenden Lichtquelle dar und bestimmt die Position des Effekts relativ zu diesem Objekt. Wenn die distance
-Eigenschaft auf 0 (null) gesetzt wird, ist der Versatz des Effekts gleich null und die angle
-Eigenschaft hat keine Auswirkungen.
Implementierung
public function get angle():Number
public function set angle(value:Number):void
blurX | Eigenschaft |
blurX:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Der Grad der horizontalen Weichzeichnung in Pixel. Die zulässigen Werte liegen zwischen 0 und 255,0 (Gleitkommazahl). Der Standardwert ist 4. Zweierpotenzen (z. B. 2, 4, 8, 16 und 32) sind optimiert und ergeben eine schnellere Anzeige als andere Werte.
Implementierung
public function get blurX():Number
public function set blurX(value:Number):void
blurY | Eigenschaft |
blurY:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Der Grad der vertikalen Weichzeichnung in Pixel. Die zulässigen Werte liegen zwischen 0 und 255,0 (Gleitkommazahl). Der Standardwert ist 4. Zweierpotenzen (z. B. 2, 4, 8, 16 und 32) sind optimiert und ergeben eine schnellere Anzeige als andere Werte.
Implementierung
public function get blurY():Number
public function set blurY(value:Number):void
distance | Eigenschaft |
distance:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Der Offset der Abschrägung. Die zulässigen Werte sind in Pixeln angegeben (Gleitkommazahl). Der Standardwert ist 4.
Implementierung
public function get distance():Number
public function set distance(value:Number):void
highlightAlpha | Eigenschaft |
highlightAlpha:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Der Alphatransparenzwert der Glanzlichtfarbe. Wird als normalisierter Wert von 0 bis 1 angegeben. Mit dem Wert 0,25 wird beispielsweise ein Transparenzwert von 25 % festgelegt. Der Standardwert ist 1.
Implementierung
public function get highlightAlpha():Number
public function set highlightAlpha(value:Number):void
highlightColor | Eigenschaft |
highlightColor:uint
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Die Glanzlichtfarbe der Abschrägung. Die zulässigen Werte werden im Hexadezimalformat 0xRRGGBB angegeben. Der Standardwert lautet 0xFFFFFF.
Implementierung
public function get highlightColor():uint
public function set highlightColor(value:uint):void
knockout | Eigenschaft |
knockout:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Wendet einen Aussparungseffekt (true
) an, der die Objektfüllung transparent macht und die Hintergrundfarbe des Dokuments zum Vorschein bringt. Der Standardwert lautet false
(keine Aussparung).
Implementierung
public function get knockout():Boolean
public function set knockout(value:Boolean):void
quality | Eigenschaft |
quality:int
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Gibt an, wie oft der Filter angewendet werden soll. Der Standardwert lautet BitmapFilterQuality.LOW
, was einer einmaligen Anwendung des Filters entspricht. Mit dem Wert BitmapFilterQuality.MEDIUM
wird der Filter zweimal angewendet und mit dem Wert BitmapFilterQuality.HIGH
dreimal. Filter mit niedrigen Werten werden schneller dargestellt.
Bei den meisten Anwendungen genügt die Angabe der niedrigen, mittleren oder hohen Qualität für quality
. Sie können zwar Werte bis 15 angeben, um unterschiedliche Effekte zu erzielen, höhere Werte führen jedoch auch zu einer langsameren Darstellung. Anstatt also den Wert von quality
zu erhöhen, können Sie einen ähnlichen Effekt mit gleichzeitig schnellerer Darstellung erzielen, indem Sie einfach die Eigenschaftswerte von blurX
und blurY
erhöhen.
Mithilfe der folgenden BitmapFilterQuality
-Konstanten können Sie die Werte der quality
-Eigenschaft einstellen:
BitmapFilterQuality.LOW
BitmapFilterQuality.MEDIUM
BitmapFilterQuality.HIGH
Implementierung
public function get quality():int
public function set quality(value:int):void
shadowAlpha | Eigenschaft |
shadowAlpha:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Der Alphatransparenzwert der Schattenfarbe. Wird als normalisierter Wert von 0 bis 1 angegeben. Mit dem Wert 0,25 wird beispielsweise ein Transparenzwert von 25 % festgelegt. Der Standardwert ist 1.
Implementierung
public function get shadowAlpha():Number
public function set shadowAlpha(value:Number):void
shadowColor | Eigenschaft |
shadowColor:uint
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Die Schattenfarbe der Abschrägung. Die zulässigen Werte werden im Hexadezimalformat 0xRRGGBB angegeben. Der Standardwert lautet 0x000000.
Implementierung
public function get shadowColor():uint
public function set shadowColor(value:uint):void
strength | Eigenschaft |
strength:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Die Stärke des Abdrucks oder Auftragens. Die zulässigen Werte liegen zwischen 0 und 255. Je höher der Wert, desto mehr Farbe wird aufgedruckt und desto stärker ist der Kontrast zwischen der Abschrägung und dem Hintergrund. Der Standardwert ist 1.
Implementierung
public function get strength():Number
public function set strength(value:Number):void
type | Eigenschaft |
type:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Die Platzierung der Abschrägung auf dem Objekt. Innere und äußere Abschrägungen werden an der Innen- bzw. Außenkante platziert. Eine vollständige Abschrägung wird auf das gesamte Objekt platziert. Bei den zulässigen Werten handelt es sich um die BitmapFilterType
-Konstanten:
BitmapFilterType.INNER
BitmapFilterType.OUTER
BitmapFilterType.FULL
Implementierung
public function get type():String
public function set type(value:String):void
Auslöser
TypeError — Der String ist leer, wenn gesetzt.
|
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)
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Initialisiert eine neue BevelFilter-Instanz mit den angegebenen Parametern.
Parameterdistance:Number (default = 4.0 ) — Der Offset der Abschrägung in Pixeln (Gleitkommazahl).
| |
angle:Number (default = 45 ) — Der Winkel der Abschrägung von 0 bis 360 Grad.
| |
highlightColor:uint (default = 0xFFFFFF ) — Die Glanzlichtfarbe der Abschrägung im Format 0xRRGGBB.
| |
highlightAlpha:Number (default = 1.0 ) — Der Alphatransparenzwert der Glanzlichtfarbe. Die zulässigen Werte liegen zwischen 0,0 und 1,0. Mit dem Wert 0,25 wird beispielsweise ein Transparenzwert von 25 % festgelegt.
| |
shadowColor:uint (default = 0x000000 ) — Die Schattenfarbe der Abschrägung im Format 0xRRGGBB.
| |
shadowAlpha:Number (default = 1.0 ) — Der Alphatransparenzwert der Schattenfarbe. Die zulässigen Werte liegen zwischen 0,0 und 1,0. Mit dem Wert 0,25 wird beispielsweise ein Transparenzwert von 25 % festgelegt.
| |
blurX:Number (default = 4.0 ) — Der Grad der horizontalen Weichzeichnung in Pixeln. Die zulässigen Werte liegen zwischen 0 und 255.0 (Gleitkomma).
| |
blurY:Number (default = 4.0 ) — Der Grad der vertikalen Weichzeichnung in Pixeln. Die zulässigen Werte liegen zwischen 0 und 255.0 (Gleitkomma).
| |
strength:Number (default = 1 ) — Die Stärke des Abdrucks oder Auftragens. Je höher der Wert, desto mehr Farbe wird aufgetragen und desto stärker ist der Kontrast zwischen der Abschrägung und dem Hintergrund. Die zulässigen Werte liegen zwischen 0 und 255.0.
| |
quality:int (default = 1 ) — Die Qualität der Abschrägung. Die zulässigen Werte liegen zwischen 0 und 15. In den meisten Anwendungen können Sie jedoch die BitmapFilterQuality -Konstanten verwenden:
Filter mit niedrigen Werten werden schneller dargestellt. Sie können die anderen verfügbaren Zahlenwerte verwenden, um andere Effekte zu erzielen. | |
type:String (default = "inner ") — Der Typ der Abschrägung. Bei den zulässigen Werten handelt es sich um die BitmapFilterType -Konstanten: BitmapFilterType.INNER , BitmapFilterType.OUTER oder BitmapFilterType.FULL .
| |
knockout:Boolean (default = false ) — Wendet einen Aussparungseffekt (true ) an, der die Objektfüllung transparent macht und die Hintergrundfarbe des Dokuments zum Vorschein bringt.
|
Verwandte API-Elemente
clone | () | Methode |
override public function clone():BitmapFilter
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Gibt eine Kopie dieses Filterobjekts zurück.
RückgabewerteBitmapFilter — Eine neue BevelFilter-Instanz mit allen Eigenschaften der ursprünglichen BevelFilter-Instanz.
|
- Importieren Sie die erforderlichen Klassen.
- Deklarieren Sie drei Eigenschaften für die
draw()
-Funktion, mit der das Objekt, auf das der Abschrägungsfilter angewendet wird, gezeichnet wird. - Erstellen Sie die
BevelFilterExample()
-Konstruktorfunktion, die Folgendes bewirkt:- Ruft die
draw()
-Funktion auf, die später deklariert wird. - Deklariert eine Variable
filter
als BitmapFilter-Objekt und weist es dem Wert zu, der sich aus dem Aufruf vongetBitmapFilter()
ergibt. - Erstellt ein neues Array-Objekt
myFilters
und fügtfilter
zum Array hinzu. Anschließend wirdmyFilters
derfilters
-Eigenschaft des BevelFilterExample-Objekts zugewiesen. Dadurch werden alle inmyFilters
vorgefundenen Filter angewendet; in diesem Fall nurfilter
.
- Ruft die
- Erstellen Sie die
getBitmapFilter
-Funktion, mit der Eigenschaften für den Filter erstellt und festgelegt werden. - Erstellen Sie die
draw()
-Funktion. Diese Funktion verwendet Methoden der Graphics-Klasse, auf die über die Eigenschaftgraphics
der Sprite-Klasse zugegriffen wird, um das Quadrat zu zeichnen.
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, 10:04 AM Z