| Paket | spark.filters |
| Klasse | public class BevelFilter |
| Vererbung | BevelFilter  BaseDimensionFilter BaseFilter EventDispatcher Object |
| Implementiert | IBitmapFilter |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
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.) Wenn Sie beispielsweise einen großen Movieclip mit aktiviertem Filter vergrößert darstellen, wird der Filter deaktiviert, sobald das Ergebnisbild die maximalen Abmessungen überschreitet.
MXML-Syntax
MXML-Syntax anzeigen
MXML-Syntax ausblendenThe <s:BevelFilter> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:BevelFilter
Properties
angle="45"
distance="4"
highlightAlpha="1"
highlightColor="0xFFFFFF"
shadowAlpha="1"
shadowColor="0x000000"
type="inner"
/>
Verwandte API-Elemente
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
flash.display.BitmapData.applyFilter()
| Eigenschaft | Definiert von | ||
|---|---|---|---|
| angle : Number
Der Winkel der Abschrägung in Grad. | BevelFilter | ||
 | blurX : Number
Der Grad der horizontalen Weichzeichnung. | BaseDimensionFilter | |
| blurY : Number
Der Grad der vertikalen Weichzeichnung. | BaseDimensionFilter | |
| 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
Gibt an, ob für das Objekt ein Aussparungseffekt definiert wurde. | BaseDimensionFilter | |
| quality : int
Gibt an, wie oft der Filter angewendet werden soll. | BaseDimensionFilter | |
| shadowAlpha : Number
Der Alphatransparenzwert der Schattenfarbe. | BevelFilter | ||
| shadowColor : uint
Die Schattenfarbe der Abschrägung. | BevelFilter | ||
| strength : Number
Die Stärke des Abdrucks oder Auftragens. | BaseDimensionFilter | |
| type : String
Die Platzierung des Filtereffekts. | 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)
Konstruktor. | BevelFilter | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | |
Gibt eine Kopie dieses Filterobjekts zurück. | BevelFilter | ||
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
|
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 | |
|
Propagiert ein Change-Ereignis, wenn sich der Filter geändert hat. | BaseFilter | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
|
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 | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher | |
angle | Eigenschaft |
angle:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Der Winkel der Abschrägung in Grad. Die zulässigen Werte liegen zwischen 0 und 360. 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 Offset des Effekts gleich null und die angle-Eigenschaft hat keine Auswirkungen.
Der Standardwert ist 45.
Implementierung
public function get angle():Number public function set angle(value:Number):voiddistance | Eigenschaft |
distance:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
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):voidhighlightAlpha | Eigenschaft |
highlightAlpha:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
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):voidhighlightColor | Eigenschaft |
highlightColor:uint| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die Glanzlichtfarbe der Abschrägung. Die zulässigen Werte werden im Hexadezimalformat 0xRRGGBB angegeben.
Der Standardwert ist 0xFFFFFF.
Implementierung
public function get highlightColor():uint public function set highlightColor(value:uint):voidshadowAlpha | Eigenschaft |
shadowAlpha:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
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):voidshadowColor | Eigenschaft |
shadowColor:uint| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die Schattenfarbe der Abschrägung. Die zulässigen Werte werden im Hexadezimalformat 0xRRGGBB angegeben.
Der Standardwert ist 0x000000.
Implementierung
public function get shadowColor():uint public function set shadowColor(value:uint):voidtype | Eigenschaft |
type:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die Platzierung des Filtereffekts. Mögliche Werte sind die „flash.filters.BitmapFilterType“-Konstanten:
BitmapFilterType.OUTER– Glühen-Effekt am äußeren Rand des Objekts.BitmapFilterType.INNER– Glühen-Effekt an der Innenkante des Objekts (die Standardeinstellung)BitmapFilterType.FULL– Glühen-Effekt über dem Objekt.
Der Standardwert ist BitmapFilterType.INNER.
Implementierung
public function get type():String public function set type(value:String):voidVerwandte API-Elemente
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 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Konstruktor.
Parameterdistance:Number (default = 4.0) | |
angle:Number (default = 45) | |
highlightColor:uint (default = 0xFFFFFF) | |
highlightAlpha:Number (default = 1.0) | |
shadowColor:uint (default = 0x000000) | |
shadowAlpha:Number (default = 1.0) | |
blurX:Number (default = 4.0) | |
blurY:Number (default = 4.0) | |
strength:Number (default = 1) | |
quality:int (default = 1)flash.filters.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")flash.filters.BitmapFilterType-Konstanten: BitmapFilterType.INNER, BitmapFilterType.OUTER oder BitmapFilterType.FULL.
| |
knockout:Boolean (default = false)true) an, der die Objektfüllung transparent macht und die Hintergrundfarbe des Dokuments zum Vorschein bringt.
|
Verwandte API-Elemente
clone | () | Methode |
public function clone():BitmapFilter| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt eine Kopie dieses Filterobjekts zurück.
RückgabewerteBitmapFilter — Eine neue BevelFilter-Instanz mit allen Eigenschaften der ursprünglichen BevelFilter-Instanz.
|
<?xml version="1.0"?>
<!-- filters/examples/BevelFilterExample.mxml -->
<s:Application
xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:mx="library://ns.adobe.com/flex/mx"
xmlns:s="library://ns.adobe.com/flex/spark"
creationComplete="createFilters()">
<fx:Script><![CDATA[
import spark.filters.*;
import flash.filters.BitmapFilterQuality;
import flash.filters.BitmapFilterType;
private var myBevelFilter:BevelFilter;
private var color:Number = 0xFF33FF;
public function createFilters():void {
myBevelFilter = new BevelFilter(5, 45, 0xFFFF00, .8, 0x0000FF, .8, 3, 3, 1, BitmapFilterQuality.MEDIUM, BitmapFilterType.INNER, false);
b1.filters = [myBevelFilter];
}
]]></fx:Script>
<s:VGroup>
<!-- This button has a filter applied in ActionScript. -->
<s:Button id="b1" label="Click me"/>
<!-- This button has a filter applied in MXML. -->
<s:Button id="b2" label="Click me">
<s:filters>
<s:BevelFilter
distance="5"
angle="45"
highlightColor="0xFFFF00"
highlightAlpha=".8"
shadowColor="0x0000FF"
shadowAlpha=".8"
blurX="3"
blurY="3"
strength="1"
quality="{BitmapFilterQuality.MEDIUM}"
type="{BitmapFilterType.INNER}"
knockout="false"/>
</s:filters>
</s:Button>
</s:VGroup>
</s:Application>
Tue Jun 12 2018, 10:04 AM Z